Hyperliquid Spot API

io.github.Br0ski777由 GitHub 账号 Br0ski777 发布v1.1.0更新于 Oct 24, 2026

Hyperliquid spot tokens, prices, volume, wallet balances. 454 tokens. x402 micropayment.

发布方自己的服务:Spot

已验证SSE可网页运行金融数据与分析

概览

AI 生成的概览

面向 Hyperliquid 现货市场的远程 MCP 服务器,提供代币列表、实时价格与 24 小时成交量、钱包现货余额,按次付费。

可以做什么
列出并搜索 Hyperliquid 上的 454 个现货代币,返回符号、tokenId、索引、精度等元数据,可按名称或符号子串过滤。获取所有现货交易对的市场数据,包括价格、中间价、24 小时成交量和涨跌幅,可按成交量、涨跌幅或名称排序。查询指定钱包地址的非零现货代币余额,含冻结与可用数量。
适用场景
当助手需要 Hyperliquid 现货代币元数据、实时现货价格与成交量,或某钱包地址的现货持仓,且不想注册 API 密钥时适用。仅覆盖现货,不含永续合约、金库、资金费率或历史 K 线。
运行要求
需在客户端配置中添加远程 MCP 端点,无需 API 密钥或注册。每次调用通过 x402 协议以 Base L2 上的 USDC 付费,因此需要支持 x402 的客户端和已充值的钱包来完成支付挑战。
安装前请注意
每次工具调用花费 0.005 USDC(Base 网络),会从连接的钱包中实际扣款。余额工具需要输入钱包地址,只应提供公开地址,切勿提供私钥或助记词。请求和支付信息会发送给第三方服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hyperliquid Spot API,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 SSE。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Br0ski777%2Fhl-spot/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Hyperliquid Spot API

[MCP Server] [x402] [License: MIT]

Hyperliquid SPOT market data: 454 tokens, live prices, 24h volume, wallet balances. Native L1 DEX data, no CoinGecko. The spot data layer agents need for Hyperliquid trading. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

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

Quickstart -- HTTP (x402)

bash
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

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
hyperliquid_list_spot_tokensPOST/api/tokens$0.005List all 454 spot tokens on Hyperliquid with metadata: name, tokenId, index, decimals, wei decimals.
hyperliquid_get_spot_marketsPOST/api/markets$0.005Spot market prices, 24h volume, mid price, and trading pair info for all Hyperliquid spot pairs.
hyperliquid_get_spot_balancesPOST/api/balance$0.005Spot token balances for any wallet address on Hyperliquid, including held and available amounts.

hyperliquid_list_spot_tokens

Use this when you need to list or search spot tokens available on Hyperliquid L1 DEX. Returns all 454 spot tokens with full metadata including token name, symbol, tokenId, index, decimals, and wei conversion factors.

Parameters

NameTypeRequiredDescription
searchstringnoOptional filter: search tokens by name or symbol (case-insensitive substring match). Omit to return all 454 tokens.

Example response:

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

Not for: perps/futures data (use hyperliquid_get_perp_markets), token prices on CEX/CoinGecko (use token_get_price), wallet portfolio across chains (use wallet_get_portfolio), Hyperliquid vault data (use hyperliquid_get_vaults).

hyperliquid_get_spot_markets

Use this when you need live spot market data from Hyperliquid DEX: prices, 24h volume, and trading activity for all spot pairs. Returns merged token metadata + real-time market context for every active spot market.

Parameters

NameTypeRequiredDescription
sortstringnoSort order for results. 'volume' = highest 24h volume first (default), 'change' = biggest price movers first, 'name' = alphabetical.

Example response:

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

Not for: perps/futures markets (use hyperliquid_get_perp_markets), CoinGecko prices (use token_get_price), funding rates (use hyperliquid_get_funding_rates), historical OHLCV candles (use token_get_ohlcv).

hyperliquid_get_spot_balances

Use this when you need to check spot token balances for a specific wallet address on Hyperliquid L1 DEX. Returns all non-zero spot token holdings with available and held (in-order) amounts.

Parameters

NameTypeRequiredDescription
addressstringyesWallet address in 0x format (42 characters). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Example response:

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

Not for: perps positions (use hyperliquid_get_perp_positions), Hyperliquid vault balances (use hyperliquid_get_vaults), EVM token balances (use token_get_balance).

Example agent prompts

  • "List or search spot tokens available on Hyperliquid L1 DEX"
  • "Live spot market data from Hyperliquid DEX: prices, 24h volume, and trading activity for all spot pairs"
  • "Check spot token balances for a specific wallet address on Hyperliquid L1 DEX"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)
  • Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

来源:README.md,提交 9daea50

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Spot 集成