About Hyperliquid Spot API
Hyperliquid Spot API is an MCP server published by Br0ski777 in the RAG category: hyperliquid spot tokens, prices, volume, wallet balances. 454 tokens. x402 micropayment.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/Br0ski777/hl-spot-x402This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (3)
hyperliquid_get_spot_balancesPOST
Parameters not published.
hyperliquid_get_spot_marketsPOST
Parameters not published.
hyperliquid_list_spot_tokensPOST
Parameters not published.
Ask AI
Ask AI about Hyperliquid Spot API
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.