Ironflow: Hyperliquid data

@ironflowsh/mcp

适用于 Ironflow 的 MCP 服务，为 Claude、Cursor 和任何 MCP 客户端提供只读的 Hyperliquid 市场数据和钱包分析。涵盖原生永续合约、HIP-3 构建者市场、HIP-4 结果市场和现货。提供 41 个工具，全部为只读工具，包括 run_query，可对所有 Hyperliquid 成交、钱包、资金费率和清算数据表运行只读 SQL。

启动时无需 API 密钥：无密钥调用每分钟可请求 30 次、每天 2,000 次，并可访问 24 小时的历史数据。通过 ironflow.sh/key 免费获取密钥后，限额将提升至每分钟 60 次，并可访问 30 天的历史数据。

安装

托管服务无需安装或密钥：https://mcp.ironflow.sh/mcp（Streamable HTTP）。

Claude Code

claude mcp add --transport http ironflow https://mcp.ironflow.sh/mcp

Claude（claude.ai 和 Claude Desktop）：打开 Customize → Connectors，点击 Add custom connector，输入名称 Ironflow 和 URL https://mcp.ironflow.sh/mcp，然后点击 Add。在 Team 和 Enterprise 套餐中，Owner 可在 Organization settings → Connectors → Add → Custom 中添加，之后成员点击 Connect 即可。

Cursor：点击上方按钮，或将以下内容添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "ironflow": { "url": "https://mcp.ironflow.sh/mcp" }
  }
}

VS Code：点击上方按钮，或使用

code --add-mcp '{"name":"ironflow","type":"http","url":"https://mcp.ironflow.sh/mcp"}'

本地服务（stdio）：npx -y @ironflowsh/mcp，参见本地服务。

使用免费密钥

将其作为 Authorization: Bearer if_your_api_key 发送；对于无法设置标头的客户端，也可在 URL 中使用 ?key=if_your_api_key。

claude mcp add --transport http ironflow https://mcp.ironflow.sh/mcp \
  --header "Authorization: Bearer if_your_api_key"

在 Cursor 中，将 "headers": { "Authorization": "Bearer if_your_api_key" } 添加到 url 旁边。

本地服务

npx -y @ironflowsh/mcp

需要 Node.js 18+。Claude Desktop 配置（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "ironflow": {
      "command": "npx",
      "args": ["-y", "@ironflowsh/mcp"],
      "env": { "IRONFLOW_API_KEY": "if_your_api_key" }
    }
  }
}

env 块为可选项。Claude Code：claude mcp add ironflow -- npx -y @ironflowsh/mcp。

要自行托管 HTTP 服务：npx -y -p @ironflowsh/mcp ironflow-mcp-http（监听 PORT，默认值为 8080，路径为 /mcp）。

工具

随意提问（SQL）： describe_data 列出可查询的表、列和示例查询；run_query 在这些数据上执行一条只读的 ClickHouse SELECT 查询（每笔成交、每个钱包的每日总额、行为标签、资金流、标记价格和预言机价格、未平仓量、强平、构建者代码成交、转账、金库流动）；get_wallet_behavior 返回每个钱包过去 30 天的交易风格标签。无需密钥的查询可查看过去 24 小时的数据；使用免费密钥可查看 30 天的数据。

市场数据： get_price、get_recent_trades、get_candles、get_funding_rates、get_open_interest、get_open_interest_changes、get_premium、get_outcome_markets、get_liquidations、get_liquidation_summary、get_auto_deleveraging、get_fills、get_mark_prices、get_vault_operations、list_markets、get_markets_snapshot

市场分析： get_funding_stats、get_pnl_leaderboard、get_market_top_wallets、get_wallet_labels、get_vault_leaderboard 和 get_liquidation_levels（需要 Builder 或 Enterprise 密钥）

信号： get_top_traders、get_market_leaders、get_early_movers、get_trader_profile

钱包分析： get_user_state、get_positions_at、get_user_summary、get_user_pnl_series、get_user_funding、get_user_maker_taker、get_user_ledger

群组： list_cohorts、get_cohort_addresses

状态： get_status、get_status_metrics、get_status_history

市场可使用显示符号（BTC-PERP、xyz:NVDA-PERP、HYPE/USDC）或 Hyperliquid 名称（BTC、@107、xyz:NVDA）指定；时间可使用 Unix 毫秒、Unix 秒或 ISO 8601 格式。当 API 读取名称，或因密钥的历史记录限制而返回从晚于请求时间的窗口开始的数据时，结果会以说明这一情况的 notice 开头。成交历史覆盖滚动的 12 个月。没有订单簿、订单状态或流式传输工具。

配置

环境变量	默认值
IRONFLOW_API_KEY	可选；可在 ironflow.sh/key 获取免费密钥
IRONFLOW_API_URL	https://api.ironflow.sh
PORT（HTTP 服务）	8080
MCP_LOG_SALT（HTTP 服务）	每个进程随机生成；用于对访问日志中的调用方进行哈希

使用数据

每次 API 调用都会携带两个标头，以便我们了解用户使用哪些应用和工具：X-Ironflow-Client（MCP 客户端的名称和版本，例如 claude-code/2.1.0）和 X-Ironflow-Tool（工具名称）。托管服务会记录每个请求的方法、工具参数、客户端名称、状态、工具是否返回错误、背后的 API 状态和错误代码，以及调用方 IP 的加盐哈希。它绝不会记录 IP 或 API 密钥。

链接

• 文档：docs.ironflow.sh
• API 参考：docs.ironflow.sh/api-reference
• Hyperliquid 节点指南：ironflow.sh/guides

许可证

MIT