关于 Hyperliquid Data X402
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://hyperliquid-data.api.klymax402.com/mcpclaude mcp add --transport sse hyperliquid-data-x402 https://hyperliquid-data.api.klymax402.com/mcp{"mcpServers":{"hyperliquid-data-x402":{"type":"sse","url":"https://hyperliquid-data.api.klymax402.com/mcp"}}}在 Cursor 中打开{"servers":{"hyperliquid-data-x402":{"type":"sse","url":"https://hyperliquid-data.api.klymax402.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"hyperliquid-data-x402":{"type":"sse","url":"https://hyperliquid-data.api.klymax402.com/mcp"}}}{"mcpServers":{"hyperliquid-data-x402":{"serverUrl":"https://hyperliquid-data.api.klymax402.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Hyperliquid 永续合约市场数据 API
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_data | GET | /api/orderbook | $0.003 | Hyperliquid 永续合约交易对的 L2 订单簿 |
hyperliquid_get_market_data | POST | /api/orderbook | $0.003 | Hyperliquid 永续合约交易对的 L2 订单簿(POST 变体) |
hyperliquid_get_all_markets | GET | /api/markets | $0.003 | 所有 Hyperliquid 资产的中间价、资金费率、未平仓量和交易量 |
hyperliquid_get_all_markets | POST | /api/markets | $0.003 | 所有 Hyperliquid 资产的中间价、资金费率、未平仓量和交易量(POST 变体) |
hyperliquid_get_candles | GET | /api/candles | $0.002 | Hyperliquid 永续合约交易对的 OHLCV 蜡烛图数据 |
hyperliquid_get_candles | POST | /api/candles | $0.002 | Hyperliquid 永续合约交易对的 OHLCV 蜡烛图数据(POST 变体) |
hyperliquid_get_market_data
需要查询某种币的 Hyperliquid 永续期货数据时使用。一次调用即可返回完整的 L2 订单簿深度、实时价格和资金费率指标。
参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
coin | string | 是 | 币种符号(例如 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 请求体传递,而非查询字符串。
参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
coin | string | 是 | 币种符号(例如 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 蜡烛图数据时使用。返回指定周期的开盘价、最高价、最低价、收盘价和交易量。
参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
coin | string | 是 | 币种符号(例如 BTC、ETH、SOL) |
interval | string | 否 | 蜡烛图周期(1m、5m、15m、1h、4h、1d) |
limit | number | 否 | 返回的蜡烛数量(默认 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 请求体传递,而不是查询字符串。
参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
coin | string | 是 | 币种符号(例如 BTC、ETH、SOL) |
interval | string | 否 | 蜡烛图周期(1m、5m、15m、1h、4h、1d) |
limit | number | 否 | 返回的蜡烛数量(默认 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、零注册。
- 目录:https://klymax402.com/llms.txt
- 完整 API 参考:https://klymax402.com/llms-full.txt
- 实时统计:https://klymax402.com/stats
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。