0xArchive MCP 服务器

在 Claude 中使用自然语言查询 Hyperliquid、HIP-3 和 Lighter.xyz 的加密市场数据。

包含 79 个工具，涵盖订单簿、交易、K 线、资金费率、持仓量、清算、L4 订单级数据、数据质量指标以及基于钱包的身份验证——数据范围从 2023 年 4 月至今，支持实时查询。

快速入门 (30 秒)

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

然后询问 Claude：“BTC 当前的资金费率是多少？”

使用示例

询问 Claude...	触发的工具
“给我一份 BTC 市场摘要”	`get_summary`
“显示过去一周 ETH 的 4 小时 K 线”	`get_candles`
“SOL 当前的资金费率是多少？”	`get_funding_current`
“比较 Hyperliquid 和 Lighter 上的 BTC 资金费率”	`get_funding_current` + `get_lighter_funding_current`
“显示过去 24 小时内 SOL 的清算情况”	`get_liquidations`
“获取 20 档的 BTC 订单簿”	`get_orderbook`
“本月有任何数据异常吗？”	`get_data_incidents`
“HIP-3 上 km:US500 的价格是多少？”	`get_hip3_summary`
“显示 2026 年 1 月的 SLA 报告”	`get_data_sla`

设置 (详细)

1. 安装与构建

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

2. 获取 API 密钥

在 0xarchive.io 注册并在仪表板中生成 API 密钥。或者使用 web3_challenge 和 web3_signup 工具，仅需以太坊钱包即可获取免费 API 密钥——无需浏览器。

3. 添加到 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. 添加到 Claude Desktop

添加到你的 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"
      }
    }
  }
}

可用工具 (79)

Hyperliquid

工具	描述
`get_instruments`	列出所有 Hyperliquid 永续/现货交易对
`get_instrument`	按币种获取单个 Hyperliquid 交易对
`get_orderbook`	当前 L2 订单簿快照
`get_orderbook_history`	历史订单簿快照
`get_trades`	交易/成交历史
`get_candles`	OHLCV K 线数据
`get_funding_current`	当前资金费率
`get_funding_history`	资金费率历史
`get_open_interest`	当前持仓量
`get_open_interest_history`	持仓量历史
`get_liquidations`	清算历史
`get_liquidations_by_user`	特定用户地址的清算记录
`get_liquidation_volume`	汇总清算量 (USD 分桶)
`get_freshness`	各币种数据新鲜度和延迟
`get_summary`	综合市场摘要 (价格、资金费率、持仓量、成交量、清算)
`get_price_history`	标记/预言机/中间价历史

Hyperliquid L4 (订单级)

工具	描述
`get_order_history`	包含用户归属的订单历史 (Build+ 层级)
`get_order_flow`	汇总的订单挂单、撤单和成交指标 (Build+ 层级)
`get_tpsl`	包含触发价格和触发状态的 TP/SL 订单历史 (Pro+ 层级)
`get_l4_orderbook`	特定时间戳的 L4 订单簿重构 (Pro+ 层级)
`get_l4_diffs`	时间范围内的原始订单级变更 (新增、修改、取消、成交) (Pro+ 层级)
`get_l4_orderbook_history`	定期的完整订单级订单簿检查点 (Pro+ 层级)

Hyperliquid L2 (全深度)

工具	描述
`get_l2_orderbook`	基于 L4 推导的 L2 全深度订单簿 (Build+ 层级)
`get_l2_orderbook_history`	历史 L2 全深度订单簿快照 (Build+ 层级)
`get_l2_diffs`	L2 逐笔差异 (Pro+ 层级)

HIP-3 (Builder Perps)

工具	描述
`get_hip3_instruments`	列出 HIP-3 交易对
`get_hip3_instrument`	按币种获取单个 HIP-3 交易对
`get_hip3_orderbook`	当前 HIP-3 订单簿
`get_hip3_orderbook_history`	历史 HIP-3 订单簿快照
`get_hip3_trades`	HIP-3 交易历史
`get_hip3_trades_recent`	最近的 HIP-3 交易
`get_hip3_candles`	HIP-3 K 线数据
`get_hip3_funding_current`	当前 HIP-3 资金费率
`get_hip3_funding`	HIP-3 资金费率历史
`get_hip3_open_interest`	当前 HIP-3 持仓量
`get_hip3_open_interest_history`	HIP-3 持仓量历史
`get_hip3_liquidations`	HIP-3 清算事件 (2026 年 2 月起)
`get_hip3_liquidation_volume`	汇总的 HIP-3 清算量 (USD 分桶，2026 年 2 月起)
`get_hip3_freshness`	各币种 HIP-3 数据新鲜度和延迟
`get_hip3_summary`	综合 HIP-3 市场摘要
`get_hip3_price_history`	HIP-3 标记/预言机/中间价历史

HIP-3 L4 (订单级)

工具	描述
`get_hip3_order_history`	包含用户归属的 HIP-3 订单历史 (Build+ 层级)
`get_hip3_order_flow`	汇总的 HIP-3 订单挂单、撤单和成交指标 (Build+ 层级)
`get_hip3_tpsl`	包含触发价格和触发状态的 HIP-3 TP/SL 订单历史 (Pro+ 层级)
`get_hip3_l4_orderbook`	特定时间戳的 HIP-3 L4 订单簿重构 (Pro+ 层级)
`get_hip3_l4_diffs`	时间范围内的 HIP-3 原始订单级变更 (Pro+ 层级)
`get_hip3_l4_orderbook_history`	HIP-3 定期完整订单级订单簿检查点 (Pro+ 层级)

HIP-3 L2 (全深度)

工具	描述
`get_hip3_l2_orderbook`	基于 L4 推导的 HIP-3 L2 全深度订单簿 (Build+ 层级)
`get_hip3_l2_orderbook_history`	HIP-3 L2 全深度订单簿历史 (Build+ 层级)
`get_hip3_l2_diffs`	HIP-3 L2 逐笔差异 (Pro+ 层级)

Lighter.xyz

工具	描述
`get_lighter_instruments`	列出 Lighter 交易对
`get_lighter_instrument`	按币种获取单个 Lighter 交易对
`get_lighter_orderbook`	当前 Lighter 订单簿
`get_lighter_orderbook_history`	历史 Lighter 订单簿快照
`get_lighter_trades`	Lighter 交易历史
`get_lighter_trades_recent`	最近的 Lighter 交易
`get_lighter_candles`	Lighter K 线数据
`get_lighter_funding_current`	当前 Lighter 资金费率
`get_lighter_funding`	Lighter 资金费率历史
`get_lighter_open_interest`	当前 Lighter 持仓量
`get_lighter_open_interest_history`	Lighter 持仓量历史
`get_lighter_freshness`	各币种 Lighter 数据新鲜度和延迟
`get_lighter_summary`	综合 Lighter 市场摘要
`get_lighter_price_history`	Lighter 标记/预言机/中间价历史

Lighter L3 (订单级)

工具	描述
`get_lighter_l3_orderbook`	包含订单 ID 和用户地址的当前 L3 订单级订单簿 (Pro+ 层级)
`get_lighter_l3_orderbook_history`	包含单个订单的历史 L3 订单簿快照 (Pro+ 层级)

数据质量

工具	描述
`get_data_quality_status`	所有交易所的系统健康状况
`get_data_coverage`	数据覆盖范围 (最早/最新、记录数、完整性)
`get_exchange_coverage`	特定交易所的覆盖范围
`get_symbol_coverage`	各交易对的覆盖范围及缺口检测
`get_data_incidents`	中断和降级历史
`get_incident`	按 ID 获取单个事件详情
`get_data_latency`	WebSocket/REST 延迟和数据新鲜度
`get_data_sla`	每月 SLA 合规报告

Web3 身份验证

工具	描述
`web3_challenge`	获取钱包地址的 SIWE 挑战消息
`web3_signup`	使用已签名的 SIWE 消息创建免费层级账户和 API 密钥
`web3_list_keys`	列出钱包的所有 API 密钥
`web3_revoke_key`	撤销特定 API 密钥
`web3_subscribe`	通过 Base 链上的 x402 USDC 支付订阅付费层级 (build/pro)

免费层级流程： web3_challenge (获取 SIWE 消息) → 使用 personal_sign (EIP-191) 签名 → web3_signup (提交签名) → 接收 API 密钥。

付费层级流程 (x402)： 使用层级调用 web3_subscribe → 返回包含定价的 402 错误 → 签署 USDC 转账 (Base 链上的 EIP-3009) → 再次调用 web3_subscribe 并附带 payment_signature → 接收 API 密钥 + 订阅。

定价层级

部分端点需要付费计划。当达到层级限制时，服务器会返回清晰的错误消息及升级指南。

层级	价格	访问权限
免费	$0/月	仅限 BTC 历史数据
Build	$49/月	所有币种、REST API、25 个 WS 订阅
Pro	$199/月	全深度订单簿、100 个 WS 订阅
企业	定制	逐笔数据、200 个 WS 订阅

请在 0xarchive.io/pricing 升级。

工具注解

所有 79 个工具均带有 MCP 注解，以便客户端判断安全性和重试行为。

市场数据工具 (74)：

注解	值	含义
`readOnlyHint`	`true`	工具从不修改数据
`destructiveHint`	`false`	无破坏性副作用
`idempotentHint`	`true`	失败时可安全重试
`openWorldHint`	`true`	查询外部 API

Web3 工具 (5)： readOnlyHint: false, idempotentHint: false — 这些工具用于创建账户、密钥和订阅。

所有工具还声明了 outputSchema，以便客户端验证结构化响应。

智能默认值

时间范围：未指定时默认为过去 24 小时
限制：默认为 100 条记录
间隔：K 线默认为 1 小时
分页：当有更多数据时返回下一页的游标
时间戳：同时接受 Unix 毫秒和 ISO 8601 字符串

批量数据下载

对于大规模数据导出（完整订单簿、完整交易历史等），请使用 0xarchive.io/data 提供的 S3 Parquet 批量导出功能。数据浏览器允许你选择时间范围、交易对和数据类型，然后直接下载压缩的 Parquet 文件。MCP 工具最适合点查询和中等规模的数据提取；对于批量需求，数据浏览器的速度显著更快。

0xarchive-mcp