Quickstart

Connect to SoDEX Spot or Perps, register an API key, and start trading through REST or an official SDK.

1. Set up your account

Environment	REST base URL	Chain ID	What it covers
Testnet	https://testnet-gw.sodex.dev	138565	Order placement and account APIs.
Mainnet	https://mainnet-gw.sodex.dev	286623	Orders plus the deposit and withdrawal loop.

Spot endpoints use /api/v1/spot; Perps endpoints use /api/v1/perps.

There is no Testnet Mirror API. To fund or withdraw on Mainnet:

1. Bring the asset onto ValueChain with Custody Deposits or Bridge Deposits, unless it is already there.

2. Credit Spot or Perps with ValueChain to Spot or Perps. If the trading account does not exist (UserNotFound), the first credit must be USDC or SOSO (activation costs 1 unit).

3. To leave SoDEX, move Perps → Spot → ValueChain EVM, then Withdrawals. Trading transfers stop at EVM.

A signed order example can run on Testnet once that account is funded. The full external deposit and withdrawal path is Mainnet.

2. Register an API key

Use your master wallet to register a separate trading key. Use that key for routine trading and keep its private key local. The X-API-Key header contains the registered key name.

Follow the registration example in API Keys and Nonces to create and verify your trading key.

3. Connect your application

Choose an official SDK, or use REST directly with Authentication & Signing.

Before placing an order, retrieve the account ID and market rules, including price and quantity increments. See the Python SDK examples on GitHub, or Manual REST Signing for raw HTTP requests.

4. Track your orders

A successful submission is not a fill. Retain the client order ID and returned order ID, then track Account Order Updates and Account Trades.

If a request times out or the WebSocket disconnects, reconcile with REST before retrying.

API Reference

REST APIWebSocket StreamsRate Limits