femtos

HyperCore · Liquidations & positions

Liquidations stream

Each liquidation fill, the block it happens.

WebSocket channel hc.liquidations on wss://api.femtos.xyz/v1/ws

Parameters

ParamInExample or values
coinfilter(optional)
min_notionalfilter(optional)

Subscribe

{"op":"subscribe","channel":"hc.liquidations","filter":{}}

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

Response fields

FieldTypeMeaning
snapshot: trueobject[]last 50 liquidation fills
dataobject{coin, liquidated_user, liquidated_side, method, px, sz, notional, mark_px, time, block}

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.
  • 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.
  • Liquidation map GET /v1/positions/liqmap
    Notional that would be liquidated at each price around the mark.
  • Position changes WS hc.positions
    Each perp position change, one per block, account and coin.

More