Liquidation model (Strata)
Modelled liquidation levels and heatmaps, net positions, the model's calibration, and recorded liquidations - what the model is and is not.
Strata estimates where leveraged positions would be liquidated, from the open interest and prices ChartDeck records on each exchange. It is the same model as the terminal's Strata panels.
- Levels (
/v1/strata/levels): price bands with the modelled size that would be liquidated there, for long and short positions, now or as of a past time (at). - Heatmap (
/v1/strata/heatmap): the modelled field over time. Grids travel compactly as base64 bytes (format=sqrt8: a byte q stands for aboutmax_usd * (q / 255)^2), or decoded (format=usd). - Net positions (
/v1/strata/netpos): positions inferred from changes in open interest. - Calibration (
/v1/strata/calibration): the model scored against liquidations that actually happened over 30 days. Read it before relying on the model. - Recorded liquidations (
/v1/strata/realized,/v1/strata/liq-exact): what actually happened, from the exchanges' liquidation feeds;liq-exactlists single orders with exact time, price and size. - Hyperliquid (
/v1/strata/hl): liquidation prices observed on Hyperliquid's public positions, aggregated (never an address).
side always names the position side: long positions are liquidated below the price, short positions above. Prices are *_usd, sizes size_usd or size_coin.
What the model is not. It is a reading aid, not a forecast: it does not know every position, exchanges report open interest differently, and the calibration page shows how often it was right. Answers with modelled values carry an attribution line saying so: keep it with the data.
The model window is 7d on every tier; 30d from Developer.
#Operations
| Operation | Summary |
|---|---|
GET /v1/strata/calibration | The model scored against recorded liquidations (30 days) |
GET /v1/strata/heatmap | The modelled liquidation field over time |
GET /v1/strata/hl | Observed Hyperliquid liquidation prices (aggregated, never an address) |
GET /v1/strata/levels | Modelled liquidation levels now (or as of `at`) |
GET /v1/strata/liq-exact | Single recorded liquidation orders with exact time, price and size (at most 6 hours a call) |
GET /v1/strata/netpos | Net positions inferred from open interest |
GET /v1/strata/realized | Actual liquidations: hourly totals and price clusters |
GET /v1/strata/symbols | The coins with a liquidation model, busiest first, and their venues |