hyperliquid-info-mcp

Hyperliquid Info MCP

一个 MCP 服务，为 Claude、Cursor 及任何兼容 MCP 的 Agent 提供来自 Hyperliquid 的实时市场和账户数据——永续合约和现货价格、资金费率、未平仓量、订单簿和钱包持仓。

无需 API 密钥。无需注册。Hyperliquid 公共信息 API 免费使用。

大多数“X 的 MCP”仓库都只完成了一半，第二次请求就会出错。这个项目带有测试和完善的错误处理，让 Agent 真正可以依赖它。

你的 Agent 可以做什么

可以询问：

• “现在 Hyperliquid 上 24 小时交易量最高的永续合约有哪些？”
• “显示 BTC 永续合约的标记价格、资金费率和未平仓量。”
• “哪些永续合约的资金费率最高？”（寻找套利 / 基差机会）
• “BTC 的订单簿和价差是多少？”
• “过去 48 小时 ETH 的资金费率走势如何？”
• “今天 Hyperliquid 现货市场涨幅最大和跌幅最大的币种有哪些？”
• “显示钱包 0xabc... 的未平仓头寸和盈亏。”

工具

工具	功能
get_all_mids	所有市场的当前中间价，可按指定币种筛选
get_perp_markets	所有永续合约，按交易量 / 未平仓量 / 资金费率 / 涨跌幅 / 涨幅榜 / 跌幅榜排序
get_market	单个永续合约的详细快照：标记价格 / 预言机价格 / 中间价、24 小时涨跌幅和交易量、资金费率、未平仓量、溢价、杠杆
get_funding_history	永续合约在 N 小时窗口内的资金费率历史及平均值
get_order_book	永续合约或现货交易对的实时 L2 订单簿（最佳买价 / 卖价 + 价差）
get_spot_markets	现货市场（HYPE、PURR 等），按交易量 / 涨跌幅排序
get_user_state	任意钱包的永续合约账户状态：价值、保证金和带有盈亏及强平价格的未平仓头寸

安装

无需安装。可直接通过 npx 从 npm 运行。

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "hyperliquid-info-mcp"]
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "hyperliquid-info-mcp"]
    }
  }
}

重启客户端后，即可使用 hyperliquid 工具。

说明

• 所有数据均为来自公共 https://api.hyperliquid.xyz/info 端点的只读市场 / 账户信息。本服务不会下单，也不需要私钥。
• 资金费率同时显示每小时费率（Hyperliquid 的收费方式）和年化费率，交易者通常会比较年化费率。
• get_user_state 适用于任何公开钱包地址——它读取的数据与区块浏览器显示的数据相同。

开发

npm install
npm run dev     # run from TypeScript source over stdio
npm test        # run the unit tests
npm run build   # compile to dist/

许可证

MIT——参见 LICENSE。

---

聘请我

我构建定制 MCP 服务和 AI 系统（多 Agent、RAG、自动化）。需要连接你自己的 API，或进行完整的 AI 集成？

• 在 Upwork 上聘请我：https://www.upwork.com/freelancers/~01946645ed245c263d
• 或在此仓库中提交问题。

由 Gleb 构建。