API reference · Stops & take-profits

Triggered stops

Stop-loss and take-profit orders that fired, newest first, with the fill they got.

GET https://api.femtos.xyz/v1/hypercore/stops/triggered

Parameters

Param	In	Example or values	Meaning
`coin`	query	`BTC`	HyperCore coin
`since`	query	(optional)	Window start (Unix ms, default until − 1 h)
`until`	query	(optional)	Window end (Unix ms, exclusive, default now)
`limit`	query	`100`	Rows
`cursor`	query	(optional)	Next page: `next_cursor` of the previous answer

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/stops/triggered?coin=BTC&limit=100"

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

Field	Type	Meaning
`events`	object[]	Newest first: {oid, user, coin, side, kind, exec, orderType, triggerPx, triggerCondition, limitPx, sz, origSz, …}
`events.triggeredAt`	ms	When it fired (= statusTime)
`events.child`	object \| null	The order the trigger placed: its status in the trigger block (filled, open, canceled…), size, limit price: {status, sz, limitPx}
`events.fill`	object \| null	Fills of that order in the trigger block; null when none: {sz, avgPx, notional, fills}
`since`	ms	Window start read
`until`	ms	Window end
`next_cursor`	string \| null	Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page

Next page: cursor = the next_cursor of the previous answer, the same on every list (pagination).

Stop map GET /v1/hypercore/stops HyperCore
Open stop-loss and take-profit orders of one coin, bucketed by trigger price around the mark.
Stops stream WS hc.stops HyperCore
Every trigger order event: placed, triggered, canceled, and the order a trigger placed.
Wallet stops GET /v1/hypercore/wallet/{address}/stops HyperCore
One wallet's open trigger orders, or with history=1 every status event of them.