Orderbook API Reference

Public REST surface of the XO CLOB orderbook.

The XO Orderbook API is the public REST surface of the CLOB. The endpoints in this section are generated from the live OpenAPI spec.

For narrative context on the smart-account identity model and EIP-712 signing domains, see Smart accounts.

Server

	Value
URL	https://orderbooks.xo.market
Chain id	3223

The CTF Exchange address (0x4bC5E872256D12E6017dfe466E04c867DC761B77) and chain id (3223) are part of the EIP-712 order domain — signatures are tied to this deployment. See the introduction for the full contract list and the mainnet RPC / bundler endpoints.

Wire conventions

• Prices are trimmed decimal strings (e.g. "0.5", "0.555").
• Sizes are decimal-string integers in human shares.
• Timestamps in trade and book responses are stringified Unix seconds / milliseconds.
• Token IDs are decimal U256 strings; condition IDs are 0x-prefixed 32-byte hex.

Only XO smart-account orders (signatureType = 3) are accepted today. Direct EOA orders (signatureType = 0) will be rejected.

Next steps

Authentication

L1 ClobAuth and L2 HMAC headers.

Rate limits

Per-tier request and connection limits.

Data API reference

Market discovery and public portfolio reads.