QRDXDocs

Trade API

trade.qrdx.org's read-only API: markets oriented by pair, USD prices, accounts and PnL.

A read-only API over the native exchange. It serves trade.qrdx.org and anyone else: no key, CORS open.

NetworkBase URL
Testnethttps://trade.qrdx.org/api/v1-test
Mainnet (not launched)https://trade.qrdx.org/api/v1

It does not place orders. Orders are exchange transactions signed by the trader's key and sent to a node, normally through QRDX Wallet. Use this API for what the node does not do: pair orientation, USD prices, aggregated accounts and PnL.

Conventions

  • Amounts and prices are decimal strings. Do not parse them to floats for anything you sign.
  • Assets in paths are a verified slug (btc, eth, usdc, qrdx, …) or a token address for unverified tokens. A verified token's address redirects (308) to its slug.
  • Pair orientation follows the path: in /markets/eth/usdc, prices are USDC per ETH and sizes are in ETH, whatever the node's sorted order is.
  • Bodies carry source (node, indexer, coinbase, kraken, coingecko) and asOf (Unix seconds).
  • Errors: { "error": { "code", "message" } } with 400 bad_request, 404 not_found, 404 ambiguous_symbol (a symbol that is not a verified slug; candidates lists matching tokens by address), 502 node_unavailable.

Markets

TRADE
/markets
https://trade.qrdx.org/api/v1-test/markets

Run sends this request from your browser.

Endpoint
GET /marketsevery spot pair with a pool, and every perps market
GET /markets/{base}/{quote}one spot market: last, 24-hour stats, index prices, pools
GET /markets/{base}/{quote}/orderbook?depth=the book, oriented to the path
GET /markets/{base}/{quote}/trades?limit=recent trades
GET /markets/{base}/{quote}/candles?interval=&limit=candles (1m 5m 15m 1h 4h 1d)
GET /perps, GET /perps/{base}/{quote}[/orderbook | /trades | /candles]the same for perps
GET /pools[?base=&quote=], GET /pools/{poolId}?twap=pools
GET /quote?from=&to=&amount=&sender=&venue=autoa swap quote
GET /quote/liquidity?pool=&tickLower=&tickUpper=&amount0=&amount1=a liquidity quote
GET /assets[?all=1], GET /assets/{asset}verified assets, every token, one asset with supply, authorities and its creator's profile
GET /launches?limit=recent token launches
GET /statusthe network's node: height, latency
GET /featureswhat the network's node runs (the 2026-10 trading features, its history database) and what the protocol charges
GET /leaderboard?window=&metric=perps traders by realized profit or volume
GET /vaults, GET /vaults/{vault}?holder=user vaults and markets' liquidity vaults
GET /perps/check?token=whether a token can have a perpetual listed: its pools' depth and price history, the fee and the minimum liquidity
GET /tickersthe unique-ticker auction's price
GET /nfts/market, POST /nfts/market { address }the NFT market contract, and registering a deployment (checked on chain)

Prices

JS
USD prices from the trade API
output⌘/Ctrl + Enter to run
Edit the code and run it. It talks to testnet from your browser.

GET /prices[?assets=btc,qrdx,0x…] (up to 100) and GET /prices/{asset}. Verified assets with an outside market use their index price from public exchanges (Coinbase, then Kraken, then CoinGecko). Everything else, including QRDX itself, is priced through the network's pools to an asset that has one (source: "route", with the route and pools used). An asset with neither is null. These are reference prices, labelled as such.

Accounts and PnL

TRADE
/accounts/0xPQF024d7895096D4Cd86fD4bC68e526FbdE8373e83C78F2CaEeE9279249201aCbc/pnl
https://trade.qrdx.org/api/v1-test/accounts/0xPQF024d7895096D4Cd86fD4bC68e526FbdE8373e83C78F2CaEeE9279249201aCbc/pnl

Realized and open PnL from the account's trades: spot (book fills and pool swaps) on a signed average-cost basis per market, perps as the clearinghouse realized them. USD at today's prices.

Run sends this request from your browser.

Endpoint
GET /accounts/{address}[?tokens=0x…,0x…]balances (with what is in orders), spot orders oriented to their markets, liquidity positions, the perps account, the exchange nonce
GET /accounts/{address}/family[?tokens=]a wallet account and every sub-account and vault it signs for: balances, the QRDX it pays gas with, perps summary, spot orders and triggers
GET /accounts/{address}/pnltotals, a PnL series, the spot trades behind it, and PnL per market
GET /accounts/{address}/controlits trading agents, sub-accounts, the vaults it leads, its fee tier and referral
GET /accounts/{address}/history?kind=trades|orders&cursor=its fills or order events from the node's trading history
GET /receipts/{txHash}an exchange receipt, 404 while pending

PnL

  • Spot is replayed from the account's own trades (history_getTrades: book fills and pool swaps, up to 5,000), each market oriented as /trade/{base}/{quote} shows it, on a signed average-cost basis in the quote token (unit). Selling more than was bought leaves position negative, measured against holding those coins and realized when they are bought back. Open positions are marked at last, the pool price where there is a pool.
  • Perps use the PnL the clearinghouse realized on each fill (perp_getEvents), in collateral units (perpUnit), plus unrealized PnL at mark.
  • series has a point at each spot trade and perps realization: realizedUsd so far, and pnlUsd with open spot positions added. trades lists the newest 300 spot trades (time, market, side, amount, price, base, quote) for chart markers.
  • USD values use today's prices; markets whose quote has no USD price are listed in totals.unpriced. window.truncated says whether history was cut off.

The asset object

{ "segment": "btc", "slug": "btc", "symbol": "BTC", "name": "Bitcoin", "verified": true,
  "address": "0x0e35…5658", "onChainSymbol": "qBTC", "decimals": 8, "color": "#f7931a",
  "listed": true, "image": null }

segment is what goes in a URL. An unverified token has slug: null and its address as segment. image is the image its creator published (profiles), or null.

On this page