Skip to main content
Take-profit and stop-loss orders are trigger orders: they rest until a price condition fires. This route returns those trigger orders for a symbol. It is available on Hyperliquid core, HIP-3, and HIP-4.

Get take profits & stop losses

curl "https://api.0xarchive.io/v1/hyperliquid/orders/BTC/tpsl" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"
/v1/hyperliquid/orders/{symbol}/tpsl. Plain perp symbols such as BTC.
The OpenAPI spec types this route as a raw object array, so capture a live fixture and pin the fields you depend on. Records carry the trigger price, side, size, and the order that placed the trigger.

Request parameters

ParameterInTypeRequiredDescription
symbolpathstringYesTrading pair symbol, e.g. BTC
startquerystringNoStart time, ISO 8601 (e.g. 2026-01-01T00:00:00Z)
endquerystringNoEnd time, ISO 8601
user_addressquerystringNoFilter by wallet address
limitqueryintegerNoMax results. Default 1000, max 10000
cursorquerystringNoPagination cursor from meta.next_cursor

When to use it

A take-profit or stop-loss sits as a trigger until its price condition fires. When it fires, it becomes an ordinary fill, so a complete picture pairs this route with Trades for the resulting executions and Order history for the order lifecycle. Use the user_address filter to study one wallet’s risk management, or pull the whole symbol to see where triggers cluster around price. Store the trigger price, side, and status with each record: a trigger that never fired and one that fired are different events, and the status field is what separates them.

Stream it live

There is no dedicated take-profit or stop-loss channel. Trigger orders surface in the L4 order-event stream (l4_orders, plus the venue-prefixed variants), where you can filter for trigger order types as they are placed, fired, or canceled.
ws.send(JSON.stringify({ op: "subscribe", channel: "l4_orders", symbol: "BTC" }));
Connection and reconnect handling live in the WebSocket tab; see WebSocket Channels for the family matrix.

Export in bulk

Take-profit and stop-loss records ship in the l4_orders (Order Events / TP/SL) export schema ($8/GB, $25 minimum), delivered as Parquet with ZSTD compression. Build a selection in the Data Catalog; columns and coverage keys are on Export Schemas.

Next

Use Order history for full order lifecycle, Order flow for aggregated activity, or Order books for the L4 book.
Last modified on June 8, 2026