Summary
Connects directly to Hyperliquid's L1 DEX API to pull spot market data for all 454 tokens without routing through CoinGecko or other aggregators. Exposes three endpoints: list tokens with metadata, get live prices and 24h volume sorted by activity, and check spot balances for any wallet address. Uses x402 micropayments at $0.002 per call, so your agent signs USDC on Base when it hits the 402 response. Reach for this when you need native Hyperliquid spot data for trading bots, portfolio tracking, or finding trending pairs before executing trades. If you need perps data or combined position views, the related HL Portfolio and HL Funding servers cover those.
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Tools
Public tool metadata for what this MCP can expose to an agent.
3 tools
hyperliquid_list_spot_tokensUse 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 con1 params
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 con
Parameters* required
searchstringOptional filter: search tokens by name or symbol (case-insensitive substring match). Omit to return all 454 tokens.
hyperliquid_get_spot_marketsUse 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 activ1 params
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 activ
Parameters* required
sortstringSort order for results. 'volume' = highest 24h volume first (default), 'change' = biggest price movers first, 'name' = alphabetical.one of
volume · change · namehyperliquid_get_spot_balancesUse 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 f1 params
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 f
Parameters* required
addressstringWallet address in 0x format (42 characters). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
Hyperliquid Spot API
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.):
{
"mcpServers": {
"hl-spot": {
"url": "https://hl-spot.api.klymax402.com/mcp"
}
}
}
Quickstart -- 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
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
hyperliquid_list_spot_tokens | POST | /api/tokens | $0.002 | List all 454 spot tokens on Hyperliquid with metadata: name, tokenId, index, decimals, wei decimals. |
hyperliquid_get_spot_markets | POST | /api/markets | $0.002 | Spot market prices, 24h volume, mid price, and trading pair info for all Hyperliquid spot pairs. |
hyperliquid_get_spot_balances | POST | /api/balance | $0.002 | Spot 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
| Name | Type | Required | Description |
|---|---|---|---|
search | string | no | Optional filter: search tokens by name or symbol (case-insensitive substring match). Omit to return all 454 tokens. |
Example response:
{ 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
| Name | Type | Required | Description |
|---|---|---|---|
sort | string | no | Sort order for results. 'volume' = highest 24h volume first (default), 'change' = biggest price movers first, 'name' = alphabetical. |
Example response:
{ 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
| Name | Type | Required | Description |
|---|---|---|---|
address | string | yes | Wallet address in 0x format (42 characters). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 |
Example response:
{ 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.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Featured
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →