Hyperliquid Spot API

Hyperliquid SPOT-Marktdaten: 454 Token, Live-Preise, 24h-Volumen, Wallet-Salden. Native L1-DEX-Daten, kein CoinGecko. Die Spot-Datenschicht, die Agenten für den Hyperliquid-Handel benötigen. Pay-per-Call über x402 (USDC auf Base L2) – kein API-Schlüssel, keine Anmeldung, keine Rate-Limit-Barriere.

Teil des klymax402 Marktplatzes – 100 x402-Mikrozahlungs-APIs für KI-Agenten, eine Wallet, USDC auf Base.

Quickstart -- MCP

Fügen Sie zu Ihrer MCP-Client-Konfiguration hinzu (Claude Desktop, Cursor, ElizaOS, etc.):

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

Related MCP server: boo-x402-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

Jeder x402-fähige Client (@x402/fetch, x402-agent-tools, ATXP) übernimmt den 402 -> Sign -> Retry-Zyklus automatisch.

Tools

hyperliquid_list_spot_tokens

Verwenden Sie dies, wenn Sie Spot-Token auflisten oder suchen möchten, die auf Hyperliquid L1 DEX verfügbar sind. Gibt alle 454 Spot-Token mit vollständigen Metadaten zurück, einschließlich Token-Name, Symbol, tokenId, Index, Dezimalstellen und Wei-Umrechnungsfaktoren.

Parameter

Beispielantwort:

{ tokens: [{ name: "PURR", tokenId: "0xc4bf3f...", index: 1, decimals: 0, weiDecimals: 8 }], count: 454 }

Nicht für: Perps/Futures-Daten (verwenden Sie hyperliquid_get_perp_markets), Token-Preise auf CEX/CoinGecko (verwenden Sie token_get_price), Wallet-Portfolio über Ketten hinweg (verwenden Sie wallet_get_portfolio), Hyperliquid-Vault-Daten (verwenden Sie hyperliquid_get_vaults).

hyperliquid_get_spot_markets

Verwenden Sie dies, wenn Sie Live-Spot-Marktdaten von Hyperliquid DEX benötigen: Preise, 24h-Volumen und Handelsaktivität für alle Spot-Paare. Gibt zusammengeführte Token-Metadaten + Echtzeit-Marktkontext für jeden aktiven Spot-Markt zurück.

Parameter

Beispielantwort:

{ markets: [{ name: "PURR/USDC", markPx: "0.0234", dayNtlVlm: "1250000", change24h: 5.32 }], count: 120 }

Nicht für: Perps/Futures-Märkte (verwenden Sie hyperliquid_get_perp_markets), CoinGecko-Preise (verwenden Sie token_get_price), Funding-Raten (verwenden Sie hyperliquid_get_funding_rates), historische OHLCV-Kerzen (verwenden Sie token_get_ohlcv).

hyperliquid_get_spot_balances

Verwenden Sie dies, um Spot-Token-Salden für eine bestimmte Wallet-Adresse auf Hyperliquid L1 DEX zu überprüfen. Gibt alle Nicht-Null-Spot-Token-Bestände mit verfügbaren und gehaltenen (in Auftrag) Beträgen zurück.

Parameter

Beispielantwort:

{ address: "0xabc...", balances: [{ coin: "PURR", total: "15000", hold: "5000", available: "10000", entryNtl: "350.50" }], count: 3 }

Nicht für: Perps-Positionen (verwenden Sie hyperliquid_get_perp_positions), Hyperliquid-Vault-Salden (verwenden Sie hyperliquid_get_vaults), EVM-Token-Salden (verwenden Sie token_get_balance).

Beispiel-Agenten-Prompts

• "Liste oder suche Spot-Token, die auf Hyperliquid L1 DEX verfügbar sind"

• "Live-Spot-Marktdaten von Hyperliquid DEX: Preise, 24h-Volumen und Handelsaktivität für alle Spot-Paare"

• "Überprüfe Spot-Token-Salden für eine bestimmte Wallet-Adresse auf Hyperliquid L1 DEX"

Zahlung

• Protokoll: x402 – HTTP-natives Pay-per-Call, keine Anmeldung, kein API-Schlüssel

• Netzwerk: Base L2 (eip155:8453)

• Asset: USDC

• Vermittler: Coinbase CDP (primär), PayAI (Fallback)

• Auch erreichbar über ATXP (OAuth-gewrappt x402, RFC 9728 geschützte Ressourcen-Metadaten)

Teil von klymax402

100 x402-Mikrozahlungs-APIs für KI-Agenten – eine Wallet, USDC auf Base, keine Anmeldung.

• Katalog: https://klymax402.com/llms.txt

• Vollständige API-Referenz: https://klymax402.com/llms-full.txt

• Live-Statistiken: https://klymax402.com/stats

Lizenz

MIT