MT5 Manager API, Web API или Server API

Что такое MT5 Manager API?

MT5 Manager API — это интерфейс, который MetaQuotes предоставляет для написания собственного ПО администрирования и управления сервером MetaTrader 5. Всё, что сотрудник бэк-офиса делает в терминале MT5 Manager, — открытие счетов, перевод их между группами, зачисление пополнений, наблюдение за позициями, обработка запросов дилеру — в принципе можно делать из программы, построенной на нём.

Он поставляется владельцам лицензий в составе пакетов MetaQuotes для разработчиков, а не как общедоступная загрузка, а документация находится на сайте поддержки MetaQuotes и доступна после входа. В пакетах, с которыми мы работали, это нативная библиотека для Windows с заголовочными файлами для C++ и обёртками для .NET; сверяйтесь с актуальным пакетом для сборки вашего сервера, потому что детали меняются.

Чем отличаются Manager API, Web API и Server API?

Быстрее всего различить их, если спросить, где выполняется код и что будет, если он упадёт. Программы на Manager API и Web API работают вне сервера и подключаются к нему; плагин Server API работает внутри сервера и вызывается при каждом соответствующем событии.

Где здесь Gateway API и Report API?

Они дополняют набор, но отвечают на другие вопросы. Gateway API подключает MT5 к другим торговым системам и потокам данных — так присоединяются поставщики ликвидности и биржи; о нём рассказывает руководство по MT5 Gateway API. Report API расширяет отчёты, которые формирует торговый сервер, что важно для регуляторной и управленческой отчётности.

Ни один из них не заменяет Manager API или Web API. CRM, которой нужно открывать счета, никогда не будет использовать Gateway API, а подключение к ликвидности никогда не строят на Web API.

Что брокеры автоматизируют с помощью Manager API?

В основном брокеры используют Manager API для работы, которую иначе сотрудники делали бы вручную в терминале Manager, — в больших объёмах или круглосуточно. Типичные примеры из проектов, которые мы видели:

• Администрирование счетов — массовое создание счетов, перевод клиентов между группами, изменение кредитного плеча после оценки уместности.
• Балансовые операции — зачисление пополнений, выводов, кредитных средств и корректировок из одобренной очереди платежей.
• Инструменты дилинга и риск-менеджмента — собственные экраны чистой позиции по каждому символу, оповещения о крупных позициях и доходность клиентов.
• Отчётность для представляющих брокеров — выгрузка сделок для расчёта комиссий в конце каждого дня.
• Комплаенс-проверки — пометка счетов, которые торгуют нетипично или держат позиции через выходные.
• Поддержание порядка — архивирование неактивных счетов, очистка тестовых групп, сверка настроек символов с эталонным списком.

Пример: от одобрения KYC до первой сделки

Допустим, брокер одобряет нового клиента в своей CRM во вторник в 10:00. Вот как в типичной интеграции распределяется работа между интерфейсами; в веб-CRM, как у нас, вызовы на уровне менеджера обычно идут через Web API.

1. KYC одобренКомплаенс-офицер одобряет документы в CRM. CRM проверяет страну клиента и назначает нужную группу MT5.
2. Счёт созданCRM обращается к серверу как менеджер, создаёт счёт с именем, группой, кредитным плечом и сгенерированным паролем, а затем показывает логин в личном кабинете.
3. Пополнение зачисленоПлатёжный провайдер подтверждает пополнение картой. После собственных проверок CRM на счёт проводится балансовая операция с номером платежа в комментарии.
4. Клиент торгуетКлиент входит в WebTrader или приложение и открывает позицию. Если у брокера есть плагин Server API, на этом этапе он может применить собственные правила.
5. ОтчётностьНочью задание отчётности считывает сделки за день для расчёта комиссий IB и для панели риск-менеджеров.

Когда Web API лучше, чем Manager API?

Web API обычно предпочтительнее, когда потребитель — веб-сервис, работающий на Linux, в облаке или написанный не на C++ и не на .NET. Он работает по HTTPS и JSON, поэтому CRM на PHP, Node.js, Go или Python может использовать его без нативной библиотеки. Именно поэтому на нём построено большинство CRM и порталов, включая наши.

Manager API оправдан, когда вы создаёте десктопный инструмент для дилеров, вам нужен полный набор менеджерских функций в нативном приложении или нужно реагировать на события сервера без периодических запросов. Типичный случай — монитор рисков, который должен показывать изменение позиции в реальном времени. Ограничения Web API подробнее разобраны в нашем руководстве по MetaTrader 5 Web API.

Что такое плагин MT5 Server API и когда он нужен?

Плагин Server API — это код, который работает внутри торгового сервера или сервера истории MetaTrader 5 и вызывается при наступлении событий: торговый запрос, сделка, изменение счёта. Он нужен, когда правило должно применяться к каждой операции до того, как результат станет окончательным, и не может ждать, пока внешняя программа это заметит.

Примеры — собственные проверки маржи или совокупной позиции, бонусные правила, зависящие от торгового объёма, логика копитрейдинга, которая должна срабатывать мгновенно, или дополнительные данные, записываемые в сделки для отчётности. В этой силе и риск: медленный или ошибочный плагин замедляет или останавливает сервер для всех. Мы советуем клиентам делать плагины небольшими, тестировать их на отдельном сервере с реалистичной нагрузкой и выносить за пределы сервера всё, что может там работать.

Какой API MT5 использовать для каждой задачи брокера?

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

Кто может получить доступ к MT5 Manager API?

Доступ даёт владелец сервера MT5, потому что каждая менеджерская учётная запись создаётся на этом сервере. С собственной лицензией MT5 вы сами решаете, кто какой менеджер получит и какие пакеты для разработчиков вы используете. На white label решает владелец лицензии, и выданный вам менеджер обычно ограничен вашими группами. На grey label MT5 вы, как правило, работаете через CRM и интерфейсы провайдера, а не получаете учётные данные менеджера напрямую.

Этот вопрос нужно решить до подписания договора. Если в ваших планах собственный инструмент для дилинга или своя CRM, письменно спросите провайдера, какой уровень доступа к API вы получите и на каких условиях. Мы независимая компания, FXUP не связана с MetaQuotes; по лицензионным вопросам о самих пакетах API обращайтесь в MetaQuotes или к провайдеру вашего сервера. Если вы подаёте заявку на собственную лицензию MT5, мы в рамках консалтинговой услуги за плату берём на себя требования MetaQuotes и подачу заявки.

Не знаете, что именно запрашивать? Напишите нам в WhatsApp, опишите свою конфигурацию — и мы предложим формулировку.

А как же сторонние сервисы «MT5 API»?

Многие продукты, которые продаются как «MT5 API», вообще не являются брокерскими API MetaQuotes. Одни подключаются к отдельным торговым счетам, запуская терминалы в облаке вендора; другие оборачивают Python-пакет MetaQuotes, который работает с десктопным терминалом на той же машине. Они подходят трейдерам, сигнальным сервисам и аналитике и работают со счетами любого брокера.

Другие — это размещённые у вендора обёртки над Manager API или Web API, дающие REST-интерфейс поверх менеджерского подключения. Они могут сэкономить время разработки, но тогда ваши учётные данные менеджера находятся у третьей стороны, а вы зависите от её доступности и её цикла обновлений, когда MetaQuotes выпускает новую сборку. Спросите, где размещён сервис, кто может видеть учётные данные и что будет с вашей интеграцией, если вендор прекратит работу.

Как обезопасить интеграцию на уровне менеджера?

Относитесь к каждой менеджерской учётной записи, которую использует программа, как к привилегированной системной учётной записи — ведь это она и есть. Правила, которые мы применяем в собственных интеграциях:

• Один менеджер на одну интеграцию — только с теми правами и группами, которые ей нужны.
• Балансовые операции — только из одобренной очереди, никогда напрямую из запроса со стороны клиента.
• Учётные данные — в хранилище секретов, со сменой при смене сотрудников или подрядчиков.
• Подключение разрешено только с известных серверов.
• Каждая запись фиксируется в журнале с указанием бизнес-причины и ежедневно сверяется.
• Никаких автоматических повторов денежных операций или сделок после тайм-аута; сначала проверьте состояние на сервере.

Какие ошибки типичны для проектов на MT5 Manager API?

Типичные ошибки — архитектурные, и большинство из них совершается в первую же неделю. Избежать их дёшево, а исправлять дорого, когда клиенты уже зависят от системы.

• Один менеджер на всё. CRM, задание отчётности и инструмент дилера используют один логин с полными правами, поэтому никто не может понять, какая система внесла изменение, и ни у одной нельзя отозвать доступ отдельно.
• Опрос счёт за счётом. Портал, который по очереди запрашивает позиции каждого клиента, работает при 50 счетах и замедляет сервер при 5000. Используйте пакетные запросы и кэшируйте то, что не меняется.
• Бизнес-логика в плагине. Правило копитрейдинга или бонусов, написанное как плагин Server API, потому что так казалось «ближе к серверу», хотя оно могло бы безопасно работать снаружи.
• Игнорирование серверного времени. Сделки хранятся в CRM по времени сервера и сравниваются с платёжными записями в UTC, поэтому ежедневные сверки расходятся на два-три часа.
• Повтор денежных операций. Вызов пополнения не дождался ответа, код пробует снова — и клиенту зачисляют деньги дважды. Перед любым повтором проверьте историю счёта.
• Нет плана на обновления MT5. MetaQuotes регулярно выпускает новые сборки. Держите тестовый сервер на следующей сборке и прогоняйте на нём интеграцию до обновления рабочего сервера.

Меняет ли выбор проп-компания или проект копитрейдинга?

Да, немного. Технологии для проп-трейдинга во многом опираются на быстрые действия со счетами по правилам — например, закрытие счёта на оценочном этапе (challenge) в момент нарушения лимита просадки. Одни компании делают это снаружи через Web API или Manager API с частыми проверками; другие предпочитают плагин, чтобы правило применялось внутри сервера. Компромисс — между скоростью реакции и риском запуска собственного кода на сервере.

Копитрейдинг и PAMM находятся в похожем положении. Само копирование может работать вне сервера, но распределение объёма и комиссий должно быть точным, поэтому выбранный интерфейс должен давать надёжные данные о сделках и возможность сверки. Ликвидность — отдельная тема: если проекту нужны ещё и новые поставщики, см. интеграцию с поставщиком ликвидности.

Как FXUP работает с API MT5?

Наш брендированный WebTrader, мобильные приложения и собственная CRM для брокеров подключаются к MT5 через бэкенд на Go, который использует Web API. Мы также работаем с партнёрскими CRM и предлагаем то, что подходит проекту; в любом случае мы проверяем, какой интерфейс и какие права менеджера нужны CRM, до запуска. Для клиентов с собственным сервером мы также оцениваем инструменты для дилеров, задания отчётности и изредка плагины — и скажем вам, если с задачей справится уже существующая функция MT5 или более простой интерфейс.

Если вы сравниваете предложения по проекту с API, пришлите нам спецификацию в WhatsApp; мы скажем, какой интерфейс нужен для каждого пункта и где скрыта работа. Какие проекты мы берём, перечислено на странице индивидуальных интеграций.

Частые вопросы

Не нашли ответа? Спросите в WhatsApp, напишите @FXUPCK в Telegram или на почту [email protected].