Skip to main content
GET
Get HIP-3 liquidation levels

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

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
at
integer<int64>

Point-in-time read: epoch milliseconds (UTC). Serves the newest snapshot at or before this instant. Omit for the latest snapshot. History begins 2026-07-27; earlier instants return 404.

Response

Get HIP-3 liquidation levels

API response containing projected forced-liquidation levels for one snapshot.

success
boolean
Example:

true

data
object

Projected forced-liquidation levels computed from clearinghouse positions and margin state (positions plus maintenance-margin tiers), aggregated into price buckets around the snapshot mark price. Snapshots are computed roughly every 45 minutes; snapshot_ts identifies the snapshot served.

meta
object

Response metadata

Last modified on July 28, 2026