Liquidation levels and trigger levels: projected forced-liquidation maps with history, on Hyperliquid and HIP-3
Current docs: Liquidation levels.
Current docs: TP/SL triggers.
The liquidation-levels endpoints now serve projected forced-liquidation levels computed from clearinghouse positions and margin state. The pending stop-loss and take-profit map moved to its own trigger-levels endpoints. Both families are historical with cursor pagination, and both are available on Hyperliquid perps and HIP-3.
- GET /v1/hyperliquid/liquidations/{symbol}/levels (and the HIP-3 equivalent) returns where open positions are projected to liquidate: price buckets of long and short notional with position counts, computed from positions and margin state and refreshed about every 5 minutes. Accuracy is validated against liquidation prices reported by the exchange.
- GET /v1/hyperliquid/orders/{symbol}/trigger-levels (and the HIP-3 equivalent) carries the pending stop-loss and take-profit trigger-order map that previously lived on the liquidations path, with an as_of freshness timestamp and side totals.
- Both families gained /history endpoints: cursor pagination via meta.next_cursor, summary=true for cheap snapshot discovery, and at= (epoch ms) point-in-time reads on the current endpoints. Snapshots are retained from July 27, 2026: trigger levels every 15 minutes, liquidation levels about every 5 minutes.
- Breaking note: before this release the HIP-3 /liquidations/{symbol}/levels path served the trigger-order map. Clients reading trigger buckets from that path should move to /orders/{symbol}/trigger-levels.
- SDKs 1.8.0 (TypeScript, Python, Rust) add typed methods for all four families, plus fixes: WebSocket l4_snapshot and l4_batch frames are now surfaced in Rust and Python (previously dropped), Rust candles and liquidations-by-user calls are repaired, spot pair and TWAP types now match the wire, and TypeScript L2 full-depth pagination cursors work again.
- Hosted MCP 1.1.0: 13 new tools (levels and trigger levels on both venues, HIP-4 questions, Lighter liquidations), corrected order-status enums, and removal of unsupported filters.
- OpenAPI 1.6.0 documents all eight levels operations with exact response schemas.
