Agents should choose the job type before the venue route. A file export, live stream, replay, generated client, and one-off REST request should not collapse into the same answer.
Route-Selection Order
- If the user asks for Parquet files, bulk historical delivery, credits, checkout, export schemas, or a Data Catalog export page, use Data catalog, Export schemas, and Export checkout. Do not invent REST checkout routes unless OpenAPI exposes them.
- If the user asks for live streams, replay, gap handling, stateful L4 books, or subscription events, use WebSocket and WebSocket message schema before REST.
- If the user names Lighter, use
/v1/lighter/*.
- If the user names Hyperliquid Spot or gives a pair symbol such as
HYPE-USDC, use /v1/hyperliquid/spot/*.
- If the symbol has a builder prefix such as
km:US500, use /v1/hyperliquid/hip3/* unless context says otherwise.
- If the user names an outcome, HIP-4, or a numeric outcome side such as
0, use /v1/hyperliquid/hip4/*. Bare numeric HIP-4 coins are canonical; legacy #0 and %230 forms are accepted when a source supplies them.
- If the user names a standard Hyperliquid perp such as
BTC, use Hyperliquid core at /v1/hyperliquid/*.
- If venue remains unclear, ask for the venue before making the request.
The family-prefix entries above are routing hints only, not callable request paths. Resolve the exact method, path, symbol encoding, parameters, and response contract in OpenAPI before execution. For MCP, select only an exact tool name and input schema returned by the connected server; do not infer tool names from REST paths, and stop if the required tool is not advertised.
Examples of exact REST route shapes include GET /v1/hyperliquid/orderbook/{symbol}, GET /v1/hyperliquid/spot/orderbook/{symbol}, GET /v1/hyperliquid/hip3/orderbook/{symbol}, GET /v1/hyperliquid/hip4/orderbook/{symbol}, and GET /v1/lighter/orderbook/{symbol}. Use OpenAPI for exact REST paths, parameters, schemas, and examples. Use https://api.0xarchive.io/v1/symbols and the Data Catalog pages for catalog discovery; the API-domain symbols feed is not the generated OpenAPI reference.
Agent Route Checklist
Last modified on September 3, 2026
