> For the complete documentation index, see [llms.txt](https://wdao.gitbook.io/wdao-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wdao.gitbook.io/wdao-docs/hl-tracker-or-gaid-dlya-polzovatelya.md). # HL Tracker | гайд для пользователя Актуальная сборка на дату 27.05.2026 Бот следит за позициями китов на бирже **Hyperliquid** в реалтайме и шлёт алерты: * 💬 **В топик группы** — карточки с подробным разбором каждой сделки * 📱 **На телефон через Pushover** — push-уведомления (подписываешься через @WDAO\_robot) Тебе самому ничего настраивать в этом боте не нужно — список китов и фильтры ведёт админ. Твоя задача: научиться **читать** алерты и (опционально) подписаться на Pushover-фильтры. *** ### ⚡ 1. Быстрый старт 1. **Зайди в топик** где бот постит алерты (Hyperliquid Tracker). 2. **Закреплено сверху** — живая сводка по всем активным позициям китов (`📌 ПОЗИЦИИ`). Обновляется каждые 10 секунд. 3. **Лента алертов** — каждое движение кита (открытие/закрытие/TWAP/ликвидация) приходит отдельным сообщением. Лейбл кита — кликабельная ссылка на его hypurrscan. 4. **Хочешь push на телефон?** Открой @WDAO\_robot → `Pushover` → `HL Tracker` → создай профиль (фильтры по кошельку, монете, размеру). Детали — раздел §11. > Первая задача — научиться различать «закрытие» от «открытия» и TWAP от market'а. Это всё в шапке алерта. *** ### 📖 2. Как читать алерт — общая структура Любой алерт о сделке состоит из 3 блоков: ``` 🟢 OPEN LONG · ИМЯ_КИТА · +$340k BTC 🎯 MARKET ← шапка Позиция: $1.24M LONG ← размер после сделки Ликвидация: 62 120 ← блок "позиция" (5 строк): Цена: 67 890 liq / mark / entry / ТВХ: 66 200 net_pnl / unrealized Net PNL: +$3,421 uPNL: −$890 💰 Total $124k · Free $89k ← баланс кита ``` #### Шапка слева направо | Кусок | Что значит | | ----------------------- | -------------------------------------------------------------------- | | 🟢/🔴 | Сторона **позиции**: 🟢 LONG, 🔴 SHORT | | **OPEN / CLOSE** | Что сделал кит: открыл новую часть позиции (OPEN) или закрыл (CLOSE) | | **LONG / SHORT** | Сторона позиции (та же что emoji) | | `· имя кита` | Кликабельная ссылка на hypurrscan кита | | **+$340k / −$340k BTC** | Размер сделки. `+` = открытие (деньги «в» позицию), `−` = закрытие | | 🎯 / 📊 / ⏱ | Тип fill'а — Market / Limit / TWAP-слайс | | **(×N)** | Алерт «склеил» N сделок в одну (см. §3) | #### Блок «Позиция» | Строка | Что значит | | -------------- | ------------------------------------------------------------------------------ | | **Ликвидация** | Цена при которой кита ликвидируют. Если близка к текущей — кит близок к смерти | | **Цена** | Цена этой сделки (или mark price если позиция уже закрыта) | | **ТВХ** | Точка входа (entry price) в текущую позицию | | **Net PNL** | Накопленный реализованный PnL по этому трекеру за всё время | | **uPNL** | Нереализованный PnL текущей позиции (плюс/минус по цене сейчас) | Если позиция полностью закрылась — вместо блока «Позиция» придёт жирная плашка **«ПОЗИЦИЯ ЗАКРЫТА ПОЛНОСТЬЮ»** (или **«ЛИКВИДИРОВАНА ПОЛНОСТЬЮ»** при ликвидации). #### Подвал `💰 Total / Free` `Total` — equity всего аккаунта кита. `Free` — свободная маржа (что осталось под новые позиции). *** ### 🎯 3. Fill-алерты — Market / Limit / TWAP Каждая сделка кита приходит как одна карточка с одним из трёх типов: | Иконка | Тип | Что это | | ------------- | ------------ | ------------------------------------------------------- | | 🎯 **MARKET** | Маркет-ордер | Кит «съел» стакан — taker, обычно срочно | | 📊 **LIMIT** | Лимит-ордер | Кита засосало по выставленному ранее лимиту — maker | | ⏱ **TWAP** | TWAP-слайс | Часть большой растянутой во времени сделки (TWAP-ордер) | #### Что значит «(×N)» в шапке Когда кит делает много мелких сделок подряд (за секунды), бот **склеивает** их в один алерт с общим размером и средневзвешенной ценой. Пример: `🟢 OPEN LONG · ... · +$2.1M BTC 📊 LIMIT (×42)` — 42 лимит-fill'а слиплись в один алерт на $2.1M суммарно. #### Метки в шапке * **⚡ В ШЛЕЙФЕ** — этот fill часть «шлейфа» (см. §4) * **NET: −$240k** — net по шлейфу на момент этого fill'а (closes vs opens) * **(reopen)** — кит **открыл** позицию пока ещё активен open-шлейф (т.е. он сейчас в режиме набора) #### Иконки направления (LONG / SHORT) * 🟢 = LONG (бычья ставка, кит за рост) * 🔴 = SHORT (медвежья ставка, кит за падение) *** ### ⚡ 4. Шлейф (Burst Summary) «Шлейф» — это когда кит активно дёргается **подряд** в одну сторону: серия закрытий или серия открытий за короткое время. Бот ловит такие очереди в окно 60 секунд и в конце показывает **итоговую сводку**: ``` ⚪ Шлейф закрыт · LDO2 · LDO 🔴 CLOSE LONG ⏱ 2м 6с · 448 close + 0 open 📉 Close total: −$556k 📈 Open total: +$0 📊 NET: −$556k (нетто-закрытие) Было: $667k LONG → ПОЗИЦИЯ ЗАКРЫТА ПОЛНОСТЬЮ Realized: +$59,379 ``` | Поле | Смысл | | ---------------------------- | ------------------------------------------------------------------------------------------------- | | **⚪ Шлейф закрыт** | Кит выдохся — за 60с не было ни одной новой сделки | | **CLOSE / OPEN** в шапке | Какой именно поток был доминирующим — серия закрытий или серия открытий | | **⏱** | Длительность шлейфа (от первой сделки до последней) | | **N close + M open** | Сколько fill'ов на каждой стороне попало в шлейф | | **Close total / Open total** | Суммарный USD-объём с каждой стороны | | **NET** | Разница closes − opens (с правильным знаком). «нетто-закрытие» = кит больше закрывал чем открывал | | **Было → Стало** | Размер позиции до и после, с % изменения | | **Realized** | Сколько кит реально зафиксировал PnL за этот шлейф | > Шлейф = «зум-аут» картина. Отдельные fill-алерты показывают каждый шаг, а финальный шлейф — **результат**. *** ### 🔇 5. Тихий шлейф (Hidden Burst) Если все сделки кита прошли НИЖЕ установленных админом фильтров (например min\_size $10k, а кит делает по $4k), то **ни один fill-алерт не пришёл**. Но бот замечает что активность есть и шлёт **тихие напоминания**: ``` 🔇 Тихий шлейф идёт · loracle · HYPE 🔴 CLOSE SHORT ⏱ 12м · 25 close + 0 open · темп $14k/мин 📉 Close total: −$168k 📈 Open total: +$0 📊 NET: −$168k Было: $832k SHORT → $664k SHORT (−20.2%) ``` **Когда приходят:** * через **5 минут** после первой сделки шлейфа * затем через **15 минут**, **30 минут** * дальше каждые **30 минут** пока шлейф жив * в конце — финальная карточка **🔇 Тихий шлейф закрыт** **Темп $X/мин** — единственное доп. поле относительно обычного шлейфа. Подсказывает «насколько быстро кит долбит» — $14k/мин это вяло, $200k/мин это уже опасно. > 🔇 ≠ ⚪. Если видишь 🔇 — это значит весь поток был **под фильтром** (мелкие сделки). Если видишь ⚪ — был хотя бы один заметный fill-алерт в чате. *** ### ⏱ 6. TWAP — большие растянутые ордера TWAP = Time-Weighted Average Price. Кит говорит бирже «продай N токенов равномерно за M минут», и Hyperliquid режет это на десятки/сотни маленьких слайсов. У TWAP есть жизненный цикл: | Алерт | Что это | | --------------------- | ------------------------------------------------------------------ | | 🟡 **TWAP STARTED** | Начался — бот узнал параметры (total / длительность / первая цена) | | ⏱ **TWAP в работе** | Промежуточный summary каждые \~30 минут (для длинных TWAP) | | ✅ **TWAP DONE** | Завершился — кит исполнил \~100% запланированного | | 🛑 **TWAP CANCELLED** | Прерван досрочно (HL отменил или кит остановил) | Пример START: ``` 🟡 TWAP STARTED · кит01 · ZEREBRO 🔴 SELL Total: $387k · Slice ~$134 Длительность: ~24ч (~2880 slices @ 30s) Первая цена: 0.0309 Будет приходить: • первые 5 slice-fills • прогресс каждые 30м • окончание / досрочная отмена ``` Каждый отдельный slice приходит как обычный fill-алерт с ⏱ TWAP, но **только первые 5** — потом бот идёт в режим «прогресс каждые 30м», иначе спам. Пример DONE: ``` ✅ TWAP DONE · кит01 · ZEREBRO 🔴 SELL Executed: 100% ($385k of $387k) · avg 0.0307 Длительность: 23ч 58м 💰 Total $1.2M ``` > Если кит остановил TWAP досрочно (например при ликвидации или панике) — придёт 🛑 CANCELLED с фактическими %% executed. *** ### 🚨 7. Ликвидации Самые важные алерты. Несколько форматов: #### Одиночная partial-ликвидация ``` 🚨🔴 LIQUIDATED · кит01 · −$185k TST 🔴 LONG Позиция: $647k LONG Ликвидация: 0.0157 ... ``` #### Каскад (несколько ликвидаций подряд) ``` 🚨🔴 5× LIQUIDATED · кит01 · TST 🔴 LONG Total: −$832k · avg 0.0131 ``` HL частично ликвидирует позицию по кусочкам если она не успевает закрыться сама. #### Финальный wipe + Summary ``` 🚨🔴 LIQUIDATED · кит01 · TST 🔴 LONG ПОЗИЦИЯ ЛИКВИДИРОВАНА ПОЛНОСТЬЮ ``` Сразу после — отдельный авторитетный summary от Hyperliquid: ``` 🚨 LIQUIDATION SUMMARY · кит01 Total swept: $916k notional • TST: 60.1M Account value after: $84k ``` > 🚨 имеет **критический** приоритет — летит вперёд всех остальных алертов в очереди. *** ### 🔄 8. Flip — переворот позиции Когда кит закрыл LONG и открыл SHORT (или наоборот) — это «флип». Может произойти за секунды (fast-path) или с паузой между ногами. ``` 🔄 FLIP · кит01 · BTC 🟢 LONG → 🔴 SHORT Closed: $1.24M LONG @ 67 920 (Realized +$8,640) Opened: $800k SHORT @ 67 930 Пауза между ногами: 14с ``` > 🔄 имеет **критический** приоритет — это редкое и важное событие. *** ### 📌 9. Ордера (placed / cancelled / modified) Если админ включил трекинг ордеров — увидишь алерты когда кит выставляет/двигает/отменяет лимит-ордера: | Иконка | Тип | Что значит | | --------------- | ---------------------- | ---------------------------------------------------------- | | 📌 **PLACED** | Выставлен лимит-ордер | Кит **готовит** сделку (но пока не исполнилась) | | ❌ **CANCELLED** | Отменён | Кит передумал, снял ордер. **N×** если отменил пачку разом | | ↔️ **MODIFIED** | Сдвинут | Кит переставил цену/размер ордера | | 📊 **SCALE** | Серия ордеров лесенкой | Кит расставил 3+ ордеров рядом за секунду | | 🛡 **SL** | Stop Loss | Защитный стоп | | 🎯 **TP** | Take Profit | Цель прибыли | Каждый алерт показывает цену ордера, размер, и сколько % от mark он отстоит. *** ### 📊 10. Pinned-сводка в топике Сверху топика закреплено сообщение со **сводкой по всем активным позициям всех китов**. Обновляется автоматически каждые 10 секунд. ``` 📌 ПОЗИЦИИ (обновлено 14:32) 🐋 кит01 🟢 BTC LONG $1.24M · Entry 66,200 · Liq 62,120 · uPNL +$3.4k 🔴 ETH SHORT $640k · Entry 3,820 · Liq 4,015 · uPNL −$890 🐋 кит02 — нет выбранных трекеров — ... ``` Сюда попадают только монеты на которые есть **активный трекер** у кита. Если кит держит позиции на других монетах — они не отображаются (по решению админа). > 💡 Pinned обновляется в фоне — не нужно следить руками. Открыл топик → быстро глянул кто живёт. *** ### 📱 11. Pushover — подписка на сигналы китов Если не хочешь следить за топиком — подпишись на push на телефон через **@WDAO\_robot** (соседний бот в этой же приватке). Алерты прилетят даже когда Telegram заглушен. #### Краткий путь 1. Открой @WDAO\_robot → `Pushover` → `HL Tracker` 2. Создай профиль: * **Кошельки** — конкретный список адресов ИЛИ «любой активный» * **Монеты** — какие тикеры тебе интересны * **Стороны** — long / short / обе * **Min size USD** — порог размера сделки (отсекает мелочь) * **События** — Position opened/closed, TWAP, Flip, Liquidation, First open/close, Order placed/cancelled, Deposit/Withdraw * **Cooldown** — пауза между пушами (минуты), `One-time` — пушнуть один раз и отключить 3. Сохрани → push'и пойдут на твой Pushover-аккаунт #### Что особенно полезно подписать | Событие | Зачем | | ---------------------------- | -------------------------------------------------------------------------------------------------------- | | **First open / First close** | Однократный сигнал когда кит **впервые** входит/выходит из монеты. Самый ценный — даёт максимальную фору | | **Liquidation** | Критические события, телефон зазвонит | | **Flip** | Переворот позиции — сильный сигнал смены настроения | | **TWAP start / done** | Узнать о крупных растянутых ордерах | | **Position opened/closed** | Все обычные сделки (может быть шумно — поставь min\_size) | **Полная инструкция** по созданию Pushover-профилей и привязке ключа — в гайде @WDAO\_robot, раздел `Pushover` (§13) и `HL Tracker` (§12). *** ### ❓ FAQ #### «Я вижу одну сделку, потом через минуту 🟢 SUMMARY на тот же кошелёк. Это дубль?» Нет. Первый алерт — отдельная сделка. SUMMARY/«⚪ Шлейф закрыт» — **итог серии** этих сделок (см. §4). Шлейф ждёт 60 секунд тишины и потом показывает суммарный результат. #### «Что значит «(reopen)» в шапке OPEN-алерта?» Кит сейчас **активно набирает позицию** (open-шлейф идёт). Лейбл говорит «это не разовый open, а часть серии — следи внимательно». #### «🔇 Тихий шлейф пришёл, а я ничего раньше не видел в чате — это норм?» Да. 🔇 = вся активность была **под фильтром** (мелкие сделки). Это бот говорит «ты пропустил серию мелочи на $168k за 12м, вот сводка». #### «Где смотреть кошелёк целиком?» Лейбл кита в шапке любого алерта — кликабельная ссылка на **hypurrscan.io** этого адреса. Там вся история позиций и сделок. #### «Слишком много алертов, как уменьшить?» * В топике: попроси админа поменять фильтры * В Pushover: подними **Min size USD**, включи **Cooldown** (например 5 минут), или подписывайся только на **First open/First close** + **Liquidation** #### «Я не вижу алертов хотя кит торгует» * Проверь что админ добавил трекер именно на эту монету + направление (LONG/SHORT/BOTH) * Если у Pushover — проверь что профиль ✅ включён (не на ⏸) * Если совсем тихо — спроси админа --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://wdao.gitbook.io/wdao-docs/hl-tracker-or-gaid-dlya-polzovatelya.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.