> 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/personalnyi-hl-tracker-or-gaid-dlya-polzovatelya.md). # Персональный HL Tracker | Гайд для пользователя Актуальная сборка на дату 22.06.2026 Персональный бот следит за позициями выбранных **тобой** кошельков на бирже **Hyperliquid** в реалтайме и шлёт алерты **лично тебе в личку**. В отличие от общего бота в группе (где список китов ведёт админ), здесь **ты сам**: * добавляешь до **10 кошельков**, за которыми хочешь следить, * выбираешь монеты, направление и минимальный размер сделки, * получаешь алерты в личных сообщениях с ботом, * видишь живой закреп со всеми своими позициями. > ⚠️ Доступ — только для участников группы **W DAO**. Если выйдешь из группы — слежка приостановится, при возвращении восстановится автоматически. *** ### ⚡ 1. Быстрый старт 1. Открой бота и нажми **/start** — увидишь приветствие и кнопки внизу: `➕ Добавить кошелёк` · `📋 Мои кошельки` · `🤖 Свой бот` · `❓ Помощь`. 2. **Пришли адрес кошелька** `0x…` (или ссылку на hypurrscan) — запустится окно добавления. 3. Пройди 3 шага: **монеты → направление → минимальный размер** (см. §3). 4. Готово — алерты по этому кошельку начнут приходить **сюда, в этот чат**. Текущие позиции появятся в **закрепе** (`📌 Мои подписки`, обновляется каждые 30 сек). 5. **Больше 3 кошельков?** Подключи личного бота (`🤖 Свой бот`) — это обязательно (см. §7). > Первое, чему стоит научиться — читать шапку алерта: открытие/закрытие, LONG/SHORT, Market/Limit/TWAP. Всё это в §9. *** ### 🔐 2. Доступ — только для участников W DAO Бот доступен **только** тем, кто состоит в группе W DAO. Это проверяется автоматически: * **Ты в группе** → пользуешься ботом как обычно. * **Вышел / исключён из группы** → придёт сообщение «🚫 Доступ ограничен», все твои подписки **замораживаются** (алерты перестают приходить), но **сохраняются**. * **Вернулся в группу** → подписки **восстанавливаются сами**, ничего заново настраивать не нужно. Ничего отдельно «активировать» не требуется — просто будь участником группы. *** ### ➕ 3. Добавить кошелёк Нажми `➕ Добавить кошелёк` (или просто пришли адрес `0x…` / ссылку hypurrscan). Мастер проведёт через 4 коротких шага в **одном редактируемом сообщении**: #### Шаг 1 — имя ``` 📡 Новый кошелёк 0x9378…f2c2 Короткое имя (для удобства): ``` Напиши понятное имя (например «Кит APE») — оно будет в шапке алертов и в закрепе. Можно нажать **Пропустить** — тогда именем станет короткий адрес. #### Шаг 2 — монеты ``` 💼 Кит APE Какие монеты отслеживать? ☐ 🌐 Все монеты ``` * **🌐 Все монеты** — следить за всем, что торгует кошелёк (рекомендуется, если хочешь полную картину). Новые монеты подхватятся сами. * Или выбери конкретные из его **открытых позиций** (нажимай — появится ☑). * **✍️ Ввести монету** — добавить тикер вручную (например `BTC`, `HYPE`, `kPEPE`), даже если сейчас по ней нет позиции. * **Далее →** когда выбрал. #### Шаг 3 — направление ``` 🎯 Кит APE Какие направления отслеживать? ``` * **◉ Оба (LONG + SHORT)** — все сделки (по умолчанию). * **Только 🟢 LONG** — только лонги. * **Только 🔴 SHORT** — только шорты. #### Шаг 4 — минимальный размер ``` 🔔 Кит APE Минимальный размер сделки для алерта: Сейчас: все (меньше — не уведомляем; ликвидации приходят всегда) ``` Отсекает мелочь. Пресеты **все / $1k / $10k / $50k**, или **✏️ Своё** (введи число: `500`, `$2k`, `1.5M`). Жми **✅ Сохранить**. ``` ✅ Кошелёк добавлен! 💼 Кит APE • монеты: BTC,HYPE • направление: LONG+SHORT • мин. размер: $1k Алерты будут приходить сюда. Текущие позиции появятся в закреплённом сообщении. ``` > Можно отслеживать до **10 кошельков**. Кнопки `← Назад` на любом шаге возвращают на предыдущий. *** ### ⚙️ 4. Что означают настройки | Настройка | Что делает | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Монеты** | Фильтр по тикерам. «🌐 Все монеты» = без фильтра (всё, что торгует кошелёк). Конкретный список = только эти монеты. | | **Направление** | LONG / SHORT / Оба. Если выбрал «только LONG» — шорт-сделки этого кошелька тебе не придут. | | **Мин. размер** | Порог размера сделки в USD. Сделки меньше порога не присылаются. `все` = без порога. **Ликвидации приходят всегда, независимо от порога.** | > 💡 Эти настройки — твои личные. Другой пользователь, следящий за тем же кошельком, может выбрать другие монеты/порог — вы не мешаете друг другу. *** ### 📋 5. Мои кошельки Кнопка `📋 Мои кошельки` — список твоих подписок. Каждая строка: имя (ссылка на hypurrscan), монеты, направление, мин. размер. ``` 📋 Мои кошельки Кит APE BTC,HYPE · LONG+SHORT · мин $1k WIF Whale ⏸ все монеты · LONG · мин все ``` Под каждым кошельком — кнопки: | Кнопка | Действие | | ------------ | -------------------------------------------------------------------------------------------------------------- | | **✏️ <имя>** | Изменить настройки (заново пройти мастер монеты → направление → размер, всё уже предзаполнено) | | **⏸ / ▶️** | Поставить на паузу / снять с паузы. На паузе алерты и закреп по этому кошельку молчат, но подписка сохраняется | | **🗑** | Удалить (спросит подтверждение) | Снизу — **➕ Добавить кошелёк**. > 💤 Значок «дремлет» рядом с кошельком означает, что подписка заморожена (ты вышел из группы W DAO). *** ### 📌 6. Закреп «Мои подписки» В личке с ботом закреплено сообщение с **живой сводкой по всем твоим кошелькам**. Обновляется каждые **30 секунд** (только то, что ты отслеживаешь — твои монеты/направления). ``` 📌 Мои подписки · 14:32 MSK ━━ Кит APE ━━ 🟢 HYPE LONG $541k x20 Entry 44.10 · Mark 45.02 · Liq 31.8 uPnL +$11.2k ━━ WIF Whale ━━ 🔴 WIF SHORT $120k x5 Entry 1.95 · Mark 1.88 · Liq 2.41 uPnL +$4.3k Кошельков: 2 ``` > Открыл бота → глянул закреп → сразу видно, кто как стоит. Следить руками не нужно. *** ### 🤖 7. Свой бот (Own Bot) У Telegram есть лимит скорости на одного бота (\~30 сообщений/сек на всех пользователей). Чтобы алерты приходили **без задержек**, ты можешь подключить **личного бота** — тогда твои уведомления идут через него, отдельно от всех. **При более чем 3 кошельках подключить свой бот обязательно** — при добавлении 4-го бот попросит это сделать: ``` 🤖 Чтобы отслеживать больше 3 кошельков, подключите личного бота. [🤖 Подключить свой бот] ``` #### Как подключить Нажми `🤖 Свой бот` и следуй инструкции: 1. Открой **@BotFather** в Telegram. 2. Отправь **/newbot**. 3. Придумай имя и username (должен заканчиваться на `bot`). 4. **Скопируй Token** (вид `123456789:ABCdef…`) и **пришли его сюда** одним сообщением. 5. Бот проверит токен и попросит: **открой своего бота и нажми Start**, затем вернись и жми **🔄 Проверить**. 6. Готово: ``` 🎉 Готово! Алерты и закреп теперь идут через вашего личного бота. ``` С этого момента все уведомления и закреп приходят через твоего бота. Настраивать кошельки ты по-прежнему продолжаешь **здесь, в этом (основном) боте** — личный бот нужен только для доставки. * **⚠️ Никому не передавай токен** — он даёт полный контроль над ботом. * **Отключить** свой бот можно кнопкой `❌ Отключить` (доступна, если у тебя ≤3 кошельков). Доставка вернётся на основного бота. * Если личный бот перестанет работать (токен отозвали / бота остановили) — придёт предупреждение, и алерты временно пойдут через основного бота. *** ### 🆕 8. Новая монета у кита Если ты выбрал **конкретные монеты** (не «все»), а отслеживаемый кошелёк начал торговать **новую** монету (которой нет в твоём списке) — придёт подсказка: ``` 🆕 Новая монета у кита Кит APE начал торговать SOL 🟢 на $120k. Добавить SOL в отслеживание этого кошелька? [➕ Добавить SOL] [🗑 Скрыть] ``` Нажми **➕ Добавить SOL** — монета добавится к этому кошельку, и ты начнёшь получать по ней алерты. Подсказка приходит **один раз** на пару (кошелёк + монета). > Если у тебя выбрано «🌐 Все монеты» — подсказка не нужна (ты и так получаешь всё). *** ### 📖 9. Как читать алерт Алерты по содержанию такие же, как в общем боте — меняется только то, что они приходят **тебе в личку** и **отфильтрованы по твоим настройкам**. Структура любого алерта о сделке: ``` 🟢 OPEN LONG · Кит APE · +$340k BTC 🎯 MARKET ← шапка Позиция: $1.24M LONG ← размер после сделки Ликвидация: 62 120 ← блок «позиция»: Цена: 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) | | `· имя` | Имя кошелька (как ты его назвал) — кликабельная ссылка на hypurrscan | | **+$340k / −$340k BTC** | Размер сделки. `+` = открытие, `−` = закрытие | | 🎯 / 📊 / ⏱ | Тип fill'а — Market / Limit / TWAP-слайс | | **(×N)** | Бот «склеил» N мелких сделок подряд в одну (общий размер, средняя цена) | | **(reopen)** | Кит снова открывается, пока идёт серия набора | #### Блок «Позиция» | Строка | Что значит | | -------------- | ---------------------------------------------------------------- | | **Ликвидация** | Цена, при которой кошелёк ликвидируют. Близко к текущей — опасно | | **Цена** | Цена этой сделки (или mark, если позиция уже закрыта) | | **ТВХ** | Точка входа в текущую позицию | | **Net PNL** | Накопленный реализованный PnL по этой монете | | **uPNL** | Нереализованный PnL текущей позиции | Если позиция закрылась полностью — вместо блока придёт плашка **«ПОЗИЦИЯ ЗАКРЫТА ПОЛНОСТЬЮ»** (или **«ЛИКВИДИРОВАНА ПОЛНОСТЬЮ»**). `💰 Total` — equity всего аккаунта кошелька, `Free` — свободная маржа. *** ### 🎯 10. Типы сделок и серии #### Market / Limit / TWAP | Иконка | Тип | Что это | | ------------- | ------------------------------------------------------------- | ------- | | 🎯 **MARKET** | Маркет-ордер (taker) — «съел» стакан, обычно срочно | | | 📊 **LIMIT** | Лимит-ордер (maker) — исполнился по заранее выставленной цене | | | ⏱ **TWAP** | Слайс большого ордера, растянутого во времени | | #### ⚪ Шлейф (серия сделок) Когда кошелёк активно дёргается **подряд** в одну сторону, бот ловит серию в окно \~60 секунд и в конце шлёт **итоговую сводку**: ``` ⚪ Шлейф закрыт · Кит APE · LDO 🔴 CLOSE LONG ⏱ 2м 6с · 448 close + 0 open 📉 Close total: −$556k 📊 NET: −$556k (нетто-закрытие) Было: $667k LONG → ПОЗИЦИЯ ЗАКРЫТА ПОЛНОСТЬЮ Realized: +$59,379 ``` Отдельные fill-алерты — это каждый шаг; шлейф — **результат серии**. #### ⏱ TWAP — большие растянутые ордера У TWAP есть жизненный цикл: **🟡 TWAP STARTED** (начался, известны total/длительность) → **⏱ прогресс** (для длинных, \~раз в 30 мин) → **✅ TWAP DONE** (исполнен) или **🛑 TWAP CANCELLED** (прерван). Отдельные слайсы приходят только первые несколько — дальше прогрессом, чтобы не спамить. #### 🚨 Ликвидации Самые важные алерты, приходят с **критическим приоритетом** (вперёд очереди) и **игнорируют твой мин. размер**. Бывают одиночные, каскадом (`🚨🔴 5× LIQUIDATED`), и финальная плашка **«ЛИКВИДИРОВАНА ПОЛНОСТЬЮ»** + авторитетный **LIQUIDATION SUMMARY** от биржи. #### 🔄 Flip — переворот позиции Кошелёк закрыл LONG и открыл SHORT (или наоборот): ``` 🔄 FLIP · Кит APE · BTC 🟢 LONG → 🔴 SHORT Closed: $1.24M LONG @ 67 920 (Realized +$8,640) Opened: $800k SHORT @ 67 930 ``` #### 📌 Ордера Если сделка прошла через выставление/отмену лимит-ордеров, можешь видеть 📌 **PLACED** / ❌ **CANCELLED** / ↔️ **MODIFIED** / 🛡 **SL** / 🎯 **TP** (с ценой и расстоянием от mark). *** ### 📱 11. Pushover — push на телефон (опционально) Кроме алертов в Telegram, твои персональные кошельки можно вывести на **push-уведомления на телефон** через соседний бот **@WDAO\_robot** (Pushover). Удобно, когда Telegram заглушен. 1. Открой **@WDAO\_robot** → `Pushover` → `HL Tracker` → раздел **Кошельки**. 2. Твои персональные кошельки появятся там с бейджем **«мой»** (они подтягиваются автоматически, пока кошелёк у тебя в подписках). 3. Создай профиль: выбери кошельки (твои «мои» и/или общих китов), монеты, стороны, мин. размер, события (open/close, TWAP, flip, ликвидации, first open/close), cooldown. 4. Сохрани → push'и пойдут на твой Pushover. > Доставку Pushover делает @WDAO\_robot по твоему ключу. Персональный бот лишь передаёт туда события по твоим кошелькам — приватно, только тебе. *** ### ❓ FAQ **«Добавил кошелёк, но алертов нет»** Проверь: (1) кошелёк сейчас вообще торгует нужные тебе монеты/сторону; (2) сделки не ниже твоего **мин. размера**; (3) подписка не на ⏸ паузе (`📋 Мои кошельки`); (4) ты участник группы W DAO. **«Пришёл 🆕 про новую монету — что это?»** Кит начал торговать монету, которой нет в твоём списке по этому кошельку. Нажми **➕ Добавить**, если хочешь получать по ней алерты. **«В шапке имя, а не адрес — откуда оно?»** Это имя, которое **ты** задал кошельку при добавлении (можно поменять в `📋 Мои кошельки → ✏️`). Само имя — ссылка на hypurrscan. **«Хочу больше 3 кошельков»** Подключи личного бота (`🤖 Свой бот`, §7) — тогда лимит откроется до 10. **«Слишком много алертов»** Подними **мин. размер** у шумных кошельков (`✏️`), сузь список монет, или поставь кошелёк на ⏸ паузу. Самый чистый сигнал — конкретные монеты + высокий мин. размер. **«Вышел из группы — что с подписками?»** Они замораживаются (не теряются). Вернёшься в W DAO — восстановятся автоматически. **«Личный бот не шлёт»** Убедись, что ты нажал **Start** в своём боте и прошёл **🔄 Проверить**. Если токен отозвали — переподключи бота заново (`🤖 Свой бот`). *** > Идеи / баги → пиши админу. --- # 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/personalnyi-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.