Hl Spot X402

Hyperliquid Spot API

Hyperliquid 现货市场数据：454 种代币、实时价格、24 小时交易量和钱包余额。原生 L1 DEX 数据，无需 CoinGecko。为 Hyperliquid 交易所需的现货数据层。通过 x402 按次付费（使用 Base L2 上的 USDC）——无需 API 密钥、无需注册，也没有速率限制。

属于 klymax402 市场的一部分——为 AI Agent 提供 100 个 x402 小额支付 API，只需一个钱包，使用 Base 上的 USDC。

快速开始——MCP

添加到你的 MCP 客户端配置中（Claude Desktop、Cursor、ElizaOS 等）：

{
  "mcpServers": {
    "hl-spot": {
      "url": "https://hl-spot.api.klymax402.com/mcp"
    }
  }
}

快速开始——HTTP（x402）

curl -X POST "https://hl-spot.api.klymax402.com/api/tokens" \
  -H "Content-Type: application/json" \
  -d '{}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

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

工具

工具	方法	路径	价格	描述
hyperliquid_list_spot_tokens	POST	/api/tokens	$0.005	列出 Hyperliquid 上全部 454 种现货代币及其元数据：名称、tokenId、索引、精度位数和 wei 精度位数。
hyperliquid_get_spot_markets	POST	/api/markets	$0.005	获取 Hyperliquid 所有现货交易对的市场价格、24 小时交易量、中间价和交易对信息。
hyperliquid_get_spot_balances	POST	/api/balance	$0.005	查询 Hyperliquid 上任意钱包地址的现货代币余额，包括持有量和可用量。

hyperliquid_list_spot_tokens

当你需要列出或搜索 Hyperliquid L1 DEX 上可用的现货代币时使用。返回全部 454 种现货代币的完整元数据，包括代币名称、符号、tokenId、索引、精度位数和 wei 转换系数。

参数

名称	类型	必需	描述
search	string	否	可选筛选条件：按名称或符号搜索代币（不区分大小写的子字符串匹配）。省略则返回全部 454 种代币。

响应示例：

{ tokens: [{ name: "PURR", tokenId: "0xc4bf3f...", index: 1, decimals: 0, weiDecimals: 8 }], count: 454 }

不适用于：永续合约/期货数据（使用 hyperliquid_get_perp_markets）、CEX/CoinGecko 上的代币价格（使用 token_get_price）、跨链钱包资产组合（使用 wallet_get_portfolio）、Hyperliquid 金库数据（使用 hyperliquid_get_vaults）。

hyperliquid_get_spot_markets

当你需要 Hyperliquid DEX 的实时现货市场数据时使用：价格、24 小时交易量和所有现货交易对的交易活动。返回合并后的代币元数据，以及每个活跃现货市场的实时市场信息。

参数

名称	类型	必需	描述
sort	string	否	结果排序方式。'volume' = 按 24 小时交易量从高到低排序（默认），'change' = 按价格波动幅度从大到小排序，'name' = 按字母顺序排序。

响应示例：

{ markets: [{ name: "PURR/USDC", markPx: "0.0234", dayNtlVlm: "1250000", change24h: 5.32 }], count: 120 }

不适用于：永续合约/期货市场（使用 hyperliquid_get_perp_markets）、CoinGecko 价格（使用 token_get_price）、资金费率（使用 hyperliquid_get_funding_rates）、历史 OHLCV 蜡烛图（使用 token_get_ohlcv）。

hyperliquid_get_spot_balances

当你需要查询 Hyperliquid L1 DEX 上特定钱包地址的现货代币余额时使用。返回所有非零现货代币持仓，以及可用量和持有量（挂单中）。

参数

名称	类型	必需	描述
address	string	是	采用 0x 格式的钱包地址（42 个字符）。示例：0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

响应示例：

{ address: "0xabc...", balances: [{ coin: "PURR", total: "15000", hold: "5000", available: "10000", entryNtl: "350.50" }], count: 3 }

不适用于：永续合约持仓（使用 hyperliquid_get_perp_positions）、Hyperliquid 金库余额（使用 hyperliquid_get_vaults）、EVM 代币余额（使用 token_get_balance）。

Agent 提示词示例

• “列出或搜索 Hyperliquid L1 DEX 上可用的现货代币”
• “Hyperliquid DEX 实时现货市场数据：所有现货交易对的价格、24 小时交易量和交易活动”
• “查询 Hyperliquid L1 DEX 上特定钱包地址的现货代币余额”

付款

• 协议：x402——原生支持 HTTP 的按次付费，无需注册，无需 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• Facilitator：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