API Reference

Complete reference for the TESS Radar Prediction Markets API

Overview

TESS Radar provides a unified API for prediction market data from Polymarket and Kalshi, plus AI-powered analysis with news and social sentiment.

Base URL

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

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer or_live_xxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your API key secure. Never expose it in client-side code.

Get your API key from the Dashboard.


Endpoints at a Glance

Market Data

EndpointMethodCreditsDescription
/marketsGET1List all markets with filtering
/markets/{id}GET1Get single market details
/markets/{id}/ohlcGET1OHLC candlestick data
/markets/{id}/orderbookGET1Current orderbook depth
/markets/{id}/tradesGET1Recent trade history
/markets/{id}/market-historyGET1Historical price snapshots

Discovery

EndpointMethodCreditsDescription
/eventsGET1List prediction events
/events/{id}GET1Event with all markets
/matching-markets/{category}GET1Find cross-platform matches
/markets/{id}/resolutionGET1Resolution criteria

AI Analysis

EndpointMethodCreditsDescription
/researchPOST10Full AI analysis with news & social

Reference

EndpointMethodCreditsDescription
/exchangesGET1List supported exchanges
/statsGET1Platform statistics
/creditsGETFreeCheck credit balance

Response Format

Success

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

Error

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

Error Codes

HTTPCodeDescription
400INVALID_REQUESTMissing or invalid parameters
401UNAUTHORIZEDAPI key missing or invalid
402INSUFFICIENT_CREDITSNot enough credits
404NOT_FOUNDResource not found
429RATE_LIMITEDToo many requests
500INTERNAL_ERRORServer error

Data Sources

SourceDescription
PolymarketCrypto & event markets on Polygon
KalshiUS-regulated prediction exchange
NewsAPIReal-time news articles
X (Twitter)Social sentiment analysis
Gemini AIAI-powered market analysis

On this page