Описание/Инструкция hamster-bot

Рекомендуемый VPS

https://contabo.com/?show=vps

VPS S SSD 4.99€ + Windows Server 2016 Datacenter (64 bit) 4.99€

4 CPU cores | 8 GB RAM | 200 GB SSD

Скачивание hamster бота

Постоянная ссылка на скачивание бота https://github.com/ksandric/hamster-bot/blob/master/hamster-bot_release.zip?raw=true

Пароль от архива - 1111


Запуск и обновление

Можно проверить наличие обновлений и скачать/установить обновление.

Обновление бота по кнопке

Не забывайте сохранить настройки. Если включена функция автостарт то бот сразу после обновления загрузит настройки и запустит торги.

Для обновления вручную можно скачать архив содержащий только exe необходимый для обновления (замены) по ссылке https://github.com/ksandric/hamster-bot/blob/master/hamster-bot.zip?raw=true


AutoStart

Для настройки автозапуска бота и торгов с запуском системы нужно:

  • Сохранить профиль настроек бота в файл с названием autostart.hbs
  • Скачать шаблон скрипта запуска ботов hamster-bot_starup.bat
    В примере - запуск трех ботов с паузой в 30 секунд между запуском ботов.
hamster-bot_starup.bat
  • Прописать в скрипте свои пути к папкам ботов
  • Между командами start нужно прописать паузу как в примере. Пауза нужна если у вас 2 и более ботов на одном аккаунте. При автостарте бот потребляет много запросов и при превышении лимита запросов бот может долго запускаться или произойдет бан на час за превышение лимита запросов
  • Добавить файл hamster-bot_starup.bat в папу автозагрузки windows (W+R > shell:startup)
W+R > shell:startup

Если в папке с ботом есть файл настроек с именем autostart.hbs то при запуске применяются настройки из этого файла и начнутся торги автоматически.

выполнение скрипта

Активация бота/пресета. Файл/ключ лицензии.

  • при подключении к бирже бот сам проверит наличие файла лицензии на сервере и скачает фал лицензии бота
  • если все пройдет успешно - то в логе будет написано "The license file was received successfully. ######" и поле User ID подсветится зеленым цветом.
  • аналогично при активации пресета бот сам попробует найти файл лицензии.


Описание Бота

Основная часть окна бота

Содержит:

  • имя пользователя
  • версию бота
  • баланс кошелька/маржи
  • общая загрузка маржи и плечо на аккаунте
  • кнопка обновления баланса
  • кнопка остановки/запуска торгов
  • желтый значок - говорит о том, что на аккаунте есть другие открытые ордера/позиции
  • красная кнопка - закрывает позицию, снимает ордера и останавливает бота
  • дату окончания аренды
  • Торгуемая пара
  • таймфрейм
  • текущая цена торгуемого инструмента
  • размер открытой позиции
  • средняя цена входа
  • ROE и простой % хода цены от цены входа
  • информационная строка стратегии
  • информационная строка состояния фильтров и закрывающих опций (TP, SL, Trailing Stop и др.)
  • название активного пресета
  • 🟢API load: - полоса загрузки API. Если кружок красный🔴 - WatchDog сервер не рабоатет.

Вкладка About

Вкладка Log

Формат сообщения в логе:

  • 272 - день в году
  • 09/28/2020 17:02:04 - дата и время
  • api: 22%| - загрузка API
  • autostar: OK - текст сообщения

Все сообщения лога отправляются в telegram.

Вкладка Terminal

Функционал терминала в боте:

  • Отправка Рыночных ордеров на биржу
  • Отправка Лимитных ордеров на биржу
  • Возможность установки флага "Уменьшение" для ордера
  • Отмена активного ордера (двойное нажатие по ордеру в таблице)
  • Отмена всех активных ордеров
  • Закрытие позиции
  • Просмотры Активных/Исполненных/Отмененных ордеров

Пара для работы терминала выбирается во вкладке Settings.

Работать в терминале можно не запуская или не останавливая работу по стратегии.

Работа рыночными ордерами не мешает работе по стратегии.

Для выставления лимитных ордеров во время работы бота по стратегии нужно активировать опцию MC (manual control) в боте, чтобы бот не удалял ордера не по стратегии.

Вкладка Chart

На графики отображается:

  • График цены выбранного инструмента
  • Объем торгов
  • Средняя цена входа в позицию
  • Точка Входа в позицию
  • Точки изменения (доборы и сбросы) позиции
  • Индикаторы выбранной стратегии

На графике можно менять число отображаемых свечей.

график и текущее состояние по стратегии в telegram

Вкладка History

На вкладке отображается история баланса за выбранный период и небольшой отчет по парам.

На графике показывается вклад каждой торгуемой пары на аккаунте в изменение баланса.

отчет приходит и в telegram
График истории баланса в telegram

Вкладка Presets

Пресет - готовый файл с настройками стратегии и риск менеджмента.

Вкладка нужна для скачивания пресета, его настройки и активации.

Вкладка Settings

  • Exchange - выбор биржи
  • Symbol - торгуемы инструмент (пара)
  • Time-frame
  • Strategy - выбор стратегии. Off - выключение стратегии, закрывающие опции остаются в работе.
  • Symbol info - информация об инструменте: тик и дата экспирации фьючерса
  • API key и Secret - пара API ключей биржи
  • Telegram chat id - id чата в telegram куда будет писать бот
  • Connect - кнопка подключения к бирже. После Подключения к бирже некоторые настройки нельзя будет поменять.
  • User ID - id пользователя биржи
  • Leverage - можно выбрать кросс плечо или изолированное плечо
  • LONG / SHORT - Включение/Выключение направления торгов
  • Balance % и risk X - аналогичные параметры влияющие на часть баланса используемую для расчета лота
  • fixed rate BTC - использование фиксированного значения XBT для расчета лота
  • Calculate - кнопка расчета лота
  • Custom lot (Fixed lot) - использование фиксированного числа контрактов введенного вручную
  • size control - бот будет следить за размером позиции и скинет лишнюю часть позиции. Рекомендуется для ZZ

Другие настройки

Telegram notifictions:

  • edit order - вкл/выкл уведомления об изменении ордера
  • new order - вкл/выкл уведомления о выставлении ордера
  • new level - вкл/выкл уведомления о новом уровне на ZZ
  • use telegram - вкл/выкл отправки сообщений в telegram
  • use wachdog - вкл/выкл отправки сообщений о статусе работы на watchdog сервер
Telegram WatchDog. Уведомление об отвале бота/сервера/интернета
  • Do not count +PNL - не учитывать прибыль в расчете лота
  • Do not count -PNL - не учитывать убыток в расчете лота

  • new data loading - вкл/выкл нового алгоритма загрузки данных и число загружаемых свечей.
  • Tray minimize - сворачивать программу в системный трей
  • Stop trading after closing a position - остановка торгов ботом после закрытия позиции. Удобно если нужно поменять настройки.

Вкладка Strategy

Содержит вкладки настроек стратегий.

Вкладка Closing conditions - общая вкладка для всех стратегий.

  • [TV] - опция которая приводит поведение работы бота ближе к поведению тестера стратегий TradingView


Запуск бота на ОС Linux

wine + .Net 4.8 работает стабильно

wine + .Net 4.8

Ошибки. Частые проблемы и их решение

Бот не запускается | Появляется окно с ошибкой

Для работы бота нужно обновить .NET Framework до версии 4.8 https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-web-installer

Telegram bot не пишет и не отвечает на команды

Пользователи из Российской Федерации должны использовать VPN или запускать бота на удаленном компьютере(сервере/облаке). Также проблема может быть связана с использованием старого windows server 2008.

Антивирус

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

Результаты проверки онлайн антивирусами:

https://opentip.kaspersky.com/249A8653FE95566B23733062EE254288A20B813FA1563590F1128BD5A85BCD9A/

https://online.drweb.com/result2/?mode=show_stored&id=orc_1589412384_bd665667979484ca85b24df01b19dc8d&lng=ru

Приходит ошибка от telegram бота

user: bitmex
GET /user {"error":{"message":"This request has expired - expires is in the past. Current time: 1580986216","name":"HTTPError"}}

На компьютере установлены неправильные  дата и время. Установите правильное время. Поменяйте сервер синхронизации времени.


Статьи

Ссылки