Hyperliquid Spot API

io.github.Br0ski777Published by GitHub account Br0ski777v1.1.0Updated Oct 24, 2026

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

The publisher's own server: Spot

VerifiedSSEWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server for Hyperliquid spot market data: token lists, live prices and 24h volume, and wallet spot balances, paid per call.

What you can do
List and search the 454 Hyperliquid spot tokens with metadata such as symbol, tokenId, index and decimals, optionally filtered by name or symbol substring. Retrieve spot market data for all pairs, including prices, mid price, 24h volume and change, sortable by volume, change or name. Look up non-zero spot token balances for a given wallet address, with held and available amounts.
When to use it
Useful when an assistant needs Hyperliquid spot token metadata, live spot prices and volume, or spot holdings for a wallet address, without signing up for an API key. It covers spot only, not perps, vaults, funding rates or historical candles.
Requirements
A remote MCP endpoint added to the client configuration; no API key or signup. Each call is paid through the x402 protocol in USDC on Base L2, so an x402-aware client and a funded wallet are needed to complete the payment challenge.
Before you install
Every tool call costs $0.005 in USDC on Base, so usage spends real funds from a connected wallet. The balance tool takes a wallet address as input; only public addresses should be supplied, never private keys or seed phrases. Requests and payment details go to a third-party service.

Installation

In SourceWeft

  1. Open Hyperliquid Spot API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Br0ski777%2Fhl-spot/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

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

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

Quickstart -- HTTP (x402)

bash
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

ToolMethodPathPriceDescription
hyperliquid_list_spot_tokensPOST/api/tokens$0.005List all 454 spot tokens on Hyperliquid with metadata: name, tokenId, index, decimals, wei decimals.
hyperliquid_get_spot_marketsPOST/api/markets$0.005Spot market prices, 24h volume, mid price, and trading pair info for all Hyperliquid spot pairs.
hyperliquid_get_spot_balancesPOST/api/balance$0.005Spot 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

NameTypeRequiredDescription
searchstringnoOptional filter: search tokens by name or symbol (case-insensitive substring match). Omit to return all 454 tokens.

Example response:

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

NameTypeRequiredDescription
sortstringnoSort order for results. 'volume' = highest 24h volume first (default), 'change' = biggest price movers first, 'name' = alphabetical.

Example response:

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

NameTypeRequiredDescription
addressstringyesWallet address in 0x format (42 characters). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Example response:

json
{ 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.

License

MIT

Source: README.md at commit 9daea50

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Spot integrations

Spot

inc.spotOfficial publisher

Spot is a remote MCP server that lets an assistant create events, sell tickets, approve guests, invite people and find events from plain text.

Streamable HTTPWeb executableAuth
Productivity & WorkflowCredential requiredNov 7, 2026

HubSpot MCP by AdPlug

Published by GitHub account danielpopamd

Remote HubSpot MCP connector exposing 9 tools across client portals, with write actions previewed before they run.

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 27, 2026

HubSpot Auditor

Published by GitHub account M-Pineapple

Read-only HubSpot portal auditor that scores CRM, pipeline, form, tracking and email checks and returns a prioritized fix plan.

STDIODesktop only
Data & Analytics2 toolsOct 29, 2026

LightSpot

Published by GitHub account nmarijane

LightSpot runs SEO and AI-search visibility audits on a website and returns scores, fixes, competitor data and expert reports to an assistant.

STDIODesktop only
Productivity & WorkflowNot validated yetNov 1, 2026

SpotGPU

Published by GitHub account flowtestpro-svg

A discontinued MCP server that looked up spot GPU rental prices from Vast and RunPod through the SpotGPU API.

STDIODesktop only
Cloud & InfrastructureNot validated yetOct 24, 2026