Hyperliquid Spot API

Datos de mercado SPOT de Hyperliquid: 454 tokens, precios en vivo, volumen en 24 h, saldos de wallet. Datos nativos del DEX de L1, sin CoinGecko. La capa de datos de spot que los agentes necesitan para operar en Hyperliquid. Pago por llamada vía x402 (USDC en Base L2) -- sin clave de API, sin registro, sin límite de tasa.

Parte del marketplace klymax402 -- 100 APIs de micropagos x402 para agentes de IA, una sola wallet, USDC en Base.

Inicio rápido -- MCP

Agrega esto a la configuración de tu cliente MCP (Claude Desktop, Cursor, ElizaOS, etc.):

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

Related MCP server: boo-x402-mcp

Inicio rápido -- 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

Cualquier cliente compatible con x402 (@x402/fetch, x402-agent-tools, ATXP) gestiona automáticamente el ciclo 402 -> firma -> reintento.

Herramientas

hyperliquid_list_spot_tokens

Utilízala cuando necesites listar o buscar tokens spot disponibles en el DEX L1 de Hyperliquid. Devuelve todos los tokens spot con metadatos completos, incluidos el nombre del token, símbolo, tokenId, decimal y factores de conversión wei.

Parámetros

Ejemplo de respuesta:

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

No apto para: datos de perps/futuros (usa hyperliquid_get_perp_markets), precios de tokens en CEX/CoinGecko (usa token_get_price), cartera de wallets en varias cadenas (usa wallet_get_portfolio), datos de bóvedas de Hyperliquid (usa hyperliquid_get_vaults).

hyperliquid_get_spot_markets

Úsalo cuando necesites datos de mercado spot en vivo del DEX de Hyperliquid: precios, volumen de 24 h y actividad de trading de todos los pares spot. Devuelve los metadatos de token combinados con el contexto de mercado en tiempo real de cada par activo.

Parámetros

Ejemplo de respuesta:

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

No apto: mercados de perps/futuros (usa hyperliquid_get_perp_markets), precios de CoinGecko (usa token_get_price), tasas de funding (usa hyperliquid_get_funding_rates), claves OHLCV históricas (usa token_get_ohlcv).

hyperliquid_get_spot_balances

**Úsalo cuando necesites comprobar los equilibrios de tokens spot para una dirección concreta de wallet en el DEX L1 de Hyperliquid. Devuelve todos los holdings de tokens spot no nulos, con las cantidades disponibles y mantenidas (en pedidos).

**Parámetros

Ejemplo de respuesta:

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

No apto: posiciones de perps (usa hyperliquid_get_perp_positions), saldo de bóvedas de Hyperliquid (usa hyperliquid_get_vaults), saldo de tokens EVM (usa token_get_balance).

Ejemplos de prompts para agentes

• "List the tokens spot disponibles en el DEX L1 de Hyperliquid"

• "Obtén datos de mercado spot en vivo del DEX de Hyperliquid: precios, volumen de 24 h y actividad de trading para todos los pares spot"

• "Consulta los saldos de tokens spot de una dirección de wallet concreta en el DEX L1 de Hyperliquid"

Pagos

• Protocolo: x402 -- texto de pago nativo de HTTP, sin registro, sin clave API

• Red: Base L2 (eip155:8453)

• Activo: USDC

• Facilitador: Coinbase CDP (principal), PayAI (respuesta)

• También accesible vía ATXP (OAuth envuelto en x402, metadatos de recursos protegidos RFC 9728)

Parte de klymax402

100 APIs de micropagos x402 para agentes de IA -- una sola wallet, USDC en Base, cero registros.

Preparado * Catálogo: https://klymax402.com/llms.txt

• Referencia completa de la API: https://klymax402.com/llms-full.txt

• Estadísticas en vivo: https://klymax402.com/stats

Licencia

MIT