Объём 24ч—Открытый интерес—Ликвидации 24ч$1.36BЛонг/Шорт 24ч—Доминация BTC—Доминация ETH—
Приложение
Язык ▾
₽ RUB ▾
/api/hl/address/:addr
GETДоступен

Состояние счёта Hyperliquid по адресу

Состояние счёта Hyperliquid по адресу (позиции, капитал счёта)

GET/api/hl/address/:addr
Читается напрямую из публичного API Hyperliquid при каждом запросе; не кешируется и не сохраняется.

Запрос

Параметры запроса

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
addr pathstringОбязательный——Адрес из 40 шестнадцатеричных символов с префиксом 0x; 400 при неверном формате. Пример: 0x5b5d51203a0f9079f8aeb098a6523a13f298c060

Параметры с пометкой «path» являются частью URL.

Пример запроса

curl -s "https://www.coinboss.com/api/hl/address/0x5b5d51203a0f9079f8aeb098a6523a13f298c060"

Поля ответа

Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
updatednumbermsВремя последнего обновления данных.
accountValuenumberUSDСобственные средства счёта.
totalNtlPosnumberUSDСовокупная номинальная стоимость всех открытых позиций счёта по бессрочным контрактам из сводки маржи Hyperliquid.
totalMarginUsednumberUSDМаржа, заблокированная сейчас под открытые позиции счёта, из сводки маржи Hyperliquid.
withdrawablenumberUSDБаланс, который счёт может вывести прямо сейчас, по данным Hyperliquid.
positionsarray—Открытые позиции.
positions[]object—Открытые позиции.
positions[].coinstring—Символ монеты в верхнем регистре (например, BTC).
positions[].szinumber—Размер позиции в монетах со знаком (отрицательное значение = шорт).
positions[].entryPxnumberUSDСредняя цена входа.
positions[].positionValuenumberUSDНоминал позиции.
positions[].unrealizedPnlnumberUSDНереализованные прибыль и убыток.
positions[].returnOnEquitynumberfractionНереализованный PnL, делённый на маржу позиции, в том виде, в каком его сообщает Hyperliquid (0.13 = 13 %).
positions[].liquidationPxnumber|nullUSDРасчётная цена ликвидации.
positions[].leverageobject—Плечо позиции.
positions[].leverage.typestring—Тип.
positions[].leverage.valuenumber—Значение.
positions[].marginUsednumberUSDМаржа, используемая позицией.
positions[].fundingSinceOpennumberUSDНакопленное финансирование с момента открытия позиции в принятом у Hyperliquid соглашении о знаке (положительное = уплачено, отрицательное = получено); 0, если не публикуется.

Сформировано 2026-11-11 23:00 UTC; использовано реальных ответов: 1.

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

/api/hl/address/0x5b5d51203a0f9079f8aeb098a6523a13f298c060 · Реальный ответ, получен 2026-11-13 03:58:26 UTC. Длинные массивы и словари сокращены для отображения: positions: элементов было 23.

  • {
    • "success": true,
    • "updated": 1794542306834,
    • "accountValue": 72245515.006981,
    • "totalNtlPos": 333028862.928831,
    • "totalMarginUsed": 72245515.006981,
    • "withdrawable": 0,
    • "positions": [
      • { … 10 },
      • { … 10 }
      ]
    }

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
Не кешируется
Частота обновления
в реальном времени при каждом запросе, без кеша
Источники данных
Текущее состояние счёта (сводка по марже и открытые позиции) для любого адреса Hyperliquid, передаваемое напрямую из официального info API Hyperliquid.
Покрытие бирж
Любой корректный адрес 0x
Пагинация
нет
Единицы измерения
USD; position sizes in coin units
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

Текущий статус

ДоступенПроверено: 2026-11-13 03:58:26 UTCHTTP 200101 msСхема совпадаетВозраст самой новой точки данных: 0s

Доступность за последние 30 дней

Пройдено 100% из 409 проверок

Ошибки

Неудачные вызовы имеют одинаковую структуру на всех эндпоинтах. Полный список приведён на странице ошибок. Ошибки и лимиты запросов →

КодHTTPЗначениеЧто делать
INVALID_PARAM400Отсутствует обязательный параметр, или значение не принимается. `param` называет параметр, если он известен.Не повторяйте запрос без изменений; исправьте его.
UNAUTHORIZED401Заголовок `CB-API-KEY` был отправлен, но ключ неизвестен или отозван. Для публичных данных ключ не нужен — уберите заголовок или используйте действительный ключ.Не повторяйте запрос без изменений.
FORBIDDEN403Маршрут не входит в публичный API (внутренний или только для аккаунта).Не повторяйте запрос.
NOT_FOUND404Неизвестный маршрут, либо запрошенная монета / биржа / фонд не существует.Не повторяйте запрос; сверьте путь и идентификаторы с каталогом.
RATE_LIMITED429Запросов больше, чем позволяет поминутный лимит. `Retry-After` указывает, сколько секунд нужно подождать.Дождитесь истечения `Retry-After`, затем повторите запрос с нарастающей задержкой.
INTERNAL500Непредвиденная ошибка сервера. Сообщение намеренно общее; при обращении указывайте `request_id`.Повторите запрос один раз через несколько секунд; если ошибка сохраняется, сообщите о ней, указав ID запроса.
UPSTREAM_FAILED503Источник данных, стоящий за этим эндпоинтом, не ответил вовремя. Устаревшие или подменные значения вместо него не возвращаются.Повторите запрос с нарастающей задержкой; проверьте страницу статуса.
UNAVAILABLE501 / 503Набор данных временно не готов (прогрев кеша), либо у эндпоинта пока нет законного публичного источника.Повторите запрос позже; каталог помечает эндпоинты, недоступные по проектному решению.
REQUEST_FAILED200Некоторые более старые эндпоинты отвечают HTTP 200 с `success: false`. Всегда проверяйте `success`, а не только статус HTTP.Зависит от сообщения; считайте запрос неудачным.

Попробовать

GET/api/hl/address/:addrДоступен
Параметры

string — 0x-prefixed 40-hex address; 400 on bad format.

URL запросаhttps://www.coinboss.com/api/hl/address/0x5b5d51203a0f9079f8aeb098a6523a13f298c060
Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.