Интеграция Freqtrade для алготорговли криптовалютами

Почему Freqtrade интеграция упирается в инфраструктуру

Алгоритмическая торговля ломается не на стратегии. Сигнал считается мгновенно, а подтвердить, что заявка реально встала в стакан, пережить разрыв связи и не потерять позицию — это уже задача инфраструктуры. Freqtrade интеграция начинается ровно там, где заканчивается проверка стратегии на истории: на стыке торговой логики и реального счёта.

Первое узкое место — обрыв соединения с биржей. Пока канал жив, расчётное состояние позиций и фактическое на счёте совпадают. Стоит связи пропасть на несколько секунд, и отправленный ордер остаётся висеть, а движок считает, что заявка не ушла. На следующей итерации логика принимает решение по неверному балансу — и открывает вторую позицию там, где должна быть одна.

Второе — расхождение позиций после ручных входов в сделку. Трейдер видит возможность и заходит руками, а автоматика об этой сделке не знает. Её расчёт риска, стопов и средней цены становится неверным, и любое автоматическое закрытие превращается в лотерею.

Третье — отсутствие контроля над исполнением. Частичные исполнения, снятые заявки, изменение лимитов на стороне биржи сдвигают фактическую позицию относительно расчётной. Поэтому подключение торговой системы к бирже — это в первую очередь сверка состояния, обработка сетевых сбоев и разграничение ручных и автоматических действий, а не запуск процесса.

Разбираем, как это закрывается.

Что даёт связанная торговля: эффект в измеримых величинах

Связанный контур — это когда стратегия, исполнение и контроль риска работают как одна система, а не как набор ручных операций. Ниже — что именно меняется в измеримых величинах и по каким метрикам это принимается.

• Доля автоматических решений. Автоматика закрывает весь путь от сигнала до заявки и сопровождения позиции; вручную остаются только смена риск-лимитов и вывод средств.
• Скорость реакции на рыночное событие. Сигнал превращается в заявку за доли секунды — там, где человек реагирует минутами и обычно уже после движения цены.
• Время восстановления после сбоя. Контур поднимается с восстановлением состояния открытых позиций за минуты, а не за часы ручной сверки.
• Ушедший класс отказов. Пропущенный сигнал из-за занятости, ошибка в объёме заявки, потеря связи с биржей без оповещения — эти сбои перестают быть возможны как класс.
• Прозрачность исполнения. Журнал сделок и отклонение фактической цены исполнения от расчётной видны в одном месте, а не собираются по выгрузкам.

Чтобы эффект автоматизации торговли был проверяемым, на старте фиксируем целевые значения по каждой строке — иначе остаются лозунги. Контур собираем на Freqtrade, обвязку и правила риска пишем под ваш регламент.

Режимы работы: биржа напрямую, промежуточный шлюз, свой сервер

Режим подключения определяет не скорость запуска, а поведение системы при разрыве связи. Торговая логика может жить на том же хосте, где лежат ключи биржи, на выделенном сервере рядом с биржей или за промежуточным слоем, который принимает сигналы и передаёт их на исполнение. Разница видна в момент сбоя: где хранится состояние позиции, повторится ли ордер после реконнекта и кто первым заметит расхождение.

Интеграция Freqtrade начинается именно с выбора этой схемы — от неё зависят и структура стратегии, и мониторинг. Ниже варианты, между которыми реально выбирают при запуске алготорговли.

Общее ограничение у всех режимов одно: торговое состояние должно восстанавливаться после перезапуска без дублирования ордеров. Поэтому в конфигурации фиксируем, чем сверяется фактическая позиция, как ограничивается частота запросов к бирже и что считаем аварийным завершением — бот либо доводит позицию по правилам, либо закрывает её и останавливается.

Этапы внедрения Freqtrade интеграции: от аудита до передачи

Этапы внедрения выстраиваем так, чтобы каждая ступень опиралась на результат предыдущей: сначала фиксируем состояние торговой логики и доступов, затем собираем схему подключений и лишь потом считаем стратегию готовой к реальным средствам.

1. Аудит торговой логики. Разбираем правила входа и выхода, работу со стопами и размер позиции, поведение на резких движениях. На выходе — перечень допущений, которые нельзя переносить в автоматический режим без проверки.
2. Схема подключений. Фиксируем источники рыночных данных, способ доступа к бирже, места хранения конфигураций и логов. Ключи выдаём с ограниченными правами, без возможности вывода средств.
3. Настройка окружения. Разворачиваем бота в изолированном контуре: отдельный экземпляр, свои каталоги данных, сохранение состояния сделок между перезапусками. Тестовый запуск не пересекается с боевым.
4. Проверка на исторических данных. Прогоняем стратегию на длинном отрезке котировок с учётом комиссий и проскальзывания, смотрим просадку и распределение сделок. Слабые по прибыли к риску возвращаем на доработку.
5. Проверка на тестовом контуре. Переводим в режим сухого запуска с живыми котировками: срабатывание ордеров, лимиты биржи, поведение при обрыве связи и возобновление после сбоя.
6. Передача в эксплуатацию. Поднимаем боевой контур, поэтапно увеличиваем объём позиций, настраиваем оповещения о сбоях и регламент аварийной остановки, передаём документацию по конфигурации и восстановлению.

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

Конфигурации, ключи доступа и регламенты: что передаём после сдачи

По итогам интеграции Freqtrade передаём не «работающий бот», а комплект, по которому ваша команда запускает, меняет и обслуживает систему без нас. Ниже — что уходит в репозиторий и внутреннюю базу знаний в день сдачи.

• Файлы конфигурации — раздельные профили для тестового и рабочего контура, ключи только через переменные окружения, шаблон с описанием каждого параметра.
• Разграничение прав доступа — роли «наблюдатель», «оператор стратегий», «администратор»; оператор не меняет лимиты риска и размер позиции.
• Ротация ключей — ключи бирж без права вывода средств и с привязкой к адресу, график плановой замены и сценарий отзыва при утечке.
• Документация по стратегиям — для каждой: логика входа и выхода, индикаторы, на каком отрезке истории проверялась, при каких условиях отключается.
• Регламент обслуживания — ежедневные проверки свежести данных и статуса ордеров, еженедельные — полнота истории сделок и резервные копии, порядок действий при остановке процесса.
• Схема взаимодействия — компоненты, потоки данных, точки отказа и порядок ручного вмешательства.
• Журнал изменений — что и когда правилось, чтобы при разборе инцидента была восстановима вся цепочка решений.

Заканчиваем передачей доступов и контрольным прогоном на тестовом контуре: рабочий контур вы запускаете сами, а мы остаёмся на связи по согласованному регламенту.

Кейс: как ручную торговлю перевели на автоматические правила

До переноса торговлю вёл один человек: 5–6 инструментов, сигналы считались по индикаторам в терминале, вход и выход — руками. На трёхнедельном отрезке из 40+ сигналов треть осталась без отработки: часть приходилась на ночь и выходные, часть терялась, пока трейдер вёл другую сделку. Средняя задержка между сигналом и входом — минуты, и правило уже не давало того соотношения риска и прибыли, под которое считалось.

Правила описали формально: условие входа и выхода, стоп, размер позиции, лимит одновременных сделок. Их перенесли в конфигурацию Freqtrade и прогнали на истории — так отсеялись правила, которые в ручном режиме «работали», а на длинном отрезке давали просадку. Затем автоматику запустили параллельно с ручной торговлей в режиме наблюдения и разбирали расхождения по журналу, пока решения не совпали.

После переноса доля отработанных сигналов — 100% вместо 65–70%, задержка входа — секунды вместо минут, ручных действий за день — с 25–30 до 2. Изменился и класс ошибок: входы вне правил исчезли, потому что каждая сделка пишется в журнал вместе с причиной.

Журнал дал побочный эффект: видно, какое правило тянет результат вниз, поэтому отключается одно условие, а не вся стратегия. Метрики снимали до и после на одном отрезке и по одной методике — число сделок, доля отработанных сигналов, задержка входа, максимальная просадка по каждой паре.

Что делать, если торговая система уже развёрнута на своём сервере?

Работающая система — это не только код стратегии, а её состояние: открытые позиции, выставленные и неисполненные ордера, история сделок, снимок баланса и параметры управления риском. Поэтому перенос начинается не с копирования файлов, а со снятия согласованного снимка этого состояния прямо во время торговли.

Останавливать бота для этого не нужно. Мы фиксируем снимок состояния и конфигурации, разворачиваем Freqtrade рядом на целевом сервере и запускаем в режиме без выставления реальных ордеров: система читает те же рыночные данные и генерирует сигналы. Сверка сигналов с текущим контуром за несколько торговых сессий показывает, совпадают ли расчёты индикаторов, таймфреймы и логика входов.

Если расхождений нет, начинается поэтапное переключение: новые сделки открывает уже новая система, а позиции, набранные на старой, дожимаются по прежним правилам до закрытия. Разделение идёт по торговым парам или по объёму, иначе одна и та же позиция откроется дважды — это главный риск параллельного запуска.

Доступы переносим отдельно: ключи к бирже выдаются с правом торговли, но без права вывода средств, а прежний контур остаётся в горячем резерве. Если первые сделки показывают отклонение от ожидаемого поведения, возврат занимает минуты — история, позиции и отчётность сохраняются в обеих системах.

Технические сомнения: нагрузка, доступы к бирже, обрывы связи

Сам Freqtrade — один процесс, который ведёт десяток торговых пар: на сервере это почти незаметно, узкое место не в процессоре, а в лимитах биржевого API. Число запросов в минуту на один ключ ограничивает раньше, чем ресурсы машины, поэтому частоту опроса свечей и баланса задаём отдельно от частоты выставления ордеров.

Доступы держим вне репозитория: ключ только с правом торговли, без вывода средств и переводов, с привязкой к IP сервера. Состояние — открытые позиции, стопы, история сделок — пишется в локальную базу, поэтому после обрыва связи или перезапуска процесс восстанавливает позицию из неё, а не открывает дубль.

Как убедиться, что стратегия работает, а не подогнана под историю?

Сначала прогон на исторических данных за несколько рыночных циклов — с резкими падениями, периодами низкой ликвидности, комиссией и проскальзыванием. Затем торговля в режиме наблюдения без реальных ордеров: расхождение между расчётными и фактическими сигналами показывает разницу между моделью и живой биржей. Реальный счёт включаем с минимальным объёмом на сделку и сверяем фактическое исполнение с ожидаемым.

Опишите задачу — вернёмся с оценкой и планом работ

Чтобы обсудить задачу и вернуться с оценкой сроков и планом работ по интеграции Freqtrade, готовое техзадание не нужно — достаточно описать замысел и приложить то, что уже есть. Чем конкретнее исходные данные для оценки, тем меньше допущений мы закладываем в план, а значит, тем честнее оценка.

• Торговая логика: правила входа и выхода, индикаторы или события, по которым стратегия принимает решение.
• Рынки и инструменты: биржи, спотовые или фьючерсные пары, нужен ли учёт плеча и комиссий.
• Режим работы: только расчёт на истории, торговля в тестовом режиме или вывод сделок на реальные средства.
• Доступы: тестовые ключи биржи без права вывода средств и доступ к репозиторию, если наработки уже есть.
• Управление рисками: лимит на размер позиции, стоп-лосс, допустимая просадка, поведение при обрыве связи с биржей.
• Инфраструктура и уведомления: где запускается бот, нужен ли мониторинг состояния и оповещения в мессенджер.

Если часть данных пока не определена — это не блокер: зафиксируем допущения в плане и уточним их до старта. На выходе вы получаете разбивку работ по этапам, оценку сроков и перечень проверок, которые подтвердят работоспособность стратегии до вывода её на реальные средства.