Get order book history (Deprecated)

{ "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" } }

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Path Parameters

symbol

string

required

Trading pair symbol (e.g., BTC, ETH, SOL)

Example:

"BTC"

Query Parameters

start

integer<int64>

Start timestamp in Unix milliseconds. Defaults to 24h ago.

end

integer<int64>

End timestamp in Unix milliseconds. Defaults to now.

cursor

integer<int64>

Cursor for pagination (timestamp from previous response's next_cursor). If not provided, starts from the beginning of the range.

limit

integer

default:100

Maximum number of results (default: 100, max: 1000)

Required range: x <= 1000

depth

integer

Requested price levels per side for this deprecated Hyperliquid compatibility route. Native Hyperliquid L2 data is capped at 20 levels per side; values above 20 do not return full depth here. Use /v1/hyperliquid/orderbook/{symbol}/l2 for full-depth aggregated L2.

Required range: x <= 20

Response

List of order book snapshots

success

boolean

Example:

true

data

object[]

Hide child attributes

data.symbol

string

required

Trading pair symbol

Example:

"BTC"

data.coin

string

required

deprecated

Trading pair symbol (deprecated, use symbol instead)

Example:

"BTC"

data.timestamp

string<date-time>

required

Snapshot timestamp (UTC)

Example:

"2025-01-21T10:30:45.123Z"

data.bids

object[]

required

Bid price levels (best bid first)

Hide child attributes

data.bids.px

string

required

Price

Example:

"42150.00"

data.bids.sz

string

required

Total size at this price level

Example:

"1.5"

data.bids.n

integer

required

Number of orders at this level

Example:

15

data.asks

object[]

required

Ask price levels (best ask first)

Hide child attributes

data.asks.px

string

required

Price

Example:

"42150.00"

data.asks.sz

string

required

Total size at this price level

Example:

"1.5"

data.asks.n

integer

required

Number of orders at this level

Example:

15

data.mid_price

string

Mid price (best bid + best ask) / 2

Example:

"42150.50"

data.spread

string

Spread in absolute terms (best ask - best bid)

Example:

"1.00"

data.spread_bps

string

Spread in basis points

Example:

"2.37"