快速接入

OpenClaw Bot 用户

将以下 Skill URL 提供给你的 OpenClaw Bot，Bot 会自动完成两件事：

1. 读取 Skill 页面，获取 Hyperbot MCP 的工具说明

2. 根据说明自动安装并连接 Hyperbot MCP 服务器

完成后即可直接提问，全程无需手动操作。

https://clawhub.ai/developHyperbotNetwork/hyperbot-quote-mcp

也可以手动添加 MCP Server：打开 Settings → MCP → Add Server，填入：

• Name：hyperbot-trading

• URL：https://mcp.hyperbot.network/mcp/sse

配置完成后重启 OpenClaw 生效。

---

前置条件： 需要安装 Node.js 18+

• macOS：brew install node

• Windows：前往 https://nodejs.org/ 下载安装

配置文件路径：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

• Windows：%APPDATA%\Claude\claude_desktop_config.json

• Linux (AppImage)：~/.config/Claude/claude_desktop_config.json

配置内容：

{
  "mcpServers": {
    "hyperbot-trading": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
    }
  }
}

安装步骤：

1. 打开 Claude Desktop → Settings → Developer → Edit Config

2. 将上方配置内容填入文件并保存

3. 重启 Claude Desktop（Cmd/Ctrl + R）

4. 在 MCP 工具列表中确认 Hyperbot 工具已出现

---

Cursor 用户

方式一：通过 UI 添加（推荐） 打开 Cursor Settings → Tools & Integrations → MCP → Add New MCP Server，填入：

• Name：hyperbot-trading

• Type：sse

• URL：https://mcp.hyperbot.network/mcp/sse

方式二：直接编辑配置文件 编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "hyperbot-trading": {
      "type": "sse",
      "url": "https://mcp.hyperbot.network/mcp/sse"
    }
  }
}

配置完成后重启 Cursor 生效。 Linux 用户路径： ~/.cursor/mcp.json（同上） 安装验证： 重启后在 MCP 工具列表中确认以下工具已出现：fetch_leader_board、get_whale_positions、get_trader_stats 等。 常见问题排查：

问题	解决方法
工具未出现	重启 Cursor
连接超时	检查网络或防火墙设置
mcp-remote 未找到	运行 npm install -g mcp-remote

---

其他 AI Agent / 自定义接入

如果你在开发自己的 AI Agent 或应用，可以直接将 Hyperbot MCP 集成进来：

参数	值
SSE 端点	https://mcp.hyperbot.network/mcp/sse
消息端点	https://mcp.hyperbot.network/mcp/message
协议	JSON-RPC 2.0

支持直接 SSE URL 的客户端：

{
  "type": "sse",
  "url": "https://mcp.hyperbot.network/mcp/sse"
}

需要 mcp-remote 的客户端（如 Claude Desktop）：

{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://mcp.hyperbot.network/mcp/sse"]
}

获取 sessionId： 先 GET 请求 SSE 端点，从响应中取得 sessionId，后续消息请求携带 ?sessionId={your-session-id} 参数即可。

---

能力全览

以下 22 个数据工具由 Hyperbot MCP 提供；Skills 负责告诉 AI Agent 何时调用哪个工具。两者共同覆盖 Hyperliquid 链上博弈分析的 6 大维度。

聪明钱榜单与发现

工具	能做什么
fetch_leader_board	获取聪明钱排行榜，支持按盈利额或胜率排序，周期 24h / 7d / 30d
find_smart_money	多维度筛选聪明钱地址，9 种排序方式（胜率、ROI、账户余额、持仓数等），可附带 PnL 曲线

市场行情

工具	能做什么
get_tickers	获取所有币种最新价格
get_ticker	获取指定币种最新价格
get_klines	K 线数据，含主动买卖量，支持 1m / 3m / 5m / 15m / 30m / 1h / 4h / 8h / 1d
get_market_stats	当前挂单多空统计、鲸鱼挂单占比、市场中间价
get_l2_order_book	L2 订单簿完整深度

鲸鱼监控

工具	能做什么
get_whale_positions	当前鲸鱼持仓，支持按方向、盈亏、资金费率多维度过滤与排序
get_whale_events	实时鲸鱼开仓 / 平仓事件流
get_whale_directions	当前鲸鱼多空持仓数量统计，可按币种筛选
get_whale_history_ratio	历史多空比走势（1h / 1d 粒度）

交易员分析

工具	能做什么
fetch_trade_history	指定钱包地址的完整历史交易明细
get_trader_stats	综合统计：胜率、盈亏、持仓时长、交易次数
get_max_drawdown	最大回撤，支持 1 / 7 / 30 / 60 / 90 天区间
get_best_trades	周期内收益最高的若干笔交易
get_performance_by_coin	按币种拆分的胜率与盈亏表现

持仓历史

工具	能做什么
get_completed_position_history	已完成仓位的完整历史变动
get_current_position_history	当前持仓的历史状态变化（无持仓时返回 400）
get_completed_position_executions	已平仓位的买卖执行轨迹（可按时间区间和粒度查询）
get_current_position_pnl	当前持仓的盈亏曲线

批量查询

---

数据更新频率

数据类型	更新频率
市场行情 / 鲸鱼仓位	实时
交易员统计	每 5 分钟
聪明钱榜单	每小时
接口频率上限	100 次 / 分钟（单 IP）

---

常见问题

Hyperbot MCP 和 Hyperbot Data API 有什么区别？ 两者底层数据相同，定位不同。MCP + Skills 面向 AI Agent 场景，无需编程，用自然语言驱动；Data API 面向开发者，提供更完整的接口覆盖（包括 WebSocket 实时推送、强平数据、TWAP 等），适合量化系统和产品集成。

Claude Desktop 用户必须安装 Node.js 吗？ 是的，Claude Desktop 通过 mcp-remote 桥接连接远程 MCP 服务器，而 mcp-remote 依赖 Node.js 18+ 运行。macOS 用户可用 brew install node 安装，Windows 用户前往 nodejs.org 下载。

Cursor 还需要单独安装 Skills 吗？ MCP 连接配置（mcp.json）是让 Cursor 能调用 Hyperbot 工具的必要步骤。Skills（npx skills add）是可选的补充——它给 AI 提供更详细的工具使用说明，有助于 AI 更准确地选择和调用工具。

什么是 MCP（Model Context Protocol）？ MCP 是 Anthropic 推出的开放协议，允许 AI 助手通过标准接口调用外部数据和工具服务。Hyperbot MCP 基于该协议，将链上博弈数据封装为 AI 可直接调用的工具集。

数据覆盖哪些链？ 当前 Hyperbot MCP 专注于 Hyperliquid 生态的链上数据，包括聪明钱、鲸鱼持仓、市场行情与交易员分析。

接口有使用限制吗？ 单 IP 每分钟最多调用 100 次；批量查询接口每次最多支持 50 个地址。