0xArchive Market Data

Query Hyperliquid and Lighter market data from your agent. Get current and historical order books, trades, candles, funding, open interest, liquidations, positions and data coverage through read-only market-data tools, and manage webhooks when you grant webhook access.

Highlights

• No key, no install. Add one URL, sign in through your client's OAuth flow, and approve read access.
• Every client that speaks MCP. Claude Code, Claude web and Desktop, ChatGPT, Codex, Cursor, VS Code, Antigravity and Gemini CLI, with setup steps for each below.
• Both venues, every market. Hyperliquid core perps, HIP-3, HIP-4 and Spot, and Lighter on mainnet and Robinhood Chain.
• Read-only by default. Market data needs mcp:market.read; webhook tools appear only if you also grant webhook scopes.

Connect

Server URL

https://mcp.0xarchive.io/mcp

Add the URL as a remote HTTP MCP server, then sign in with your 0xArchive account through the client's OAuth flow. Approve the mcp:market.read permission when prompted; approve mcp:webhooks.read and mcp:webhooks.write as well if you want the webhook tools. No 0xArchive API key or local MCP server installation is required.

Start with:

Get a BTC market summary on Hyperliquid.

Agents and clients

If you already have MCP servers configured, add 0xArchive without replacing the other entries.

claude mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp

codex mcp add 0xarchive --url https://mcp.0xarchive.io/mcp

codex mcp login 0xarchive

{  "mcpServers": {    "0xarchive": {      "url": "https://mcp.0xarchive.io/mcp"    }  }}

{  "servers": {    "0xarchive": {      "type": "http",      "url": "https://mcp.0xarchive.io/mcp"    }  }}

{  "mcpServers": {    "0xarchive": {      "serverUrl": "https://mcp.0xarchive.io/mcp"    }  }}

gemini mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp

/mcp auth 0xarchive

grok mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp

hermes mcp add --url https://mcp.0xarchive.io/mcp --auth oauth 0xarchive

hermes mcp login 0xarchive

openclaw mcp set 0xarchive '{  "url": "https://mcp.0xarchive.io/mcp",  "transport": "streamable-http",  "auth": "oauth",  "oauth": {"scope": "mcp:market.read"}}'

openclaw mcp login 0xarchive

{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "0xarchive": {      "type": "remote",      "url": "https://mcp.0xarchive.io/mcp",      "enabled": true    }  }}

opencode mcp auth 0xarchive

devin mcp add 0xarchive https://mcp.0xarchive.io/mcp

devin mcp login 0xarchive

{  "mcpServers": {    "0xarchive": {      "serverUrl": "https://mcp.0xarchive.io/mcp"    }  }}

Other MCP clients

Use the same server URL with a client that supports Streamable HTTP and OAuth. Let the client discover the authorization server and complete sign-in. Do not substitute an API key or a manually pasted bearer token.

For custom integrations, the server publishes OAuth resource metadata. See the MCP authorization specification for the client flow.

What you can query

• Hyperliquid core perps: market summaries, prices, trades, candles, CVD, funding, open interest, liquidations, L2 and L4 order books, order history, order flow, trigger orders, market breadth, and wallet classification.
• Hyperliquid Spot: pair discovery, trades, candles, order books, L4 snapshots and diffs, order history, TWAP records, and freshness.
• HIP-3 builder perps: market discovery and summaries, trades, candles, CVD, funding, open interest, liquidations, L2 and L4 books, orders, market breadth, oracle external prices and discovery bounds, and wallet classification. Builder-prefixed symbols such as xyz:SP500 identify the market.
• HIP-4 outcome markets: instruments, outcomes and questions, prices, candles, trades, open interest, order history, and L2 and L4 books.
• Lighter (mainnet and Robinhood Chain): market discovery and summaries, trades, candles, funding, open interest, liquidations, and order books; L3 order books on mainnet.
• Account positions: current and historical positions, position changes, and account summaries by Hyperliquid wallet or Lighter account index, plus per-market position listings.
• Webhooks: endpoints, subscriptions, estimate and dry-run previews, watched wallets, and the delivery log, when your client connects with webhook access.

Hyperliquid core and HIP-3 also expose projected forced-liquidation price levels and trigger-price levels. Data-quality tools provide coverage, freshness (including account positions), incident, latency, and status information.

Examples include get_summary, get_hip3_instruments, get_spot_pairs, get_hip4_outcomes, get_lighter_l3_orderbook, and get_symbol_coverage. Your client discovers the available tools and their input schemas when it connects.

Venue and dataset coverage · MCP tool examples · Data quality

Example requests

Market summary

Get a BTC market summary on Hyperliquid. Include the source timestamp.

Funding across venues

Fetch current BTC funding separately for Hyperliquid and Lighter. Show each source's units and timestamp before comparing the values.

Historical candles

Fetch ETH one-hour Hyperliquid candles for the last 24 hours. Summarize the price range and trading volume.

Builder markets

Find the HIP-3 market xyz:SP500 and get its current summary and order book.

Spot markets

Find Hyperliquid Spot pairs for HYPE, then fetch recent trades for the matching pair.

Outcome markets

List unsettled HIP-4 outcomes. Show the question and current price for one of them.

Order-level data

Fetch the current BTC L3 order book on Lighter and show the top bids and asks.

Historical coverage

Check BTC coverage on Hyperliquid for the last 24 hours and list any recorded data incidents in that window.

Working with historical data

Specify the venue, market, and UTC interval. For longer histories, use smaller windows and follow pagination when a cursor is returned. If a response is too large, narrow the request rather than treating the returned portion as the complete dataset.

Keep timestamps and source units with the values, especially when comparing funding across venues. Use market discovery to resolve symbols, and coverage tools to find available history.

For bulk Parquet files, use the Data Catalog. For continuous market-data streams, use the WebSocket API.

Account and access

Sign in with your 0xArchive account. Data access and usage limits follow your 0xArchive plan; your AI client's own subscription and custom-connector permissions are separate.

Troubleshooting

Help

• MCP setup and reference
• Service status
• Report a connection or documentation issue
• Contact 0xArchive

Keep access tokens, API keys, and private account information out of prompts and public issues.