HyperCore · Liquidations & positions

Positions

Open positions of one perp with leverage and liquidation price.

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

Parameters

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/positions?coin=BTC&sort=notional&limit=50"

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

Field	Type	Meaning
`positions[]`	object	{address, szi, side, entryPx, notional, upnl, leverage, marginMode, liqPx, liqDistancePct}
`markPx · asOf · height`	decimal · int	mark used, snapshot time and block
`sort · order`	string	applied sort

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.
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.