Hyperliquid Spot API

Hyperliquid SPOT 市场数据：454 个代币、实时价格、24 小时成交量、钱包余额。原生 L1 DEX 数据，无需 CoinGecko。这是代理进行 Hyperliquid 交易所需的现货数据层。通过 x402 按调用付费（Base L2 上的 USDC）——无需 API 密钥、无需注册、没有速率限制墙。

属于 klymax402 市场的一部分 —— 面向 AI 代理的 100 个 x402 微支付 API，一个钱包，USDC 在 Base 上。

快速入门 —— MCP

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

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

Related MCP server: boo-x402-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

当你需要列出或搜索 Hyperliquid L1 DEX 上可用的现货代币时，请使用此工具。返回全部 454 个现货代币及其完整元数据，包括代币名称、symbol、tokenId、index、decimals 和 wei 转换因子。

参数

示例响应：

{ 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 vault 数据（使用 hyperliquid_get_vaults）。

hyperliquid_get_spot_markets

当你需要获取来自 Hyperliquid DEX 的实时现货市场数据：所有现货交易对的价格、24 小时成交量和交易活动时，请使用此工具。返回每个活跃现货市场的合并代币元数据 + 实时市场上下文。

参数

示例响应：

{ 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 K 线（使用 token_get_ohlcv）。

hyperliquid_get_spot_balances

当你需要检查 Hyperliquid L1 DEX 上某个钱包地址的现货代币余额时，请使用本工具。返回所有非零现货代币持仓，包括可用金额和挂单中（在途）金额。

参数

响应示例：

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

不适用：永续合约（使用 hyperliquid_get_perp_positions）、Hyperliquid vault 余额（使用 hyperliquid_get_vaults）、EVM 代币余额（使用 token_get_balance）。

示例 Agent 提示词

• "列出或搜索 Hyperliquid L1 DEX 上可用的现货代币"

• "获取 Hyperliquid DEX 的实时现货市场数据：所有现货对的价格、24h 成交量和交易活动"

• "检查 Hyperliquid L1 DEX 上某个钱包地址的现货代币余额"

支付

• 协议：x402 —— HTTP 原生按调用付费，无需注册，无需 API 密钥

• 网络：Base L2 (eip155:8453)

• 资产：USDC

• Facilitator：Coinbase CDP（主要），PayAI（备用）

• 也可通过 ATXP 访问（OAuth 包装的 x402，RFC 9728 受保护资源元数据）

属于 klymax402

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

• 目录：https://klymax402.com/llms.txt

• 完整 API 参考：https://klymax402.com/llms-full.txt

• 实时统计：https://klymax402.com/stats

许可证

MIT