mcpField
H
Hyperliquid Data X402

Hyperliquid Data X402

远程服务
github.com数据与分析08 周前更新

关于 Hyperliquid Data X402

Hyperliquid Data X402 通过 Hyperliquid 提供永续合约市场数据,面向需要在 Agent 工作流中获取行情的开发者和交易分析场景。它通过 x402 使用 Base 上的 USDC 按次付费。

主要功能

  1. 01查询 L2 订单簿
  2. 02获取全市场价格与资金费率
  3. 03读取未平仓量和成交量
  4. 04获取 OHLCV K 线

适用场景

  1. 01交易前检查价差和深度
  2. 02筛选市场资金费率
  3. 03分析或回测历史行情

MCP 相关

提供远程 MCP 服务,向兼容客户端开放订单簿、全市场数据和 K 线工具;调用采用 x402 按次支付。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://hyperliquid-data.api.klymax402.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Hyperliquid 永续合约市场数据 API

MCP Server x402 License: MIT

Hyperliquid 永续合约市场数据——订单簿、价格、资金费率、未平仓量、交易量、OHLCV 蜡烛图数据,一站式 API。通过 x402 按次付费(Base L2 上的 USDC)——无需 API 密钥、无需注册,也没有速率限制。

这是 klymax402 市场的一部分——面向 AI Agent 的 100 个 x402 微支付 API,一个钱包即可使用 Base 上的 USDC。

快速入门——MCP

添加到你的 MCP 客户端配置中(Claude Desktop、Cursor、ElizaOS 等):

{
  "mcpServers": {
    "hyperliquid-data": {
      "url": "https://hyperliquid-data.api.klymax402.com/mcp"
    }
  }
}

快速入门——HTTP(x402)

curl "https://hyperliquid-data.api.klymax402.com/api/orderbook?coin=BTC"
# -> 402 Payment Required, with an x402 payment challenge in the response body

任何支持 x402 的客户端(@x402/fetch、x402-agent-tools、ATXP)都会自动处理 402 → 签名 → 重试流程。

工具

工具方法路径价格描述
hyperliquid_get_market_dataGET/api/orderbook$0.003Hyperliquid 永续合约交易对的 L2 订单簿
hyperliquid_get_market_dataPOST/api/orderbook$0.003Hyperliquid 永续合约交易对的 L2 订单簿(POST 变体)
hyperliquid_get_all_marketsGET/api/markets$0.003所有 Hyperliquid 资产的中间价、资金费率、未平仓量和交易量
hyperliquid_get_all_marketsPOST/api/markets$0.003所有 Hyperliquid 资产的中间价、资金费率、未平仓量和交易量(POST 变体)
hyperliquid_get_candlesGET/api/candles$0.002Hyperliquid 永续合约交易对的 OHLCV 蜡烛图数据
hyperliquid_get_candlesPOST/api/candles$0.002Hyperliquid 永续合约交易对的 OHLCV 蜡烛图数据(POST 变体)
hyperliquid_get_market_data

需要查询某种币的 Hyperliquid 永续期货数据时使用。一次调用即可返回完整的 L2 订单簿深度、实时价格和资金费率指标。

参数

名称类型必填描述
coinstring是币种符号(例如 BTC、ETH、SOL、ARB、DOGE)

返回值

  • bids——包含价格和数量的买单档位数组
  • asks——包含价格和数量的卖单档位数组
  • midPrice——当前最佳买价与最佳卖价之间的中间价
  • markPrice——用于强平的预言机标记价格
  • fundingRate——当前每小时资金费率(例如 0.0001 = 0.01%)
  • openInterest——以 USD 计的未平仓总量
  • volume24h——以 USD 计的 24 小时交易量

响应示例:

{"midPrice":67450.5,"markPrice":67448.2,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"bids":[{"price":67450,"size":12.5}],"asks":[{"price":67451,"size":8.3}]}

使用场景:在 Hyperliquid 上进行交易。开仓前检查价差、深度和资金费率必不可少。

hyperliquid_get_market_data

需要查询某种币的 Hyperliquid 永续期货数据时使用。一次调用即可返回完整的 L2 订单簿深度、实时价格和资金费率指标。hyperliquid_get_market_data 的 POST 变体——参数以 JSON 请求体传递,而非查询字符串。

参数

名称类型必填描述
coinstring是币种符号(例如 BTC、ETH、SOL、ARB、DOGE)

返回值

  • bids——包含价格和数量的买单档位数组
  • asks——包含价格和数量的卖单档位数组
  • midPrice——当前最佳买价与最佳卖价之间的中间价
  • markPrice——用于强平的预言机标记价格
  • fundingRate——当前每小时资金费率(例如 0.0001 = 0.01%)
  • openInterest——以 USD 计的未平仓总量
  • volume24h——以 USD 计的 24 小时交易量

响应示例:

{"midPrice":67450.5,"markPrice":67448.2,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"bids":[{"price":67450,"size":12.5}],"asks":[{"price":67451,"size":8.3}]}

使用场景:在 Hyperliquid 上进行交易。开仓前检查价差、深度和资金费率必不可少。

hyperliquid_get_all_markets

需要一次性获取所有 Hyperliquid 永续市场的快照时使用。单次调用即可返回所有已上市资产的价格、资金费率和交易量数据。

参数:无。

返回值

  • markets -- 所有已上市永续资产的数组
  • totalMarkets -- 已上市永续市场的数量
  • timestamp -- ISO 格式的数据时间戳

响应示例:

{"markets":[{"coin":"BTC","midPrice":67450,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"dayChange":2.3},{"coin":"ETH","midPrice":3520,"fundingRate":0.00012,"openInterest":890000000,"volume24h":1200000000,"dayChange":1.1}],"totalMarkets":148}

适用场景:筛选所有 Hyperliquid 市场、查找资金费率最高的市场,或构建市场概览仪表板。

hyperliquid_get_all_markets

需要一次性获取所有 Hyperliquid 永续市场的快照时使用。单次调用即可返回所有已上市资产的价格、资金费率和交易量数据。hyperliquid_get_all_markets 的 POST 变体——参数以 JSON 请求体传递,而不是查询字符串。

参数:无。

返回值

  • markets -- 所有已上市永续资产的数组
  • totalMarkets -- 已上市永续市场的数量
  • timestamp -- ISO 格式的数据时间戳

响应示例:

{"markets":[{"coin":"BTC","midPrice":67450,"fundingRate":0.00008,"openInterest":1250000000,"volume24h":3400000000,"dayChange":2.3},{"coin":"ETH","midPrice":3520,"fundingRate":0.00012,"openInterest":890000000,"volume24h":1200000000,"dayChange":1.1}],"totalMarkets":148}

适用场景:筛选所有 Hyperliquid 市场、查找资金费率最高的市场,或构建市场概览仪表板。

hyperliquid_get_candles

需要获取 Hyperliquid 永续交易对的历史 OHLCV 蜡烛图数据时使用。返回指定周期的开盘价、最高价、最低价、收盘价和交易量。

参数

名称类型必填描述
coinstring是币种符号(例如 BTC、ETH、SOL)
intervalstring否蜡烛图周期(1m、5m、15m、1h、4h、1d)
limitnumber否返回的蜡烛数量(默认 100,最多 5000)

返回值

  • candles -- OHLCV 数据条数组
  • coin -- 查询的币种符号
  • interval -- 使用的蜡烛图周期
  • count -- 返回的蜡烛数量

响应示例:

{"coin":"BTC","interval":"1h","count":100,"candles":[{"timestamp":"2026-04-13T10:00:00Z","open":67200,"high":67550,"low":67100,"close":67450,"volume":45000000}]}

适用场景:进行技术分析、回测策略,或绘制 Hyperliquid 永续市场的历史价格图表。

hyperliquid_get_candles

需要获取 Hyperliquid 永续交易对的历史 OHLCV 蜡烛图数据时使用。返回指定周期的开盘价、最高价、最低价、收盘价和交易量。hyperliquid_get_candles 的 POST 变体——参数以 JSON 请求体传递,而不是查询字符串。

参数

名称类型必填描述
coinstring是币种符号(例如 BTC、ETH、SOL)
intervalstring否蜡烛图周期(1m、5m、15m、1h、4h、1d)
limitnumber否返回的蜡烛数量(默认 100,最多 5000)

返回值

  • candles -- OHLCV 数据条数组
  • coin -- 查询的币种符号
  • interval -- 使用的蜡烛图周期
  • count -- 返回的蜡烛数量

响应示例:

{"coin":"BTC","interval":"1h","count":100,"candles":[{"timestamp":"2026-04-13T10:00:00Z","open":67200,"high":67550,"low":67100,"close":67450,"volume":45000000}]}

适用场景:进行技术分析、回测策略,或绘制 Hyperliquid 永续市场的历史价格图表。

Agent 提示词示例

  • “特定币种的 Hyperliquid 永续期货数据”
  • “特定币种的 Hyperliquid 永续期货数据”
  • “一次性获取所有 Hyperliquid 永续市场的快照”

付款

  • 协议:x402——基于 HTTP 的按次付费,无需注册,无需 API 密钥
  • 网络:Base L2(eip155:8453)
  • 资产:USDC
  • 支付处理方:Coinbase CDP(主要)、PayAI(备用)
  • 也可通过 ATXP 访问(使用 OAuth 封装的 x402,受 RFC 9728 受保护资源元数据保护)

klymax402 的组成部分

面向 AI Agent 的 100 个 x402 微支付 API——一个钱包、Base 上的 USDC、零注册。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。