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

FieldTypeRequiredDescription
querystringYesNatural language query about a market or topic
streambooleanNoEnable 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

FieldTypeDescription
querystringOriginal search query
marketIdstringMatched market identifier
platformstringSource platform (polymarket, kalshi, unknown)
timestampstringResponse timestamp (ISO 8601)
creditsUsednumberCredits consumed
dataSourcesarrayData sources used for analysis
processingTimeMsnumberProcessing time in milliseconds

Critical Finding Object (Optional)

Appears when important market events are detected.

FieldTypeDescription
typestringRESOLVED, EXPIRING, HIGH_VOLATILITY, BREAKING_NEWS, WARNING
titlestringAlert title
descriptionstringDetailed alert description

Market Object

FieldTypeDescription
titlestringMarket title
questionstringFull market question
platformstringSource platform
volumenumberTotal trading volume (USD)
volume24hnumber24-hour volume (USD)
liquiditynumberAvailable liquidity (USD)
endDatestringMarket end date (ISO 8601)
statusstringopen, closed, resolved, unknown
outcomesarrayOutcome options with prices
urlstringDirect link to market

Analysis Object

FieldTypeDescription
summarystringAI-generated analysis summary
confidencenumberOverall confidence score (0-1)
newsBasedSentimentobjectNews sentiment analysis

News Based Sentiment

FieldTypeDescription
overallstringbullish, bearish, neutral
scorenumberSentiment score (-1 to 1)
keyPointsarrayKey takeaways from news
sourcesarrayNews articles with URLs and sentiment

Resolution Criteria Object

FieldTypeDescription
descriptionstringHow the market resolves
criteriaarrayIndividual resolution requirements
currentStatusstringCurrent progress summary

Each criterion has:

  • requirement - What needs to happen
  • status - MET, NOT_MET, PENDING, UNCLEAR
  • evidence - Supporting data

Trading Assessment Object

FieldTypeDescription
doNotTradeobjectWarning if market should be avoided
positionsarrayAnalysis of each position

Each position includes:

  • position - Entry point (e.g., "YES @ 42¢")
  • forArguments - Reasons to take position
  • againstArguments - Reasons against
  • potential - HIGH, MEDIUM, LOW
  • confidence - Confidence score (0-1)

Execution Object

FieldTypeDescription
warningsarrayExecution warnings
liquidityAssessmentstringGOOD, LOW, VERY_LOW
slippageEstimatestringExpected slippage
suggestedSizestringRecommended position size

Context Object

FieldTypeDescription
summarystringBroader market context
relatedMarketsarrayCorrelated markets
externalFactorsarrayExternal influences

Social Sentiment Object (Optional)

FieldTypeDescription
platformstringx, reddit, news
mentionsnumberTotal mentions
sentimentnumberSentiment score (-1 to 1)
trendingbooleanCurrently trending
topPostsarrayTop 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

On this page