The examples below show common REST request shapes. Replace https://exchange.derivadex.com with the base URL for the deployment you are integrating against.
Market data
L3 order book
curl "https://exchange.derivadex.com/exchange/api/v1/order_book?symbol=ETHP&depth=4"
| Query parameter | Meaning |
|---|
symbol | Product symbol, such as ETHP or BTCP. |
depth | Best N bids and asks to return. |
side | Optional side filter: 0 for bid, 1 for ask. |
trader | Optional trader address with the blockchain discriminant prefix. |
strategyIdHash | Optional strategy ID hash. |
L2 order book
curl "https://exchange.derivadex.com/stats/api/v1/order_book_l2?symbol=ETHP&depth=4&priceAggregation=1"
| Query parameter | Meaning |
|---|
symbol | Product symbol. |
depth | Best N bids and asks to return. |
priceAggregation | Aggregation level for L2 prices. Current values are 0.1, 1, and 10 for ETHP; 1, 10, and 100 for BTCP. |
side | Optional side filter: 0 for bid, 1 for ask. |
Tickers
curl "https://exchange.derivadex.com/exchange/api/v1/tickers?symbol=ETHP"
| Query parameter | Meaning |
|---|
symbol | Optional product symbol. |
marketKind | Optional market type filter. 0 is single-name perpetual, 2 is index-fund perpetual, and 3 is fixed-expiry future. |
Trader and strategy state
Strategy metrics
curl "https://exchange.derivadex.com/stats/api/v1/strategy_metrics?trader=0xb993e587c15a9e0a0fe4f111de98fd6b5ce7067d&strategyId=main"
| Query parameter | Meaning |
|---|
trader | Required trader address. |
strategyId | Required strategy ID, such as main. |
Strategy positions
curl "https://exchange.derivadex.com/stats/api/v1/positions?trader=0xb993e587c15a9e0a0fe4f111de98fd6b5ce7067d&strategyId=main&symbol=ETHP&limit=500&offset=0"
| Query parameter | Meaning |
|---|
trader | Required trader address. |
strategyId | Required strategy ID. |
symbol | Optional product symbol. |
limit | Number of rows to return. Defaults to 500. |
offset | Offset for returned rows. Defaults to 0. |
Trader state
curl "https://exchange.derivadex.com/stats/api/v1/trader?trader=0xb993e587c15a9e0a0fe4f111de98fd6b5ce7067d"
| Query parameter | Meaning |
|---|
trader | Required trader address. |
History and pagination
Order updates
curl "https://exchange.derivadex.com/exchange/api/v1/order_updates?trader=0x00b993e587c15a9e0a0fe4f111de98fd6b5ce7067d&strategyIdHash=0x2576ebd1&symbol=ETHP&limit=500&order=asc"
| Query parameter | Meaning |
|---|
trader | Optional trader address with the blockchain discriminant prefix. |
strategyIdHash | Optional strategy ID hash. |
symbol | Optional product symbol. |
reason | Optional order-update reason. 0 post, 1 trade, 2 liquidation, 3 cancel, 4 order rejection, 5 cancel rejection. |
limit | Number of rows to return. Defaults to 500. |
globalOrdinal | Boundary used when fetching the next timeseries page. |
order | Result order: asc or desc. |
since | Earliest timestamp in seconds. Cannot be used with order=desc. |
orderHash | Optional order hash. Multiple values can be provided. |
Strategy updates
curl "https://exchange.derivadex.com/exchange/api/v1/strategy_updates?trader=0x00b993e587c15a9e0a0fe4f111de98fd6b5ce7067d&strategyIdHash=0x2576ebd1&reason=5&limit=500&order=asc"
| Query parameter | Meaning |
|---|
trader | Optional trader address with the blockchain discriminant prefix. |
strategyIdHash | Optional strategy ID hash. |
reason | Optional strategy-update reason. 0 deposit, 1 withdraw, 2 withdraw intent, 3 funding payment, 4 PnL settlement, 5 trade, 6 fee, 7 liquidation, 8 ADL, 9 withdrawal rejection. |
limit | Number of rows to return. Defaults to 500. |
globalOrdinal | Boundary used when fetching the next timeseries page. |
order | Result order: asc or desc. |
Last modified on April 27, 2026
