Quick Start

Get started with the TESS Radar API in under 5 minutes

1. Get Your API Key

  1. Sign up at console.tessradar.online
  2. Go to Dashboard → API Keys
  3. Click Create New Key and copy it

Your API key is shown only once. Store it securely!

Want to test without writing code? Try the API Playground to explore all endpoints interactively.

2. Your First Request

Quick market summary (5 credits, ~2 seconds):

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

Response:

{
  "success": true,
  "data": {
    "market": {
      "title": "Will Trump nominate himself as Fed chair?",
      "volume": 20688463,
      "outcomes": [
        { "name": "Yes", "price": 0.0005 },
        { "name": "No", "price": 0.9995 }
      ]
    },
    "summary": "Trading at 0.05% YES on Polymarket...",
    "keyFactors": ["Warsh overtakes Hassett as favorite"]
  },
  "creditsUsed": 5
}

3. Deep Analysis

For AI analysis with social sentiment (10 credits, ~10 seconds):

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

Research includes:

  • AI-powered summary
  • News sentiment analysis
  • Twitter/X social trends
  • Trading recommendations

4. Browse Markets

List all markets with filtering:

curl "https://api.tessradar.com/api/v1/markets?limit=10&exchange=POLYMARKET" \
  -H "Authorization: Bearer or_live_your_key"

5. Use in Your App

JavaScript

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(data.summary);

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()['data']
print(data['summary'])

Credit Costs

EndpointCostSpeed
Markets, Exchanges, Stats1 credit<1s
Explain5 credits1-3s
Research10 credits5-15s

Next Steps

On this page