Hyperliquid Spot API

Данные спотового рынка Hyperliquid: 454 токена, живые цены, объём за 24 часа, балансы кошельков. Нативные данные L1 DEX, без CoinGecko. Спотовый слой данных, необходимый агентам для торговли на Hyperliquid. Оплата за вызов через x402 (USDC на Base L2) — без API-ключа, без регистрации, без ограничений по частоте запросов.

Часть маркетплейса klymax402 — 100 x402 микроплатежных API для AI-агентов, один кошелёк, USDC на Base.

Быстрый старт -- MCP

Добавьте в конфигурацию вашего MCP-клиента (Claude Desktop, Cursor, ElizaOS и т.д.):

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

Related MCP server: boo-x402-mcp

Быстрый старт -- 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

Любой x402-совместимый клиент (@x402/fetch, x402-agent-tools, ATXP) автоматически обрабатывает цикл 402 -> подпись -> повтор.

Инструменты

hyperliquid_list_spot_tokens

Используйте это, когда вам нужно перечислить или найти спотовые токены, доступные на Hyperliquid L1 DEX. Возвращает все 454 спотовых токена с полными метаданными, включая название токена, символ, tokenId, index, decimals и коэффициенты конвертации wei.

Параметры

Пример ответа:

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

Не для: данных по перпетуалам/фьючерсам (используйте hyperliquid_get_perp_markets), цен токенов на CEX/CoinGecko (используйте token_get_price), портфеля кошелька в разных сетях (используйте wallet_get_portfolio), данных Hyperliquid vault (используйте hyperliquid_get_vaults).

hyperliquid_get_spot_markets

Используйте это, когда вам нужны живые данные спотового рынка с Hyperliquid DEX: цены, объём за 24 часа и торговая активность по всем спотовым парам. Возвращает объединённые метаданные токенов + контекст рынка в реальном времени для каждого активного спотового рынка.

Параметры

Пример ответа:

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

Не для: рынков перпетуалов/фьючерсов (используйте hyperliquid_get_perp_markets), цен CoinGecko (используйте token_get_price), ставок финансирования (используйте hyperliquid_get_funding_rates), исторических свечей OHLCV (используйте token_get_ohlcv).

hyperliquid_get_spot_balances

Используйте это, когда вам нужно проверить балансы спотовых токенов для конкретного адреса кошелька на Hyperliquid L1 DEX. Возвращает все ненулевые спотовые токены с доступными и удерживаемыми (в ордерах) суммами.

Параметры

Пример ответа:

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

Не для: позиций по перпетуалам (используйте hyperliquid_get_perp_positions), балансов Hyperliquid vault (используйте hyperliquid_get_vaults), балансов EVM-токенов (используйте token_get_balance).

Примеры промптов для агентов

• "Перечислить или найти спотовые токены, доступные на Hyperliquid L1 DEX"

• "Живые данные спотового рынка с Hyperliquid DEX: цены, объём за 24 часа и торговая активность по всем спотовым парам"

• "Проверить балансы спотовых токенов для конкретного адреса кошелька на Hyperliquid L1 DEX"

Оплата

• Протокол: x402 — нативный HTTP-протокол оплаты за вызов, без регистрации, без API-ключа

• Сеть: Base L2 (eip155:8453)

• Актив: USDC

• Фасилитатор: Coinbase CDP (основной), PayAI (резервный)

• Также доступен через ATXP (x402 с OAuth-обёрткой, метаданные защищённого ресурса RFC 9728)

Часть klymax402

100 x402 микроплатежных API для AI-агентов — один кошелёк, USDC на Base, без регистрации.

• Каталог: https://klymax402.com/llms.txt

• Полная справочная документация API: https://klymax402.com/llms-full.txt

• Живая статистика: https://klymax402.com/stats

Лицензия

MIT