🔗 REST APIOrderbooks

Returns historical orderbook limit orders for a market from flat files.

Retrieves historical limit order data from flat files stored in external storage (S3). Returns raw limit order updates (adds, updates, deletes) rather than reconstructed snapshots. Supports hourly granularity with automatic fallback to daily files. Use either 'date' for full day or 'time_start'/'time_end' for specific time ranges. The limit parameter applies in both cases (default 100, max 10000), including when date selects a full day.

Important: Results are filtered by data processing time (time_coinapi) - the time when CoinAPI received and processed the data from the exchange. Each order also includes time_exchange showing when the order was created/updated on the exchange. Due to API polling delays, time_exchange may be earlier than time_coinapi.

GET
/v1/orderbook/{exchange_id}/{market_id}/history

Authorization

headerAuthorization<token>

API Key is required to access the endpoints

Path Parameters

exchange_id*string
market_id*string

Query Parameters

date?string

Full day in ISO 8601 or YYYY-MM-DD (mutually exclusive with time_start/time_end)

time_start?string

Range start in ISO 8601 (required if date is omitted)

time_end?string

Range end in ISO 8601 (optional)

limit?integer

Maximum number of limit order updates to return (1-10000, default 100). Applies even when date selects a full day.

Formatint32
Default100

Response Body

Historical limit order updates in ascending time order

  1. response
[index: integer]?unknown
curl -X GET 'https://api.prediction-markets.finfeedapi.com/v1/orderbook/string/string/history'
[  null]