Claude MarketplacesSubmit
br0ski777 avatar

Hyperliquid Spot API

br0ski777/hl-spot-x402

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.

tools
3
transport
SSE
last updated
May 16, 2026
View on GitHub

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

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
searchstring
Optional 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
sortstring
Sort order for results. 'volume' = highest 24h volume first (default), 'change' = biggest price movers first, 'name' = alphabetical.one of volume · change · name
hyperliquid_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
addressstring
Wallet address in 0x format (42 characters). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

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.):

{
  "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

View the full README on GitHub

Details

Repository
github.com/br0ski777/hl-spot-x402
Website
github.com/Br0ski777/hl-spot-x402
Transport
SSE
Registry
MCP registry, active

More from br0ski777