Exchange Testnet

The Nexus Exchange is live on testnet at nexus.xyz/trade.

You can authenticate via the API, place orders, and trade across the live perpetual futures markets.

The frontend displays live exchange state in read-only mode. All trading is conducted via the REST and WebSocket APIs.

Full API documentation is the API Reference section of these docs.

Getting Started

1. Authenticate

Sign in with your Ethereum wallet using an EIP-191 personal signature:

POST /auth/login

Sign the message "Sign in to Nexus Exchange" to receive a session token (24-hour TTL). Your account is created automatically on first sign-in.

2. Create an API Key

POST /keys

Returns an HMAC key pair (key_id + secret). The secret is shown once — store it immediately.

Manage keys with GET /keys (list) and DELETE /keys/{key_id} (revoke).

3. Fund your account

Credit your testnet account with synthetic USDX from the faucet:

POST /account/credit

You need a USDX balance before you can place orders. Check your balance at any time via GET /account.

Each API key can claim up to 500 test USDX per day.

4. Place an Order

Authenticate all trading requests with three headers: X-API-Key, X-Timestamp, X-Signature.

POST /orders

{
  "market_id": "BTC-USDX-PERP",
  "side": "Buy",
  "order_type": "Limit",
  "price": "67000",
  "quantity": "0.01",
  "time_in_force": "GTC"
}

See the API Reference section for complete authentication examples and all available endpoints.

Markets

The table below is the configured set: 32 perpetual futures pairs across crypto, FX, commodities, and indices, all denominated in USDX. Testnet lists a subset of it, and that subset moves as markets are listed and delisted — query GET /markets for what is live right now.

Category	Assets
Major Crypto	BTC, ETH, SOL
Altcoins	AVAX, DOT, ADA, ATOM, NEAR, SUI, APT, TIA, SEI, INJ, LINK, UNI, AAVE, MKR, SNX, CRV, FIL, WIF, DOGE, ARB, OP, POL
FX	EUR, GBP, JPY
Commodities	GOLD, OIL
Indices	SPX, NDQ

All markets are denominated in USDX. Query all available markets via GET /markets/summary.

Venue telemetry

Aggregate venue telemetry is available over the API, and those endpoints are public — no API key:

Endpoint	What it returns
GET /stats	Venue snapshot, including rolling unique-trader counts
GET /stats/history	Throughput samples over time
GET /stats/volume	Cumulative traded notional, venue total and per market
GET /stats/open-interest	Open interest, long and short reported separately
GET /stats/balance-distribution	Accounts per balance band

Every one of these is documented as carrying no per-account data by construction, which is why they are public. See Venue Statistics for the response shapes and the sign and units traps — particularly that open interest reports the two sides separately and that gross_oi_two_sided_quote is twice the one-sided figure.

There is no public analytics dashboard on the production frontend today. Use the endpoints above.