Overview
All paths are relative to the DerivaDEX deployment you are integrating against. Choose the base URL for the target environment first, then append the documented path.| Environment | Base URL |
|---|---|
| Testnet | https://testnet.derivadex.io |
| Area | Use it for |
|---|---|
| System | Exchange metadata, products, status, time, and supply state. |
| Market | Order books, prices, tickers, volume, funding, insurance-fund history, and market aggregations. |
| Trade | Trader, strategy, position, fee, account-update, and signed private-request surfaces. |
System endpoints
| Method | Path | Use it for |
|---|---|---|
GET | /exchange/api/v1/exchange_info | Global exchange configuration. |
GET | /exchange/api/v1/ping | Connectivity check. |
GET | /exchange/api/v1/symbols | Tradable product symbols and active-state filters. |
GET | /exchange/api/v1/time | Server time for client clock synchronization. |
GET | /stats/api/v1/status | High-level exchange status. |
GET | /stats/api/v1/specs | Current operator configuration settings. |
GET | /stats/api/v1/supply | DDX circulation information. |
GET | /stats/api/v1/tradable_products | Available trading products. |
GET | /contract-server/addresses | Deployment contract addresses when exposed by the target environment. |
Market endpoints
| Method | Path | Use it for |
|---|---|---|
GET | /exchange/api/v1/mark_prices | Mark price history by symbol, epoch, and paging cursor. |
GET | /exchange/api/v1/order_book | Current L3 order book, optionally filtered by trader, strategy, symbol, side, or depth. |
GET | /exchange/api/v1/tickers | Market ticker data such as funding rate, open interest, price data, and 24-hour volume. |
GET | /stats/api/v1/aggregations/funding_rate_comparison | Funding-rate comparison between DerivaDEX and major exchanges. |
GET | /stats/api/v1/aggregations/insurance_fund | Insurance fund value aggregation. |
GET | /stats/api/v1/aggregations/traders | Top traders by volume. |
GET | /stats/api/v1/aggregations/volume | Trading volume aggregation. |
GET | /stats/api/v1/epochs | Epoch history and paging cursors. |
GET | /stats/api/v1/funding_rate_history | Funding rates over time. |
GET | /stats/api/v1/insurance_fund | Insurance fund balance history. |
GET | /stats/api/v1/open_interest_history | Open interest over time. |
GET | /stats/api/v1/order_book_l2 | Current L2 aggregated order book by symbol, depth, side, and price aggregation. |
GET | /stats/api/v1/price_checkpoints | Price checkpoint history. |
Trade endpoints
| Method | Path | Use it for |
|---|---|---|
GET | /exchange/api/v1/order_updates | Order posts, fills, cancellations, liquidations, and rejection history. |
GET | /exchange/api/v1/strategy_updates | Strategy update history for collateral, funding, PnL, fees, withdrawals, liquidations, and ADL. |
GET | /exchange/api/v1/trader_updates | Trader DDX balance, fee-preference, admission, denial, and profile update history. |
GET | /stats/api/v1/aggregations/balance | Strategy balance changes over a recent lookback window. |
GET | /stats/api/v1/aggregations/collateral | Collateral inflow and outflow aggregation. |
GET | /stats/api/v1/aggregations/ddx | DDX inflow and outflow aggregation. |
GET | /stats/api/v1/aggregations/fees | Fee aggregation by symbol, fee symbol, period, and grouping. |
GET | /stats/api/v1/fees | Maker and taker fee history for a strategy. |
GET | /stats/api/v1/positions | Current positions for a strategy. |
GET | /stats/api/v1/strategy | Current state of a trader strategy. |
GET | /stats/api/v1/strategies | Strategy list for a trader when exposed by the target deployment. |
GET | /stats/api/v1/strategy_metrics | Strategy KPIs and risk metrics such as margin fraction, leverage, available collateral, and strategy value. |
GET | /stats/api/v1/trader | Current trader DDX balance and profile. |
GET | /v2/encryption-key | Operator public key for encrypted private request submission. |
POST | /v2/request | Signed and encrypted private order, cancel, cancel-all, profile-update, or withdrawal request submission. |
REST and Realtime together
| Stage | Typical API choice |
|---|---|
| Bootstrap market or account state | REST |
| Submit a signed trading request | REST |
| Watch order book and mark-price changes | Realtime |
| Track order, strategy, and trader updates after bootstrap | Realtime |
Integration notes
| Topic | Detail |
|---|---|
| Endpoint details | Operation-specific parameter and response schemas appear under the generated REST endpoint pages. |
| Private trading requests | Signed and encrypted write requests use Signed Private Requests. |
| Pagination | Historical endpoints commonly use limit, order, epoch, ordinal, timestamp, cursor, or offset fields. |
| Numeric values | Decimal quantities are represented as strings where precision matters. |
| Limits and errors | Use Rate Limits and Access Tiers and Error Reference. |
| Live updates | Use Realtime Channels after REST bootstrap when a client needs continuous updates. |