Сведения об отдельном ките Hyperliquid

Сведения об отдельном ките Hyperliquid (позиции и активность)

GET/api/hl/whale/:addr

Если сохранённый снимок адреса старше 10 минут, запрос перед ответом обновляет его через публичный API Hyperliquid, поэтому первый вызов может выполняться медленнее.

Запрос

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

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

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

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

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

Поля ответа

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

Поле	Тип	Единица	Описание
success	boolean	—	true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
updated	number	ms	Время последнего обновления данных.
address	string	—	Ончейн-адрес.
tracked	boolean	—	True, если адрес входит в отслеживаемый пул китов.
labels	array	—	Метки.
labels[]	object	—	Метки.
labels[].label	string	—	Метка.
labels[].type	string	—	Тип.
profile	object	—	Запись адреса в пуле; null, если он не отслеживается.
profile.firstSeen	number	ms	Время, когда адрес впервые был зафиксирован в крупном исполнении или ликвидации.
profile.lastActive	number	ms	Время, когда адрес в последний раз встречался в крупном исполнении или ликвидации.
profile.totalVolumeUsd	number	USD	Накопленный номинал крупных исполнений адреса, зафиксированных с момента `firstSeen`; это не полный объём его торгов.
profile.tradeCount	number	count	Число крупных исполнений, зафиксированных по адресу с момента `firstSeen`.
profile.maxFillUsd	number	USD	Крупнейшее разовое исполнение, зафиксированное по адресу.
profile.liqCount	number	count	Ликвидации этого адреса на Hyperliquid, зафиксированные с начала его отслеживания.
profile.source	string	—	Откуда взято значение.
profile.accountValue	number	USD	Собственные средства счёта.
profile.totalUpnl	number	USD	Общий нереализованный PnL.
profile.totalPosValue	number	USD	Сумма стоимостей всех открытых позиций на момент последнего опроса (`posPolledAt`); null, если адрес ни разу не опрашивался.
profile.posPolledAt	number	ms	Время последнего опроса позиций.
positions	array	—	Открытые позиции.
positions[]	object	—	Открытые позиции.
positions[].coin	string	—	Символ монеты в верхнем регистре (например, BTC).
positions[].side	string	—	`long` / `short` или `buy` / `sell`.
positions[].szi	number	—	Размер позиции в монетах со знаком (отрицательное значение = шорт).
positions[].entryPx	number	USD	Средняя цена входа.
positions[].positionValue	number	USD	Номинал позиции.
positions[].unrealizedPnl	number	USD	Нереализованные прибыль и убыток.
positions[].roe	number	fraction	Нереализованный PnL, делённый на маржу позиции, в том виде, в каком его сообщает Hyperliquid (0.13 = 13 %); null, если он равен нулю или отсутствует.
positions[].leverage	number	—	Плечо позиции.
positions[].leverageType	string	—	Режим маржи позиции: `cross` или `isolated`.
positions[].marginUsed	number	USD	Маржа, используемая позицией.
positions[].liquidationPx	number\|null	USD	Расчётная цена ликвидации.
positions[].snapshotTs	number	ms	Время снимка позиций.
recentLiquidations	array	—	До 50 последних ликвидаций этого адреса на Hyperliquid, от новых к старым; пусто, если ликвидаций не зафиксировано. пусто в образцах, по которым построена таблица
stats	object	—	Торговая статистика, рассчитанная по последним исполнениям адреса по бессрочным контрактам (не более 2 000); null, пока она не рассчитана.
stats.windowDays	number	days	Число дней между самым старым и самым новым из проанализированных исполнений (не менее 1).
stats.fillsAnalyzed	number	count	Число проанализированных исполнений: самые последние исполнения, которые Hyperliquid возвращает по адресу, не более 2 000.
stats.closedTrades	number	count	События закрытия среди проанализированных исполнений по бессрочным контрактам (исполнения с ненулевым закрытым PnL, сгруппированные по транзакции и монете).
stats.wins	number	count	События закрытия с положительным закрытым PnL.
stats.winRate	number	fraction	`wins` ÷ `closedTrades` (0.6 = 60 %); null, если событий закрытия нет.
stats.realizedPnl	number	USD	Сумма закрытого PnL по проанализированным исполнениям, до вычета комиссий.
stats.feesPaid	number	USD	Сумма торговых комиссий по проанализированным исполнениям по бессрочным контрактам.
stats.volumeUsd	number	USD	Сумма произведений цена × размер по проанализированным исполнениям по бессрочным контрактам.
stats.maxDrawdown	number	USD	Наибольшее падение накопленного закрытого PnL от пика до минимума в пределах проанализированных исполнений; null, если просадки не было.
stats.roi	number	fraction	Доходность счёта за 30 дней из собственного рейтинга Hyperliquid (0.1 = 10 %); null, если адреса нет в этом рейтинге.
stats.topCoins	array	—	Крупнейшие монеты.
stats.topCoins[]	string	—	Крупнейшие монеты.
stats.computedAt	number	ms	Метка времени.

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

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

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

{
- "success": true,
- "updated": 1794542590673,
- "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
- "tracked": true,
- "labels": [
  - { … 2 },
  - { … 2 }
  ],
- "profile": {
  - "firstSeen": 1784647213853,
  - "lastActive": 1794431032742,
  - "totalVolumeUsd": 1925599.62,
  - "tradeCount": 21,
  - "maxFillUsd": 207800.94,
  - "liqCount": 0,
  - "source": "bigfill",
  - "accountValue": 71962896.59,
  - "totalUpnl": 70395642.16,
  - "totalPosValue": 331781859.18,
  - "posPolledAt": 1794542471343
  },
- "positions": [
  - { … 12 },
  - { … 12 }
  ],
- "recentLiquidations": [],
- "stats": {
  - "windowDays": 1,
  - "fillsAnalyzed": 2000,
  - "closedTrades": 1262,
  - "wins": 772,
  - "winRate": 0.6117,
  - "realizedPnl": 44221.53,
  - "feesPaid": 164.6835,
  - "volumeUsd": 1047900.19,
  - "maxDrawdown": 2774.11,
  - "roi": 0.812723,
  - "topCoins": [ … 5 ],
  - "computedAt": 1793024816450
  }
}