curl --request GET \
--url https://api.0xarchive.io/v1/orderbook/{symbol}/history \
--header 'X-API-Key: <api-key>'{
"success": true,
"data": [
{
"symbol": "BTC",
"coin": "BTC",
"timestamp": "2025-01-21T10:30:45.123Z",
"bids": [
{
"px": "42150.00",
"sz": "1.5",
"n": 15
}
],
"asks": [
{
"px": "42150.00",
"sz": "1.5",
"n": 15
}
],
"mid_price": "42150.50",
"spread": "1.00",
"spread_bps": "2.37"
}
],
"meta": {
"count": 123,
"next_cursor": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Deprecated: Use /v1/hyperliquid/orderbook/{symbol}/history or /v1/lighter/orderbook/{symbol}/history instead.
Get historical order book snapshots within a time range. Snapshot spacing varies by market activity and query window.
curl --request GET \
--url https://api.0xarchive.io/v1/orderbook/{symbol}/history \
--header 'X-API-Key: <api-key>'{
"success": true,
"data": [
{
"symbol": "BTC",
"coin": "BTC",
"timestamp": "2025-01-21T10:30:45.123Z",
"bids": [
{
"px": "42150.00",
"sz": "1.5",
"n": 15
}
],
"asks": [
{
"px": "42150.00",
"sz": "1.5",
"n": 15
}
],
"mid_price": "42150.50",
"spread": "1.00",
"spread_bps": "2.37"
}
],
"meta": {
"count": 123,
"next_cursor": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Documentation Index
Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
Use this file to discover all available pages before exploring further.
API key for authentication. Get yours at https://www.0xarchive.io/dashboard/
Trading pair symbol (e.g., BTC, ETH, SOL)
"BTC"
Start timestamp in Unix milliseconds. Defaults to 24h ago.
End timestamp in Unix milliseconds. Defaults to now.
Cursor for pagination (timestamp from previous response's next_cursor). If not provided, starts from the beginning of the range.
Maximum number of results (default: 100, max: 1000)
x <= 1000Number of price levels per side. Tier limits: Free=20, Build=200, Pro=Full Depth, Enterprise=Full Depth
List of order book snapshots
true
Hide child attributes
Trading pair symbol
"BTC"
Trading pair symbol (deprecated, use symbol instead)
"BTC"
Snapshot timestamp (UTC)
"2025-01-21T10:30:45.123Z"
Mid price (best bid + best ask) / 2
"42150.50"
Spread in absolute terms (best ask - best bid)
"1.00"
Spread in basis points
"2.37"
Was this page helpful?