0xarchive MCP

0x存档MCP服务器

为支持MCP的客户端键入0xArchive市场数据工具。

0xArchive是用于Hyperliquit和Lighter.xyz的粒度市场数据基础架构。HIP-3构建器perps、HIP-4结果市场和Hyperliquit Spot都位于Hyperliquid名称空间下。该服务器公开了111种类型的工具，用于订单簿、交易、蜡烛、资金、未平仓合约、清算、L4/L3订单级数据、结果市场、现货对、TWAP状态、数据质量和钱包管理身份验证。

当您希望在支持MCP的任何客户端（包括启用了MCP的Claude Code、Claude Desktop、Cursor、Codex CLI或IDE设置以及其他代理客户端）上键入工具或共享客户端配置时，请使用MCP。Claude Code和GPT Codex是相等的一流编码代理路径：在任何MCP可用的地方使用此服务器，并使用相同的API密钥与CLI、SDK、技能、， llms.txtOpenAPI和markdown文档，只要shell、repo或文件上下文是更好的途径。

第一个工具结果

MCP服务器发布到npm @0xarchive/mcp-server。全局安装或按需运行 npx:

# Option A: install globally
npm install -g @0xarchive/mcp-server

# Option B: one-shot with npx (no install needed)
npx -y @0xarchive/mcp-server

export OXARCHIVE_API_KEY="0xa_your_api_key"

# Claude Code command mechanics (npx form, no local checkout required)
claude mcp add 0xarchive -s user -t stdio \
  -e OXARCHIVE_API_KEY="$OXARCHIVE_API_KEY" \
  -- npx -y @0xarchive/mcp-server

这 claude mcp add line是Claude Code的设置机制。启用了MCP的Codex CLI或IDE用户应在其Codex MCP配置中注册相同的stdio命令： npx -y @0xarchive/mcp-server.先问一个狭隘的问题：

BTC目前的融资率是多少？

预期结果：客户端调用具体的0xArchive MCP工具并返回现场数据或直接身份验证/配置错误。

代理集成要求

选择此或其他代理路径

使用示例

设置

1.安装

# Global install
npm install -g @0xarchive/mcp-server

# Or run on demand without installing
npx -y @0xarchive/mcp-server

2.获取API密钥

在以下网址创建帐户 0x存档注册，生成一个API密钥，并设置 OXARCHIVE_API_KEY。或使用 web3_challenge 和 web3_signup 只需使用以太坊钱包即可获得免费API密钥，无需浏览器。

3.添加到MCP客户端

Claude Code命令机制：

claude mcp add 0xarchive -s user -t stdio \
  -e OXARCHIVE_API_KEY=0xa_your_api_key \
  -- npx -y @0xarchive/mcp-server

4.添加到克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "0xarchive": {
      "command": "npx",
      "args": ["-y", "@0xarchive/mcp-server"],
      "env": {
        "OXARCHIVE_API_KEY": "0xa_your_api_key"
      }
    }
  }
}

对于GPT Codex和其他代理工作流，只要您的客户端支持本地MCP服务器，就可以使用相同的stdio server命令。如果MCP在那里不可用，则通过CLI、SDK、技能、降价文档路由相同的API密钥， llms.txt或OpenAPI。获取路径是共享的：发出一个经过身份验证的请求，然后扩展到重播、SDK、数据目录导出或代理工具。

可用工具（111）

超流动

超液体L4（订单级别）

超液体L2（全深度）

HIP-3（建筑工人福利）

HIP-3 L4（订单级别）

HIP-3 L2（全深度）

HIP-4（结果市场）

HIP-4硬币使用裸数字格式 ` （例如。 0 对于结果0是， 1 结果0否）。遗产 #0 / %230 表格仍然被接受。 mark_price HIP-4是\[0,1\]中的隐含概率，而不是美元价格。HIP-4没有资金，没有清算，也没有设计蜡烛。监听WebSocket outcome_settled` 当结果解决时通知事件。

超液体点

点对使用虚线规范符号（例如。 HYPE-USDC, PURR-USDC)；服务器解析为Hyperliquit的有线格式(PURR/USDC, @107)内部。294双鞋。Spot没有资金，没有未平仓合约，没有清算，也没有设计蜡烛（这些都是perp独有的构造）。覆盖范围：2025-03-22年的交易（HL S3回填）；订单簿、L4和TWAP状态将于2026年5月5日生效。

打火机.xyz

打火机L3（订单级别）

数据质量

实时WebSocket通道

MCP服务器公开历史REST端点。为了实时，将任何WebSocket客户端指向 wss://api.0xarchive.io/ws?apiKey=... 并订阅：

任何WebSocket访问都需要构建+层；适用于L4通道的Pro+。

Web3身份验证

自由层流量： web3_challenge （获取SIWE消息）→ 签署 personal_sign （EIP-191）→ web3_signup （提交签名）→ 接收API密钥。

付费层流（x402）： web3_subscribe 带层→ 返回402及其定价→ 签署USDC转账（基础上的EIP-3009）→ web3_subscribe 再次与 payment_signature → 接收API密钥+订阅。

定价层级

某些端点需要付费计划。当达到层限制时，服务器会返回明确的错误消息和升级指导。

升级至 0xarchive.io/定价.

工具注释

所有111个工具都带有MCP注释，因此客户端可以推断安全性并重试行为。

市场数据工具（106）：

Web3工具（5）： readOnlyHint: false, idempotentHint: false。这些创建帐户、密钥和订阅。

所有工具还声明 outputSchema 因此客户端可以验证结构化响应。

智能默认值

• 时间范围：如果未指定，则默认为持续24小时
• 限制：默认为100条记录
• 间隔：蜡烛默认为1小时
• 分页：当有更多数据可用时，返回下一页的光标
• 时间戳：接受Unix毫秒和ISO 8601字符串

数据目录

对于大规模数据导出（完整的订单簿、完整的交易历史等），请使用 数据目录。它允许您选择市场、数据集和日期范围，查看实时报价，并导出zstd压缩的Parquet。MCP工具最适合键入点查询和适度的数据拉取；数据目录是文件导出路径。