Skillget

0xarchive-mcp

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Uyari
  • process.env — Environment variable access in src/index.ts
  • network request — Outbound network request in src/index.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This MCP server acts as a bridge allowing AI models (like Claude) to query historical and real-time cryptocurrency market data—such as orderbooks, trades, and funding rates—from exchanges like Hyperliquid and Lighter.xyz using natural language.

Security Assessment
Overall risk: Medium. The tool requires an API key passed via environment variables, which is a standard and secure practice. There are no hardcoded secrets, no execution of dangerous shell commands, and it does not request broad system permissions. However, it actively makes outbound network requests to fetch market data. Because it handles financial information and makes external API calls on behalf of the user, developers should ensure it is only connected to trusted AI environments to prevent prompt injection attacks from triggering unintended API calls or leaking their API key.

Quality Assessment
The codebase is open-source under the permissive and standard MIT license. The project is very new and currently has low visibility, evidenced by only having 5 GitHub stars. While this indicates a low level of community scrutiny and testing, it appears to be actively maintained (updated recently). Users should expect limited community support if issues arise.

Verdict
Use with caution. The code itself follows standard security practices for managing API keys, but the combination of low community trust, active outbound network requests, and financial data requires users to verify the code themselves and restrict its use to secure, controlled environments.
SUMMARY

MCP server for querying historical and real-time crypto market data across Hyperliquid, Hyperliquid HIP-3, and Lighter.xyz - orderbooks, trades, candles, funding, open interest, liquidations, and data quality metrics.

README.md

0xArchive MCP Server

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.

Yorumlar (0)

Sonuc bulunamadi