Skip to main content
GET
/
trades
Get historical trades
curl --request GET \
  --url https://api.polyrouter.io/functions/v1/trades \
  --header 'X-API-Key: <api-key>'
{
"data": {
"trades": [
{
"trade_id": "3e02c6be-3d4f-610e-eb37-24ea1a4cde0a",
"platform": "kalshi",
"market_id": "KXGOVTCUTS-25-50",
"timestamp": 1762184718,
"size": 8,
"price": 0.0013,
"side": "buy",
"yes_price": 0.13,
"no_price": 0.87,
"metadata": {
"created_time": "2025-11-03T15:45:18.499636Z",
"yes_price_dollars": "0.1300",
"no_price_dollars": "0.8700"
}
}
],
"pagination": {
"total": 100,
"limit": 100,
"has_more": true,
"next_cursor": "WzEwMCxbWzEsMSwiRWVoSUtFSUdLRjJiZUYwWFFsUFZCNVpidjQ5QWFEQWluZzZQSUJoRGduOFhaQWciXV1d"
},
"meta": {
"market_id": "KXGOVTCUTS-25-50",
"platform": "kalshi",
"request_time": 111
}
},
"meta": {
"request_time": 111
}
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

market_id
string
required

Platform-native market identifier (Polymarket numeric ID or Kalshi ticker symbol)

limit
integer
default:100

Number of trades to return (1-1000). Kalshi API maximum is 100 per request.

Required range: 1 <= x <= 1000
cursor
string

Opaque cursor for pagination (from previous response)

Response

Historical trades retrieved successfully

data
object
meta
object