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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
Real-time spot market data for all 454 tokens on Hyperliquid L1 DEX. Prices, volume, wallet balances. Powered by x402 micropayments.
Native Hyperliquid data -- no CoinGecko, no aggregators. Direct from the L1 DEX API for maximum accuracy and speed.
Endpoints
POST /api/tokens - $0.002/call
List all 454 spot tokens with metadata.
// Request
{ "search": "PURR" }
// Response
{
"tokens": [
{ "name": "PURR", "tokenId": "0xc4bf3f...", "index": 1, "decimals": 0, "weiDecimals": 8 }
],
"count": 1
}
POST /api/markets - $0.002/call
Live spot market prices, 24h volume, and price changes.
// Request
{ "sort": "volume" }
// Response
{
"markets": [
{
"name": "PURR/USDC",
"coin": "PURR",
"tokenId": "0xc4bf3f...",
"markPx": "0.0234",
"midPx": "0.0233",
"prevDayPx": "0.0222",
"dayNtlVlm": "1250000",
"change24h": 5.41
}
],
"count": 120
}
POST /api/balance - $0.002/call
Spot token balances for a wallet address.
// Request
{ "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }
// Response
{
"address": "0xd8dA...",
"balances": [
{ "coin": "PURR", "token": 1, "total": "15000", "hold": "5000", "available": "10000", "entryNtl": "350.50" }
],
"count": 1
}
Use Cases
- Token discovery: Find which spot tokens are available on Hyperliquid before trading
- Market scanning: Identify high-volume or trending spot pairs
- Portfolio tracking: Check spot holdings for any Hyperliquid wallet
- Trading bots: Get real-time prices for spot order execution
- Analytics dashboards: Build Hyperliquid spot market overviews
MCP Integration
Works with Claude Desktop, Cursor, Copilot, and any MCP-compatible client.
{
"mcpServers": {
"hl-spot": {
"url": "https://hl-spot-production.up.railway.app/mcp",
"transport": "sse"
}
}
}
Payment
Uses x402 protocol. Send a request, get HTTP 402 with price, your agent signs USDC on Base automatically. No API keys, no signup.
Related APIs
- Hyperliquid Data - Perps/futures market data (not spot)
- HL Portfolio - Full Hyperliquid portfolio (perps + spot combined)
- Token Price - CoinGecko-based token prices (CEX, not HL native)
- Wallet Portfolio - Multi-chain wallet balances (EVM, not HL-specific)
- HL Funding - Funding rates for Hyperliquid perps
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →