What are the requirements for 0xArchive MCP?

0xArchive MCP requires the following environment variables: OXARCHIVE_API_KEY (required). You'll also need a compatible MCP client like Claude Desktop or Claude Code.

Is 0xArchive MCP free to use?

Yes, 0xArchive MCP is open source and free to use. You can find the source code on GitHub.

What MCP clients support 0xArchive MCP?

0xArchive MCP works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure 0xArchive MCP?

Configure 0xArchive MCP by adding it to your MCP client's config file. For Claude Desktop, edit claude_desktop_config.json and add the server configuration. See the Configuration section above for a ready-to-use example.

0xArchive MCP Server

Q: What tools does 0xArchive MCP provide?

get_instruments: List all Hyperliquid perp/spot instruments. get_orderbook: Current L2 orderbook snapshot. get_trades: Trade/fill history. get_candles: OHLCV candle data. get_funding_current: Current funding rate. get_liquidations: Liquidation history. get_summary: Combined market summary including price, funding, OI, volume, and liquidations.

Q: How do I install 0xArchive MCP?

Install 0xArchive MCP by running: git clone https://github.com/0xArchiveIO/0xarchive-mcp.git && cd 0xarchive-mcp && npm install && npm run build

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal

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

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal

claude mcp add -e "OXARCHIVE_API_KEY=${OXARCHIVE_API_KEY}" 0xarchive-mcp -- node "<FULL_PATH_TO_0XARCHIVE_MCP>/dist/index.js"

Replace <FULL_PATH_TO_0XARCHIVE_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:OXARCHIVE_API_KEY

README.md

Query crypto market data across Hyperliquid, HIP-3, and Lighter.xyz

0xArchive MCP Server

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

73 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 (73)

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 (Build+ tier)
`get_l4_orderbook_history`	Periodic full order-level orderbook checkpoints (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 202

Tools (7)

get_instrumentsList all Hyperliquid perp/spot instruments

get_orderbookCurrent L2 orderbook snapshot

get_tradesTrade/fill history

get_candlesOHLCV candle data

get_funding_currentCurrent funding rate

get_liquidationsLiquidation history

get_summaryCombined market summary including price, funding, OI, volume, and liquidations

Environment Variables

OXARCHIVE_API_KEYrequiredAPI key for accessing 0xArchive data services

Configuration

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"}}}}

Try it

→Give me a BTC market summary

→Show ETH 4h candles for the past week

→What's the current funding rate for SOL?

→Compare BTC funding on Hyperliquid vs Lighter

→Show me SOL liquidations in the last 24 hours

Frequently Asked Questions

What are the key features of 0xArchive MCP?

Query real-time and historical crypto market data. Access orderbooks, trades, candles, and funding rates. Support for Hyperliquid, HIP-3, and Lighter.xyz. Advanced L4 order-level data and liquidation tracking. Data quality metrics and SLA reporting.

What can I use 0xArchive MCP for?

Analyzing historical market trends for trading strategies. Monitoring real-time funding rates across different protocols. Reconstructing orderbook depth for specific timestamps. Tracking liquidation events for risk management.

How do I install 0xArchive MCP?

Install 0xArchive MCP by running: git clone https://github.com/0xArchiveIO/0xarchive-mcp.git && cd 0xarchive-mcp && npm install && npm run build

What MCP clients work with 0xArchive MCP?

0xArchive MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep 0xArchive MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.

Open Conare

View all other servers →

0xArchive MCP Server

Set the server up locally

Register it in Claude Code

0xArchive MCP Server

Quick Start (30 seconds)

Usage Examples

Setup (detailed)

1. Install & Build

2. Get an API Key

3. Add to Claude Code

4. Add to Claude Desktop

Available Tools (73)

Hyperliquid

Hyperliquid L4 (Order-Level)

HIP-3 (Builder Perps)

Tools (7)

Environment Variables

Configuration

Try it

Frequently Asked Questions

Turn this server into reusable context

Related MCP Servers