POST

Explain

Get a quick market summary with key factors affecting the market. This is a faster, more cost-effective alternative to the full research endpoint.

Cost: 5 credits per request

Request

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

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

Headers

Header	Value	Required
`Authorization`	`Bearer or_live_...`	Yes
`Content-Type`	`application/json`	Yes (for POST)

Query Parameters (GET)

Parameter	Type	Description	Required
`query`	string	Market URL or keyword	Yes

Body Parameters (POST)

Parameter	Type	Description	Required
`query`	string	Market URL or keyword	Yes

Supported Query Formats

Kalshi URL: https://kalshi.com/markets/kxbtc/bitcoin-price
Polymarket URL: https://polymarket.com/event/bitcoin-2026
Keywords: bitcoin, trump, election

The API searches our database for matching markets and returns the best match.

Example Request

curl "https://api.tessradar.com/api/v1/explain?query=trump" \
  -H "Authorization: Bearer or_live_your_api_key"

Example Response

{
  "success": true,
  "data": {
    "meta": {
      "query": "trump",
      "marketId": "https://polymarket.com",
      "platform": "polymarket",
      "timestamp": "2026-01-08T00:00:09.773Z",
      "creditsUsed": 1
    },
    "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,
      "createdAt": "2026-01-07T22:34:47.357Z",
      "endDate": "",
      "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/..."
    },
    "summary": "Will Trump nominate himself as the next Fed chair? is currently trading at 0.05% YES on Polymarket. Volume: $20,688,463.",
    "keyFactors": [
      "Kevin vs. Kevin: Warsh overtakes Hassett as favorite to be Fed chair nominee",
      "Divisions at the Fed that defined 2025 are expected to carry into 2026"
    ],
    "sources": [
      { "type": "market-db" },
      { "type": "newsapi" }
    ]
  },
  "creditsUsed": 5,
  "processingTimeMs": 1323
}

Response Fields

Top Level

Field	Type	Description
`success`	boolean	Whether the request succeeded
`data`	object	Response data
`creditsUsed`	number	Total credits charged (always 5)
`processingTimeMs`	number	Processing time in milliseconds

data.meta

Field	Type	Description
`query`	string	Original query provided
`marketId`	string	Market URL or identifier
`platform`	string	Market platform (kalshi, polymarket)
`timestamp`	string	ISO 8601 timestamp
`creditsUsed`	number	Credits used for data fetch

data.market

Field	Type	Description
`title`	string	Market title
`question`	string	Market question
`platform`	string	Platform name
`volume`	number	Total trading volume
`volume24h`	number	24-hour trading volume
`liquidity`	number	Current liquidity
`endDate`	string	Market end date (ISO 8601)
`status`	string	Market status (open, closed)
`outcomes`	array	Outcomes with id, name, and price
`url`	string	Market URL
`image`	string	Market image URL

data.summary

A brief text summary of the market, including current price and volume.

data.keyFactors

An array of strings representing key factors affecting the market, extracted from recent news.

data.sources

Array of data sources used:

market-db - Market data from TESS Radar database
newsapi - News articles for key factors

Data Sources

Source	Description
`market-db`	Market data from our aggregated database (Polymarket, Kalshi)
`newsapi`	Real-time news articles for context

The Explain endpoint doesn't include social sentiment or AI analysis. For comprehensive analysis, use the Research endpoint.

Performance

Average Response Time: 1-3 seconds
Credit Cost: 5 credits per request
Data Sources: 2 (market-db, newsapi)

Code Examples

JavaScript/TypeScript

const response = await fetch(
  'https://api.tessradar.com/api/v1/explain?query=bitcoin',
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
    },
  }
);

const data = await response.json();

console.log('Summary:', data.data.summary);
console.log('Key Factors:', data.data.keyFactors);
console.log('Price:', data.data.market.outcomes[0].price);

Python

import requests

response = requests.get(
    'https://api.tessradar.com/api/v1/explain',
    params={'query': 'bitcoin'},
    headers={'Authorization': f'Bearer {API_KEY}'}
)

data = response.json()

print(f"Summary: {data['data']['summary']}")
print(f"Key Factors: {data['data']['keyFactors']}")
print(f"Volume: ${data['data']['market']['volume']:,}")

cURL

curl "https://api.tessradar.com/api/v1/explain?query=bitcoin" \
  -H "Authorization: Bearer or_live_your_api_key"

When to Use Explain vs Research

Use Explain When	Use Research When
Quick overview needed	Comprehensive analysis needed
1-3 second response time is important	5-15 seconds is acceptable
News headlines are sufficient	You need social sentiment analysis
Budget is a concern (5 credits)	You need trading recommendations (10 credits)

The Explain endpoint does not include AI-powered analysis, social sentiment, or trading recommendations. Use the Research endpoint for comprehensive insights.

POST Explain