API reference · Liquidations & positions

Liquidations stream

Each liquidation fill, the block it happens.

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

Parameters

Param	In	Example or values	Meaning
`coin`	filter	(optional)	HyperCore market (BTC, @107, xyz:TSLA)
`user`	filter	(optional)	Liquidated account: 0x address or a named wallet's handle
`min_notional`	filter	(optional)	Minimum notional, USD

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

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

Field	Type	Meaning
`snapshot: true`	HcLiquidation[]	last 50 liquidation fills
`data`	HcLiquidation	each liquidation fill, the block it happens: {coin, liquidated_user, liquidated_side, method, px, sz, notional, mark_px, time, block, tid, entity}

Liquidations GET /v1/liquidations HyperCore
Perp liquidations, newest first, one row per account, coin and block.
Liquidation stats GET /v1/liquidations/stats HyperCore
Totals, per coin, per time bucket and the largest, over a window.
Positions GET /v1/positions HyperCore
Open positions of one perp with leverage and liquidation price.
Position changes WS hc.positions HyperCore
Each perp position change, one per block, account and coin.
Open interest GET /v1/positions/overview HyperCore
Open interest, accounts and unrealized PnL per perp.
Liquidation map GET /v1/positions/liqmap HyperCore
Notional that would be liquidated at each price around the mark.