Appearance
Configuration
Назначение
Этот раздел описывает основные настройки TradingMonitor.Pro: личный кабинет, desktop-приложение, торговые исполнители, маршрутизацию команд и внешние интеграции. Используйте его как справочник, когда нужно понять, где находится параметр, что он означает и когда его менять.
Для первого запуска используйте getting-started.md. Для подключения отдельных каналов используйте guides/telegram.md, guides/discord.md и guides/n8n.md.
Configuration Scope
Настройки платформы делятся на четыре группы:
- account settings в личном кабинете;
- signal settings в desktop-приложении;
- executor settings в NinjaTrader 8 или MetaTrader 5;
- notification settings для Telegram, Discord и n8n.
Обычно настройка выполняется в таком порядке: сначала личный кабинет и session token, затем торговый исполнитель, затем signal list в desktop app, затем интеграции и проверка доставки.
Dashboard Settings
Личный кабинет используется для аккаунта, тарифа, лимитов, session token и внешних интеграций.
| Setting | Где находится | Назначение | Когда менять |
|---|---|---|---|
Email | Account / Dashboard | Email пользователя и вход в личный кабинет. | При смене аккаунта. |
Session token | Dashboard | Подключает desktop app и торговые plugins к вашему аккаунту. | При первичной настройке или после перевыпуска token. |
Plan | Dashboard / Billing | Определяет доступные функции, лимиты и интеграции. | При необходимости большего лимита или доступа к Telegram, Discord, n8n. |
Daily signals | Dashboard | Показывает использование дневного лимита сигналов. | Проверяется при остановке доставки из-за лимитов. |
Device limit | Dashboard / Billing | Количество разрешенных подключенных устройств. | При подключении дополнительных терминалов или рабочих мест. |
Online Signals | Dashboard navigation | Лента полученных сигналов для проверки доставки. | При диагностике и тестировании. |
Session Token
Session token является ключевым пользовательским credential. Он нужен для:
- входа desktop-приложения в пользовательскую сессию;
- подключения NinjaTrader 8 plugin;
- подключения MetaTrader 5 plugin;
- связывания сигналов, интеграций и торговых исполнителей с одним аккаунтом.
Рекомендации:
- храните token как пароль;
- не отправляйте token в чатах и не показывайте на скриншотах;
- при подозрении на утечку перевыпустите token и обновите его во всех подключенных приложениях;
- после замены token проверьте desktop app, NinjaTrader 8, MetaTrader 5 и интеграции.
Desktop App Settings
Desktop-приложение TradingMonitor.Pro используется как Signal Studio: в нем создаются signal lists, настраивается обнаружение сигналов и формируется торговая команда.
| Setting | Где находится | Назначение |
|---|---|---|
Signal list | Left panel / Load / Save | JSON-файл с набором signal templates. |
Signal name | Signal editor | Читаемое имя сигнала в списке. |
Category | Signal editor | Группа или тип сигнала для организации списка. |
Detection type | Signal editor | Режим обнаружения: Screen/OCR или Price/Indicator. |
Command | Command editor | JSON-команда, которая будет отправлена при срабатывании. |
Init | Detection tabs | Подготовка источников, областей или таблиц перед запуском. |
Start | Start Detecting | Запуск мониторинга и фактической отправки сигналов. |
Log | Start Detecting | Проверка runtime-событий, ошибок и отправленных сигналов. |
Важно: Init должен только подготовить detection runtime. Фактический поток логов и отправка сигналов должны начинаться после Start.
Signal List Settings
Signal list сохраняется как JSON-документ с массивом templates. Каждый template описывает один сигнал и связанную команду.
Рекомендуемые правила:
- храните отдельные signal lists для разных стратегий;
- не смешивайте Screen/OCR и Price/Indicator сигналы в одном running list;
- используйте понятные имена сигналов;
- сохраняйте signal list после изменения условий или команд;
- перед live-исполнением проверяйте новый signal list в demo или dry-run.
Screen/OCR Detection
Screen/OCR detection используется для визуальных сигналов на графике.
| Setting | Назначение |
|---|---|
| Text layers | Текстовые элементы, которые нужно найти на экране. |
| Text color | Цвет текста, если сигнал зависит от цвета. |
| Primitive | Визуальная фигура или marker рядом с сигналом. |
| Primitive orientation | Направление или расположение primitive. |
| Reference image | Эталонное изображение для сравнения. |
| Threshold | Минимальный уровень совпадения. |
| Capture area | Область экрана или браузера, где выполняется поиск. |
Рекомендуемый порядок: настройте signal, нажмите Init, убедитесь, что подготовка прошла успешно, затем нажмите Start.
Price and Indicator Detection
Price/Indicator detection используется для условий по TradingView Table View.
| Setting | Назначение |
|---|---|
| Source | Колонка данных: Open, High, Low, Close, Volume или indicator column. |
| Condition | Тип сравнения или события. |
| Value | Числовой порог, если условие сравнивается со значением. |
| Compare source | Второй источник данных, если условие сравнивает две колонки. |
| Logical mode | And или Or между condition blocks. |
| Emission mode | Once или Every bar. |
Перед запуском откройте TradingView Table View, нажмите Init во вкладке Price & Indicators, выберите источники и условия, затем запустите мониторинг через Start.
Command Settings
Команда определяет, что произойдет после срабатывания сигнала. Она хранится как JSON и может быть направлена в торговый plugin или notification integration.
| Field | Назначение | Пример |
|---|---|---|
v | Версия формата команды. | 1 |
signalId | Уникальный идентификатор сигнала. | "ema-cross-long" |
type | Категория команды. | "order", "position", "risk" |
cmd | Конкретное действие. | "buy", "sell", "close" |
platform | Куда направить сигнал. | "mt5", "ninjatrader", "telegram", "any" |
instanceId | Конкретный терминал или plugin instance. | "mt5-vps-01" |
payload | Параметры команды. | symbol, volume, price, stop loss, take profit |
Перед live-режимом проверьте, что type, cmd и payload поддерживаются выбранным торговым исполнителем.
Platform Routing
Поле platform управляет маршрутизацией сигнала.
| Value | Назначение |
|---|---|
any | Отправить во все подходящие и настроенные направления. |
ninjatrader | Отправить в NinjaTrader 8 plugin. |
mt5 | Отправить в MetaTrader 5 plugin. |
telegram | Отправить в Telegram. |
discord | Отправить в Discord. |
n8n | Отправить в n8n. |
telegram,discord | Отправить в несколько выбранных интеграций. |
Если platform не указан, сигнал рассматривается как предназначенный для всех доступных направлений. Для точного контроля лучше указывать platform явно.
Instance Routing
instanceId помогает направить команду в конкретный терминал или plugin instance.
Используйте instanceId, если:
- одновременно подключено несколько терминалов;
- есть отдельные demo и live окружения;
- разные терминалы торгуют разные symbols или accounts;
- нужно исключить случайное исполнение команды не тем plugin instance.
Рекомендации по именам:
ninjatrader-demo-01;ninjatrader-live-main;mt5-demo-vps;mt5-live-eurusd.
Значение instanceId в команде должно совпадать с настройкой в plugin.
NinjaTrader 8 Plugin Settings
NinjaTrader 8 использует indicator TMPro.
| Setting | Назначение |
|---|---|
| Connection URL | Адрес подключения TradingMonitor.Pro. |
| Session token | Token из личного кабинета. |
| InstanceId | Имя конкретного plugin instance. |
| AccountName | Торговый account NinjaTrader. |
| QuantityMultiplier | Множитель количества контрактов. |
| Execution mode / enable execution | Контролирует dry-run или фактическое исполнение. |
| Verbose logging | Расширенные logs для первичной настройки и диагностики. |
Рекомендации:
- сначала проверяйте plugin на demo account;
- включайте live execution только после проверки routing, account и command payload;
- используйте отдельный
InstanceIdдля каждого chart/workspace, если их несколько; - проверяйте logs NinjaTrader после каждого изменения настроек.
MetaTrader 5 Plugin Settings
MetaTrader 5 использует plugin TMPro.
| Setting | Назначение |
|---|---|
| Connection URL | Адрес подключения TradingMonitor.Pro. |
| Session token | Token из личного кабинета. |
| InstanceId | Имя конкретного terminal instance. |
| Execution mode | Dry-run, demo/live-demo или live. |
| DLL imports | Разрешение на использование runtime library, если это требуется вашей поставкой plugin. |
| Trade permission | Разрешение торговли в terminal и account. |
| Volume multiplier | Множитель объема. |
| Allowed symbols | Локальный список разрешенных symbols, если используется. |
Рекомендации:
- сначала используйте dry-run;
- проверьте, что plugin установлен в правильное место;
- включайте live только после проверки journal/log MetaTrader 5;
- убедитесь, что symbol names совпадают с именами у broker.
Notification Settings
Notification settings находятся в личном кабинете в блоке Notifications.
| Integration | Required settings | Optional settings | Статус после настройки |
|---|---|---|---|
| Telegram | Telegram Bot Token, Telegram Chat ID | - | Linked |
| Discord | Discord Webhook URL | - | Linked |
| n8n | n8n Webhook URL | n8n Webhook Secret | Linked |
Если интеграция разрешена тарифом, но поля не заполнены, статус будет Pending Setup. Если интеграция не входит в тариф, статус будет Disabled by Plan.
n8n Webhook Settings
Для n8n отправляется POST request с JSON payload. Если задан n8n Webhook Secret, он передается в header:
text
X-Webhook-Token: <n8n Webhook Secret>Используйте secret, если workflow выполняет важные действия: отправляет заявки, пишет в production tables, вызывает внешние API или запускает цепочку автоматизаций.
Recommended Configuration Profiles
| Profile | Где использовать | Рекомендуемые настройки |
|---|---|---|
| First test | Первый запуск | Demo account, dry-run, verbose logs, Telegram или Discord для уведомлений. |
| Strategy test | Проверка signal list | Dry-run, explicit platform, explicit instanceId, Online Signals enabled. |
| Demo execution | Проверка торгового исполнения | Demo account, live-demo mode, small size, strict symbols. |
| Live execution | Реальная торговля | Explicit platform, explicit instanceId, verified account, conservative size, integration alerts. |
Configuration Checklist
Перед запуском мониторинга проверьте:
- session token скопирован из правильного аккаунта;
- desktop app подключен к этому token;
- нужный trading plugin подключен и показывает нормальный статус;
platformв команде соответствует нужному направлению;instanceIdсовпадает с plugin settings, если используется;- signal list сохранен после последнего изменения;
- для Screen/OCR нажата
Init; - для Price/Indicator открыт TradingView Table View и нажата
Init; - мониторинг запущен кнопкой
Start; - доставка проверяется через desktop log, Online Signals и plugin logs.
Security Notes
Секретными считаются:
session token;Telegram Bot Token;Discord Webhook URL;n8n Webhook URL;n8n Webhook Secret.
Не публикуйте эти значения и не сохраняйте их в открытых документах. При утечке замените соответствующий token, webhook URL или secret, затем обновите настройки во всех подключенных компонентах.
Troubleshooting
Сигнал не появляется в Online Signals: проверьте session token в desktop app, лимиты тарифа, desktop log и факт нажатия Start.
Сигнал появляется в Online Signals, но не приходит в plugin: проверьте platform, instanceId, token и статус подключения plugin.
Сигнал приходит в plugin, но не исполняется: проверьте execution mode, account, trade permissions, symbol, volume и поддержку команды выбранным plugin.
Интеграция показывает Pending Setup: заполните обязательные поля и нажмите Save settings.
Интеграция показывает Disabled by Plan: выберите тариф, где доступна нужная интеграция.