📘 PairTrading PRO — Руководство пользователя

🔧 Установка программы

1.1 Что нужно перед установкой

Перед началом работы убедитесь, что у вас подготовлен компьютер или VPS сервер.

Системные требования:

Также вам понадобятся:
Лицензионный Public Key (доступен в вашем Личном кабинете на сайте).

🛠 1.2 Пошаговая установка

1. Скачайте установщик PairTrading PRO из Личного кабинета на сайте.
2. Запустите файл (лучше правой кнопкой мыши → «Запуск от имени администратора»).
3. Ознакомьтесь с условиями и примите лицензионное соглашение.
4. Следуйте мастеру установки: нажимайте Next → Next → Install → Finish.
5. На рабочем столе появится ярлык программы 🎉

💡 Совет: Не меняйте папку установки по умолчанию, если не знаете зачем — так проще потом искать файлы.

📸 [СКРИН S01 — мастер установки: окно с кнопками Next / Install / Finish]

🚪 Первый запуск

2.1 Запуск

1. Дважды кликните по ярлыку PairTrading Pro.
2. Если Windows запросит разрешение на сетевой доступ (Firewall) — обязательно разрешите, иначе программа не сможет подключиться к биржам.

2.2 Окно входа (Login)

Перед вами откроется окно входа. Здесь всё просто:

1. В поле Public Key введите ваш лицензионный ключ.
2. Поставьте галочку Remember me (чтобы не вводить его каждый раз).
3. Нажмите кнопку Log in ✅

🔑 ВАЖНО:

• Ключ вводите без лишних пробелов в начале и конце — иначе он может не сработать.
• Один ключ активации можно использовать для двух одновременных запусков платформы на разных компьютерах. При первом входе ключ привязывается к компьютеру. Если необходимо в дальнейшем сменить компьютер для использования терминала, необходимо на сайте в разделе «Моя подписка» сбросить привязку к ПК, нажав на соответствующую кнопку.

2.3 Проверка подключений

После входа программа проверяет существующие подключения к биржам ("Check connections"):

1. Дождитесь надписи "Check connections completed".
2. Нажмите OK.

⚠️ Если этого окна нет — не паникуйте. Это значит, что подключения к биржам ещё не настроены. Просто переходите к следующему разделу.

🏠 Главное окно

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

3.1 Верхнее меню (самое важное)

3.2 Рабочие вкладки (таблицы в нижней части)

🧠 Золотое правило начинающего:
Сначала подключение → потом спред → потом тест на истории → потом торговля минимальным объёмом. Не перескакивайте этапы!

🔌 Подключение биржи

Это ключевой этап. Без подключения к бирже программа не может ни получать котировки, ни торговать.

4.1 Открываем настройки подключений

1. В верхнем меню нажмите Connections.
2. Выберите Edit.

4.2 Создание и настройка подключения к крипто-биржам

4.2.1. Подготовка API-ключей на крипто-бирже (ВАЖНО! ⚠️)

Перед тем как добавлять подключение в программу, вам нужно создать API-ключ на самой бирже (ByBit, OKX, Binance и т.д.). Вот правила безопасности:

🔒 Совет по безопасности: Если биржа позволяет — включи IP whitelist и впишите IP вашего компьютера или VPS. Так, даже если ключ каким-то образом утечёт, злоумышленник не сможет им воспользоваться с другого IP.

💡 Где взять ключи? Процесс создания ключей индивидуален для каждой площадки. Обычно этот раздел находится в настройках профиля («Управление API» / «API Management»). Рекомендуем ознакомиться с официальными инструкциями вашей биржи по созданию API ключей.

4.2.2. Настройка подключения к крипто-бирже

1. В окне Connection Settings нажмите кнопку Add.
2. Выберете из списка нужную крипто-биржу.
3. Заполните в ней поля:
   • Account name — придумайте понятное имя (например: bybit_test).
   • Exchange — выберите биржу и рынок (например: ByBit_spot).
   • Enable — поставьте галочку ✅.
   • api_key — вставьте ваш API Key (скопируйте с биржи).
   • api_secret — вставьте ваш API Secret (скопируйте с биржи).
   • Если биржа требует дополнительные поля — passphrase, uid — заполните их тоже.
4. Нажмите OK.

4.4 Настройка подключения к MetaTrader 5 (MT5)

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

1. В окне Connection Settings нажмите кнопку Add.
2. Выберите MT5_NETTING или MT5_HEDGING.
   • MT5_NETTING — одна общая позиция по инструменту. Новые сделки усредняют или закрывают текущую.
   • MT5_HEDGING — раздельные независимые позиции. Можно открывать несколько сделок по одному инструменту.
3. Account name: Придумайте имя (например, Just2Trade_MT5).
4. login: Введите номер вашего торгового счета (только цифры).
5. password: Введите ваш торговый пароль от счета.
6. Server (Важно!) ❗ Здесь нужно указать точное имя сервера, как оно прописано у брокера. Ошибка даже в одном символе не даст подключиться.
   • 💡 Где взять имя сервера? В терминале MT5 нажмите File (Файл) → Open an Account (Открыть счет) или Login. Скопируйте название сервера из списка (например: Just2Trade-MT5 или Alpari-Pro).
7. path_to_file Нажмите кнопку Find file "terminal64.exe". В открывшемся окне найдите папку, куда установлен ваш MT5, и выберите файл terminal64.exe. Это необходимо, чтобы программа могла запускать терминал и отправлять в него команды.
8. Commission type: Выберите тип исполнения ордеров. Обычно используется FOK (Fill or Kill) или IOC или Return.
9. time_zone (Важно!) ❗Укажите часовой пояс сервера брокера (смещение относительно GMT/UTC). Если указать пояс неверно, исторические данные из МТ5 терминала будут неправильно накладываться на данные с других бирж. Это приведет к ошибкам в расчетах построения графика спреда.
   • 💡 Как определить time_zone? Откройте в MT5 окно «Обзор рынка» (Market Watch) и посмотрите его текущее время. Сравните это время с временем по Гринвичу (GMT). Пример: Если время в Лондоне (GMT) 12:00, а в терминале 15:00, значит смещение +3. В поле вводим цифру 3.
10. Поставьте галочку Enable ✅ и нажмите OK.

4.5 Проверка подключения

1. Вернитесь на вкладку Connections Status в главном окне.
2. Убедитесь, что статус вашего аккаунта — Connected ✅.
3. Если статус Disconnected или ошибка — смотрите раздел 13 «Частые проблемы».

📐 Создание спреда

5.1 Что такое спред простыми словами?

Спред — это «связка» двух и более инструментов. Вы не ставите на рост или падение одного актива. Вместо этого вы ставите на то, что разница между активами вернётся к своему среднему значению. Это и есть суть парного/баскет трейдинга! 🎯

Пример: BTCUSDT и ETHUSDT обычно двигаются похоже. Если один «убежал вперёд» — вы ставите на то, что второй его «догонит» (или первый «вернётся»).

5.2 Открываем Spread Builder

1. В верхнем меню нажмите Spread.
2. Выберите New Spread.

5.3 Добавляем первый инструмент

1. Нажмите Add instrument.
2. В появившемся окне New instrument:
   • Exchange — выберите ваш аккаунт (например bybit_test).
   • Instrument Name — введите тикер первого инструмента (например XRPUSDT).
   • Нажмите Apply.

5.4 Добавляем второй инструмент

1. Повторите то же самое для второго тикера (например XLMUSDT).
2. Нажмите Apply.

5.5 Переходим дальше

1. Убедитесь, что в списке видны оба инструмента.
2. Нажмите Next.

📊 Загрузка данных

6.1 Зачем нужна история?

Чтобы программа могла:

• Рассчитать правильные веса спреда;
• Построить график спреда;
• Протестировать стратегию на прошлых данных (бэктест).

Без истории — ни расчётов, ни тестов. Так что этот шаг обязателен! 📈

6.2 Настройка загрузки

1. Timeframe — выберите таймфрейм (размер одной свечи):
   • Для первого раза рекомендуем 1h(один час).
   • Чем меньше таймфрейм — тем больше данных загрузится (и дольше ждать).
2. Period — выберите период:
   • last week — последняя неделя.
   • last 3 month — последние 3 месяца.
   • last 6 month — последние 6 месяцев.
   • custom dates — свой диапазон (указываете First date и Second date).
3. Нажмите Next.

⏳ Дождитесь окончания загрузки (может занять от нескольких секунд до нескольких минут в зависимости от объема данных).

💡 Совет: Начните с last 6 month. Если всё загрузилось без ошибок — потом загрузите больший период для серьёзного бэктеста.

⚖️ Конструктор спредов

7.1 Что тут происходит?

Программа считает, в каких пропорциях покупать/продавать каждую ногу спреда, чтобы позиция была сбалансированной (нейтральной к рынку). Это самое «сердце» парного трейдинга.

7.2 Выбор модели весов (Weighting Model)

В выпадающем списке доступны модели:

💡 Совет: Если вы только начинаете, используйте OLS. Это золотой стандарт. Переходите к TLS или PCA, только если понимаете, почему OLS не справляется с вашей конкретной парой.

7.3 Настройка капитала

Allocated Capital per Spread, USD — сколько долларов вы выделяете на этот спред.
Программа автоматически рассчитает:

• Weight — вес каждой ноги;
• Lot — рекомендуемый объём (например: 0.154253 для BTCUSDT);
• Estimated Margin — оценка необходимой маржи.

7.4 Проверяем и идём дальше

1. Нажмите Refresh Graphic — обновится график спреда.
2. Посмотрите на таблицу с весами/лотами — убедитесь, что значения адекватные.
3. Нажмите Next.

🧪 Бэктестер

8.1 Зачем делать бэктест?

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

8.2 Fast Backtest

После Spread Calculator программа перейдет в Fast Backtest (быстрое бектестирование):

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

После завершения вы увидите два блока:

Блок "Backtest result" — ключевые метрики:

• Total profit — Итоговая прибыль за весь период.
• Profit Factor — Отношение прибыли к убытку (чем больше — тем лучше).
• Winrate — Процент прибыльных сделок.
• Sharpe Ratio — Коэффициент Шарпа (доходность/риск, >1 — хорошо).
• Drawdown — Максимальная просадка в %.

Кнопки действий:

• Recalculate — пересчитать бэктест с изменёнными параметрами.
• Back — вернуться назад к Spread Calculator.
• Finish — завершить настройку и перейти к живой торговле.

8.4 Полный бэктест

Он расположен в окне Торговля спредом(см. следующий раздел). В нем вы можете провести более глубокую оптимизацию параметров и более расширенное тестирование как и всего спреда, так и отдельных его ног для возможного нахождения ведущих и ведомых инструментов в спреде.

💹 Торговля спредом

9.1 Переход к торговле

После бэктеста нажмите Finish — откроется торговое окно спреда.

9.2 Элементы торгового окна

Главная панель управления:

Нижние вкладки:

• Trading — Главная панель управления.
• Messages — Системные сообщения.
• Script Messages — Сообщения скрипта автоторговли.
• Quotes — Котировки отдельных торговых инстументов в реальном времени.

9.3 Ручная торговля (рекомендуем начать именно с неё! 👆)

Пошаговый алгоритм первой сделки:

1. Проверьте готовность:
   • ✅ Подключение — Connected.
   • ✅ На счёте есть средства/маржа.
   • ✅ Котировки обновляются.
2. Настройте параметры:
   • Position = 0 (показывает открытую текущую позицию)
   • Max pos. limit = 1 (означает что программа не сможет открыть более одного спреда).
   • Quantity = 1 (количество спредов которые программа купит/продаст при нажатии кнопок Buy Spread или Sell Spread).
3. Откройте позицию:
   • Нажмите Buy Spread или Sell Spread.
4. Проверьте исполнение:
   • Убедитесь, что открылись все ноги спреда (торговые позиции по всем инструментам в спреде).
5. Закройте позицию:
   • Нажмите Close All — программа закроет обе ноги одновременно.

🛡️ Защита: Max pos. limit = 1 означает, что программа не откроет больше одного спреда. Это страховка от случайных «двойных нажатий» и ограничение для набора позиций скрипта.

9.4 Окно Edit Spread

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

• Блок Short (Шорт / Продажа): Список инструментов, которые будeт проданы при покупке спреда. На примере сюда добавлены BCHUSDT, AVAXUSDT, LTCUSDT.
• Блок Long (Лонг / Покупка): Список инструментов, которые будeт куплены при покупке спреда. В примере это ADAUSDT, BNBUSDT, ETHUSDT.
• Кнопки Add / Edit / Delete (Добавить / Изменить / Удалить): Позволяют управлять списком в каждой из колонок. Вы можете гибко собирать любые связки (например, 3 актива против 3, или 1 актив против 5).

9.4.1 Окно «New Short/Long Instrument» (Настройки конкретного инструмента в корзине)
Это окно открывается при нажатии кнопки Add или Edit. Здесь задаются точные параметры для каждой отдельной "ноги" (торгового инструмента) внутри вашей корзины:

• Exchange (Биржа): Выбор подключения для конкретной монеты(вы можете собирать в одну корзину инструменты с разных бирж (например, лонговать на Binance, а шортить на Bybit).
• Instrument Name (Имя инструмента): Тикер инструмента(пример — BCHUSDT).
• Weight (Вес): Математический вес инструмента в общей формуле спреда. Для шорт-позиций он обычно отрицательный (-1.21), для лонгов — положительный. Программа использует эти веса для построения единого графика спреда.
• Trade Lots (Торговый лот): Физический объем (торговый лот), который скрипт будет покупать или продавать при входе в сделку по этому конкретному активу (в примере — 4.1874 BCH).
• Commission per trade (Комиссия за сделку): Позволяет заложить процент или фиксированную комиссию биржи прямо в настройки инструмента. Это делает бэктест и расчет PnL (прибыли/убытка) максимально точным и приближенным к реальности.

🤖 Автоматическая торговля

10.1 Что делает скрипт?

Скрипт автоматически открывает и закрывает позиции по спреду на основе стратегии (той самой, которую вы настраивали в бэктесте).

10.2 Запуск скрипта

1. В торговом окне спреда откройте меню Script.
2. Нажмите Edit Script
3. Проверьте еще раз параметры скрипта перед запуском, если необходимо, сохраните параметры в отдельный файл, после этого можно закрыть окно.
4. В торговом окне спреда снова откройте меню Script и нажмите Run Script.
5. Внизу слева статус сменится на: "Script is running" ✅ - скрипт запущен.
6. Во вкладке Script Messages будут вестись записи действий скрипта.

10.3 Остановка скрипта

1. Меню Script → Stop Script.
2. Статус сменится на "Script stopped".

⚠️ Важно: Остановка скрипта НЕ закрывает открытые позиции! Если при остановке скрипта у вас есть открытая позиция — закройте её вручную кнопкой Close All или через биржу.

📋 Журналы, позиции

11.1 В главном окне программы

• Opened Positions — Что сейчас открыто.
• Closed Positions — Вся история закрытых сделок.
• Total Profit — Общий итог (сколько заработано/потеряно суммарно).

💾 Сохранение и загрузка

12.1 Сохранение спреда

1. В торговом окне спреда перейдите в меню Spread → Save Spread.
2. Выберите папку для сохранения.
3. Введите имя файла и нажмите Сохранить.

12.2 Сохранение параметров скрипта

Если нужно сохранить настройки торгового алгоритма, действия аналогичны:

1. В меню выберите Script → Edit→Save Script.
2. Задайте имя файла и нажмите Сохранить.

12.3 Загрузка спреда или настроек

В главном или торговом окне:

1. Для спреда: Spread → Load Spread.
2. Для настроек скрипта: Script → Edit→Load Script.
3. Выберите нужный файл (например, .sprd) и нажмите Открыть.

12.4 Автосохранение

В Settings → Common Settings можно включить Autosave.

💡 Совет: Всегда сохраняйте спред после настройки. Если программа или VPS перезагрузится — вы не потеряете работу.

⚙️ Настройки программы

13.1 Main Settings

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

• Reconnect count (Количество переподключений): Сколько раз программа автоматически попытается заново подключиться к бирже (или серверу брокера) в случае внезапного обрыва связи. 
• Language (Язык): Выбор языка интерфейса платформы.
• Cores count (Количество ядер): Указывает, сколько ядер вашего процессора (CPU) программа может задействовать на параллельную отправку ордеров на биржи. Выделение большего количества ядер позволяет платформе отправлять команды по всем «ногам» спреда одновременно, минимизируя сетевые задержки. Это важно для синхронного входа в сделку и минимизации проскальзывания в открытии ордеров. Учитывайте: чем больше ядер задействовано, тем сильнее становится общая нагрузка на ваш ПК или VPS.
• Theme (Тема оформления): Выбор визуального стиля программы. На скриншоте выбрана Dark Theme (Тёмная тема) — идеальный вариант для того, чтобы глаза не уставали во время длительных торговых сессий.
  
  

13.2 Common Settings

Расположено в верхнем меню Settings окна торговли спредом. Здесь задаются базовые параметры отрисовки графиков, расписания работы спреда и сохранения данных.

1. Chart settings (Настройки графиков)

• Timeframe: Таймфрейм по умолчанию для построения графиков (Важно: При изменении таймфрейма все текущие исторические данные будут удалены).
• Max Ticks On Chart: Лимит отображаемых тиков (данных) на графике. Ограничение помогает не перегружать оперативную память компьютера, если спред открыт очень долго.
• Max Ticks On History: Максимальное количество исторических данных, загружаемых в память для бэктестов и расчетов.
• Day Separator: Если поставить галочку, на графике появятся вертикальные линии, визуально разделяющие торговые дни.
• Show Open/Close lvls: Включает/выключает отображение уровней открытия и закрытия при на графике спреда.

2. Trading time (Время торговли)
Этот блок управляет расписанием работы окна спреда:

• Start time / Stop time: Промежуток времени, в котором работает спред (по локальному времени ПК/VPS). 
• Edit break time: Кнопка для настройки перерывов работы внутри торгового дня (например, для остановки на время клиринга на традиционных биржах или выхода важных новостей).
• Дни недели (Mn, Tu, We, Th, Fr, Sa, Su): Галочками отмечаются дни, в которые автоторговля активна. Для крипты обычно оставляют все галочки, а для классических рынков (MT5) — убирают субботу (Sa) и воскресенье (Su).

3. Data settings (Настройки данных)

• Autosave spread data: Активирует функцию автоматического сохранения спреда в ранее сохраненный файл.
• Autosave period(min): Интервал автосохранения в минутах. Например, при значении 1 программа будет сохранять прогресс каждую минуту, страхуя вас от потери данных при сбоях.
• Clear spread data: Кнопка для очистки кэша и сохраненных данных текущего спреда (полезно, если нужно полностью сбросить накопленную историю и начать с чистого листа).

4. Trading settings (Торговые настройки)
Блок защиты от сетевых сбоев и ошибок биржи:

• Max tries open/close order: Количество попыток переоткрыть неудавшийся ордер при открытии/закрытии спреда, если предыдущий был отклонен биржей (например, из-за резкого скачка цены).
• Max tries reopen order: Сколько раз программа попытается повторно отрыть/закрыть спред, если произошел дисбаланс позиций в спреде

🛠️ Частые проблемы и решения

14.1 🐞 Автоматический отчет об ошибках

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

Выбор остается за вами:
✅ Согласиться — отправить отчет. Это поможет нам быстрее найти причину сбоя и исправить её в новом обновлении.
❌ Отказаться — закрыть окно без отправки данных.

*Никакие личные данные при этом не передаются, только техническая информация о произошедшей ошибке.

14.2 ❌ Не удаётся войти (Login)

• Ошибка при вводе ключа: Скопируйте ключ заново, уберите пробелы в начале/конце.
• Ошибка времени: Включите автосинхронизацию времени в Windows.

14.3 ❌ Биржа не подключается (Disconnected)

Это самая частая проблема. Проверяйте по порядку:

1. API Key / Secret (скопированы без пробелов?).
2. Права ключа (Read + Trade — Да, Withdraw — НЕТ).
3. IP whitelist (добавлен ли IP вашего ПК/VPS?).
4. Время Windows (синхронизировано?).
5. Текст ошибки в Messages (прочитайте его).

14.4 ❌ История не загружается

• Ошибка при загрузке: Проверьте точное написание тикера.
• Пустой график: Проверьте, правильный ли рынок выбран (spot vs futures).
• Таймаут: Уменьшите период или увеличьте таймфрейм (5m вместо 1m).

14.5 ❌ Ордер отклонён (Invalid quantity)

• Invalid quantity: Объём меньше минимума биржи — увеличьте Quantity.
• Insufficient margin: Недостаточно средств — пополните счёт.

14.6 ⚠️ Открылась только одна нога спреда

Это опасная ситуация — вы остаётесь с направленной позицией.
Экстренный протокол:

1. 🛑 Сразу остановите скрипт (Script → Stop Script).
2. Если скрипт сам не смог закрыть уже открытую ногу, закройте ее вручную на самой бирже.
3. Изучите причину на вкладке Messages.

❓ FAQ

15.1 Можно ли торговать между разными подключениями?

Да, безусловно! Платформа позволяет гибко настраивать маршрутизацию сделок.

Вы можете выбрать разные подключения для каждой стороны спреда (Leg 1 и Leg 2). Это открывает возможности для:

• Межбиржевого арбитража (например, купить на Binance, продать на Bybit).
• Торговли между разными типами терминалов (например, связка MetaTrader 5 и криптобиржи).

Просто укажите нужный источник (Connection) для каждого инструмента при настройке спреда.

15.2 Обязательно ли запускать скрипт?

Нет. Можно торговать вручную кнопками Buy/Sell Spread. Начинающим лучше начать именно так, чтобы понять логику.

15.3 Можно ли запускать несколько спредов одновременно?

Да, можно. Но учитывайте, что каждый спред потребляет ресурсы (CPU, RAM) и маржу.

15.4 Программа закрылась / VPS перезагрузился — что будет с позициями?

Если программа была закрыта или произошла перезагрузка сервера (VPS), ваши открытые позиции останутся висеть на бирже. Они не закроются автоматически.

⚠️ Важно: На данный момент наша платформа не умеет восстанавливать управление ранее открытыми позициями после перезапуска. Программа "забудет" о них.

Вам необходимо:

1. Зайти на биржу через веб-интерфейс/мобильное приложение биржи или терминал брокера.
2. Найти эти позиции.
3. Закрыть их самостоятельно вручную.

🔐 Рекомендации по безопасности

16.1 API-ключи

❌ Никогда не включайте Withdraw — даже если ключ утечёт, деньги не выведут.
✅ Используйте IP whitelist — ключ будет работать только с вашего IP.

16.2 VPS / Сервер

• Используйте сложный пароль от VPS.
• Включите автообновление Windows.
• Настройте автозапуск программы через Планировщик заданий (Task Scheduler).

📞 Контакты и обновления

17.1 Техническая поддержка

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

Пожалуйста, используйте форму обратной связи на нашем сайте.

17.2 Обновление программы

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

🎓 Заключение

Поздравляем! Если вы дочитали до этого места — вы уже знаете больше, чем 90% людей, которые скачивают программу и пробуют наугад 😄

Главные выводы:

1. 🔌 Подключение — фундамент всего. Если биржа не Connected — дальше ничего не работает.
2. 📐 Спред — сначала создайте, загрузите историю, рассчитайте веса.
3. 🧪 Бэктест — обязателен перед реальной торговлей.
4. 💹 Торговля — начните руками, минимальным объёмом.
5. 💾 Сохраняйте спреды в .sprd файлы.
6. 🛡️ Безопасность — Withdraw OFF, IP whitelist ON.