0xarchive

Query crypto market data across Hyperliquid, HIP-3, and Lighter.xyz using natural language in Claude.

79 tools covering orderbooks, trades, candles, funding rates, open interest, liquidations, L4 order-level data, data quality metrics, and wallet-based authentication — from April 2023 to real-time.

Quick Start (30 seconds)

git clone https://github.com/0xArchiveIO/0xarchive-mcp.git
cd 0xarchive-mcp && npm install && npm run build
claude mcp add 0xarchive -s user -t stdio -e OXARCHIVE_API_KEY=0xa_your_api_key -- node $(pwd)/build/index.js

Then ask Claude: "What's BTC's current funding rate?"

Usage Examples

Ask Claude...	Tool that fires
"Give me a BTC market summary"	get_summary
"Show ETH 4h candles for the past week"	get_candles
"What's the current funding rate for SOL?"	get_funding_current
"Compare BTC funding on Hyperliquid vs Lighter"	get_funding_current + get_lighter_funding_current
"Show me SOL liquidations in the last 24 hours"	get_liquidations
"Get BTC orderbook with 20 levels"	get_orderbook
"Any data incidents this month?"	get_data_incidents
"What's the km:US500 price on HIP-3?"	get_hip3_summary
"Show me the SLA report for January 2026"	get_data_sla

Setup (detailed)

1. Install & Build

git clone https://github.com/0xArchiveIO/0xarchive-mcp.git
cd 0xarchive-mcp
npm install
npm run build

2. Get an API Key

Sign up at 0xarchive.io and generate an API key in Dashboard. Or use the web3_challenge and web3_signup tools to get a free API key with just an Ethereum wallet — no browser needed.

3. Add to Claude Code

claude mcp add 0xarchive -s user -t stdio -e OXARCHIVE_API_KEY=0xa_your_api_key -- node /absolute/path/to/0xarchive-mcp/build/index.js

4. Add to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "0xarchive": {
      "command": "node",
      "args": ["/absolute/path/to/0xarchive-mcp/build/index.js"],
      "env": {
        "OXARCHIVE_API_KEY": "0xa_your_api_key"
      }
    }
  }
}

Available Tools (79)

Hyperliquid

Tool	Description
get_instruments	List all Hyperliquid perp/spot instruments
get_instrument	Get a single Hyperliquid instrument by coin
get_orderbook	Current L2 orderbook snapshot
get_orderbook_history	Historical orderbook snapshots
get_trades	Trade/fill history
get_candles	OHLCV candle data
get_funding_current	Current funding rate
get_funding_history	Funding rate history
get_open_interest	Current open interest
get_open_interest_history	Open interest history
get_liquidations	Liquidation history
get_liquidations_by_user	Liquidations for a specific user address
get_liquidation_volume	Aggregated liquidation volume (USD buckets)
get_freshness	Per-coin data freshness and lag
get_summary	Combined market summary (price, funding, OI, volume, liquidations)
get_price_history	Mark/oracle/mid price history

Hyperliquid L4 (Order-Level)

Tool	Description
get_order_history	Order history with user attribution (Build+ tier)
get_order_flow	Aggregated order placement, cancellation, and fill metrics (Build+ tier)
get_tpsl	TP/SL order history with trigger prices and triggered status (Pro+ tier)
get_l4_orderbook	L4 orderbook reconstruction at a specific timestamp (Pro+ tier)
get_l4_diffs	Raw order-level changes (new, modified, cancelled, filled) over a time range (Pro+ tier)
get_l4_orderbook_history	Periodic full order-level orderbook checkpoints (Pro+ tier)

Hyperliquid L2 (Full-Depth)

Tool	Description
get_l2_orderbook	L2 full-depth orderbook derived from L4 (Build+ tier)
get_l2_orderbook_history	Historical L2 full-depth orderbook snapshots (Build+ tier)
get_l2_diffs	L2 tick-level diffs (Pro+ tier)

HIP-3 (Builder Perps)

Tool	Description
get_hip3_instruments	List HIP-3 instruments
get_hip3_instrument	Get a single HIP-3 instrument by coin
get_hip3_orderbook	Current HIP-3 orderbook
get_hip3_orderbook_history	Historical HIP-3 orderbook snapshots
get_hip3_trades	HIP-3 trade history
get_hip3_trades_recent	Most recent HIP-3 trades
get_hip3_candles	HIP-3 candle data
get_hip3_funding_current	Current HIP-3 funding rate
get_hip3_funding	HIP-3 funding history
get_hip3_open_interest	Current HIP-3 open interest
get_hip3_open_interest_history	HIP-3 open interest history
get_hip3_liquidations	HIP-3 liquidation events (Feb 2026+)
get_hip3_liquidation_volume	Aggregated HIP-3 liquidation volume (USD buckets, Feb 2026+)
get_hip3_freshness	Per-coin HIP-3 data freshness and lag
get_hip3_summary	Combined HIP-3 market summary
get_hip3_price_history	HIP-3 mark/oracle/mid price history

HIP-3 L4 (Order-Level)

Tool	Description
get_hip3_order_history	HIP-3 order history with user attribution (Build+ tier)
get_hip3_order_flow	Aggregated HIP-3 order placement, cancellation, and fill metrics (Build+ tier)
get_hip3_tpsl	HIP-3 TP/SL order history with trigger prices and triggered status (Pro+ tier)
get_hip3_l4_orderbook	HIP-3 L4 orderbook reconstruction at a specific timestamp (Pro+ tier)
get_hip3_l4_diffs	HIP-3 raw order-level changes over a time range (Pro+ tier)
get_hip3_l4_orderbook_history	HIP-3 periodic full order-level orderbook checkpoints (Pro+ tier)

HIP-3 L2 (Full-Depth)

Tool	Description
get_hip3_l2_orderbook	HIP-3 L2 full-depth orderbook derived from L4 (Build+ tier)
get_hip3_l2_orderbook_history	HIP-3 L2 full-depth orderbook history (Build+ tier)
get_hip3_l2_diffs	HIP-3 L2 tick-level diffs (Pro+ tier)

Lighter.xyz

Tool	Description
get_lighter_instruments	List Lighter instruments
get_lighter_instrument	Get a single Lighter instrument by coin
get_lighter_orderbook	Current Lighter orderbook
get_lighter_orderbook_history	Historical Lighter orderbook snapshots
get_lighter_trades	Lighter trade history
get_lighter_trades_recent	Most recent Lighter trades
get_lighter_candles	Lighter candle data
get_lighter_funding_current	Current Lighter funding rate
get_lighter_funding	Lighter funding history
get_lighter_open_interest	Current Lighter open interest
get_lighter_open_interest_history	Lighter open interest history
get_lighter_freshness	Per-coin Lighter data freshness and lag
get_lighter_summary	Combined Lighter market summary
get_lighter_price_history	Lighter mark/oracle/mid price history

Lighter L3 (Order-Level)

Tool	Description
get_lighter_l3_orderbook	Current L3 order-level orderbook with order IDs and user addresses (Pro+ tier)
get_lighter_l3_orderbook_history	Historical L3 orderbook snapshots with individual orders (Pro+ tier)

Data Quality

Tool	Description
get_data_quality_status	System health across all exchanges
get_data_coverage	Data coverage (earliest/latest, records, completeness)
get_exchange_coverage	Coverage for a specific exchange
get_symbol_coverage	Per-symbol coverage with gap detection
get_data_incidents	Outage and degradation history
get_incident	Single incident details by ID
get_data_latency	WebSocket/REST latency and data freshness
get_data_sla	Monthly SLA compliance report

Web3 Authentication

Tool	Description
web3_challenge	Get a SIWE challenge message for a wallet address
web3_signup	Create a free-tier account and API key with a signed SIWE message
web3_list_keys	List all API keys for a wallet
web3_revoke_key	Revoke a specific API key
web3_subscribe	Subscribe to a paid tier (build/pro) via x402 USDC payment on Base

Free-tier flow: web3_challenge (get SIWE message) → sign with personal_sign (EIP-191) → web3_signup (submit signature) → receive API key.

Paid-tier flow (x402): web3_subscribe with tier → returns 402 with pricing → sign USDC transfer (EIP-3009 on Base) → web3_subscribe again with payment_signature → receive API key + subscription.

Pricing Tiers

Some endpoints require a paid plan. The server returns clear error messages with upgrade guidance when tier limits are hit.

Tier	Price	Access
Free	$0/mo	BTC-only historical data
Build	$49/mo	All coins, REST API, 25 WS subs
Pro	$199/mo	Full orderbook depth, 100 WS subs
Enterprise	Custom	Tick data, 200 WS subs

Upgrade at 0xarchive.io/pricing.

Tool Annotations

All 79 tools carry MCP annotations so clients can reason about safety and retry behavior.

Market data tools (74):

Annotation	Value	Meaning
readOnlyHint	true	Tools never modify data
destructiveHint	false	No destructive side effects
idempotentHint	true	Safe to retry on failure
openWorldHint	true	Queries an external API

Web3 tools (5): readOnlyHint: false, idempotentHint: false — these create accounts, keys, and subscriptions.

All tools also declare an outputSchema so clients can validate structured responses.

Smart Defaults

• Time range: Defaults to last 24 hours if not specified
• Limit: Defaults to 100 records
• Interval: Defaults to 1h for candles
• Pagination: Returns cursor for next page when more data available
• Timestamps: Accepts both Unix milliseconds and ISO 8601 strings

Bulk Data Downloads

For large-scale data exports (full order books, complete trade history, etc.), use the S3 Parquet bulk export available at 0xarchive.io/data. The Data Explorer lets you select time ranges, symbols, and data types, then download compressed Parquet files directly. The MCP tools are best for point queries and moderate-sized data pulls; for bulk needs, the Data Explorer is significantly faster.