HL Portfolio API

Анализируйте аккаунты Hyperliquid: позиции, PnL, исполнения, открытые ордера, финансирование. Полное состояние клиринговой системы для любого кошелька. Портфельный слой, который агентам нужен для торговой аналитики Hyperliquid. Оплата за вызов через x402 (USDC на Base L2) — без API-ключа, без регистрации, без ограничения на количество запросов.

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

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

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

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

Related MCP server: polskidegen-hl-tracker

Быстрый старт — HTTP (x402)

curl -X POST "https://hl-portfolio.api.klymax402.com/api/account" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x0000000000000000000000000000000000dEaD"}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

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

Инструменты

hyperliquid_get_account_state

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

Параметры

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

{ accountValue: "125430.50", totalNtlPos: "89200.00", withdrawable: "36230.50", positions: [{ coin: "BTC", size: "1.5", entryPrice: "67500.00", unrealizedPnl: "2340.00", leverage: 5, liquidationPrice: "54200.00", marginType: "cross" }] }

Когда использовать: при анализе риска трейдера, проверке состояния маржи или оценке распределения портфеля на Hyperliquid. Необходимо для оценки копирования сделок и мониторинга рисков.

Не подходит: для истории сделок (используйте hyperliquid_get_trade_fills), открытых ордеров (используйте hyperliquid_get_open_orders), платежей по финансированию (используйте hyperliquid_get_user_funding), эффективности волатов (используйте hyperliquid_get_vault_details), отслеживания китов (используйте hyperliquid_detect_whale_trades).

hyperliquid_get_trade_fills

Используйте этот инструмент, когда вам необходимо получить последние исполнения сделок (fills) для перпетуального аккаунта Hyperliquid. Возвращает последние сделки с деталями исполнения, включая реализованный PnL по закрытым позициям.

Параметры

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

{ fills: [{ coin: "ETH", side: "buy", size: "10.0", price: "3450.50", fee: "0.69", closedPnl: "0.00", timestamp: 1712000000000 }], count: 20 }

Не подходит: для текущих позиций (используйте hyperliquid_get_account_state), открытых/ожид выполнение (используйте hyperliquid_get_open_orders), платежей по финансированию (используйте hyperliquid_get_user_funding).

hyperliquid_get_open_orders

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

Параметры

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

{ orders: [{ coin: "BTC", side: "buy", limitPx: "65000.00", sz: "0.5", orderType: "limit", reduceOnly: false, oid: 123456 }], count: 3 }

Не подходит: для исполненных сделок (используйте hyperliquid_get_trade_fills), для текущих позиций (используйте hyperliquid_get_account_state).

hyperliquid_get_user_funding

Используйте этот инструмент, когда вам необходимо получить историю платежей по финансированию для перпетуального аккаунта Hyperliquid. Возвращает все платежи по ставке финансирования, полученные или уплаченные, что полезно для расчёта доходов/расходов по финансированию и оценки прибыльности кэрри-сделок.

Параметры

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

{ funding: [{ coin: "BTC", fundingRate: "0.0001", payment: "-1.35", timestamp: 1712000000000, positionSize: "1.5" }], totalReceived: "45.20", totalPaid: "-12.30", netFunding: "32.90" }

Не подходит: для текущих позиций (используйте hyperliquid_get_account_state), для поиска возможностей арбитража финансирования (используйте funding_arb_find_opportunities), для истории исполнений сделок (используйте hyperliquid_get_trade_fills).

Примеры запросов к агенту

• "Получить полное состояние портфеля перпетуального аккаунта Hyperliquid"

• "Получить последние исполнения сделок (fills) для перпетуального аккаунта Hyperliquid"

• "Просмотреть все ожидающие/открытые ордера для перпетуального аккаунта Hyperliquid"

Оплата

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

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

• Актив: USDC

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

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

Часть klymax402

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

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

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

• Актуальная статистика: https://klymax402.com/stats

Лицензия

MIT