Открытый код · MIT Python 3.11+ Лонг и шорт Собственный сервер

Алгоритмическая торговля криптофьючерсами со встроенной защитой.

CROT — CryptoRoboTrading — бот на Python с открытым кодом для бессрочных фьючерсов USDT-M. Он хранит стоп-лоссы на самой бирже, соблюдает строгие лимиты маржи и записывает полный журнал каждого решения. Бесплатный, гибко настраиваемый и честный в отношении рисков.

Сейчас торгует на HTX · построен на CCXT и готов к расширению на другие биржи

Торговля фьючерсами связана с существенным риском. Это программа, а не финансовая рекомендация.

Что это

Самостоятельное торговое приложение, а не очередной биржевой шаблон

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

Ваша инфраструктура

Работает на вашем ПК или небольшом VPS. API-ключи остаются в локальном файле, не загружаются, не попадают в журналы и git. Средства всегда находятся на вашем биржевом счёте.

Ваши правила

Каждый порог, фильтр и лимит безопасности — именованный параметр в одном текстовом файле. Более 300 настроек имеют рабочие значения по умолчанию; лонг и шорт можно настраивать отдельно без изменения кода.

Ваши данные

Бот записывает события сделок, аналитику сигналов, диагностику, PnL счёта и макроконтекст. В комплекте есть скрипты, чтобы оценивать стратегию по собственным результатам, а не рекламе.

Сравнение с биржевыми конструкторами ботов

Конструкторы бирж
шаблоны grid / DCA
CROT
отдельный открытый код
ЛогикаГотовые шаблоны и несколько настроекМногоуровневая стратегия: тренд, откат, триггер, проверки качества и ранжирование
ПараметрыОбычно 5–15Более 300 документированных настроек с рабочими значениями
КодЗакрыт — доверие чёрному ящику биржиMIT и открытый код — проверьте каждую строку до пополнения
Стоп-лоссЗависит от шаблона, иногда отсутствуетЖёсткий reduce-only стоп на бирже с момента входа, активный без сервера
Привязка к биржеПолнаяСтратегия и риск-ядро ваши; сейчас HTX, основа CCXT
Журнал и аналитикаСводные цифры в панелиПолный CSV/JSONL-аудит и исследовательские скрипты
СтоимостьЧасто подписка или доля прибылиБесплатно, кроме обычных комиссий биржи
Что требуетсяНичего, работает на сервере биржиПостоянно включённый ПК или VPS и базовое владение терминалом

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

Стратегия

Рабочая базовая стратегия, рассчитанная на развитие

Текущая основа — EMA Pullback: торговля откатов по направлению сформировавшегося тренда. Бот определяет тренд на медленных графиках, ждёт отката и начала восстановления на быстрых и только затем рассматривает вход.

Это развивающаяся стратегия: результат каждого сигнала измеряется, а правила меняются, когда этого требуют данные. В истории есть функции, удалённые из-за отсутствия подтверждения. Не меняются риск-контроль, проверки качества и аудит.

Три слоя таймфреймов

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

СлойТаймфреймEMAРоль
Макротренд1 ч48 / 120Есть ли настоящий тренд?
Откат5 мин24 / 72Цена откатилась и восстанавливается?
Триггер5 мин24 / 72Краткосрочный импульс согласован?

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

Семь проверок качества до входа

Одного тренда недостаточно. Кандидат проходит независимую цепочку:

  1. Фильтр боковика пропускает шумный рынок.
  2. Подтверждение объёмом требует поддержки движения и блокирует подозрительные встречные всплески.
  3. Профиль объёма считает неблагоприятный пробой зоны стоимости риском разворота.
  4. Относительная сила к BTC проверяет самостоятельность движения монеты.
  5. 30-минутный фильтр BTC запрещает лонги при резком падении и шорты при выносе вверх.
  6. Сверка между биржами блокирует вход при аномальном расхождении HTX с эталонной площадкой.
  7. Итоговый рейтинг распределяет капитал только среди сильнейших кандидатов.

Терпеливый вход

Лестница post-only лимитных заявок ниже рынка (выше для шорта) ждёт цену вместо погони и получает maker-комиссию.

Ограниченная частота

Жёсткие лимиты ограничивают новые позиции на сигнал и час. Когда много монет сигналят одновременно, правила перегруженного рынка автоматически ужесточаются.

Строго ограниченное усреднение

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

Управление рисками

Риск — ядро конструкции, а не дополнение

Каждый уровень выхода и расчёта размера предполагает, что сделка, сеть или сервер могут подвести. Защита ниже включена по умолчанию.

Стоп-лосс на самой бирже

Сразу после открытия позиции на HTX размещается reduce-only жёсткий стоп. При сбое сервера, интернета или остановке бота он остаётся активным. Стоп может немного расширяться по ATR, но не превышает заданный предел.

Жёсткие лимиты маржи

По умолчанию бюджет позиции — 2% капитала, маржа одной позиции ограничена 3% счёта, общая маржа — 50%. Резерв котируемой валюты всегда остаётся нетронутым.

Многоуровневый тейк-профит

Прибыль фиксируется адаптивной reduce-only лестницей, а не одной целью. Трейлинг позволяет части позиции следовать за сильным трендом, пока остальная фиксирует раннюю прибыль.

Безубыток и выход по времени

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

Учёт макрорежима

Сочетание RSI золота и BTC классифицирует рынок. При слабости криптовалют или делевериджинге бот сокращает бюджеты, отключает усреднение и ускоряет выходы.

Проверка цены другой биржей

Стакан MEXC служит независимым ориентиром. Аномальная премия, скидка или минутное расхождение блокируют вход и могут отправить монету на паузу.

Настройка

Более 300 параметров. Ни одного изменения кода.

Вся стратегия задаётся одним текстовым файлом. У каждого фильтра, порога, лимита и интервала есть имя и рабочее значение по умолчанию.

  • Один понятный файл. Настройки находятся в .env в простом формате ИМЯ=значение, сгруппированы и прокомментированы.
  • Отдельные правила для лонга и шорта. Любой параметр переопределяется префиксом LONG_ или SHORT_.
  • Никаких скрытых настроек. При старте бот сохраняет все 380+ итоговых значений без API-ключей.
  • Консервативно из коробки. Небольшие бюджеты, строгие лимиты и включённые фильтры безопасности.
.env — небольшой фрагмент
# Торгуемые направления
BOT_PROFILES=long,short

# Размеры и жёсткие лимиты
EMA_POSITION_BUDGET_FRACTION=0.02   # 2% капитала на позицию
EMA_MAX_POSITION_MARGIN_FRACTION=0.03
EMA_MAX_TOTAL_MARGIN_FRACTION=0.50

# Защитный стоп на бирже
HARD_STOP_LOSS_PCT=0.02

# Проверки качества входа
EMA_CHOP_FILTER_ENABLED=true
EMA_VOLUME_CONFIRMATION_ENABLED=true
ENTRY_MIN_SCORE=0.03

# Отдельное значение для шорта
SHORT_EMA_POSITION_BUDGET_FRACTION=0.01
Прозрачность

Бот измеряет себя и показывает данные

Вместо одной цифры PnL он сохраняет полный контекст каждого решения и содержит инструменты статистического анализа.

Полный журнал

Структурированные CSV/JSONL содержат события сделок, статистику циклов, оценки и фильтры сигналов, диагностику, PnL, историю макрорежима и межбиржевые цены.

Исследовательские инструменты

Скрипты проверяют, какие фильтры связаны с результатом, сравнивают риск/прибыль с фактической долей побед и анализируют сигналы по тройному барьеру.

Тесты, версии и открытость

Pytest покрывает биржевой слой, индикаторы, выходы и конфигурацию. Открытая история git показывает развитие стратегии, включая удаление неподтверждённых функций.

Начало работы

От нуля до работающего бота

Четыре шага. Выделите вечер: большую часть времени стоит потратить на комментарии конфигурации и контрольный список запуска.

  1. 1

    Откройте фьючерсный счёт HTX

    Нужен счёт HTX с USDT-M фьючерсами. Можно зарегистрироваться с кодом 6hc25223, поддержав проект без доплаты. Выберите кросс-маржу и односторонний режим позиций.

  2. 2

    Создайте API-ключ только для торговли

    Разрешите торговлю фьючерсами и отключите вывод средств. Ключ хранится только в локальном файле.

  3. 3

    Установите и настройте

    Клонируйте репозиторий, установите зависимости в виртуальное окружение и скопируйте пример настроек:

    терминал
    git clone https://github.com/Lermont/HTX-crypto-bot.git
    cd HTX-crypto-bot
    python -m venv .venv && source .venv/bin/activate
    pip install -r requirements.txt
    cp .env.example .env   # добавьте API-ключи и список монет
  4. 4

    Проверьте и начните с малого

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

    терминал
    python -m pytest -q     # все тесты должны пройти
    python bot.py           # запускает лонг и шорт

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

Вопросы и ответы

Прямые ответы

Этот бот будет приносить мне прибыль?

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

Нужно ли уметь программировать?

Для запуска — нет. Вся конфигурация находится в одном текстовом файле .env с понятными комментариями; менять код для настройки стратегии не нужно. Достаточно уметь выполнять базовые команды в терминале и редактировать текстовый файл. Если вы настраивали сеточного бота на бирже, основные понятия будут знакомы, но здесь контроля намного больше.

Где работает бот?

На любом подконтрольном вам компьютере с Python 3.11 или новее: домашнем ПК, мини-компьютере или небольшом VPS примерно за 5 долларов в месяц. Для непрерывной торговли обычно используют постоянно включённый сервер. В проект входит watchdog для перезапуска. Жёсткий стоп находится на самой бирже и продолжает защищать позицию даже при отключении сервера.

В безопасности ли средства и API-ключи?

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

Сколько это стоит?

Нисколько. Бот бесплатен и распространяется с открытым кодом по лицензии MIT: без подписки, доли прибыли и платных уровней. Ваши расходы — обычные комиссии биржи и, при необходимости, аренда сервера.

Какие биржи поддерживаются?

Сейчас поддерживается HTX и бессрочные фьючерсы USDT-M. Бот построен на CCXT и уже использует MEXC как независимый источник цены, поэтому добавление других бирж — развитие того же ядра, а не переписывание. Именно поэтому проект называется CROT, а не привязан к одной бирже.

Стратегия зафиксирована навсегда?

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

Чем это отличается от встроенных биржевых ботов?

Биржевые конструкторы предлагают несколько шаблонов, например grid или DCA, и немного настроек. CROT — самостоятельное ядро стратегии: тренд на нескольких таймфреймах, семь уровней проверки входа, стоп-лосс на бирже, анализ макрорежима, сверка цен между биржами и более 300 параметров. Открытый код позволяет проверить каждое действие.

Можно ли протестировать до риска реальными деньгами?

В проект входит набор pytest для биржевого слоя, индикаторов, выходов и конфигурации — запустите его до старта. Для живой проверки рекомендуются консервативные значения: бюджет позиции 2% капитала, максимум маржи на позицию 3% и общий предел маржи 50%. Все лимиты можно дополнительно уменьшить и начать с небольшого счёта.

Почему ссылки на биржи реферальные?

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

Сначала прочитайте код. В этом весь смысл.

Всё описанное проверяется в репозитории: документ стратегии, справочник настроек, тесты и история изменений. Начните с них.