Огляд

Швидкий старт

1. У «Опції» додайте Bybit API key із дозволом Derivatives Trade, без Withdraw.
2. У «Трейдери» прив’яжіть окремий субакаунт до кожного активного трейдера.
3. Виберіть ризик, множник і натисніть «Оновити equity».
4. Залиште Dry-run, перевірте нові сигнали та позиції.
5. Лише коли чекліст готовності зелений, введіть LIVE REAL MONEY.

Як працює навігація

«Позиції», «Сигнали» і «Чати» — дворівневі розділи. Натискання головної кнопки відкриває меню трейдерів. Виберіть конкретного автора, щоб не змішувати його записи з іншими; пункт «Усі трейдери» потрібен лише для загального контролю.

На сторінці є ще два рівні відбору. Кнопки LIVE / PAPER / Усі визначають тип виконання. Наступний фільтр визначає стан запису: активний, закритий, виконаний, помилковий тощо. На телефоні меню трейдерів відкривається над нижньою панеллю, а вкладки авторів прокручуються горизонтально.

• LIVE: записи, пов’язані з реальними ордерами відповідного субакаунта.
• PAPER: симуляції без біржового ордера, але з обліком результату та витрат.
• Усі: обидва режими разом; завжди перевіряйте кольоровий бейдж біля запису.

Огляд і контроль

Верхні індикатори показують стан Telegram і глобальний режим виконання. LIVE · REAL MONEY означає, що реальні заявки дозволені, але фактично їх надсилають лише трейдери, у яких окремо вибрано LIVE. DRY-RUN блокує реальні входи для всіх.

Картки капіталу показують загальний equity, чисто внесені кошти, результат за балансом та сумарний ризик незакритих позицій. Готовність до Live — не помилка й не кнопка запуску, а автоматичний чекліст Telegram, API-ключів, прив’язок, equity та ризиків. Відсоток показує частку успішних перевірок; кожен червоний рядок називає конкретну незавершену умову.

Останні події — скорочений журнал рішень парсера. Тут зручно помітити нову помилку, але повну причину та історію слід читати у «Сигналах».

Трейдери, акаунти та ризик

Усі п’ять трейдерів торгуються на USDT perpetual futures з ізольованою маржею. Окремий субакаунт не дає позиціям різних трейдерів змішуватися.

• SIM: паперова торгівля: без заявки на Bybit, але з повним PnL, комісіями та фандингом у статистиці.
• LIVE: реальні гроші; потребує перевіреного акаунта та увімкненого глобального Live. Вже відкриті SIM-позиції назавжди лишаються SIM.
• % із сигналу: відсоток автора × ваш множник × зафіксований equity.
• Власний %: ваше значення × множник × зафікований equity.
• Фіксована сума: задані USDT × множник.

Розмір = ризик / (відстань до SL + комісія входу й виходу). Кількість округлюється вниз до кроку Bybit. Плече береться максимально дозволене активом, але з запасом між SL і ліквідацією.

Особливості трейдера 3

Його зона ENTRY перетворюється на середню ціну лімітного входу. Усі TARGETS зберігаються як план. Якщо цілей 8, кожна відповідає 1/8 початкової позиції; накопичувальні повідомлення Target 1/2/3 не закривають одну частину двічі.

Коментарі «still active», «remains valid», «nothing changed» та подібні зберігаються у чаті, але не виконують жодної біржової дії. Повідомлення про Loss/Target звіряються з позицією та закривають відповідну частину.

Позиції та ручне керування

SIM — тестовий запис Dry-run; LIVE — реальна заявка/позиція. Перехід у Live не перетворює SIM на реальні гроші: тестова історія залишається окремою і не потрапляє у біржову звірку.

Фільтр «Вже відкриті» показує позиції з фактичним входом, а «Очікують входу» — активні лімітні заявки, які ще не стали позиціями. На комп’ютері натисніть назву будь-якого стовпця для сортування; на телефоні використовуйте поле сортування та кнопку ↑/↓.

Захист LIVE-ф'ючерсів: SL прикріплюється до входу на повний обсяг і спрацьовує по ринку. TP не використовується як стандартний ринковий Bybit Take Profit: після підтвердження фактичного fill бот виставляє окрему resting reduce-only LIMIT-заявку GTC. Вона заздалегідь стоїть у стакані, а після добору автоматично перебудовується на повний актуальний обсяг. Якщо окрема частка менша за мінімальний ордер Bybit, інтерфейс позначає її як об’єднану з іншою TP-ліміткою; загальна кількість при цьому лишається повністю покритою.

• У беззбиток: переносить SL на фактичний вхід.
• Закрити: у Live надсилає reduce-only Market, у Dry-run завершує симуляцію.
• × біля TP: видаляє вибрану ціль із плану та скасовує пов'язану Live TP-лімітку, якщо це остання ціль.
• В архів: ховає завершений запис; активну Live-позицію архівувати не можна.
• Видалити: остаточно видаляє лише неактивний запис, який уже в архіві.

Ручна торгівля та гнучкий стоп

Розділ «Ручна» працює з фактичними позиціями вибраного Bybit-акаунта. Сітка входу створює лімітні заявки з одним фізичним ринковим SL, а сітка виходу розкладає весь доступний обсяг на reduce-only LIMIT TP.

Одночасні LONG і SHORT. Для нових ручних сіток софт вмикає Hedge Mode символу та веде напрямки незалежно: LONG використовує positionIdx 1, SHORT — positionIdx 2. Активна сітка протилежного напрямку не блокує нову; друга сітка того самого напрямку блокується, щоб не змішувати ризик і скасування. Кнопка скасування прибирає лише невиконані ордери конкретного плану. Стару one-way позицію потрібно спочатку закрити — Bybit не дозволяє перемкнути режим із відкритою позицією або старими one-way ордерами.

Гнучкий стоп стежить за підтвердженими свічками Bybit Last Price обраного таймфрейму. Для LONG правило спрацьовує лише коли Close строго нижче рівня; для SHORT — строго вище. Тінь свічки та рівність рівню нічого не роблять. Після тригера софт перечитує фактичний залишок позиції та відправляє один Market reduce-only ордер на весь цей залишок із правильним hedge/one-way position index.

• Правило можна створити заздалегідь для активної сітки входу. Воно має статус «очікує входу», ігнорує всі попередні свічки та автоматично активується, щойно Bybit покаже перший фактичний fill. Якщо сітку скасовано без позиції, правило також скасовується.
• Правило зберігається в базі й автоматично відновлюється після перезапуску.
• Якщо WebSocket тимчасово недоступний, пропущені закриті свічки перевіряються через Bybit REST.
• Нове правило для тієї самої позиції замінює попереднє; його також можна скасувати вручну.
• Фізичний SL не переноситься і не скасовується. Ставте його далі за гнучкий рівень як аварійну страховку на випадок недоступності сервера, мережі або Bybit API.
• Ринкове виконання може мати прослизання. Telegram повідомляє про відправлене закриття або помилку, але остаточний fill завжди перевіряйте на Bybit.

Як читати «Сигнали»

Сигнал — це висновок парсера щодо одного Telegram-повідомлення. Він показує дію, актив, ID позиції, режим виконання, результат і час. Один сигнал не завжди означає новий вхід: це може бути перенесення SL, частковий TP, скасування або інформаційний коментар.

• Активні позиції: усі сигнали, що зараз належать незакритим позиціям. Це зручна історія життя угоди від входу до останнього оновлення.
• Виконані: команда успішно оброблена. Для LIVE це може означати «заявка прийнята», а остаточний fill підтверджує звірка Bybit.
• Помилки: дія не завершилася; текст під записом пояснює конкретну причину.
• Пропущені: бот навмисно нічого не зробив — наприклад, повідомлення не є торговою командою, трейдер вимкнений або вхід застарів.

При аналізі проблеми читайте разом дію, статус і пояснення. Сам червоний статус без тексту результату не дає повної картини.

Як читати «Чати»

Це незмінений архів Telegram: команди, звичайні коментарі, відповіді та повідомлення без тексту. Спочатку виберіть трейдера. LIVE/PAPER відбирає повідомлення, які вже зв’язані з позицією відповідного режиму; «Усі» також показує загальні коментарі без позиції.

Натискання на повідомлення з ID позиції переносить у «Позиції» й підсвічує потрібний запис. Кнопка «Повідомлення» у позиції робить зворотне: відкриває всю пов’язану Telegram-гілку. Так можна перевірити, які саме слова автора спричинили вхід, TP, беззбиток або закриття.

Поле пошуку шукає у тексті поточного архіву. Повідомлення «без тексту / медіа» означає, що Telegram-запис існує, але його корисний вміст був вкладенням або порожнім текстом.

Словник статусів

• Відновлення заявки: локальний запис створений до звернення до Bybit; бот шукає підтвердження за безпечним ідентифікатором.
• Надіслано / Очікує: заявка прийнята або лімітний вхід ще чекає виконання.
• Очікує розвороту: протилежна лімітка збережена, але ще не надіслана на Bybit. Вона буде виставлена лише після підтвердженого повного закриття поточної позиції цього трейдера по тому самому активу.
• Відкрита: позиція підтверджена біржею або активна у PAPER-моделі.
• Закривається / Скасовується: команда відправлена, остаточний стан ще звіряється.
• Закрита: обсяг дорівнює нулю, результат можна включати в статистику.
• Скасована: вхід не відбувся або залишок заявки скасований.
• Симуляцію завершено: PAPER-запис вручну прибраний з активних без біржової дії.
• Архів: завершений запис прихований з робочого списку, але ще зберігається.

Аналітика дохідності та RR

За сигналом / ideal використовує заявлені автором ціни входу й виходу без наших витрат. Gross за ціною використовує наші фактичні fill-ціни, але ще до комісій і фандингу. Факт net — те, що реально залишилося після всіх витрат. Виконання vs сигнал не є прибутком: напис «краще на $3,76» означає, що фактичний результат на $3,76 кращий за результат автора, навіть якщо обидва результати збиткові.

RR = PnL ÷ початковий ризик конкретної угоди. +1R означає прибуток, рівний її ризику до SL; −1R — повну ризикову втрату. Якщо автор вказав ризик 0,5%, цей менший доларовий ризик усе одно є 1R для цієї угоди. Саме тому стоп при 0,5% відображається приблизно як −1R, а не −0,5R. Колонка «Ризик сигналу / USDT» показує обидва значення поруч.

Два кольорові графіки будують плавні криві накопичувального результату кожного трейдера в RR за всіма його закритими позиціями. Net-графік використовує фактичний PnL після витрат, Gross-графік — результат до комісій і фандингу. Кожна точка відповідає одній реальній закритій угоді; згладжується лише лінія між точками, самі значення не змінюються.

Win rate — частка прибуткових закритих угод. Високий win rate не гарантує прибутковість, якщо середній збиток більший за прибуток. Активних — незакриті позиції, їх плаваючий результат ще не є остаточним. Графік «Останні 7 днів» показує потік повідомлень і сигналів, а «Статуси сигналів» — частку виконаних, пропущених і помилкових рішень.

Для LIVE closed PnL, комісії та фандинг звіряються з Bybit. Комісії й фандинг показуються окремо для пояснення, але повторно з net PnL не віднімаються. Знак фандингу: + отримано, − сплачено. Для PAPER оцінюються витрати та фандинг за моделлю симуляції. Блок «Окремо за трейдером» ізолює результати вибраного автора.

Баланси, депозит і рух коштів

Equity — фактична оцінка активів субакаунта Bybit зараз, включно з плаваючим результатом. Вона оновлюється автоматично приблизно раз на хвилину; кнопка «Оновити баланс» потрібна лише для негайної перевірки.

Внесено — початковий баланс плюс записані поповнення. Знято — записані виведення. Чисто внесено = внесено − знято. Результат за балансом = поточний equity − чисто внесено; він включає реалізований і плаваючий торговий результат.

Після поповнення або зняття сам equity підтягнеться автоматично, але подію треба вручну внести в журнал руху коштів. Інакше система бачить зміну балансу, проте не може безпомилково відрізнити переказ від торгового PnL. Перша ненульова сума нового акаунта автоматично стає початковим капіталом. Для окремої статистики кожному трейдеру потрібен власний Bybit-субакаунт.

«Опції»: API, режими та аудит

API-акаунти: дайте зрозумілу назву, виберіть Mainnet, введіть key і secret та натисніть «Перевірити та зберегти». Ключ зберігається на сервері у зашифрованому вигляді й повторно в інтерфейсі не показується. Потрібні права читання та Derivatives Trade; Withdraw заборонений. Після збереження прив’яжіть акаунт до трейдера на його сторінці.

Глобальний режим: Dry-run негайно забороняє нові реальні входи. LIVE лише дозволяє реальне виконання; остаточне рішення також залежить від режиму конкретного трейдера, його стану та чекліста. Фраза LIVE REAL MONEY захищає від випадкового натискання.

Захист депозиту: пороги 2/10 хвилин задають максимальну кількість дій, що збільшують ризик. «Розблокувати» використовуйте тільки після перевірки Telegram-повідомлень, сигналів і Bybit. Аудит системи — технічний журнал змін налаштувань, ручних дій, запусків, звірок і помилок; кнопка «Оновити» перечитує його без зміни торгівлі.

Кнопка з чотирма кутами ліворуч від круглої стрілки розгортає Mini App на весь екран; повторне натискання повертає стандартний розмір. Кругла стрілка примусово перечитує стан. Зазвичай це не потрібно: інтерфейс і баланси оновлюються автоматично. Повідомлення про успішне збереження означає завершену серверну операцію; після помилки прочитайте червоний текст і не повторюйте натискання багато разів.

Telegram-сповіщення

У «Опції» → «Сповіщення» є лише повідомлення, пов’язані з позиціями. Помилки, перезапуски, баланс, службові події та звичайні коментарі з груп у Telegram не надходять. Повідомлення отримують усі ID із списку адміністраторів; це не повідомлення у торгові групи. Щоб Telegram міг їх доставити, відкрийте діалог з адмін-ботом та надішліть /start хоча б раз.

• LIVE: вхід, добір, частковий або повний вихід з реальною позицією.
• PAPER: такі самі події для симуляцій. Вимкніть цю категорію, якщо тестова історія не потрібна в чаті.
• Оновлення позиції: Stop Loss, беззбиток, TP, скасування очікуваного входу та часткове закриття. Для них одночасно має бути увімкнений відповідний режим LIVE або PAPER.

Картка завжди містить режим, трейдера, ID позиції, актив, напрям, вхід, SL, ризик, план TP та результат дії. Неможливість надіслати сповіщення ніколи не зупиняє торгівлю.

Практичні сценарії роботи

Новий сигнал: спочатку подивіться Telegram-сповіщення. Далі в «Позиціях» відкрийте цього трейдера → LIVE або PAPER → «Тільки активні». Натисніть ID позиції, якщо треба прочитати всі пов’язані повідомлення автора. Не змінюйте SL вручну на біржі: робіть це через кнопку «У Б/З» або після сигналу автора, щоб локальний стан не розійшовся з Bybit.

Незрозумілий пропуск: відкрийте «Сигнали» → трейдер → «Пропущені». Найчастіше це не помилка: повідомлення було коментарем, вхід прийшов запізно, трейдер вимкнений або сигнал не містив безпечного SL. Якщо запис червоний, відкрийте його текст і аудит — там збережена причина.

Поповнення: переведіть гроші на конкретний субакаунт Bybit, дочекайтеся автооновлення equity, потім додайте вручну «Поповнення» у «Опції» → «Капітал». При знятті зробіть те саме з типом «Зняття». Це зберігає чесний результат за балансом.

Підозрілий рух: не видаляйте активну позицію. Перевірте Bybit, зв’язану гілку повідомлень, «Сигнали» та «Аудит системи». За необхідності використайте «Закрити» — це надсилає reduce-only Market для LIVE — і дочекайтеся підтвердження в позиції та Telegram.

Межі автоматизації та що перевіряти вручну

Бот виконує лише розпізнані торгові команди з достатньою впевненістю та відомим SL. Звичайні коментарі, новини, емодзі, медіа та неоднозначні тексти залишаються в «Чатах», але не створюють заявку. Старі входи та добори після відновлення сервера лише архівуються як історія; це навмисний захист від входу за застарілою ціною.

Для LIVE Bybit підтверджує фактичні fill-ціни й closed PnL під час звірки. Лімітна заявка може лишатися в очікуванні та не означає відкриту позицію. Вебінтерфейс не замінює біржу: у критичній ситуації завжди звіряйте відкриті позиції, ордери, SL і баланс безпосередньо в Bybit.

Фандинг у LIVE береться з фінального біржового результату, а в PAPER лише оцінюється моделлю. Це означає, що симуляція потрібна для порівняння дисципліни й витрат, але не гарантує ідентичного реального виконання. Жодна аналітика не є фінансовою порадою та не скасовує ризик ліквідації, гепу або проблем біржі.

Безпечний перехід у Live

1. Перевірте, що старі SIM-позиції позначені SIM або перенесені в архів.
2. Вимкніть трейдерів, яких поки не плануєте торгувати.
3. Для кожного активного трейдера перевірте ключ, баланс і equity snapshot.
4. Переконайтеся, що ризик у USDT відповідає сумі, яку готові втратити за SL.
5. Увімкніть Live фразою підтвердження. Повернення у Dry-run доступне однією кнопкою.

Захист депозиту

Захист рахує нові входи й добори у двох вікнах: 2 та 10 хвилин. При аномальному потоці він блокує лише збільшення ризику; закриття, SL і ручний вихід залишаються доступними. Після перевірки причини натисніть «Розблокувати».

Не давайте API-дозвіл Withdraw. Якщо Bybit дозволяє IP whitelist, використовуйте IP сервера 130.61.186.191.

Падіння сервера та відновлення

Після перезавантаження systemd запускає сервіс автоматично. До підключення нових Telegram-подій бот звіряє локальні LIVE-позиції з Bybit. Якщо на біржі знайдено позицію без локального власника або API-звірка не завершилася, нові входи блокуються захистом депозиту.

Telegram доганяє всі повідомлення після останнього збереженого ID. Старі входи та добори не виконуються через обмеження віку, але пропущені закриття, скасування і перенесення стопа обробляються. SL і одиночний TP лінійної позиції зберігаються на Bybit та не залежать від роботи вебінтерфейсу.

Рекомендований щоденний порядок

1. На «Огляді» перевірте Telegram online, глобальний LIVE і відсутність блокування захисту.
2. В «Аналітиці» звірте загальний equity та баланси кожного трейдера.
3. У «Позиціях» по черзі відкрийте кожного LIVE-трейдера → LIVE → «Тільки активні».
4. Для незрозумілої позиції відкрийте її повідомлення й прочитайте всю гілку чату.
5. У «Сигналах» перевірте «Помилки», потім «Пропущені»; причина завжди написана в результаті.
6. Після переказу коштів додайте поповнення або зняття в «Опції» → «Капітал».
7. Не видаляйте підозрілий активний запис. Спочатку перевірте Bybit, потім аудит і лише після цього використовуйте ручне закриття.

Якщо щось не працює

• Немає повідомлень: перевірте Telegram · online у верхній панелі.
• Сигнал пропущено: відкрийте «Сигнали» і прочитайте причину.
• Налаштування не зберігаються: ризик і множник мають бути більші нуля; API-акаунт спершу треба перевірити.
• Live не вмикається: червоний пункт чекліста прямо називає відсутню умову.
• Позиція зависла: не видаляйте запис; перевірте Bybit та «Аудит системи», потім використайте ручне закриття.