AI Research
AI-powered deep market analysis with news, sentiment, trading insights, and resolution tracking
AI Research
POST /api/v1/research
Get comprehensive AI-powered market analysis including real-time news, social sentiment, trading assessments, resolution criteria tracking, and execution considerations.
This endpoint costs 3 credits per request.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Natural language query about a market or topic |
stream | boolean | No | Enable streaming response (default: false) |
Example Request
curl -X POST "https://api.tessradar.com/api/v1/research" \
-H "Authorization: Bearer or_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"query": "Will Bitcoin reach $100,000 by end of 2024?",
"stream": false
}'Example Response
{
"success": true,
"data": {
"meta": {
"query": "Will Bitcoin reach $100,000 by end of 2024?",
"marketId": "0x1234567890abcdef1234567890abcdef12345678",
"platform": "polymarket",
"timestamp": "2024-11-15T14:30:00Z",
"creditsUsed": 3,
"dataSources": ["polymarket", "newsapi", "google", "gemini"],
"processingTimeMs": 2847
},
"criticalFinding": {
"type": "HIGH_VOLATILITY",
"title": "Significant Price Movement Detected",
"description": "YES price increased 12% in the last 24 hours following ETF approval news"
},
"market": {
"title": "Bitcoin $100K by EOY 2024",
"question": "Will Bitcoin reach $100,000 by December 31, 2024?",
"platform": "polymarket",
"volume": 4250000,
"volume24h": 380000,
"liquidity": 185000,
"createdAt": "2024-01-15T00:00:00Z",
"endDate": "2024-12-31T23:59:59Z",
"status": "open",
"outcomes": [
{
"id": "yes",
"name": "Yes",
"price": 0.42,
"change24h": 0.12
},
{
"id": "no",
"name": "No",
"price": 0.58,
"change24h": -0.12
}
],
"url": "https://polymarket.com/event/bitcoin-100k-2024",
"image": "https://polymarket-upload.s3.amazonaws.com/bitcoin-100k.png"
},
"analysis": {
"summary": "Bitcoin reaching $100,000 by year-end remains uncertain but increasingly plausible. Recent ETF approval has driven significant institutional inflows, pushing prices above $90,000. However, macroeconomic headwinds and typical year-end volatility present risks. The market currently prices this at 42% probability, reflecting cautious optimism.",
"confidence": 0.72,
"newsBasedSentiment": {
"overall": "bullish",
"score": 0.65,
"keyPoints": [
"Bitcoin spot ETFs saw $1.2B inflows this week",
"Institutional adoption accelerating with major banks offering custody",
"Halving supply shock effects still being priced in",
"Fed rate cuts expected in Q1 2025 supporting risk assets"
],
"sources": [
{
"title": "Bitcoin ETFs See Record Inflows as BTC Approaches $95K",
"url": "https://coindesk.com/markets/bitcoin-etf-record-inflows",
"date": "2024-11-14T10:30:00Z",
"source": "CoinDesk",
"sentiment": "bullish"
},
{
"title": "BlackRock Bitcoin ETF Holdings Surpass 400,000 BTC",
"url": "https://bloomberg.com/crypto/blackrock-btc-holdings",
"date": "2024-11-13T15:00:00Z",
"source": "Bloomberg",
"sentiment": "bullish"
},
{
"title": "Analysts Warn of Year-End Volatility Despite Bull Run",
"url": "https://reuters.com/markets/bitcoin-volatility-warning",
"date": "2024-11-12T08:00:00Z",
"source": "Reuters",
"sentiment": "neutral"
}
]
}
},
"resolutionCriteria": {
"description": "Market resolves YES if Bitcoin price reaches or exceeds $100,000 USD on any major exchange (Coinbase, Binance, Kraken) before December 31, 2024 23:59:59 UTC",
"criteria": [
{
"requirement": "BTC price >= $100,000 on Coinbase",
"status": "NOT_MET",
"evidence": "Current price: $94,250"
},
{
"requirement": "BTC price >= $100,000 on Binance",
"status": "NOT_MET",
"evidence": "Current price: $94,180"
},
{
"requirement": "Before December 31, 2024 23:59:59 UTC",
"status": "PENDING",
"evidence": "46 days remaining"
}
],
"currentStatus": "Bitcoin needs to gain approximately 6.1% to reach $100,000. At current momentum, this could occur within 2-4 weeks if trend continues."
},
"tradingAssessment": {
"doNotTrade": {
"active": false,
"reasons": []
},
"positions": [
{
"position": "YES @ 42¢",
"forArguments": "Strong ETF inflows, halving effects, institutional FOMO, only 6% away from target",
"againstArguments": "Year-end profit taking, macro uncertainty, resistance at psychological $100K level",
"potential": "MEDIUM",
"confidence": 0.65
},
{
"position": "NO @ 58¢",
"forArguments": "Strong resistance at $100K, limited time remaining, historical year-end corrections",
"againstArguments": "Momentum strongly bullish, ETF demand unprecedented, supply constrained post-halving",
"potential": "LOW",
"confidence": 0.45
}
]
},
"execution": {
"warnings": [
"High volatility - consider smaller position sizes",
"Market may gap significantly on weekend news"
],
"liquidityAssessment": "GOOD",
"slippageEstimate": "< 0.5% for orders under $10,000",
"suggestedSize": "1-2% of portfolio given volatility"
},
"context": {
"summary": "This market is part of the broader crypto bull cycle driven by ETF approvals, halving supply dynamics, and improving macro conditions. Bitcoin's performance will likely influence the entire crypto market.",
"relatedMarkets": [
{
"title": "Bitcoin $150K by end of 2025",
"id": "0xabcdef1234567890abcdef1234567890abcdef12",
"platform": "polymarket",
"correlation": 0.85
},
{
"title": "Ethereum $10K by end of 2024",
"id": "0x9876543210fedcba9876543210fedcba98765432",
"platform": "polymarket",
"correlation": 0.72
}
],
"externalFactors": [
"Federal Reserve interest rate decisions",
"US regulatory clarity on crypto",
"Global liquidity conditions",
"Geopolitical stability"
]
},
"socialSentiment": {
"platform": "x",
"mentions": 45200,
"sentiment": 0.58,
"trending": true,
"topPosts": [
{
"text": "$BTC about to flip $100K... this is the moment we've been waiting for 🚀",
"engagement": 12500,
"author": "@crypto_analyst",
"url": "https://x.com/crypto_analyst/status/123456789"
},
{
"text": "Institutional demand for Bitcoin ETFs is unlike anything we've seen. $100K is inevitable.",
"engagement": 8900,
"author": "@btc_institutional",
"url": "https://x.com/btc_institutional/status/987654321"
}
]
},
"sources": [
{ "type": "newsapi", "title": "CoinDesk", "url": "https://coindesk.com" },
{ "type": "newsapi", "title": "Bloomberg Crypto", "url": "https://bloomberg.com/crypto" },
{ "type": "x", "title": "X/Twitter Sentiment" },
{ "type": "gemini", "title": "AI Analysis" }
]
}
}Response Structure
Meta Object
| Field | Type | Description |
|---|---|---|
query | string | Original search query |
marketId | string | Matched market identifier |
platform | string | Source platform (polymarket, kalshi, unknown) |
timestamp | string | Response timestamp (ISO 8601) |
creditsUsed | number | Credits consumed |
dataSources | array | Data sources used for analysis |
processingTimeMs | number | Processing time in milliseconds |
Critical Finding Object (Optional)
Appears when important market events are detected.
| Field | Type | Description |
|---|---|---|
type | string | RESOLVED, EXPIRING, HIGH_VOLATILITY, BREAKING_NEWS, WARNING |
title | string | Alert title |
description | string | Detailed alert description |
Market Object
| Field | Type | Description |
|---|---|---|
title | string | Market title |
question | string | Full market question |
platform | string | Source platform |
volume | number | Total trading volume (USD) |
volume24h | number | 24-hour volume (USD) |
liquidity | number | Available liquidity (USD) |
endDate | string | Market end date (ISO 8601) |
status | string | open, closed, resolved, unknown |
outcomes | array | Outcome options with prices |
url | string | Direct link to market |
Analysis Object
| Field | Type | Description |
|---|---|---|
summary | string | AI-generated analysis summary |
confidence | number | Overall confidence score (0-1) |
newsBasedSentiment | object | News sentiment analysis |
News Based Sentiment
| Field | Type | Description |
|---|---|---|
overall | string | bullish, bearish, neutral |
score | number | Sentiment score (-1 to 1) |
keyPoints | array | Key takeaways from news |
sources | array | News articles with URLs and sentiment |
Resolution Criteria Object
| Field | Type | Description |
|---|---|---|
description | string | How the market resolves |
criteria | array | Individual resolution requirements |
currentStatus | string | Current progress summary |
Each criterion has:
requirement- What needs to happenstatus-MET,NOT_MET,PENDING,UNCLEARevidence- Supporting data
Trading Assessment Object
| Field | Type | Description |
|---|---|---|
doNotTrade | object | Warning if market should be avoided |
positions | array | Analysis of each position |
Each position includes:
position- Entry point (e.g., "YES @ 42¢")forArguments- Reasons to take positionagainstArguments- Reasons againstpotential-HIGH,MEDIUM,LOWconfidence- Confidence score (0-1)
Execution Object
| Field | Type | Description |
|---|---|---|
warnings | array | Execution warnings |
liquidityAssessment | string | GOOD, LOW, VERY_LOW |
slippageEstimate | string | Expected slippage |
suggestedSize | string | Recommended position size |
Context Object
| Field | Type | Description |
|---|---|---|
summary | string | Broader market context |
relatedMarkets | array | Correlated markets |
externalFactors | array | External influences |
Social Sentiment Object (Optional)
| Field | Type | Description |
|---|---|---|
platform | string | x, reddit, news |
mentions | number | Total mentions |
sentiment | number | Sentiment score (-1 to 1) |
trending | boolean | Currently trending |
topPosts | array | Top engaging posts |
Streaming Response
When stream: true, the response is delivered as Server-Sent Events (SSE):
curl -X POST "https://api.tessradar.com/api/v1/research" \
-H "Authorization: Bearer or_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{"query": "Bitcoin price prediction", "stream": true}'Events stream in chunks:
data: {"type": "meta", "content": {...}}
data: {"type": "market", "content": {...}}
data: {"type": "analysis", "content": {...}}
data: {"type": "trading", "content": {...}}
data: {"type": "done"}Error Responses
No Market Found
{
"success": true,
"data": {
"meta": {
"query": "some random query",
"marketId": "not-found",
"platform": "unknown",
"timestamp": "2024-11-15T14:30:00Z",
"creditsUsed": 3,
"dataSources": ["gemini"],
"processingTimeMs": 1200
},
"market": {
"title": "No matching market found",
"question": "No matching market found",
"platform": "unknown",
"volume": 0,
"volume24h": 0,
"endDate": "",
"status": "unknown",
"outcomes": [],
"url": ""
},
"analysis": {
"summary": "I couldn't find a specific prediction market matching your query. Try searching for a more specific topic or browse available markets.",
"confidence": 0,
"newsBasedSentiment": {
"overall": "neutral",
"score": 0,
"keyPoints": [],
"sources": []
}
}
}
}Use Cases
- Deep Market Research - Comprehensive analysis before placing trades
- News Monitoring - Track latest news affecting market outcomes
- Sentiment Analysis - Understand social and news sentiment
- Resolution Tracking - Monitor progress toward resolution criteria
- Risk Assessment - Get trading warnings and execution guidance
- Portfolio Context - Find correlated markets and external factors