HyperCore · Liquidations & positions

Position changes

Each perp position change, one per block, account and coin.

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

Parameters

Param	In	Example or values
`coin`	filter	`BTC`
`min_notional`	filter	`100000`

{"op":"subscribe","channel":"hc.positions","filter":{"coin":"BTC","min_notional":"100000"}}

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

Field	Type	Meaning
`data`	object	{coin, user, kind, dir, start_position, end_position, sz, px, notional, liquidation}
`kind`	string	open, increase, reduce, close, flip
`min_notional`	filter	default 100000, "0" for all

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.
Liquidation map GET /v1/positions/liqmap
Notional that would be liquidated at each price around the mark.