JSON-RPC
Ethereum-compatible methods plus QRDX's namespaces, with a playground for each.
POST /rpc with a JSON-RPC 2.0 body, one request per call (batches are not accepted).
curl -s https://test.qrdx.org/rpc \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'Namespaces
| Namespace | For |
|---|---|
eth_* | Ethereum-compatible: blocks, balances, calls, logs, filters, raw transactions |
qrdx_* | account ids, address info, intrinsic gas |
exchange_* | tokens, NFTs, pools, spot books, quotes; signing payloads, submission, receipts |
perp_* | perps markets, books, accounts, vault, events |
market_* | one shape for every market: tickers, books, trades, candles |
tx_* | the transaction index |
net_*, web3_* | network and client |
The method reference lists all of them.
Ethereum compatibility
Standard tools (ethers, viem, web3.py) work for reads and classic transactions. Differences:
eth_getBalance,eth_getTransactionCountandeth_getCodealso accept0xPQ…addresses, resolved to the account id.- Only legacy and type-
0x51raw transactions are accepted; send EIP-1559 fees as a legacygasPrice. - Native tokens are ERC-20s at their addresses, so
eth_calltobalanceOfworks.
Balances are hex wei (1 QRDX = 10¹⁸ wei). A 0xPQ address resolves to its account id.
Run sends this request from your browser to https://test.qrdx.org/rpc.
QRDX reads
Run sends this request from your browser to https://test.qrdx.org/rpc.
The floor gas a transaction must supply: envelope (legacy or pq), calldata, and whether it creates a contract. Compare pq with legacy: the post-quantum envelope pays for verifying and carrying a 5.3 KB key and signature.
Run sends this request from your browser to https://test.qrdx.org/rpc.
Exchange reads
Run sends this request from your browser to https://test.qrdx.org/rpc.
Run sends this request from your browser to https://test.qrdx.org/rpc.
Perps reads
Run sends this request from your browser to https://test.qrdx.org/rpc.
Run sends this request from your browser to https://test.qrdx.org/rpc.