API reference · Stops & take-profits

Wallet stops

One wallet's open trigger orders, or with history=1 every status event of them.

GET https://api.femtos.xyz/v1/hypercore/wallet/{address}/stops

Parameters

Param	In	Example or values	Meaning
`address`	path	`<address>`	0x address, or a named wallet's handle <entityId>.<hex>
`history`	query	`(empty)`, `1`	1: past status events instead of the open orders (heavy call)
`limit`	query	`100`	history: events
`cursor`	query	(optional)	Next page: `next_cursor` of the previous answer

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/wallet/<address>/stops?limit=100"

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

Field	Type	Meaning
`orders[]`	object	Open trigger orders, newest placed first: {oid, user, coin, side, kind, exec, orderType, triggerPx, triggerCondition, limitPx, sz, origSz, …}
`count`	int	Orders listed
`truncated`	boolean	More than 1000 open trigger orders: the newest 1000 listed
`events[]`	object	Status events, newest first: {oid, user, coin, side, kind, exec, orderType, triggerPx, triggerCondition, limitPx, sz, origSz, …}
`since`	ms	Window start read
`until`	ms	Window end
`entity`	object	Named wallet (labels), when known
`next_cursor`	string \| null	Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page
`billing`	heavy	heavy with history

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.
Triggered stops GET /v1/hypercore/stops/triggered HyperCore
Stop-loss and take-profit orders that fired, newest first, with the fill they got.