Hydromancer

Hydromancer MCP

使用来自 Hydromancer API 的实时数据，用简单的英语向 AI 询问 Hyperliquid 相关问题。

**披露：**此软件包由 Hydromancer 团队维护。使用它需要 Hydromancer API 密钥。

“这个钱包持有哪些资产？它是个不错的交易者吗？” “本周表现最好的交易者是谁？排除机器人。” “过去 6 小时里，谁被强制平仓了？” “我最多可以卖出多少 BTC，才不会让价格变动 0.5%？”

你的 AI 会选择合适的工具，调用 Hydromancer 并解释答案。你不必阅读 API 文档、编写代码或计算时间戳。

• 19 个只读工具：钱包、交易、顶级交易者、市场、强制平仓、构建者、预测市场
• 适用于任何 MCP 应用：Claude Desktop、Claude Code、Cursor、Codex、VS Code（Copilot）、Gemini CLI、Windsurf、Cline 等
• 输入简单灵活：币种名称不区分大小写（btc、$ETH、ETH-PERP、xyz:tsla），时间可使用 24h、7d 或 2026-10-01 等格式
• 安全：只读。它无法下单、撤单或签名，也绝不会接触资金或私钥
• 密钥保留在本地：它会从应用设置中读取密钥，且只会将密钥发送到 api.hydromancer.xyz（如果你设置了测试网，则发送到 api-testnet.hydromancer.xyz）

1. 获取 Hydromancer API 密钥

请参阅获取 API 密钥。早期阶段的团队可能符合免费使用资格。

2. 将密钥添加到 AI 应用

你需要安装 20 或更高版本的 Node.js。将 YOUR_KEY 替换为你的密钥。

Claude Desktop

打开“Settings → Developer → Edit Config”，然后添加：

{
  "mcpServers": {
    "hydromancer": {
      "command": "npx",
      "args": ["-y", "hydromancer-mcp"],
      "env": { "HYDROMANCER_API_KEY": "YOUR_KEY" }
    }
  }
}

重启 Claude Desktop。

Claude Code

claude mcp add hydromancer -e HYDROMANCER_API_KEY=YOUR_KEY -- npx -y hydromancer-mcp

Cursor

~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：使用与 Claude Desktop 相同的 mcpServers 配置块。

Codex

~/.codex/config.toml：

[mcp_servers.hydromancer]
command = "npx"
args = ["-y", "hydromancer-mcp"]
env = { HYDROMANCER_API_KEY = "YOUR_KEY" }

VS Code（GitHub Copilot）

.vscode/mcp.json：

{
  "servers": {
    "hydromancer": {
      "command": "npx",
      "args": ["-y", "hydromancer-mcp"],
      "env": { "HYDROMANCER_API_KEY": "YOUR_KEY" }
    }
  }
}

使用本地副本

git clone https://github.com/joshavenue/Hydromancer-MCP && cd Hydromancer-MCP
npm install && npm run build

然后使用 "command": "node" 和 "args": ["/full/path/to/Hydromancer-MCP/dist/index.js"]。

3. 提问

试试：

• 概述一下钱包 0x…，并告诉我它是不是个不错的交易者。
• 列出过去 7 天按利润排名的前 10 名交易者，排除机器人，然后告诉我排名前 3 的交易者目前持有哪些资产。
• 以下哪些钱包的资产超过 $1M：0x…、0x…、0x…？
• 过去 6 小时里，谁在 Hyperliquid 上被强制平仓了？是多头还是空头？
• BTC、ETH 和 HYPE：价格、24 小时交易量和未平仓量。
• 今天 ETH 的未平仓量是在上升还是下降？
• 过去一周 BTC 的资金费率平均值是多少？折算成年化是多少？
• 构建者 0x… 在过去一小时赚取了多少手续费？

工具

工具	解答内容
hydromancer_wallet_overview	余额（适用于统一账户和投资组合保证金钱包）、账户模式、未平仓头寸（入场价、清算价、杠杆、PnL）、现货余额、交易记录、机器人评分
hydromancer_compare_wallets	一次最多比较 1,000 个钱包，显示余额和账户模式，并按余额排序
hydromancer_wallet_trades	时间范围内的成交记录，包括交易量、PnL、费用和各币种汇总
hydromancer_wallet_closed_trades	往返交易：胜率、净 PnL、持仓时间、表现最佳的币种
hydromancer_wallet_open_orders	挂单限价单、止损单、止盈单
hydromancer_wallet_transfers	存款、取款、转账、金库间转移、清算
hydromancer_wallet_funding	各币种已支付或已收到的资金费
hydromancer_top_traders	按利润、胜率或交易量排列的排行榜，可筛选机器人和活跃度
hydromancer_market_snapshot	价格、24 小时交易量和未平仓合约量（热门市场列表中显示最大杠杆）
hydromancer_price_history	1 秒至 1 个月的蜡烛图（包括 15s 和 30s）
hydromancer_funding_history	资金费率、平均值和年化值
hydromancer_open_interest_history	未平仓合约量趋势，按 1 分钟至 1 个月的区间汇总
hydromancer_recent_liquidations	按市场显示的清算情况，包括多头和空头总量
hydromancer_market_depth	订单簿深度，以及指定交易规模下的滑点
hydromancer_list_markets	所有市场、HIP-3 交易所，以及按名称或类别搜索
hydromancer_builder_activity	某个构建者应用的交易量、用户数和费用
hydromancer_prediction_markets	已结算的 HIP-4 预测市场
hydromancer_my_usage	你自己的 API 使用情况和令牌
hydromancer_raw_request	任何其他 Hydromancer /info 请求

此服务还提供 hydromancer_guide 提示词和 hydromancer://guide 资源，告知 AI 应针对不同问题使用哪个工具。

设置

变量	默认值	用途
HYDROMANCER_API_KEY	（必需）	你的 API 密钥
HYDROMANCER_BASE_URL	https://api.hydromancer.xyz/info	API 端点。仅接受 Hydromancer 主网和测试网主机。
HYDROMANCER_TIMEOUT_MS	30000	请求超时时间
HYDROMANCER_MAX_RESULT_CHARS	40000	单个工具结果的上限，避免 AI 收到过多信息

须知

• 每次调用工具都会消耗你的 Hydromancer 套餐令牌，与任何 API 请求一样。使用 hydromancer_my_usage 查看用量。
• 仅限主网。HIP-3 市场使用前缀，例如 xyz:TSLA。
• 余额：统一账户和投资组合保证金钱包将资金存放在现货中，因此 balanceUsd 使用其现货稳定币余额。其他现货代币会列出，但不计价。
• 时间均为 UTC。部分端点会限制单次请求的数量（例如 2,000 条成交记录）；达到限制时，工具会提示。

开发

npm install
npm run build
npm test                                   # offline unit tests
HYDROMANCER_API_KEY=... npm run smoke      # calls every tool against the live API

Hydromancer 博客精选

获取和使用 Hyperliquid 数据的指南与研究：

• 如何查询 Reservoir 的 Hyperliquid 数据
• Hyperliquid 与 Hydromancer API：何时升级？
• 如何查看 Hyperliquid 上交易者的完整仓位
• 如何为你的 Hyperliquid 节点寻找可靠的对等节点
• Hyperliquid Builder Codes：工作原理及费用追踪方法
• Hyperliquid 测试网指南：水龙头、API URL 和主网注意事项
• Hyperliquid 费用与收入：面向构建者的指南
• HyperCore 与 HyperEVM：Hyperliquid 是 L1 还是 L2？
• Hyperliquid 最小价格变动单位和最小交易数量：价格与数量取整
• 如何构建 Hyperliquid 订单簿热力图
• Hyperliquid Vaults API：追踪表现和存款人
• 如何获取 Hyperliquid 钱包的交易历史（API + 批量）
• Hyperliquid 资金费率：运作方式及历史记录
• 如何构建 Hyperliquid 跟单交易机器人
• 如何构建 Hyperliquid 交易机器人
• Hyperliquid 排行榜：如何追踪顶级地址的盈亏
• 如何阅读 Hydromancer 实时统计页面
• Hyperliquid 速率限制：是什么及解决方案
• HIP-3 市场部署方排行榜
• Hyperliquid API 指南：端点、API 密钥、限制和 Python 示例
• Hyperliquid 上的顶级自营交易公司：并列比较
• 如何利用 Hyperliquid 的清算数据进行构建
• 如何构建 Hyperliquid 巨鲸追踪器（实时仓位、成交和提醒）

许可证

MIT