GET /api/v1/markets/{market_id}/orderbook

Get order book

Get order book.

operationId: fetchOrderBookV1 · CCXT method: fetchOrderBook

Declared server differs from the callable one. This path declares its own servers base of https://exchange.nexus.xyz, without the /api/exchange mount the document default carries. Measured 2026-09-02, the override is not routed — https://exchange.nexus.xyz/api/v1/markets/{market_id}/orderbook returns 404 while the gateway form in the sample below is routed. A client generated from this contract will aim at the override; pin the gateway base until the per-network hosts are live. See Networks.

Authentication: none — this operation is public.

Parameters

Name	In	Type	Required	Default	Description
market_id	path	string	Yes	—	Market identifier (e.g. BTC-USDX-PERP, ETH-USDX-PERP). Uppercase ASCII alphanumeric segments joined by single hyphens, at most 64 characters. A value outside that set is rejected with 400 (INVALID_MARKET_ID) before any store is read — it cannot name a market, so an empty result would assert that nothing traded rather than that the question was malformed. A well-formed identifier that names no listed market is a 404, not a 400.

Responses

Status	Body	Meaning
200	OrderBook	Current order book for the market.
400	— (no schema declared)	—
404	— (no schema declared)	Market not found
429	— (no schema declared)	—

Example

cURL

curl -X GET 'https://exchange.nexus.xyz/api/exchange/api/v1/markets/BTC-USDX-PERP/orderbook'

Python

import requests


response = requests.get("https://exchange.nexus.xyz/api/exchange/api/v1/markets/BTC-USDX-PERP/orderbook")
response.raise_for_status()
print(response.json())

TypeScript

const response = await fetch("https://exchange.nexus.xyz/api/exchange/api/v1/markets/BTC-USDX-PERP/orderbook", {
  method: "GET",
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
console.log(await response.json());

---

_{Generated from eng/apps/exchange/api/openapi.json (spec 0.9.36). Do not edit by hand — regenerate with python3 product/docs/tools/api-reference/generate.py. Hand-authored context lives in the Guides pages.}