Skip to main content
GET
Get HIP-3 liquidation levels history

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.

Example:

"xyz:TSLA"

Query Parameters

start
integer<int64>

Range start, epoch milliseconds inclusive. Default: 24 hours before end.

end
integer<int64>

Range end, epoch milliseconds inclusive. Default: now.

cursor
string

Cursor from meta.next_cursor of the previous page (a snapshot_ts in epoch milliseconds, exclusive). The page continues strictly after it.

limit
integer
default:24

Snapshots per page. Default 24, maximum 100. When a page is full, meta.next_cursor carries the cursor for the next page.

Required range: 1 <= x <= 100
summary
boolean
default:false

When true, items contain snapshot_ts, mid price and totals only (no levels array). Cheap way to discover which snapshots exist before fetching full histograms.

range_pct
number
default:10

Percentage range around the snapshot mid/mark price. Clamped between 1 and 50. Default 10.

Required range: 1 <= x <= 50
buckets
integer
default:50

Number of price buckets. Clamped between 10 and 200. Default 50.

Required range: 10 <= x <= 200
side
enum<string>

Optional side filter. bid/buy/B keeps the long (or bid) side, ask/sell/A keeps the short (or ask) side; the other side is zeroed.

Available options:
bid,
ask,
buy,
sell,
B,
A

Response

Get HIP-3 liquidation levels history

Paginated historical liquidation-levels snapshots, ascending by snapshot_ts. When a page is full, meta.next_cursor carries the cursor for the next page.

success
boolean
Example:

true

data
object[]
meta
object

Response metadata

Last modified on July 28, 2026