Як створити сигнального бота на Freya Finance

#Як створити сигнального бота на Freya Finance

Сигнальний бот виконує угоди, коли отримує зовнішній сигнал — найчастіше це сповіщення TradingView, надіслане на вебхук. Замість того щоб вибудовувати логіку входу всередині Freya (як це робить DCA-бот), ви приносите власні сигнали з іншої платформи, а сигнальний бот перетворює їх на реальні угоди на вашій біржі.

Якщо у вас уже є стратегія або зв'язка індикаторів, яким ви довіряєте, сигнальний бот — це спосіб автоматизувати їх на Freya. (Якщо ви волієте будувати логіку всередині Freya, почніть натомість із посібника Як створити вашого першого DCA-бота.)

---

#Що таке сигнальний бот

У DCA-бота умови входу ви налаштовуєте всередині Freya. Сигнальний бот — протилежність: рішення про те, коли входити чи виходити, надходить іззовні — з вашої платформи для графіків, вашого власного скрипта або будь-якого інструмента, здатного надіслати вебхук. Коли цей сигнал надходить, сигнальний бот розміщує угоду. Це міст між вашою зовнішньою стратегією та реальним виконанням на вашій біржі.

#Короткий огляд кроків

1. Створіть бота та оберіть тип Сигнальний бот, потім виберіть торгову пару й напрямок.
2. Оберіть сигнальний режим — «Власний сигнал» або Risk Ratio (де вебхук несе ваші take-profit і stop-loss).
3. Скопіюйте URL вашого вебхука (або вебхуків) — «Власний сигнал» дає URL відкриття та URL закриття; Risk Ratio дає єдиний URL.
4. Підключіть джерело сигналів — вставте ці URL у своє сповіщення TradingView (або інший інструмент).
5. Задайте налаштування ордерів і запустіть бота. Відтепер ваші сигнали керують ботом.

#Крок 1: Оберіть тип «Сигнальний бот»

У процесі створення бота оберіть Сигнальний бот («Виконує угоди на основі сигналів вебхуків»), а потім виберіть торгову пару й напрямок — так само, як для будь-якого іншого бота.

#Крок 2: Виберіть сигнальний режим

Сигнальний режим визначає, як ваш бот інтерпретує отримані сигнали. Режимів два, і ви обираєте один — поєднати їх не можна:

• Власний сигнал — бот діє за сигналами відкриття та закриття, які ви надсилаєте через вебхук (наприклад, зі сповіщення TradingView), а ордери у Freya налаштовуєте ви: суму угоди та ваші take-profit і stop-loss.
• Risk Ratio — корисне навантаження вебхука несе ціни take-profit і stop-loss; вхід виконується за ринковою ціною в момент спрацювання сигналу. Замість вибору суми угоди ви задаєте фіксовану суму ризику на угоду, а Freya автоматично розраховує розмір позиції з відстані між входом і stop-loss. Результат: якщо спрацює stop-loss, ви втратите приблизно ту саму суму ризику, яку обрали. Take-profit розміщується як лімітний ордер за ціною з вебхука (тож виконується без Slippage); stop-loss виконується як ринковий ордер після спрацювання, тож — як і будь-який стоп — може зазнати Slippage під час швидкого руху.

Обирайте режим, який відповідає тому, як побудовані ваші сигнали.

#Чому режим Risk Ratio такий потужний

Режим Risk Ratio перевертає визначення розміру позиції з ніг на голову. Зазвичай ви обираєте розмір позиції й приймаєте той збиток, який передбачає stop-loss. У режимі Risk Ratio ви обираєте збиток, на який готові піти, а розмір позиції підбирається під нього автоматично. Це робить ваш ризик на угоду стабільним незалежно від того, наскільки далеко розташований stop-loss, — дисциплінований підхід, яким користуються професіонали. Тип ризику та фіксовану суму ви задаєте на кроці стратегії; сума угоди після цього відображається як динамічна, бо обчислюється в момент надходження вебхука.

#Крок 3: Отримайте URL ваших вебхуків

Які саме URL ви отримаєте, залежить від режиму:

• У режимі Власний сигнал бот отримує URL вебхука відкриття (виклик відкриває позицію) та окремий URL вебхука закриття (виклик закриває позицію).
• У режимі Risk Ratio ви отримуєте єдиний URL вебхука для сигналу входу. Позиція потім закривається автоматично за take-profit і stop-loss, які несе вебхук, тож окремого URL закриття немає. Сигнал надсилається як невелике JSON-повідомлення, що містить значення take-profit і stop-loss.

URL можна скопіювати та перегенерувати будь-коли. Перегенерація створює новий URL і миттєво робить старий недійсним — корисно, якщо URL колись став відомий стороннім.

#Крок 4: Підключіть джерело сигналів

Вставте URL вашого вебхука (або вебхуків) у джерело сигналів. У TradingView, наприклад, ви створюєте сповіщення й задаєте його webhook URL як URL вашого бота. У режимі Власний сигнал ви використовуєте URL відкриття для входів і URL закриття для виходів; у режимі Risk Ratio ви використовуєте єдиний вебхук і додаєте свої take-profit і stop-loss у текст сповіщення. Коли умова сповіщення спрацьовує, TradingView викликає вебхук, і ваш бот діє за ним.

#Крок 5: Задайте налаштування ордерів

Налаштуйте, як бот визначає розмір і розміщує свої ордери. У режимі Власний сигнал ви задаєте суму угоди та ваші take-profit і stop-loss. У режимі Risk Ratio ви натомість задаєте фіксовану суму ризику (сума угоди стає динамічною, а take-profit і stop-loss надходять із вебхука). Потім запустіть бота — він тихо чекає, доки надійде сигнал, і тоді виконує його.

#Як убезпечити ваші вебхуки

Це найважливіша звичка під час роботи із сигнальними ботами: URL ваших вебхуків — це секрети. Будь-хто, у кого є URL, може запустити відповідну дію на вашому боті, тож:

• Ніколи не діліться URL вебхуків і не публікуйте їх привселюдно.
• Вставляйте їх лише в довірені інструменти, як-от ваші власні сповіщення TradingView.
• Негайно перегенеруйте, якщо підозрюєте, що URL став відомий стороннім, — старий одразу перестає працювати.

#Часті запитання

#Що таке сигнальний бот на Freya Finance?

Сигнальний бот виконує угоди на основі зовнішніх сигналів, надісланих на вебхук, — наприклад, сповіщення TradingView. Замість того щоб вирішувати, коли торгувати, всередині Freya, він чекає на ваш сигнал і потім відкриває або закриває позицію на вашій біржі. Це ідеальний варіант, якщо ви вже генеруєте сигнали на іншій платформі.

#Як підключити TradingView до мого сигнального бота?

Оберіть режим Власний сигнал, скопіюйте URL вебхуків відкриття та закриття вашого бота й вставте їх у ваші сповіщення TradingView (URL відкриття — для входів, URL закриття — для виходів). У режимі Risk Ratio ви натомість використовуєте єдиний URL вебхука й додаєте take-profit і stop-loss у текст сповіщення. Коли сповіщення спрацьовує, TradingView викликає вебхук, і ваш бот торгує.

#Яка різниця між режимом «Власний сигнал» і режимом Risk Ratio?

У режимі «Власний сигнал» бот діє за сигналами відкриття та закриття, які ви надсилаєте через вебхук, а ордери налаштовуєте самі — суму угоди та ваші take-profit і stop-loss. У режимі Risk Ratio корисне навантаження вебхука несе ціни take-profit і stop-loss (вхід виконується за ринком у момент спрацювання сигналу), а замість суми угоди ви задаєте фіксовану суму ризику — Freya потім автоматично підбирає розмір позиції з відстані від входу до stop-loss, тож спрацювання стопа коштує вам приблизно рівно того ризику, який ви обрали. Ці два режими не можна поєднати; оберіть той, що відповідає тому, як побудовані ваші сигнали.

#Як працює визначення розміру позиції в режимі Risk Ratio?

Ви задаєте фіксовану суму ризику на угоду. Коли сигнал спрацьовує, Freya виконує вхід за ринковою ціною й зчитує stop-loss із вебхука, після чого розраховує розмір позиції так, щоб збиток на рівні stop-loss дорівнював обраному вами ризику. Це тримає ваш ризик на угоду стабільним незалежно від того, наскільки широкий чи вузький стоп, — ви вирішуєте, який збиток готові прийняти, а розмір підлаштовується під нього.

#Чи є URL моїх вебхуків секретними?

Так — ставтеся до них як до паролів. Будь-хто, у кого є URL вебхука, може запустити відповідну дію на вашому боті. Ніколи ними не діліться, вставляйте їх лише в довірені інструменти й негайно перегенеруйте URL, якщо вважаєте, що він став відомий стороннім. Перегенерація миттєво робить старий URL недійсним.

#Я надіслав сигнал, але нічого не сталося — чому?

Перевірте, що ви використали правильний URL вебхука (відкриття чи закриття), що ваш сигнальний режим відповідає тому, як налаштоване ваше сповіщення, і що бот запущений, а не на паузі. Якщо ви нещодавно перегенерували URL, переконайтеся, що ваше джерело сигналів використовує новий. Щодо загального стану бота дивіться Чому мій бот не торгує?.

#Чи може вебхук задавати мої take-profit і stop-loss?

Так, якщо ви використовуєте режим Risk Ratio. У цьому режимі значення take-profit і stop-loss надходять із корисного навантаження вебхука, а не вводяться вручну у Freya, що дозволяє вашій зовнішній стратегії керувати виходами.