关于 0xarchive Mcp
0xarchive Mcp 是面向交易者、研究者和 Agent 的托管型市场数据 MCP 服务,主要提供只读查询,覆盖 Hyperliquid 和 Lighter。它提供当前及历史数据、账户持仓和覆盖度与时效信息;另行授权后可使用 Webhook 工具。
主要功能
- 01查询 Hyperliquid 和 Lighter 市场数据
- 02获取成交、K 线、资金费率和订单簿
- 03查看持仓与清算数据
- 04检查历史覆盖度和数据时效
- 05获准后管理 Webhook
适用场景
- 01比较不同平台的资金费率数据
- 02查看历史 K 线和交易量
- 03检查市场订单簿
- 04核对数据覆盖度与已记录事件
MCP 相关
通过远程 HTTP 端点向 MCP 客户端提供市场数据和数据质量工具。OAuth 默认授予读取权限;使用 Webhook 工具还需额外的 Webhook 权限范围。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.0xarchive.io/mcpclaude mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp{"mcpServers":{"0xarchive":{"type":"http","url":"https://mcp.0xarchive.io/mcp"}}}在 Cursor 中打开{"servers":{"0xarchive":{"type":"http","url":"https://mcp.0xarchive.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"0xarchive":{"type":"http","url":"https://mcp.0xarchive.io/mcp"}}}{"mcpServers":{"0xarchive":{"serverUrl":"https://mcp.0xarchive.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
连接 · Agent 和客户端 · 数据 · 示例 · 故障排除
通过你的 Agent 查询 Hyperliquid 和 Lighter 的市场数据。使用只读市场数据工具获取当前和历史订单簿、交易、K 线、资金费率、未平仓量、清算、持仓和数据覆盖范围;授予 Webhook 访问权限后,还可以管理 Webhook。
亮点
- 无需密钥,无需安装。 添加一个 URL,通过客户端的 OAuth 流程登录并批准读取权限。
- 兼容所有支持 MCP 的客户端。 Claude Code、Claude 网页版和桌面版、ChatGPT、Codex、Cursor、VS Code、Antigravity 和 Gemini CLI;下方提供了每个客户端的设置步骤。
- 涵盖两个交易平台的所有市场。 Hyperliquid Core 永续合约、HIP-3、HIP-4 和现货,以及主网和 Robinhood Chain 上的 Lighter。
- 默认只读。 市场数据需要
mcp:market.read;只有同时授予 Webhook 作用域时,才会显示 Webhook 工具。
连接
服务 URL
https://mcp.0xarchive.io/mcp
将此 URL 添加为远程 HTTP MCP 服务,然后通过客户端的 OAuth 流程使用你的 0xArchive 账户登录。出现提示时批准 mcp:market.read 权限;如果需要 Webhook 工具,也请批准 mcp:webhooks.read 和 mcp:webhooks.write。无需 0xArchive API 密钥,也无需在本地安装 MCP 服务。
从以下请求开始:
获取 Hyperliquid 上的 BTC 市场摘要。
Agent 和客户端
如果你已经配置了 MCP 服务,可在不替换其他条目的情况下添加 0xArchive。
Claude Code
claude mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp
在 Claude Code 中运行 /mcp,选择 0xarchive,然后选择 Authenticate。在浏览器中完成登录,然后请求 BTC 市场摘要。
Claude 网页版、桌面版和 Cowork
- 在 Claude 中打开 Customize → Connectors。
- 点击 + → Add custom connector。
- 将其命名为
0xArchive,并输入https://mcp.0xarchive.io/mcp。 - 添加连接器,点击 Connect,然后完成 OAuth 登录。
- 在对话中通过 + → Connectors 启用它。
对于 Team 和 Enterprise 工作区,所有者需要先在 Organization settings → Connectors 中添加连接器;随后每位成员连接自己的账户。
ChatGPT
- 在 Settings → Security & Login 中启用 Developer mode。
- 打开 Plugins,并使用 + 按钮添加 MCP 连接。
- 将其命名为
0xArchive,输入https://mcp.0xarchive.io/mcp,然后完成 OAuth 身份验证。 - 开始新对话,并通过 + → More 选择该连接。 ChatGPT MCP 连接指南
Codex CLI 和 IDE 扩展
codex mcp add 0xarchive --url https://mcp.0xarchive.io/mcp
完成 OAuth 登录。如需单独启动身份验证,请运行:
codex mcp login 0xarchive
CLI 和 IDE 扩展共用 MCP 配置。请在 Codex 终端界面中使用 /mcp 检查连接。
Cursor
将此条目添加到项目中的 .cursor/mcp.json。如需为用户范围配置连接,请使用 ~/.cursor/mcp.json。
{
"mcpServers": {
"0xarchive": {
"url": "https://mcp.0xarchive.io/mcp"
}
}
}
打开 Cursor 的 MCP 设置,连接 0xarchive 并完成 OAuth 登录。为 Agent 启用此服务的工具。
VS Code 和 GitHub Copilot
从命令面板运行 MCP: Add Server,选择 HTTP 服务,并输入 https://mcp.0xarchive.io/mcp。
或者将其添加到 .vscode/mcp.json:
{
"servers": {
"0xarchive": {
"type": "http",
"url": "https://mcp.0xarchive.io/mcp"
}
}
}
启动服务并完成浏览器 OAuth 流程。使用 MCP: List Servers 检查其状态,然后在聊天中启用所需工具。
Antigravity CLI 和 Gemini CLI
对于个人 Google 账号,当前建议使用 Antigravity CLI。将以下内容添加到项目中的 .agents/mcp_config.json:
{
"mcpServers": {
"0xarchive": {
"serverUrl": "https://mcp.0xarchive.io/mcp"
}
}
}
在 Antigravity CLI 中打开 /mcp,重新加载配置并检查服务。完成其 OAuth 身份验证提示。请使用 serverUrl,而不是 Gemini CLI 的 httpUrl 字段。
Gemini CLI 仍可通过 Gemini Code Assist Standard/Enterprise 许可证或付费 Google API 访问使用。在项目目录中:
gemini mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp
启动 Gemini 并运行:
/mcp auth 0xarchive
完成浏览器 OAuth 流程。/mcp 会显示服务及其可用工具。
Grok 网页版和 Grok Build
Grok 网页版
- 打开 Grok Connectors。
- 选择 New Connector → Custom。
- 输入
https://mcp.0xarchive.io/mcp并完成 OAuth 登录。 - 在对话中请求 0xArchive 市场数据。
对于 Business 和 Enterprise 组织,团队管理员需要先配置连接器。
Grok Build
grok mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp
首次使用该服务时,Grok 会启动 OAuth 流程。在终端界面中,/mcps 可打开 MCP 设置;按 i 可为所选服务启动身份验证。
Hermes Agent
hermes mcp add --url https://mcp.0xarchive.io/mcp --auth oauth 0xarchive
使用你的 0xArchive 账号进行身份验证:
hermes mcp login 0xarchive
运行 hermes mcp test 0xarchive 检查连接。如果系统提示选择工具,请启用所需的市场和数据工具。
OpenClaw
使用 OAuth 添加远程服务:
openclaw mcp set 0xarchive '{
"url": "https://mcp.0xarchive.io/mcp",
"transport": "streamable-http",
"auth": "oauth",
"oauth": {"scope": "mcp:market.read"}
}'
然后登录:
openclaw mcp login 0xarchive
运行 openclaw mcp doctor 0xarchive --probe 检查连接。使用 OpenClaw 的 MCP 工具控制项,选择哪些 Agent 或会话可以使用该服务。
OpenCode
将此条目添加到 opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"0xarchive": {
"type": "remote",
"url": "https://mcp.0xarchive.io/mcp",
"enabled": true
}
}
}
进行身份验证:
opencode mcp auth 0xarchive
完成浏览器登录。opencode mcp list 会显示身份验证状态。
OpenCode MCP 文档
Windsurf 和 Devin
Devin Local 和 Devin CLI
Devin Local 是新编辑器标签页的默认 Agent,使用 Devin MCP 配置。在项目目录中运行:
devin mcp add 0xarchive https://mcp.0xarchive.io/mcp
然后进行身份验证:
devin mcp login 0xarchive
Cascade
如果使用 Cascade,请将以下内容添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"0xarchive": {
"serverUrl": "https://mcp.0xarchive.io/mcp"
}
}
}
打开 Cascade 的 MCP 设置,启用服务并完成 OAuth 登录。如果达到客户端的工具数量上限,请选择所需的工具。每个使用的客户端都需要单独登录。
Cline
- 打开 Cline 的 MCP 服务面板和 远程服务标签页。
- 将
0xarchive输入为名称,并将https://mcp.0xarchive.io/mcp输入为 URL。 - 选择 Streamable HTTP,然后点击 添加服务。
- 服务请求 OAuth 时,点击 Authenticate,然后在浏览器中完成登录。
如果没有显示 Authenticate,请先更新 Cline,再进行连接。
其他 MCP 客户端
使用支持 Streamable HTTP 和 OAuth 的客户端连接到相同的服务 URL。让客户端发现授权服务器并完成登录。不要改用 API 密钥或手动粘贴的 bearer token。
对于自定义集成,服务会发布 OAuth 资源元数据。客户端流程请参阅 MCP 授权规范。
可查询内容
- Hyperliquid 核心永续合约: 市场摘要、价格、交易、K 线、CVD、资金费率、未平仓合约、强平、L2 和 L4 订单簿、订单历史、订单流、触发订单、市场广度和钱包分类。
- Hyperliquid 现货: 交易对发现、交易、K 线、订单簿、L4 快照和差异、订单历史、TWAP 记录和数据新鲜度。
- HIP-3 builder 永续合约: 市场发现和摘要、交易、K 线、CVD、资金费率、未平仓合约、强平、L2 和 L4 订单簿、订单、市场广度、预言机外部价格和发现范围,以及钱包分类。
xyz:SP500等带有 builder 前缀的符号用于标识市场。 - HIP-4 结果市场: 工具、结果和问题、价格、K 线、交易、未平仓合约、订单历史,以及 L2 和 L4 订单簿。
- Lighter(主网和 Robinhood Chain): 市场发现和摘要、交易、K 线、资金费率、未平仓合约、强平和订单簿;主网上还提供 L3 订单簿。
- 账户持仓: 按 Hyperliquid 钱包或 Lighter 账户索引查询当前和历史持仓、持仓变化及账户摘要,并可查看各市场的持仓列表。
- Webhook: 在客户端以 Webhook 访问权限连接时,可查询端点、订阅、估算和模拟运行预览、监控的钱包以及投递日志。
Hyperliquid 核心市场和 HIP-3 还提供预计的强平价格水平和触发价格水平。数据质量工具可提供覆盖范围、新鲜度(包括账户持仓)、事件、延迟和状态信息。
例如:get_summary、get_hip3_instruments、get_spot_pairs、get_hip4_outcomes、get_lighter_l3_orderbook 和 get_symbol_coverage。连接后,客户端会发现可用工具及其输入架构。
交易场所和数据集覆盖范围 · MCP 工具示例 · 数据质量
示例请求
市场摘要
获取 Hyperliquid 上的 BTC 市场摘要。包含来源时间戳。
跨平台资金费率
分别获取 Hyperliquid 和 Lighter 当前的 BTC 资金费率。比较数值前,先显示各来源的单位和时间戳。
历史 K 线
获取过去 24 小时 Hyperliquid 上的 ETH 一小时 K 线。总结价格范围和交易量。
Builder 市场
查找 HIP-3 市场
xyz:SP500,并获取其当前摘要和订单簿。
现货市场
查找 Hyperliquid 上的 HYPE 现货交易对,然后获取匹配交易对的近期交易记录。
结果市场
列出尚未结算的 HIP-4 结果市场。显示其中一个市场的问题和当前价格。
订单级数据
获取 Lighter 上当前的 BTC L3 订单簿,并显示买盘和卖盘的最优报价。
历史数据覆盖范围
检查 Hyperliquid 上过去 24 小时的 BTC 数据覆盖范围,并列出该时间段内记录的任何数据事件。
使用历史数据
指定交易平台、市场和 UTC 时间区间。查询较长时间范围的历史数据时,请使用较短的时间窗口;如果返回游标,请继续分页。如果响应过大,请缩小请求范围,不要将返回的部分数据当作完整数据集。
保留数值对应的时间戳和来源单位,尤其是在比较不同平台的资金费率时。使用市场发现工具解析交易品种,并使用覆盖范围工具查找可用的历史数据。
如需批量 Parquet 文件,请使用 Data Catalog。如需连续的市场数据流,请使用 WebSocket API。
账户与访问权限
使用 0xArchive 账户登录。数据访问权限和使用限制由你的 0xArchive 套餐决定;AI 客户端自身的订阅和自定义连接器权限则另行计算。
故障排除
| 问题 | 检查事项 |
|---|---|
| 客户端打开文档或报告服务器响应无效 | 使用完整 URL https://mcp.0xarchive.io/mcp,包括 /mcp,并选择 HTTP,而不是 stdio。 |
登录失败或服务器返回 401 | 通过客户端的 OAuth 流程重新连接。移除手动配置的 API 密钥或授权请求头。 |
| 客户端提示 0xArchive 已存在 | 编辑或重新连接现有服务器条目,不要重复添加。 |
| 连接成功,但工具不可用 | 检查客户端的 MCP 启用状态和工具选择;更改配置后,刷新或重启客户端。 |
| 找不到市场 | 使用相应的交易品种、现货交易对或结果市场发现工具。保留 Builder 前缀和符号大小写。 |
| 历史请求无结果或被拒绝 | 检查该市场记录的数据覆盖范围,以及套餐允许的历史数据时间范围。 |
| 请求超时或返回数据过多 | 缩短时间区间、在可用时减少请求的页面大小,或使用 Parquet 导出批量数据集。 |
| 请求受到速率限制 | 等待重试间隔结束,并在重试前检查套餐的使用限制。 |
帮助
请勿在提示词和公开议题中泄露访问令牌、API 密钥及账户私人信息。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。