API reference · Liquidations & positions

Liquidation stats

Totals, per coin, per time bucket and the largest, over a window.

GET https://api.femtos.xyz/v1/liquidations/stats

Parameters

Param	In	Example or values	Meaning
`window`	query	`1h`, `24h`, `7d`, `30d`	Window
`coin`	query	(optional)	One coin

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/liquidations/stats?window=24h"

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

Field	Type	Meaning
`total`	object	Over the window: {notional, count, accounts, longNotional, shortNotional, market, backstop}
`byCoin[]`	object	Largest first (30): {coin, notional, count, longNotional, shortNotional}
`buckets[]`	object	bucketMs apart: {t, longNotional, shortNotional, count}
`largest[]`	object	10 largest (same shape as /api/liquidations): {block, time, coin, user, side, method, trades, sz, notional, avgPx, markPx, entity}
`topAccounts[]`	object	20 most liquidated accounts: {user, notional, count}

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