POST https://api.tessradar.com/api/v1/research

GET https://api.tessradar.com/api/v1/research?query={market_url_or_keyword}

curl -X POST https://api.tessradar.com/api/v1/research \
  -H "Authorization: Bearer or_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "trump"
  }'

{
  "success": true,
  "data": {
    "meta": {
      "query": "trump",
      "marketId": "https://polymarket.com",
      "platform": "polymarket",
      "timestamp": "2026-01-08T00:00:09.773Z",
      "creditsUsed": 5,
      "dataSources": ["market-db", "newsapi", "x", "gemini"],
      "processingTimeMs": 5000
    },
    "market": {
      "title": "Will Trump nominate himself as the next Fed chair?",
      "question": "Will Trump nominate himself as the next Fed chair?",
      "platform": "polymarket",
      "provider": "Polymarket",
      "volume": 20688463.92,
      "volume24h": 3618317.31,
      "liquidity": 130540.44,
      "endDate": "2026-12-31T00:00:00.000Z",
      "status": "open",
      "outcomes": [
        { "id": "yes", "name": "Yes", "price": 0.0005 },
        { "id": "no", "name": "No", "price": 0.9995 }
      ],
      "url": "https://polymarket.com",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/..."
    },
    "analysis": {
      "summary": "Will Trump nominate himself as the next Fed chair? is trading at 0.05% on Polymarket with $20,688,463 total volume. The market consensus is strongly against this outcome.",
      "confidence": 0.85,
      "newsBasedSentiment": {
        "overall": "neutral",
        "score": 0.1,
        "keyPoints": [
          "Kevin Warsh overtakes Hassett as favorite for Fed chair nominee",
          "Divisions at the Fed expected to carry into 2026"
        ],
        "sources": [
          {
            "title": "Kevin vs. Kevin: Warsh overtakes Hassett as favorite",
            "url": "https://example.com/article",
            "date": "2026-01-07T20:00:00Z",
            "source": "Financial Times"
          }
        ]
      }
    },
    "resolutionCriteria": {
      "description": "Market resolves YES if Trump formally nominates himself as Fed chair",
      "criteria": [
        { "requirement": "Formal nomination submitted to Senate", "status": "PENDING" }
      ],
      "currentStatus": "Open until December 2026"
    },
    "tradingAssessment": {
      "doNotTrade": {
        "active": false,
        "reasons": []
      },
      "positions": [
        {
          "position": "NO @ 99.95¢",
          "forArguments": "Extremely unlikely outcome",
          "againstArguments": "Minimal upside at current price",
          "potential": "LOW",
          "confidence": 0.9
        }
      ]
    },
    "execution": {
      "warnings": [],
      "liquidityAssessment": "GOOD",
      "slippageEstimate": "<1%",
      "suggestedSize": "$500-1000"
    },
    "context": {
      "summary": "Trump has nominated Kevin Warsh and Kevin Hassett as leading candidates...",
      "externalFactors": ["Fed policy decisions", "Economic indicators"]
    },
    "socialSentiment": {
      "platform": "x",
      "mentions": 25,
      "sentiment": 0.15,
      "trending": false,
      "topPosts": [
        {
          "text": "Market analysis on Trump Fed chair nomination...",
          "engagement": 5000,
          "author": "FinanceExpert",
          "url": "https://twitter.com/..."
        }
      ]
    },
    "sources": [
      { "type": "market-db" },
      { "type": "newsapi" },
      { "type": "x" },
      { "type": "gemini" }
    ]
  },
  "creditsUsed": 10,
  "processingTimeMs": 5000
}