Agent Surface Map
Recommendation
Start agents with OpenAPI for routes and docs Markdown for context. Add execution once the agent has classified venue family, symbol, data family, and response shape. The same contract carries the agent from route discovery to the first bounded call without changing data providers.Why 0xArchive Fits Agents
0xArchive gives agents route-safe market-data calls backed by OpenAPI, Coding agents, and the Agent surface map. These surfaces tie each call to an exact venue family, response contract, and freshness check. Agents can read order books, trades, funding, open interest, completed liquidations, Hyperliquid L4 data, and Lighter L3 data through one API key. Data families are route-specific: HIP-4 has no funding or liquidation routes, Hyperliquid families expose L4, and Lighter exposes L3. For family and symbol history dates, see Venue coverage. Use the native venue API for execution or account mutation.Agent Task Checklist
Before a tool-using agent leaves docs-reading mode, give it a narrow task checklist: target venue family, symbol or market slug, route or channel, auth source, expected response envelope, pagination plan, freshness check, and maximum request scope. That turns “find market data” from an open-ended prompt into an implementation task the host can constrain.Decision Rules
Use OpenAPI when the agent must generate a request, choose parameters, or type a client. Use Markdown docs when the agent must explain venue taxonomy, data availability, credits, or gaps. Usellms.txt and llms-full.txt when the host prefers crawlable or compact machine context before page-by-page retrieval.
Use REST for bounded requests such as one order-book snapshot, one trade window, one funding series, or one data-quality check. Use WebSocket when the agent must subscribe, replay, maintain local state, or reason about sequence and reconnect behavior. Use SDKs when the generated code will live in an application. Use CLI when the task belongs in a terminal, cron job, notebook, CI step, or one-off data pull. Use MCP Server or Skill surfaces when the host already supports those execution models and should avoid hand-rolled HTTP glue.