Для использования этого расширения вам необходимо быть зарегистрированным в мессенджере Telegram.

Если у вас уже есть аккаунт в Telegram, вам нужно создать собственного бота, через которого вы будете управлять своими аккаунтами MoonTrader.

Как создать собственного бота?

‍

Чтобы создать бота, вам нужно написать в строке поиска имя бота для создания ботов в Telegram - @BotFather

‍

Напишите команду /newbot - создает нового бота

‍

‍

Задайте имя нашему боту:

Имя должно содержать слово Bot на конце

‍

После успешного создания бота вам нужно сохранить его Token

Для этого напишите команду /mybots - показывает все ваши боты

В списке ваших ботов выберите имя ранее созданного бота:

Выберите API Token:

После того как мы узнали Token нашего бота, нам нужно узнать наш собственный ChatID:

Для этого находим бота @myidbot

‍

Пишем команду /getid - чтобы узнать ваш ChatID:

‍

‍

Сохраняем все данные и переходим к установке BotClient:

Запуск и настройка BotClient

Сначала нужно распаковать BotClient в любую удобную папку

Запустите BotClient.exe:

Сначала нам нужно указать сохраненные данные Token и ChatID:

BotClient успешно создан и готов к работе

Как использовать BotClient

BotClient может управлять несколькими аккаунтами одновременно

Чтобы начать использовать его, нам сначала нужно найти нашего бота, которого мы создали в @BotFather

Для этого пишем команду /mybots - показывает все ваши боты

Нажмите на @BotName, перейдите в чат с ботом и нажмите кнопку запуска (run):

В этом меню будет происходить вся работа по управлению нашими аккаунтами MoonTrader:

Для удобства вы можете изменить язык в меню Telegram Settings в разделе Telegram Layout:

Команды

Чтобы узнать список всех доступных команд, используйте команду /help

1. Для управления командами используйте кнопки вперед, назад

2. Вводите данные с помощью клавиатуры или нажимая кнопки в меню

3. Команды можно повторить, нажав кнопку повтора после выполнения команды, независимо от результата

4. К команде можно обратиться через символ / из выпадающего меню или выбрать пошаговое действие в меню

5. Команды по умолчанию берут профили из "default profile"

6. Команды можно остановить во время их выполнения

7. Команды могут содержать более одного профиля, что позволит выполнить одно и то же действие для всех выбранных профилей

8. При выборе символов в некоторых командах появляется кнопка "all", она добавляет весь рынок, который вы выбрали в запросе (будьте осторожны при работе со всем рынком сразу, используйте эту функциональность, когда она действительно необходима)

Добавление профиля

Чтобы управлять профилем в MoonTrader, нам нужно его добавить:

Перейдите в меню профилей, раздел add:

Укажите все данные вашего аккаунта из клиента:

Если такой профиль существует, он будет успешно добавлен после нажатия кнопки Run.

Редактирование профиля

Чтобы изменить профиль, нужно перейти в меню профилей, раздел change, или использовать команду /edit_profile

‍

Выберите профиль, который нам нужно отредактировать, и перезапишите необходимые параметры:

Нажмите кнопку выполнить (execute) и работайте с новыми данными:

‍

Профили по умолчанию

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

Чтобы перейти к профилям по умолчанию, перейдите в меню профилей в раздел default

‍

В этом списке вы можете выбрать профиль по умолчанию, нажав на него:

После выбора необходимых профилей нажмите кнопку Execute, чтобы сохранить настройки:

Удаление профиля

Чтобы удалить профиль, нужно перейти в меню профилей, раздел remove, или использовать команду /remove_profile

‍

Чтобы удалить профиль, выберите его в списке профилей:

Для подтверждения действия нажмите кнопку execute:

Добавление ордера

Эта команда работает только с одним профилем

Чтобы перейти к этой команде, нужно выбрать раздел order в меню to add, или использовать команду /add_order

Эта команда имеет множество настроек для размещения ордера, убедитесь, что вы правильно ввели все данные

Для размещения ордера в меню также есть настройки Take Profit и Stop Loss:

‍

‍

‍Отмена ордеров

Отмена ордеров работает с ордерами, которые уже были размещены, но еще не были исполнены

Чтобы перейти к этой команде, нужно выбрать раздел cancel в меню order или использовать команду /cancel_order

Для выполнения команды нажмите кнопку execute и дождитесь ответа от ядра :

‍

Если мы передумали останавливать ордера или ввели неверные данные, мы всегда можем остановить команду (stop)

Получение списка ордеров

Для управления ордерами также существует команда "/get_order_list"Чтобы перейти к этой команде, выберите раздел "List" в меню "Order"Эта команда позволяет получить информацию об ордерах, которые размещены в данный момент

‍

При выборе профиля ордера будут загружены, и позже, при выборе рынка, вы сможете увидеть, сколько ордеров находится в каком рынке

Далее предлагается либо закрыть выбранные позиции, либо просмотреть информацию о них

Закрытие позиций

Закрытие позиции не работает с отложенными ордерами

Чтобы перейти к этой команде, выберите в меню position раздел close или используйте команду /close_positions

Чтобы выполнить команду, нажмите execute и дождитесь результата выполнения *

Чтобы повторить команду, нажмите кнопку repeat:

Каждая команда может быть повторена с теми же настройками

При повторении команды вы можете изменить настройки предыдущей команды

Panic

Быстрое закрытие открытых позиций

Не влияет на открытые ордера в том же рынке

Чтобы перейти к команде, выберите раздел panic в меню или используйте команду /panic_sell

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

‍

Чтобы выполнить команду, нажмите кнопку execute и дождитесь ответа от ядра

Остановка всех алгоритмов

Команда останавливает все запущенные алгоритмы на аккаунте

Чтобы перейти к команде, выберите раздел stop all в меню algorithms или используйте команду /stop_all_algorithm

‍

Чтобы выполнить команду, нажмите кнопку execute и дождитесь ответа от ядра

Запуск всех алгоритмов

Команда включает все отключенные алгоритмы на аккаунте

Чтобы перейти к команде, выберите раздел stop all в меню algorithms или используйте команду /start_all_algorithm

‍

Чтобы выполнить команду, нажмите кнопку execute и дождитесь ответа от ядра

Управление алгоритмами

Эта команда позволяет получить список алгоритмов, которые находятся в ядре

И в дальнейшем предоставляет возможность остановить/запустить или удалить выбранные алгоритмы

‍

‍

Изменение кредитного плеча

Команда работает только на рынках, где нет открытых позиций или висящих ордеров

Чтобы перейти к команде, выберите раздел change leverage в меню market или используйте команду /modify_leverage

Чтобы выполнить команду, нажмите кнопку execute и дождитесь ответа от ядра:

Изменение маржи

Команда работает только на рынках, где нет открытых позиций или висящих ордеров

Чтобы перейти к команде, выберите раздел change margin в меню market или используйте команду /modify_margin

‍

Чтобы выполнить команду, нажмите кнопку execute и дождитесь ответа от ядра:

Ядро

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

Чтобы перейти к команде, зайдите в меню kernel и выберите нужное действие:

‍

Чтобы выполнить команду, нажмите кнопку execute и дождитесь ответа от ядра:

Отчеты

Эта команда позволяет просматривать отчеты по фильтрам

Если выбран один профиль, то придет информация по каждому алгоритму (сколько ордеров было исполнено и каков был результат)

Если выбрано несколько профилей, то придет основная информация без деталей по каждому алгоритму

‍

 Поля: Markets, Quote\Symbol, Information - могут быть пустыми

Позиции

Загрузка и отображение информации о всех позициях на выбранных аккаунтах

‍

Информация о балансе

Эта команда позволяет загрузить информацию о балансе с выбранных профилей на указанном рынке

‍

‍

Перевод баланса

Команда позволяет переводить активы с одного рынка на другой

‍

‍

СИГНАЛЫ

‍

Настройка Bot Client для парсинга telegram сигналов

сигналы поддерживаются для операционных систем linux (ubuntu/linux 20.04) и windows

1. Прежде всего, мы должны подключить аккаунт telegram к удаленному контроллеру:

• Перейдите в меню "Profile"

• Выберите "Telegram profile"
  

• Нажмите "Login"
  

• После этого в конце бота появятся поля для авторизации (Если не появились, нажмите клавишу Enter)

1. Введите номер телефона
   

1. Введите код, который пришел в Telegram
   

1. Введите пароль, если требуется

Регистрация завершена

Теперь, если перейти в Profile -> Telegram profile, вы увидите следующее:

‍

2. Далее необходимо выбрать каналы, которые вы хотите отслеживать для получения сигналов

• Перейдите в меню "Algorithms"
  

• Выберите "Signals"
  

• Выберите "Channels"
  

• Выберите каналы, которые хотите отслеживать
  

• Нажмите "Execute"
  

‍

Для каждого канала можно настроить правила парсинга (Algorithms -> Signals -> Channel Settings)

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

‍

Текстовые команды

‍

/*

Команда будет обрабатываться как текстовая, только если в начале стоит #

Параметры разделяются ';' или переносом на новую строку

Параметры могут быть неполными, например pr будет эквивалентно profiles

Порядок параметров не имеет значения

Если все параметры введены правильно, команда выполнится сразу. Если некоторые параметры некорректны, отобразится стандартная форма с параметрами, которые удалось распознать

Профили можно перечислять через запятую или указать all в параметре профилей

Разделитель между параметром и значением может быть любым символом, включая пробел

Markets (Рынки): f - Futures; m- Margin; s - Spot; d - Delivery;

Side (Сторона): buy, sell;

Order Type (Тип ордера): Limit, Market, StopLimit, StopMarket, LimitMarket, PostOnly

Margin Type (Тип маржи): Cross, Isolated

*/

‍

СТАТУС ЯДРА:

‍

#core status; pr: <profile name 1>, …, <profile name N>; //получить статус ядра от выбранных профилей

#core status; pr: all; //получить статус ядра от всех профилей

‍

//Разделитель параметров - перенос строки вместо точки с запятой:

#core status

pr: <profile name 1>, …, <profile name N>

#core status

pr: all

‍

Примеры:

#core status; pr all;

#core status; profiles: pr01, pr 02, pr03;

‍

ПЕРЕЗАПУСК ЯДРА:

‍

#core restart; pr: <profile name 1>, …, <profile name N>; //перезапустить выбранные ядра

#core restart; pr: all; //перезапустить все ядра

‍

//Разделитель параметров - перенос строки вместо точки с запятой:

#core restart

pr: <profile name 1>, …, <profile name N>

#core restart

pr: all

‍

Примеры:

#core restart; pr all;

#core restart; profiles: pr01, pr 02, pr03;

‍

ПЕРЕЗАПУСК ЯДРА БЕЗ ОБНОВЛЕНИЯ:

‍

#core restart no update; pr: <profile name 1>, …, <profile name N>; //перезапуск без обновления для выбранных профилей

#core restart no update; pr: all; //перезапуск без обновления для всех профилей

‍

//Разделитель параметров - перенос строки вместо точки с запятой:

‍

#core restart no update

pr: all

‍

Примеры:

#core restart no update; pr all;

#core restart no update; profiles: pr01, pr 02, pr03;

‍

ВЫКЛЮЧЕНИЕ ЯДРА:

‍

#core shut down; pr: <profile name 1>, …, <profile name N>; //выключение выбранных ядер

#core shut down; pr: all; //выключение всех ядер

‍

//Разделитель параметров - перенос строки вместо точки с запятой:

‍

#core shut down

pr: all

‍

Примеры:

#core shutdown; pr all;

#core shutdown; profiles: pr01, pr 02, pr03;

‍

ПОЛУЧЕНИЕ ПОЗИЦИЙ:

‍

#get pos; pr: <profile name 1>, …, <profile name N>; //получить позиции для выбранных профилей

#get pos; pr: all; //получить позиции для всех профилей

‍

#get pos

pr: all

#get pos

pr: <profile name 1>, …, <profile name N>

‍

Примеры:

#get pos; pr all;

#get pos; profiles: pr01, pr 02, pr03;

‍

ЗАПУСК/ОСТАНОВКА ВСЕХ АЛГОРИТМОВ:

‍

#start all algo; pr: <profile name 1>, …, <profile name N>; //запуск всех алгоритмов

‍

#start all algo

pr: <profile name 1>, …, <profile name N>

‍

#stop all algo; pr: <profile name 1>, …, <profile name N>; //остановка всех алгоритмов

‍

#stop all algo

pr: <profile name 1>, …, <profile name N>

‍

Примеры:

#start all algo; pr all;

#stop all algo; profiles: pr01, pr 02, pr03;

‍

ЭКСТРЕННАЯ ПРОДАЖА:

‍

#panic sell; pr: <profile name 1>, …, <profile name N>; market: <Market Type>; symbols: <symbol1>, …, <symbol N>; //экстренная продажа

‍

#panic sell

pr: <profile name 1>, …, <profile name N>

market: f

symbols: <symbol1>, …, <symbol N>

‍

Примеры:

#panic sell; pr: 01; market: futures; symbols: btcusdt, ethusdt;

#panic sell; pr: all; market: spot; symbols: all;

‍

ДОБАВЛЕНИЕ ОРДЕРА:

‍

#add order

pr: <profile name 1>, …, <profile name N>

market: <Market Type>;

side: <Side Type>

order type: <Order Type>

symbol: <symbol1>, …, <symbol N>

order size: <Order Size Value>

price <Price Value>

‍

//опциональные параметры

‍

// ПАРАМЕТРЫ Take Profit

‍

//!!! если параметр "TP Percentage" не указан, остальные параметры take profit проверяться не будут

tp percentage: <Take Profit percentage>

tp order type: <Order Type>

tp is iceberg: <true, false>

//!!! если вы хотите указать автоматическое понижение TP и не указываете все параметры, UseAutoPriceDown будет false

tp auto price down time: <Auto price down time>

tp auto price down step: <Auto price down step>

tp auto price down limit: <Auto price down limit>

‍

// ПАРАМЕТРЫ Stop Loss

‍

//!!! если параметр "SL Percentage" не указан, остальные параметры stop loss проверяться не будут

sl percentage: <Stop Loss percentage>

sl order type: <Order Type>

sl spread: <Stop Loss Spread>

sl delay: <Stop Loss Delay>

// !!! если указан Stop Loss Trailing spread, то useTralingSL будет true

sl trailing spread: <Stop Loss Trailing Spread>

*Параметры TakeProfit и StopLoss можно опустить

‍

ОТМЕНА ОРДЕРА:

‍

#cancel order; pr: all; market: <Market Type>; //отмена ордеров

‍

#cancel order

pr: <profile name 1>, …, <profile name N>

market: <Market Type>

symbols: <symbol1>, …, <symbol N> //опциональный параметр

cancel all: <True, False> //опциональный параметр

‍

Примеры:

#cancel order; pr: pr01, pr02, pr03; market: spot; symbols: ethusdt;

‍

#cancel order

pr: all

market: delivery

cancel all: true

‍

ИЗМЕНЕНИЕ МАРЖИ:

‍

#modify margin; pr: <profile name 1>, …, <profile name N>; market: <Market Type>; margin type: <Margin Type>; symbols: <symbol1>, …, <symbol N>; //изменение типа маржи

#modify margin

pr: <profile name 1>, …, <profile name N>

market: <Market Type>

margin type: <Margin Type>

symbols: <symbol1>, …, <symbol N>

‍

Примеры:

#modify margin; pr: pr01, pr02; market: futures; margin type: cross; symbols: bnbusdt;

‍

#modify margin

pr: pr01, pr02

market: futures

margin type: cross

symbols: bnbusdt

‍

ИЗМЕНЕНИЕ КРЕДИТНОГО ПЛЕЧА:

‍

#modify leverage; pr: <profile name 1>, …, <profile name N>; market: <Market Type>; symbols: <symbol1>, …, <symbol N>; leverage: <New leverage Value>; //изменение кредитного плеча

‍

#modify leverage

pr: <profile name 1>, …, <profile name N>

market: <Market Type>

symbols: <symbol1>, …, <symbol N>

leverage: <New leverage Value>

‍

Примеры:

#modify leverage; pr: pr01, pr02; market: futures; symbols: bnbusdt; leverage: 23;

‍

#modify leverage

pr: pr01, pr02

market: futures

symbols: bnbusdt

leverage: 23

*если параметр leverage не указан, будет установлено максимальное значение

‍

УДАЛЕНИЕ ПРОФИЛЯ:

‍

#remove profile; pr: <profile name 1>, …, <profile name N>; //удаление профиля

‍

Примеры:

#remove profile; pr pr04, pr13;

‍

ИЗМЕНЕНИЕ ПРОФИЛЯ ПО УМОЛЧАНИЮ:

‍

#change def profile; pr: <profile name 1>, …, <profile name N>; //изменение профиля по умолчанию

‍

Примеры:

#change def profile; pr pr04, pr13;

‍

ПОЛУЧЕНИЕ БАЛАНСА:

‍

#get balance; pr: <profile name 1>, …, <profile name N>; market: <Market Type>; //получение баланса

‍

#get balance; pr: <profile name 1>, …, <profile name N>;

market: <Market Type>;

‍

Примеры:

#get balance; pr pr04, pr13; market futures;

‍

ПЕРЕВОД БАЛАНСА:

‍

#transfer balance; pr <Profile Name>; from market: <Market Type>; to market: <Market Type>; symbol: <Quote Asset>; amount: <Amount>; //перевод баланса

‍

#transfer balance

pr <Profile Name>

from market: <Market Type>

to market: <Market Type>

symbol: <Quote Asset>

amount: <Amount>

‍

Примеры:

#transfer balance; pr pr04, pr13; from market: futures; to market: spot; symbol: USDT; amount 23;

‍

‍