API reference · Liquidations & positions

Position change history

Past perp position changes of one coin over a size, one row per account and block.

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

Parameters

Param	In	Example or values	Meaning
`coin`	query	`BTC`	Perp coin
`minNotional`	query	`1000000`	Smallest notional (USD, decimal string)
`from`	query	(optional)	Window start (ms)
`to`	query	(optional)	Window end (ms, exclusive)
`sort`	query	`(empty)`, `time`, `notional`	Newest first, or largest first
`limit`	query	`50`	Rows

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

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

Field	Type	Meaning
`changes[]`	object	Sorted as asked: {block, time, coin, user, kind, dir, start_position, end_position, sz, px, notional, liquidation, …}
`changes[].kind`	open \| increase \| reduce \| close \| flip \| unchanged	What the block did to the position (unchanged: traded both ways, e.g. opened and closed)
`from`	ms	Start of the window read
`to`	ms	End of the window read (exclusive)
`billing`	medium	medium

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