GET Markets
Query prediction markets from Polymarket and Kalshi
GET
Markets
Retrieve a paginated list of markets with filtering and sorting options.
GET /api/v1/marketsQuery Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 50 | Results per page (max 200) |
offset | number | 0 | Pagination offset |
exchange | string | - | Filter by exchange: POLYMARKET or KALSHI |
status | string | - | Filter by status: OPEN, RESOLVED, CLOSED |
category | string | - | Filter by category: Politics, Sports, Crypto, etc. |
search | string | - | Search in market question text |
sortBy | string | volume24h | Sort field: volume, volume24h, liquidity, createdAt |
sortOrder | string | desc | Sort direction: asc or desc |
Example Request
curl -H "Authorization: Bearer or_live_xxx" \
"https://api.tessradar.com/api/v1/markets?limit=2&exchange=POLYMARKET"Example Response
{
"data": [
{
"id": "e4ec57b5-94d1-4159-87c0-5bb6827928f7",
"exchangeId": "POLYMARKET",
"externalMarketId": "0xc111415f3e8d30...",
"slug": "new-stranger-things-episode-released-by-wednesday",
"question": "New \"Stranger Things\" episode released by Wednesday?",
"description": "This market will resolve to \"Yes\" if Netflix officially releases...",
"category": null,
"imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/...",
"status": "OPEN",
"resolveTime": "2026-01-07T00:00:00.000Z",
"liquidity": 926805.72,
"volume": 10394552.81,
"volume24h": 5524432.41,
"outcomes": [
{
"name": "Yes",
"price": 0.0115,
"bestBidPrice": 0.01,
"bestAskPrice": 0.013
},
{
"name": "No",
"price": 0.9885,
"bestBidPrice": 0.9885,
"bestAskPrice": null
}
],
"exchange": {
"id": "POLYMARKET",
"displayName": "Polymarket"
}
}
],
"pagination": {
"total": 24664,
"limit": 2,
"offset": 0,
"hasMore": true
}
}Credits: 1 credit per request
Get Market by ID
Retrieve a single market by its internal ID.
GET /api/v1/markets/{id}Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Internal market UUID |
Example Request
curl -H "Authorization: Bearer or_live_xxx" \
"https://api.tessradar.com/api/v1/markets/e4ec57b5-94d1-4159-87c0-5bb6827928f7"Credits: 1 credit per request
Get Market Snapshots
Retrieve price history snapshots for a market.
GET /api/v1/markets/{id}/snapshotsQuery Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 100 | Number of snapshots to return |
startDate | string | - | Filter from date (ISO 8601) |
endDate | string | - | Filter to date (ISO 8601) |
Example Response
{
"data": [
{
"timestamp": "2026-01-07T23:00:00.000Z",
"bestYesPrice": 0.65,
"bestNoPrice": 0.35,
"volume24h": 125000,
"liquidity": 50000
}
]
}Credits: 1 credit per request