List all tradable markets with their current summary (mark price, 24h change, volume, open interest, funding). Public — no credentials needed.

Get the ticker (last price, bid/ask, 24h stats) for one market, e.g. "BTC-USDX-PERP". Public — no credentials needed.

Get the current order book (bids/asks with price + size) for one market. Public — no credentials needed.

List all markets with their static specs (tick size, lot size, leverage, contract details) — the raw market definitions without live summary stats. Public — no credentials needed. (Use list_markets for live mark price / volume / funding.)

Get tickers (last price, bid/ask, 24h stats) for ALL markets in one call. Public — no credentials needed.

Get the current mark price for one market. Public — no credentials needed.

Get a market's trading status and halt info (whether trading is open, halted, or in auction). Public — no credentials needed.

Get recent public trades (prints) for one market. Public — no credentials needed.

Get OHLCV candles for one market. Public — no credentials needed. Timeframe is one of 1s, 1m, 5m, 1h (default 1m).

Get the funding-rate history for one perpetual market. Public — no credentials needed.

Get the dense per-tick funding premium-index samples for one perpetual market (60s cadence, up to 480 points = 8h). Finer-grained than get_funding_history, which returns the settled hourly rates. Public — no credentials needed.

Get one market's risk parameters: margin requirements and maximum leverage, from the engine's market registry. Public — no credentials needed.

Get aggregate venue statistics (volume, trades, throughput) plus rolling unique-trader counts. Public — no credentials needed.

Get the venue's per-second throughput history (ring buffer, up to 3600 points). Public — no credentials needed.

Get a live, public demo account snapshot (balance, equity, positions). No credentials needed — useful to show the account flow before API keys are wired up.

Get the public demo account's open positions. No credentials needed.

Get the public demo account's open orders. No credentials needed.

Get the authenticated account snapshot: collateral balance, equity, and positions. Requires API credentials.

Get the authenticated account's portfolio summary (equity, margin usage, PnL rollup) — a richer view than get_balance. Requires API credentials.

Get the authenticated account's equity time-series (5s cadence, ~1h window), oldest first. Requires API credentials.

Get the authenticated account's open positions. Requires API credentials.

Get the authenticated account's closed positions (realized PnL per position). Requires API credentials.

Get the authenticated account's resting (open) orders. Requires API credentials.

Get a single order by its id (status, fills, remaining size). Pass market_id when known — the spec marks it required for routing, though the gateway currently resolves the order without it. Requires API credentials.

Get the authenticated account's terminal-status order history (filled / cancelled / rejected / expired), newest first. Requires API credentials.

List the authenticated account's recent fills (executed trades). Requires API credentials.

Get the authenticated account's funding-payment history, newest first, optionally filtered to a single market. Requires API credentials.

List the authenticated account's withdrawal history. Requires API credentials.

List the authenticated account's deposit history. Requires API credentials.

Get the authenticated account's current rate-limit status (remaining request budget). Useful for an agent to pace itself. Requires API credentials.

Get the auto-deleveraging (ADL) events that touched a given account. Requires API credentials.

Place an order on a market. Supports limit and market orders, buy/sell. For limit orders a price is required. Requires API credentials. This submits a REAL order to the matching engine.

Submit multiple orders in one request. Each order has the same shape as place_order (market_id, side, type, size, optional price/time_in_force/reduce_only). Requires API credentials. This submits REAL orders to the matching engine.

Cancel a resting order. Pass order_id to cancel one order. To cancel ALL open orders you must explicitly pass cancel_all: true — an empty or argless call is rejected so a stray call can't mass-cancel by accident. Requires API credentials.

Amend a resting order's price and/or size in one atomic cancel-replace operation. At least one of price or size is required; a pre-trade margin check is applied to the replacement before it is accepted. Liquidation orders cannot be amended. Requires API credentials. This modifies a REAL order on the matching engine.

Preview an order without submitting it: projects the margin, equity, and fee impact of the order. Takes the same arguments as place_order. Nothing reaches the matching engine. Requires API credentials.

Get the auto-deleveraging (ADL) settlement history for one market — the events where the engine force-closed positions to cover a shortfall. Requires API credentials.

Deposit USDX collateral into the authenticated account. amount is a positive decimal string. Requires API credentials. This moves REAL collateral on the account.

Claim synthetic USDX credit from the testnet faucet, up to a per-key daily allowance (default 500 USDX, resets midnight UTC). Pass amount (positive decimal string) to claim a specific amount, or omit it to claim the full remaining allowance. The credited USDX is synthetic testnet value. Requires API credentials.

Submit a (testnet/synthetic) deposit for the authenticated account via the deposits ledger (POST /deposits — unlike deposit_collateral, the deposit is recorded and listable with list_deposits). amount is a positive decimal string; asset defaults to USDX. Requires API credentials. This moves REAL collateral on the account.

Claim the fixed testnet faucet amount of synthetic USDX for the authenticated account, subject to a per-wallet cooldown and cumulative cap. Unlike claim_credit the amount is fixed server-side — no arguments. Requires API credentials.

Add or remove isolated margin on an open position. Fails if the position is not in isolated margin mode (MarginModeNotIsolated), if there is no open position in the market (NoOpenPosition), or if a removal breaches the margin floor. amount is a positive decimal string. Requires API credentials. This moves REAL margin on the position.

List the delegated agent keys registered for the authenticated wallet (address, label, expiry). Requires API credentials.

Register a delegated agent key so an AI agent can trade on a wallet's behalf without holding the wallet key. Authorized by an EIP-712 signature from the OWNER WALLET over RegisterAgent{agent, expiresAt, nonce} (domain NexusExchange v1). This server cannot produce that wallet signature — sign it externally (e.g. in the wallet) and pass it as signature. No API credentials are needed; the signature is the authorization.

Revoke a previously registered delegated agent key by its address. Destructive: the agent can no longer trade on the wallet's behalf. To avoid an accidental revoke you must pass confirm: true. Requires API credentials.

Sign in with an EVM wallet to get a 24h session token. Submit an EIP-191 personal_sign signature over the exact message "Sign in to Nexus Exchange". This server cannot sign for you — produce the signature in the wallet and pass it as signature. The returned token is used as the Bearer credential for the *_api_key tools (set it as NEXUS_EXCHANGE_SESSION_TOKEN). No credentials needed to call this.

List the HMAC API keys for the authenticated wallet (key ids and metadata; never the secrets). Authenticates with a session token from login — set NEXUS_EXCHANGE_SESSION_TOKEN.

Create a new HMAC API key for the authenticated wallet. The secret is returned ONCE and never shown again — store it immediately. Authenticates with a session token from login — set NEXUS_EXCHANGE_SESSION_TOKEN.

Delete (revoke) an HMAC API key by its key id. Destructive: any caller using that key stops working. You must pass confirm: true. Authenticates with a session token from login — set NEXUS_EXCHANGE_SESSION_TOKEN.

Mint a short-lived (60s, single-use) token for an authenticated per-account WebSocket stream (order/fill/position updates). Uses the current /ws/token endpoint, which supports HMAC keys and registered agents. The caller connects to GET /ws?token=… with the token. Requires API credentials.

Mint a short-lived (60s, single-use) token for the legacy public /stream endpoint via POST /ws-tokens. Prefer get_ws_token (/ws/token) for new code; this is kept for /stream compatibility. Requires API credentials.

Health check for the exchange gateway (liveness/readiness). Public — no credentials needed.

Engine readiness probe: 200 once every configured market has received its first oracle price this run, 503 while any market is still in the oracle warm-up window. Distinct from get_health (liveness). Public — no credentials needed.

Aggregate service health of the exchange stack (indexer / engine / oracle / bots), as used by status pages. Public — no credentials needed.

Get the on-chain deposit target (address/memo) to fund the account. Not yet available — the gateway exposes deposit submission but no deposit-address endpoint yet.