H-BotFutur - бот для торговли на фьючерсах Binance и Bybit в режиме хеджирования (двустороннем режиме позиций- Hedge Mode), с использованием стратегии Мартингейла (усреднения- увеличения позиции с целью улучшения средней цены входа).

Возможные направления работы: LONG/SHORT/AUTO.

При AUTO бот откроет сразу и LONG и SHORT позиции по выбранной паре, выставит усредняющие ордера по этим позициям и затем будет работать в направлении исполнившегося усред-ордера, а противоположная позиция останется в качестве страхующей и усред-ордер по ней будет отменен.

При установке направления LONG/SHORT бот откроет рабочую позицию только в одном направлении (как E-BotFutures),но можно дополнительно указать- открывать страхующую (противоположную) позицию (по умолчанию установится в off), при этом, с insurance_pose- on, если FIX-ордер исполнится без усреднений, то прибыли не будет (+прибыль-убыток=0).

Закрытие страхующей позиции при AUTO осуществляется в одном из 4-х вариантов:
- сразу после исполнения FIX-ордера (по умолчанию),
- при исполнении выбранного усредняющего ордера (clos_insurpos_at_aver, ввести № усреда или off),
- при определении разворота цены на указанный % после исполнения выбранного усредняющего ордера (clos_insurpos_if_revers в формате: 2.1% aver 3 или off),
- при определении разворота цены на указанный % при достижении ценой определенного % до цены выбранного усредняющего ордера (clos_insurpos_if_revers в формате: 2.1% bef_aver 3 if 3.1% или off).

Для выбора подходящей пары бот может использовать один из 10-ти режимов:
1. Режим СТАНДАРТНЫЙ- перебор пар для выбора подходящей по всем заданным условиям:
- объем торгов за 24 часа в USDT больше указанного в настройках;
- объем торгов последней свечи или предпоследней больше объема выбранной дальней свечи на %, указанный в настройках;
- изменение текущей цены по отношению к цене открытия дальней свечи:
с подрежимом delta_start1:
- цена изменилась больше, чем на указанный %,
с подрежимом delta_start2:
- цена изменилась меньше, чем на указанный %,

2. Режим CONTROL_AUTO- режим удержания выбранной по СТАНДАРТНЫМ параметрам пары всегда в позиции и работа с ней до истечения указанного таймера от старта позиции в этом режиме, или достижения стоп_цены (изменения на указанный % от цены старта).

3. Режим SUPER_ASSET- бот работает с парой без каких-либо условий до отключения или истечения таймера time_stop_sa.

4. Режим MOST_CHANGED- перебор пар для выбора подходящей по следующим условиям:
- объем торгов за 24 часа в USDT больше указанного в настройках,
- курс пары за последние 24 часа изменился в заданном коридоре (с выбором в select_delta24- ближе к максимальному или минимальному значению коридора, или, вместо select_delta24, бот может смотреть объем последних (2-3) свечей в коридоре измен цены за последние 24ч и выбрать пару с большим изменением).

5. Режим TV_SIGNALS- выбор пары по индикаторам из TradingView, нужно ввести:
- индикаторы для поиска сигналов (например: STOCH.K, CCI, Stoch.RSI),
- интервал свечей для сигналов,
- направление поиска сигналов.

6. Режим DOUBLE_CHECK- двойная проверка изменения цены за 24 часа и за выбранные свечи. Нужно выбрать один из 2-х подрежимов:
- double_check_LONG- отбор пар, упавших за 24ч в выбранном коридоре, и проверка этих пар по последним выбранным свечам на рост в указанном диапазоне,
- double_check_SHORT- отбор пар, выросших за 24ч в выбранном коридоре, и проверка этих пар по последним выбранным свечам на падение в указанном диапазоне.

7. Режим Quick_Price_Check- выбор пары по изменению цены от старта последней свечи до текущей цены. В этом режиме бот запускает вебсокеты на все пары из white_list по выбранному интералу последней свечи. Сравнивает цену открытия свечи и последней цены на момент получения данных и, если delta попадает в коридор из настроек, то берет пару в работу (учитывайте, что последняя свеча еще не закрытая, поэтому от цены старта свечи до текущей цены может быть от 1 секунды до самого интервала-таймфрейма свечи).

8. Режим Quick_My_Kline- выбор пары (по параметрам Quick_Price_Check, кроме delta_quick и kline_interval_quick) по изм.цены в произвольном периоде (свече, с выбранной в секундах длительностью).

9. Режим OCO_Quick- выбор пары (от 1 до 4) по параметрам Quick_Price_Check (кроме Quick_LONG_start_Big и use_preset_pairs_data) и выставление без усредов рыночных TakeProfit и StopLoss. В этом режиме бот открывает несколько позиций, и наблюдает, если поза закрылась по TakeProfit или StopLoss, фиксирует прибыль/убыток и берет следующую пару. При включенном OCO_time_stop- по истечении таймера закрывает позу.

10. Режим Tg_Tracking: бот работает по сигналам из телеграм канала (или чата бота), указанного в настройках.
Нужно получить API-ID и API HASH на my.telegram.org/auth, а также узнать CHANNEL_ID канала (переслав сообщение с сигналом боту: @userinfobot). Если режим используете на бирже, отличной от сигнала, обязательно sign_only_from_white ставить в 'yes'.

Режимы SUPER_ASSET, CONTROL_AUTO, MOST_CHANGED, TV_SIGNALS, DOUBLE_CHECK, Quick_Price_Check, Quick_My_Kline, OCO_Quick и Tg_Tracking взаимоисключающие, т.е. при выборе одного из режимов другие режимы отключаются. Если не выбран ни один из режимов, бот будет работать в СТАНДАРТНОМ режиме.

Настройки бота:
- fix_perc: процент повышения цены для продажи при LONG или падения для покупки при SHORT,
- trailing_FIX: возможность выставления TrailingStop ордера для FIX (on/off),
- trailingPricePercent: процент разворота цены для срабатывания TrailingStop ордера для FIX,
- step_aver-SHORT: ввод step_aver1, step_aver2, ... step_aver7 шагов изменения цены для выставления усредов для SHORT,
- qty_aver-SHORT: ввод qty_aver1, qty_aver2, ... qty_aver7 для кратного увеличения объема выставляемого усред ордера для SHORT,
- step_aver-LONG: ввод step_aver1, step_aver2, ... step_aver7 шагов изменения цены для выставления усредов для LONG,
- qty_aver-LONG: ввод qty_aver1, qty_aver2, ... qty_aver7 для кратного увеличения объема выставляемого усред ордера для LONG,
- limit_aver: разрешенное количество усреднений,
- min_order: минимальная покупка (продажа) в котируемой валюте (например, в паре ETH/USDT это USDT, ставить больше 11 и учитывайте, что в зависимости от выбранного leverage (кредитного плеча) будет использоваться меньше USDT, например: если min_order указан 20, а leverage указан 10, то для ордера будет использовано 20/10=2 USDT),
- timer_SL: функция закрытия позы (stop loss), если после № усреда прошло указанное кол-во минут (если до истечения таймера исполнился очередной усред- отсчет таймера начинается заново),
- delta_start: процент изменения цены для входа в сделку, нужно выбрать delta_start1 или delta_start2:
- delta_start1: на сколько % должен подняться курс от цены открытия выбранной дальней свечи до текущей цены для старта,
- delta_start2: на сколько % должен упасть курс от цены открытия выбранной дальней свечи до текущей цены для старта,
- delta_start_limit: ограничение дельты для реж СТАНДАРТНЫЙ от delta_start1 до delta_start1+delta_start_limit (от delta_start2-delta_start_limit до delta_start2), чтобы бот не взял слишком выросшую/упавшую пару (т.е. при delta_start1=5% и delta_start_limit=50%, бот возьмет пару с дельтой от 5% до 55%),
- delta_vol_start- на сколько % должен измениться объем торгов:
--- при interval_limit 1 бот будет получать изменение объема всегда 0),
--- при interval_limit 2 (выборе 2-х свечей для анализа) бот будет сравнивать объемы текущей (еще не закрытой) и предыдущей (уже закрытой) свечей,
--- при interval_limit 3 и более бот сравнит объемы текущей (еще не закрытой) и предыдущей (уже закрытой) свечей, выберет больший объем и будет сравнивать с объемом выбранной (3-й или больше) дальней свечи,

- kline_interval: интервал свечей для анализа (1, 3, 5, 15, 30, 60, 120, 240, 360, 720 -в минутах, D -день, M -месяц, W -неделя),
- interval_limit: какое количество свечей анализируем (если следим за изменением цены за последние 3 минуты, то можно выбрать kline_interval 1m и interval_limit 3),
- send_aver_message: включение/выключение отправки сообщений в телеграм канал о каждом выставленном/исполненном ордере,
- check_last_pair: проверять пару после закрытия позиции на соответствие условиям для входа и продолжения работы с ней, или сразу возвратиться в перебор пар,
- completed: поставить бота на паузу при закрытии очередной сделки (1-вкл/0-выкл),
- manual_aver: команда для ручного усреднения по рынку, не дожидаясь цены лимитного усред-ордера, но не сработает, если усред-ордер, выставленный ботом, исполнен частично (PARTIALLY_FILLED),
- fix_loss: команда для закрытия открытой позиции по рынку,
- clear: сброс из базы данных сведений об открытых ботом ордерах,
- leverage: размер кредитного плеча от 1 до 100 (оно разное для разных пар, смотрите в лк биржи),
- marginType: тип маржи-tradeMode (cross margin | isolated margin),
- directionOnly: LONG, SHORT или AUTO (при AUTO бот будет работать в направлении первого исполнившегося усредняющего ордера. Изменение применится при старте новой позиции),
- insurance_pose: on или off (открывать страхующую позицию при заранее выбранном направлении работы LONG/SHORT),
- clos_insurpos_at_aver: в AUTO закрыть страхующую позу в плюс при исполнении очередного усреда (ввести № усреда или off),
- clos_insurpos_if_revers: в AUTO закрыть страхующую позу в плюс при определении разворота цены, ввести:

- off

- или в формате 2.1% aver 2 (первое число-откат цены в %, следующее № усреда, после исполнения которого бот начнет отслеживание разворота цены),

- или в формате 2.1% bef_aver 2 if 3.1% (первое число-откат цены в %, следующее № усреда, до цены исполнения которого за последнее число % бот начнет отслеживание разворота цены),

- clear_profit: сброс из базы данных сведений о прибыли,
- t_sleep: при получении от биржи ошибки о превышении лимита api-запросов, можно выбрать значение паузы в секундах (например: 1, 3, 5, 7),
- t_sleep_perebor: пауза перед повтором перебора монет для выбора подходящей для старта (по умолчанию 40 сек),
- white_list: список пар, которые бот будет использовать для анализа и выбора подходящей для открытия сделки,
- api_key: открытый api-ключ от биржи с разрешением на фьючерсную торговлю,
- api_secret: секретный api-ключ от биржи,
- botID: api телеграм бота полученный от @BotFather (пример: 5656544920:AAHrXhjhujhfdf7RPJlheqJXEulBW),
- channelID: ID канала telegram бота для уведомлений, полученное от @userinfobot (пример: -1001656543985),
- tguserid: ID основного user-a телеграм, полученное от @userinfobot (пример: 346549043),
- use_testnet- включить использование бота в testnet (только для Binance и Bybit),
- licens_key: лицензионный ключ для продления периода работы бота, полученный от разработчика,
- quoteVolume24hr: минимальный 24-х часовой оборот торгов в котируемой валюте (в паре ETH/USDT это USDT, в паре ETH/BTC это BTC), чтобы бот взял пару из white_list в работу.
- max_fund_rate: максимальная ставка комиссии за финансирование при выборе пары,
- del_pair_after_check_funding: удалять или нет пару из white_list, если ставка комиссии выше, чем max_fund_rate,
- if_long_short_fund_can: брать пару в работу независимо от max_fund_rate, если комиссия за фандинг будет мне в плюс и directionOnly не AUTO (например, если directionOnly LONG и фандинг отрицательный или directionOnly SHORT и фандинг положительный),
- small_id: ограничить количество знаков при выводе id ордера в терминале (1-50)

- control_auto: режим удержания выбранной по стандартным параметрам пары всегда в позиции до достижения условий по изменению цены или времени,
- delta_stop: процент изменения цены для возврата после закрытия позиции в перебор-поиск пары,
- time_stop_ca: время удержания пары всегда в позиции после старта из перебора-поиска пары в минутах,

- super_asset: пара для бесконечной торговли независимо от delta_start, при этом пары из white_list не будут работать (вводится командой -super_asset_add в формате ETHUSDT),
- time_stop_sa: время удержания пары в SUPER_ASSET, после которого при закрытии позиции бот вернется в режим СТАНДАРТНЫЙ или MOST_CHANGED, в минутах,
- after_sa_mch: выбор перехода после истечения таймера SUPER_ASSET в режим MOST_CHANGED или в СТАНДАРТНЫЙ,
- after_sa_qpr: переход после истечения таймера SUPER_ASSET в режим Quick_Price_Check,

- most_changed: режим выбора в коридоре измен цены за последн 24ч,
- delta24_min: min изменение цены в коридоре для most_changed,
- delta24_max: max изменение цены в коридоре для most_changed,
- select_delta24: выбирать ближе к max или min для most_changed,
- delta_vol_most_ch: вместо select_delta24 смотреть объем последних (2-3) свечей в коридоре измен цены за последн 24ч и выбрать пару с большим изменением,
- delta_vol_mc_interval: период свечей для использования в delta_vol_most_ch,

- tv_signals: режим выбора пары по индикаторам из TradingView,
- indicator_add (-indicator_del): ввод (удаление) индикаторов для поиска сигналов из TradingView,
- TV_interval: интервал свечей для сигналов из TradingView (1m 5m 15m 30m 1h 2h 4h 1d 1W 1M),
- direction_TV_sign: направление поиска сигналов First_Sign/LONG/SHORT,
- TV_delta24_min: минимальный % изменения цены за 24ч для входа по TV_SIGNALS,
- use_only_new_signals, on/off -использовать только новые сигналы (первую проверку не учитывать),

- kline_interval_double, период свечей для второй проверки в режиме DOUBLE_CHECK,
- interval_limit_double, количество свечей для второй проверки в режиме DOUBLE_CHECK,
- double_check_LONG, режим двойной проверки для работы в LONG
- delta24_double_LONG, коридор изменения цены за 24 часа в % для LONG в формате 2 числа через пробел, первое должно быть меньше второго (например: -80 -15),
- delta_kline_double_LONG, коридор изменения цены за выбранные последние свечи (от цены открытия выбранной дальней свечи до текущей цены) в % для LONG в формате 2 числа через пробел, первое должно быть меньше второго (например: 3 12),
- double_check_SHORT, режим двойной проверки для работы в SHORT,
- delta24_double_SHORT, коридор изменения цены за 24 часа в % для SHORT в формате 2 числа через пробел, первое должно быть меньше второго (например: 15 80),
- delta_kline_double_SHORT, коридор изменения цены за выбранные последние свечи (от цены открытия выбранной дальней свечи до текущей цены) в % для SHORT в формате 2 числа через пробел, первое должно быть меньше второго (например: -12 -3),

- Quick_Price_Check, режим выбор пары по изменению цены от старта последней свечи до текущей цены,
- delta_quick, коридор изменения цены от старта последней свечи до текущей (в %) в формате 2 числа через пробел, первое должно быть меньше второго (например: 5 15),
- kline_interval_quick, интервал свечи для режима Quick_Price_Check,
- Quick_Only_White, проверка только пар из W_list для режима Quick_Price_Check,
- Quick_direction, Выбрать для Quick_Price_Check направление SHORT/LONG/BOTH (при LONG зайдет в растущую, при SHORT- в падающую, при BOTH- в какую попадется первой в коридоре),
- Quick_LONG_start_Big, при Quick_Price_Check LONG увеличим стартовый ордер в x раз (ввести в формате: "yes 2"/"no 2", где 2- это коэф. увеличения),
- use_preset_pairs_data, использовать заранее записанные в БД пресеты по паре (start_qty, tick и т.д.) для режима Quick_Price_Check,
- Black_List, список пар, которые будут игнорироваться при Quick_Only_White=no для Quick_Price_Check (например с фиатом),
- clear_db_all_presets_pair, удаление пресетов по всем парам (нужно при изменении leverage/marginType/tradeMode),

- Quick_My_Kline, режим выбора пары (по параметрам Quick_Price_Check, кроме delta_quick и kline_interval_quick) по изм.цены в произвольном периоде (свече, с выбранной в секундах длительностью),
- my_kline_interval, интервал (длительность) произвольной свечи в секундах от 5,
- my_kline_delta, коридор изменения цены от старта произвольной свечи до текущей цены (в %) в формате 2 числа через пробел, первое должно быть меньше второго (например: 1 7, для SHORT автозазеркалится: -7 -1),

- OCO_Quick, режим выбора пары (от 1 до 4) по параметрам Quick_Price_Check (кроме Quick_LONG_start_Big и use_preset_pairs_data) и выставления без усредов рыночных TakeProfit и StopLoss,
- OCO_max_pos, ограничение кол-ва позиций в OCO_Quick (до 4-х пар),
- OCO_time_stop, в режиме OCO_Quick закрывать или нет позу по таймеру и время ожидания в минутах (ввести в формате: "yes 2"/"no 2", где 2- это таймер ожидания),
- OCO_take_loss, вводится 2 числа- TakeProfit и StopLoss в % (например: 1 0.9),

-Tg_Tracking: режим слежения за сигналами из телеграм,
-api_id, API-ID, полученный на my.telegram.org/auth для Pyrogram,
-api_hash, API HASH, полученный на my.telegram.org/auth для Pyrogram,
-phone, номер телефона telegram для Pyrogram,
-CHANNEL_ID, id telegram channel для слежения за сигналами, получим переслав сообщение с сигналом боту: @userinfobot
-ChatType, ChatType.CHANNEL или ChatType.BOT для Pyrogram,
-sign_message_example, образец сообщения о сигнале для Pyrogram (В ОДНУ СТРОКУ!!!),
пример: "🔴 STPTUSDT Время: 2025-05-07 19:22:00 UTC Изменение: -5.37%",
после ввода образца будет выведено сообщение с элементами и их индексом (местом расположения), пример:
all_index: 🔴 [0] STPTUSDT [1] Время: [2] 2025-05-07 [3] 19:22:00 [4] UTC [5] Изменение: [6] -5.37% [7]
которые нужно ввести в настройках в последующем,
-sign_direction_LONG, образец для LONG сигнала в sign_message_example, (например: 🟢),
-sign_direction_SHORT, образец для SHORT сигнала в sign_message_example (например: 🔴),
-sign_dir_split_numb, порядковый номер направления в сигнале (в примере 0),
-sign_pair_split_numb, порядковый номер пары в сигнале (в примере 1),
-sign_procent_split_numb, порядковый номер доп.инфо (например изменения цены) в сигнале (в примере 7),
-sign_check_quote_vol, yes/no - после сигнала проверять объемы, чтобы было > quoteVolume24hr,
-ignor_sign_direction, игнорить LONG/SHORT сигнала и работать в AUTO (yes/no),
-sign_revers_direction, yes/no - после сигнала открывать противоположную позицию (т.е. если сигнал LONG, то открываем SHORT, и наоборот),
-sign_only_from_white, yes/no - после сигнала вход, только если пара есть в white_list (если используете на бирже, отличной от сигнала, обязательно sign_only_from_white = yes),
-Tg_LONG_start_Bigger, при Tg_tracking LONG увеличить стартовый ордер в x раз (ввести в формате: "yes 2"/"no 2", где 2- это коэф. увеличения),

Настройка телеграм бота для H-BotFutur
1. Создайте бота в телеграм, обратившись к @BotFather, получите api этого бота
2. Создайте частный канал для уведомлений, напишите в нем любое сообщение, перешлите его @userinfobot, получите id этого канала
3. Созданного телеграм бота сделайте админом в этом канале
4. Напишите любое сообщение @userinfobot, получите свой id в телеграм
5. Внесите полученные параметры в H-BotFutur (введя после запуска -edit):
-botID: api телеграм бота полученный от @BotFather (пример: 5656544920:AAHrXhjhujhfdf7RPJlheqJXEulBW)
-channelID: id канала telegram бота для уведомлений, полученное от @userinfobot (пример: -1001656543985)
-tguserid: id основного user-a телеграм, полученное от @userinfobot (пример: 346549043)

Табличка H-BotFutur_aver-2.xls (https://github.com/ebot732/ebot732.github.io/raw/main/screenshots2/H-BotFutur_aver-2.xls) показывает приблизительные расчёты усреднений и цены ликвидации.

Пример работы бота в терминале:

Примеры из Telegram:

....