Markets represent individual questions within an event. Each market has one or more outcomes (e.g., “Yes” / “No”), and each outcome has an associated token ID used in orderbook queries.
List Markets
List all markets, ordered by 24-hour volume (descending, nulls last).
Query Parameters
Results per page (1–500).
Minimum 24-hour volume filter. Only markets with volume_24h >= min24hVolume are returned.
Offset for pagination. When provided, cursor parameters are ignored.
Volume cursor for pagination (from next object).
Market ID cursor for pagination (from next object).
Example
Get top markets by volume:
curl "http://api.poly-data.xyz/markets?limit=5"
curl "http://api.poly-data.xyz/markets?min24hVolume=10000&limit=5"
{
"limit": 5,
"min24hVolume": 10000,
"data": [
{
"id": 1034460,
"event_id": 126261,
"question": "Will Eintracht Frankfurt win on 2026-01-09?",
"slug": "bun-ein-dor-2026-01-09-ein",
"description": "...",
"created_at": "2025-12-27T05:00:04.093Z",
"start_date": "2025-12-27T05:13:00.407Z",
"end_date": "2026-01-09T19:30:00.000Z",
"deploying_timestamp": "2025-12-27T05:00:55.483Z",
"active": true,
"closed": false,
"archived": false,
"ready": false,
"funded": false,
"accepting_orders": true,
"neg_risk": true,
"volume_24h": "225160.59",
"volume_total": "231175.94",
"liquidity": "438058.03",
"order_min_size": "5",
"order_price_min_tick_size": "0.001"
}
],
"next": {
"cursor_volume": 225160.59,
"cursor_id": 1034460
}
}
cursor_volume can be null for markets without 24-hour volume data.
Get Market
Get a single market by its numeric ID, including embedded outcomes with token IDs.
Path Parameters
Market ID (numeric only).
Example
curl "http://api.poly-data.xyz/markets/1034460"
{
"id": "1034460",
"event_id": "126261",
"question": "Will Eintracht Frankfurt win on 2026-01-09?",
"slug": "bun-ein-dor-2026-01-09-ein",
"description": "In the upcoming game, scheduled for January 9, 2026\nIf Eintracht Frankfurt wins, this market will resolve to \"Yes\".\nOtherwise, this market will resolve to \"No\".",
"created_at": "2025-12-27T05:00:04.093Z",
"start_date": "2025-12-27T05:13:00.407Z",
"end_date": "2026-01-09T19:30:00.000Z",
"deploying_timestamp": "2025-12-27T05:00:55.483Z",
"active": true,
"closed": false,
"archived": false,
"ready": false,
"funded": false,
"accepting_orders": true,
"neg_risk": true,
"volume_24h": "225160.59007300003",
"volume_total": "231175.940446",
"liquidity": "438058.02695",
"order_min_size": "5",
"order_price_min_tick_size": "0.001",
"outcomes": [
{
"id": 12771,
"outcome_index": 0,
"outcome": "Yes",
"token_id": "113230976933674601135419276232321769865636781054804255103253100668166812267778"
},
{
"id": 12772,
"outcome_index": 1,
"outcome": "No",
"token_id": "114877335229422177970817804142795745566078153600519625559547182926779275233294"
}
]
}
Market Response Fields
| Field | Type | Description |
|---|
id | string | Market ID |
event_id | string | Parent event ID |
question | string | The market question |
slug | string | URL-safe slug |
description | string | Detailed market description |
created_at | string | ISO 8601 creation timestamp |
start_date | string | ISO 8601 start timestamp |
end_date | string | ISO 8601 end timestamp |
deploying_timestamp | string | ISO 8601 deployment timestamp |
active | boolean | Whether the market is active |
closed | boolean | Whether the market is closed |
archived | boolean | Whether the market is archived |
ready | boolean | Whether the market is ready |
funded | boolean | Whether the market is funded |
accepting_orders | boolean | Whether orders are currently accepted |
neg_risk | boolean | Negative risk flag |
volume_24h | string | Trading volume in the last 24 hours |
volume_total | string | All-time trading volume |
liquidity | string | Current liquidity |
order_min_size | string | Minimum order size |
order_price_min_tick_size | string | Minimum price tick size |
outcomes | array | List of outcomes (only on single-market endpoint) |
Outcome Object
| Field | Type | Description |
|---|
id | integer | Outcome ID |
outcome_index | integer | Position index (0 = Yes, 1 = No) |
outcome | string | Outcome name (e.g., “Yes”, “No”) |
token_id | string | Token ID used in orderbook queries as asset_id |
The token_id is what you’ll use as the asset_id parameter when querying orderbooks for a specific outcome.
