Hyperliquid Spot API MCP Server

by br0ski777 Your server? Claim it

not responding

Hyperliquid Spot API is listed as active in the registry but did not answer our last check. It exposes 3 tools. Last commit 2 Sep 2026.

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

Uptime history 51 days of history · worst day 0%

51 days agonow

0.0%

Uptime 24h

0 of 91 checks

Tools

read from the server

53 ms

Response time

average over 24h

Stars

last commit 2 Sep 2026

Hyperliquid Spot API does not always answer

Over the last week it answered 29.7% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 7 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add hl-spot --transport http https://hl-spot.api.klymax402.com/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.hl-spot]
url = "https://hl-spot.api.klymax402.com/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 3

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

hyperliquid

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. Returns for each balance: 1. coin: token symbol 2. token: token index in spot registry 3. total: total balance (hold + available) as string 4. hold: amount currently held in open orders 5. available: amount available for trading or withdrawal 6. entryNtl: entry notional value in USDC Input: wallet address (0x... format, 42 characters). Example output: { address: "0xabc...", balances: [{ coin: "PURR", total: "15000", hold: "5000", available: "10000", entryNtl: "350.50" }], count: 3 } Use this to check what spot tokens a Hyperliquid wallet holds before executing trades or analyzing portfolios. Do NOT use for perps positions -- use hyperliquid_get_perp_positions instead. Do NOT use for cross-chain wallet balances -- use wallet_get_portfolio instead. Do NOT use for Hyperliquid vault balances -- use hyperliquid_get_vaults instead. Do NOT use for EVM token balances -- use token_get_balance instead.

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. Returns for each market: 1. name: token name (e.g. "PURR/USDC") 2. coin: base token symbol 3. tokenId: unique token identifier 4. markPx: current mark/mid price in USDC 5. midPx: mid price between best bid and ask 6. prevDayPx: previous day closing price 7. dayNtlVlm: 24h notional volume in USDC 8. change24h: percentage price change over 24 hours Sortable by: "volume" (default, highest 24h volume first), "change" (biggest movers first), "name" (alphabetical). Example output: { markets: [{ name: "PURR/USDC", markPx: "0.0234", dayNtlVlm: "1250000", change24h: 5.32 }], count: 120 } Use this to find trending spot tokens, check current prices, or scan for high-volume trading opportunities on Hyperliquid. Do NOT use for perps/futures markets -- use hyperliquid_get_perp_markets instead. Do NOT use for CoinGecko prices -- use token_get_price instead. Do NOT use for funding rates -- use hyperliquid_get_funding_rates instead. Do NOT use for historical OHLCV candles -- use token_get_ohlcv instead.

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. Returns for each token: 1. name: token display name (e.g. "PURR", "HFUN") 2. tokenId: unique hex token identifier on Hyperliquid 3. index: integer index in the spot meta registry 4. decimals: token decimal precision (szDecimals) 5. weiDecimals: wei-level decimal precision for raw amounts Optional filter: pass "search" to filter tokens by name/symbol substring match (case-insensitive). Returns all tokens if no search term provided. Example output: { tokens: [{ name: "PURR", tokenId: "0xc4bf3f...", index: 1, decimals: 0, weiDecimals: 8 }], count: 454 } Use this to discover which spot tokens exist on Hyperliquid before querying prices or balances. Essential for building trading interfaces or token lookups. Do NOT use for perps/futures data -- use hyperliquid_get_perp_markets instead. Do NOT use for token prices on CEX/CoinGecko -- use token_get_price instead. Do NOT use for wallet portfolio across chains -- use wallet_get_portfolio instead. Do NOT use for Hyperliquid vault data -- use hyperliquid_get_vaults instead.

Endpoints

URL	Transport	State	Latency	Checked
https://hl-spot.api.klymax402.com/mcp	sse	answering	53 ms	7 min ago

Alternatives to Hyperliquid Spot API

same job, measured the same way

x402 Web Extract

by senpi-station

Pay-per-use web extract, token prices, and wallet balances via x402 USDC micropayments.

5 tools answering

Nano Pay

by feeless402

Pay for x402-priced APIs with feeless, sub-second Nano (XNO) micropayments from a local wallet.

1 172 installs/wk local only

Coinrailz

by tdnupe3

41 crypto micropayment services via x402 protocol

123 installs/wk local only

Spraay Solana Gateway

by plagtech

Batch send SOL or any SPL token to 1000+ wallets via x402. AI agent payments on Solana.

4 tools answering

Agent Token Stripper

by goldminex

Autonomous x402 Token Stripper API settling $0.002 USDC micro-payments on Base L2.

local only

Xpay

by xona-labs

Xona Wallet: agent wallet for AI agents. x402 payments, AgenC hires, 20k+ services

115 installs/wk local only

Kura

by dinggi5

Local Ethereum wallet for AI agents - balances, history, x402 payments on Base. Keys stay local.

local only

HTTPayer

by httpayer

x402 micropayments for AI agents — credits-based, no wallets, no blockchain.

36 installs/wk local only

Hyperliquid Spot API — questions

Answers built from our own checks of this server.

What can Hyperliquid Spot API do?

It exposes 3 tools, read directly from the server on our last check. Among them: hyperliquid_get_spot_balances, hyperliquid_get_spot_markets, hyperliquid_list_spot_tokens. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Hyperliquid Spot API working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 0 of 91 checks got a reply (0.0%), average response time 53 ms. The bar chart above shows every period we have measured.

The registry lists Hyperliquid Spot API as active — why does it not respond?

The official MCP registry stores what the author submitted; it does not verify that the server still runs. We check the endpoint ourselves, and this one does not answer. Catalogues that copy the registry without checking will show it as working.

How do I connect Hyperliquid Spot API?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Hyperliquid Spot API need an API key?

No. Hyperliquid Spot API completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 3 of them are readable on this page. This is what we observed, not what the docs claim.

Is Hyperliquid Spot API open source?

Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.