femtos

HyperCore · Liquidations & positions

Liquidation map

Notional that would be liquidated at each price around the mark.

GET https://api.femtos.xyz/v1/positions/liqmap

Parameters

ParamInExample or values
coinqueryBTC
rangequery0.3
bucketsquery60

Example

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/positions/liqmap?coin=BTC&range=0.3&buckets=60"

Key: Authorization: Bearer $FEMTOS_KEY or X-API-KEY. Get a free key, or with no browser through agent onboarding.

Response fields

FieldTypeMeaning
buckets[]object{px, longNotional, shortNotional, accounts}, px = bucket centre
markPx · rangedecimal · numbercentre and half-width (0.3 = ±30 %)

Related: Liquidations & positions

  • Liquidations GET /v1/liquidations
    Perp liquidations, newest first, one row per account, coin and block.
  • Liquidation stats GET /v1/liquidations/stats
    Totals, per coin, per time bucket and the largest, over a window.
  • Liquidations stream WS hc.liquidations
    Each liquidation fill, the block it happens.
  • Positions GET /v1/positions
    Open positions of one perp with leverage and liquidation price.
  • Open interest GET /v1/positions/overview
    Open interest, accounts and unrealized PnL per perp.
  • Position changes WS hc.positions
    Each perp position change, one per block, account and coin.

More