Polymarket Endpoints
Polymarket Trade History API
Trade history returns executed trades for a market from the Polymarket CLOB, proxied through TPM.
Get Polymarket trade history
Trade history for a Polymarket market, proxied live from clob.polymarket.com. Requires market_slug or condition_id.
Live GET Request
Try it
Live Response
Click Try It to run this GET request against the API.Request
curl 'https://api.thepredictionmarkets.com/api/v2/polymarket/orders?market_slug=2026-nba-champion&limit=10' \
-H 'X-API-Key: YOUR_TPM_API_KEY'Response
{
"trades": [
{
"id": "0xabc...",
"taker_order_id": "0xdef...",
"market": "0x123...",
"asset_id": "0x456...",
"side": "BUY",
"size": "100",
"fee_rate_bps": "0",
"price": "0.495",
"status": "CONFIRMED",
"match_time": "2026-04-20T18:22:04Z",
"last_update": "2026-04-20T18:22:04Z",
"bucket_index": 0,
"outcome": "Oklahoma City Thunder"
}
],
"count": 1,
"market_slug": "2026-nba-champion",
"condition_id": "0x123...",
"next_cursor": null
}Query Parameters
| Name | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| market_slug | string | No | - | 2026-nba-champion | Polymarket market or event slug. Required unless condition_id is provided. |
| condition_id | string | No | - | 0xabc123 | Polymarket condition ID. Overrides market_slug when provided. |
| limit | integer | No | 50 | 10 | Number of trades to return. Maximum 500. |
| cursor | string | No | - | LTE= | Cursor from previous response for pagination. |
Response Fields
| Field | Type | Example | Description |
|---|---|---|---|
| trades | object[] | - | Array of trade records from the CLOB. |
| trades.side | BUY | SELL | - | Taker side of the trade. |
| trades.price | string | - | Execution price as a decimal string (0 to 1). |
| trades.size | string | - | Number of shares traded. |
| trades.match_time | string | - | ISO timestamp of trade execution. |
| next_cursor | string | null | - | Pass to cursor param for the next page. |
Build with TPM
Get your API key
Start with Kalshi and Polymarket market data, then add unified spreads, signals, alerts, and watchlists as your workflow grows.