API Reference

Base URL

All API requests should be made to:

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

Include your API key in the Authorization header:

Authorization: Bearer or_live_xxxxxxxxxxxxxxxxxxxxxxxxxx

Get your API key from the Dashboard.

Keep your API key secure! Never expose it in client-side code or public repositories.

Plan	Rate Limit
Starter	10 requests/second
Pro	50 requests/second

Endpoint	Method	Cost	Description
`/api/v1/markets`	GET	1 credit	List markets with filtering and pagination
`/api/v1/markets/{id}`	GET	1 credit	Get single market by ID
`/api/v1/markets/{id}/snapshots`	GET	1 credit	Get price history snapshots
`/api/v1/exchanges`	GET	1 credit	List supported exchanges
`/api/v1/stats`	GET	1 credit	Get platform statistics

Endpoint	Method	Cost	Speed	Description
`/api/v1/explain`	GET/POST	5 credits	1-3s	Quick market summary
`/api/v1/research`	GET/POST	10 credits	5-15s	Comprehensive AI analysis

Endpoint	Method	Cost	Description
`/api/v1/credits`	GET	Free	Check credit balance

Source	Description	Used In
`market-db`	Market data from Polymarket & Kalshi	All endpoints
`newsapi`	Real-time news articles	Explain, Research
`x`	Twitter/X social sentiment	Research only
`gemini`	AI-powered analysis	Research only

{
  "success": true,
  "data": { ... },
  "creditsUsed": 1,
  "processingTimeMs": 150
}

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid or expired."
  }
}

All responses include:

Header	Description
`X-Credits-Used`	Credits consumed by this request
`X-Credits-Remaining`	Credits left in your account
`X-RateLimit-Limit`	Max requests per window
`X-RateLimit-Remaining`	Requests remaining
`X-RateLimit-Reset`	Window reset timestamp