Get liquidation levels and ADL queue
get_liquidation_mapWhere liquidations sit for one perp (api:read; coin: BTC, or a HIP-3 market such as xyz:NATGAS) — the call for "liquidation map for BTC". view=levels (default): every open position's liquidation price, binned by percent distance from mark (input bucket_pct 0.05-5, out to max_distance_pct 1-100). The answer carries coin, markPx, asOf (ms), bucketPct, stale, and levels[] with price, side (long | short), notionalUsd, notionalByTier (by leverage tier), positionCount, size and distancePct. view=adl: the auto-deleverage queue — queueSide (which side is deleveraged first; input queue_side, default short), markPx, totalNotional, liquidityAdjustment, queue[] of {percentile, cumulativeNotional}, and market.long / market.short totals (side, markPx, totalSameSide, totalNotional, queue); per-trader rows are omitted. Source: Hydromancer position snapshots.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"coin": "<coin>"
},
"name": "get_liquidation_map"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | ||
| view | No | ||
| bucket_pct | No | levels only | |
| queue_side | No | adl only | |
| max_distance_pct | No | levels only |