Skip to main content
The REST API exposes request-response endpoints for market data, exchange state, strategy state, trader state, and historical stats. All paths are relative to the DerivaDEX deployment you are integrating against.

​
Exchange endpoints

MethodPathUse it for
GET/exchange/api/v1/exchange_infoGlobal exchange configuration.
GET/exchange/api/v1/mark_pricesMark price history by symbol, epoch, and paging cursor.
GET/exchange/api/v1/order_bookCurrent L3 order book, optionally filtered by trader, strategy, symbol, side, or depth.
GET/exchange/api/v1/order_updatesOrder posts, fills, cancellations, liquidations, and rejection history.
GET/exchange/api/v1/pingConnectivity check.
GET/exchange/api/v1/strategy_updatesStrategy update history for collateral, funding, PnL, fees, withdrawals, liquidations, and ADL.
GET/exchange/api/v1/symbolsTradable product symbols and active-state filters.
GET/exchange/api/v1/tickersMarket ticker data such as funding rate, open interest, price data, and 24-hour volume.
GET/exchange/api/v1/timeServer time for client clock synchronization.
GET/exchange/api/v1/trader_updatesTrader DDX balance, fee-preference, admission, denial, and profile update history.

​
Stats endpoints

MethodPathUse it for
GET/stats/api/v1/aggregations/balanceStrategy balance changes over a recent lookback window.
GET/stats/api/v1/aggregations/collateralCollateral inflow and outflow aggregation.
GET/stats/api/v1/aggregations/ddxDDX inflow and outflow aggregation.
GET/stats/api/v1/aggregations/feesFee aggregation by symbol, fee symbol, period, and grouping.
GET/stats/api/v1/aggregations/funding_rate_comparisonFunding-rate comparison between DerivaDEX and major exchanges.
GET/stats/api/v1/aggregations/insurance_fundInsurance fund value aggregation.
GET/stats/api/v1/aggregations/tradersTop traders by volume.
GET/stats/api/v1/aggregations/volumeTrading volume aggregation.
GET/stats/api/v1/epochsEpoch history and paging cursors.
GET/stats/api/v1/feesMaker and taker fee history for a strategy.
GET/stats/api/v1/funding_rate_historyFunding rates over time.
GET/stats/api/v1/insurance_fundInsurance fund balance history.
GET/stats/api/v1/open_interest_historyOpen interest over time.
GET/stats/api/v1/order_book_l2Current L2 aggregated order book by symbol, depth, side, and price aggregation.
GET/stats/api/v1/positionsCurrent positions for a strategy.
GET/stats/api/v1/price_checkpointsPrice checkpoint history.
GET/stats/api/v1/specsCurrent operator configuration settings.
GET/stats/api/v1/statusHigh-level exchange status.
GET/stats/api/v1/strategyCurrent state of a trader strategy.
GET/stats/api/v1/strategy_metricsStrategy KPIs and risk metrics such as margin fraction, leverage, available collateral, and strategy value.
GET/stats/api/v1/supplyDDX circulation information.
GET/stats/api/v1/tradable_productsAvailable trading products.
GET/stats/api/v1/traderCurrent trader DDX balance and profile.

​
Integration notes

TopicDetail
Base URLChoose the target DerivaDEX deployment first, then append one of the paths above.
Private trading requestsSigned and encrypted write requests use the private request flow described in REST Authentication.
PaginationHistorical endpoints commonly use limit, order, epoch, ordinal, timestamp, cursor, or offset fields.
Numeric valuesDecimal quantities are represented as strings where precision matters.
Live updatesUse Realtime Channels after REST bootstrap when a client needs continuous updates.
Last modified on April 27, 2026