API reference · Liquidations & positions

Liquidation map

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

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

Parameters

Param	In	Example or values	Meaning
`coin`	query	`BTC`	Perp coin
`range`	query	`0.3`	Half-width around the mark (0.3 = ±30 %)
`buckets`	query	`60`	Price buckets

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. Get a free key, or with no browser through agent onboarding.

Field	Type	Meaning
`buckets[]`	object	Ascending price; empty with `unavailable`: {px, longNotional, shortNotional, accounts}
`markPx`	decimal \| null	Centre
`range`	number	Half-width (absent with `unavailable`)

Liquidations GET /v1/liquidations HyperCore
Perp liquidations, newest first, one row per account, coin and block.
Liquidations stream WS hc.liquidations HyperCore
Each liquidation fill, the block it happens.
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.