Exchange Testnet

The Nexus Exchange is live on testnet at exchange.nexus.xyz.

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 hosted at exchange.nexus.xyz/api-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 documentation for complete authentication examples and all available endpoints.

Markets

Four markets are live on testnet today — BTC, ETH, SOL, and NDQ. The configured set expands to 32 perpetual futures pairs across crypto, FX, commodities, and indices, all denominated in USDX.

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.

Analytics Dashboard

Real-time exchange telemetry exists at exchange.nexus.xyz/analytics:

• Engine — fills/second, throughput, HTTP latency, resource utilization
• Microstructure — cross-market spread, depth, imbalance, order book heatmap
• Risk — account risk distribution, insurance fund flow, liquidation monitoring
• Oracle — mark price divergence per market, feed status
• Invariants — continuous correctness monitoring (fund conservation, OI symmetry)