MetaTrader 5 Web API — серверный интерфейс MetaQuotes для подключения торгового сервера MT5 к сайтам, CRM и другим системам компании. Приложение входит под менеджерской учётной записью и может управлять пользователями, балансами, группами, символами, ордерами, позициями, сделками, тиками и графиками. Подключать поставщиков ликвидности или транслировать стакан LP он не умеет — это задачи других API MT5.
Что такое MetaTrader 5 Web API?
MetaTrader 5 Web API — интерфейс, который MetaQuotes предоставляет для подключения торгового сервера MT5 к собственным веб-сервисам брокера: личному кабинету клиента, CRM, обработке платежей, отчётности и собственным торговым интерфейсам. Он работает с сервером, а не с терминалом трейдера, и аутентифицируется как менеджер — тот же тип учётной записи, под которым ваши сотрудники бэк-офиса работают в терминале MT5 Manager.
Собственное определение MetaQuotes умещается в одну строку и при этом точно: Web API предназначен для интеграции с веб-ресурсами и другими сервисами компании. Всё остальное на этой странице — о том, что это означает на практике. Полный технический справочник находится на сайте поддержки MetaQuotes и доступен владельцам лицензий после входа; если у вас есть серверная лицензия MT5 или вы работаете на её владельца, этот справочник важнее всего, что написано здесь.
“Web API используется для интеграции платформы с веб-ресурсами и другими сервисами компании.”
Чем Web API отличается от других API MetaTrader 5?
MetaQuotes публикует пять API для MT5, и у каждого своя задача. Web API — единственный, который обращается к серверу снаружи по сети; остальные либо работают внутри сервера, либо подключают его к рынкам, либо расширяют его отчёты. Определения во втором столбце — цитаты со страницы MetaQuotes для брокеров.
| API | Определение MetaQuotes | Где работает ваш код | Типичная задача брокера |
|---|---|---|---|
| Web API | «используется для интеграции платформы с веб-ресурсами и другими сервисами компании» | На вашем сервере, с подключением по сети | CRM, личный кабинет клиента, платежи, собственный WebTrader |
| Manager API | «позволяет разрабатывать собственные утилиты администрирования и управления и даже собственный менеджерский терминал» | В менеджерском приложении, которое подключается к серверу | Инструменты бэк-офиса, утилиты дилинга и риск-менеджмента |
| Server API | «может помочь добавить новые функции в MetaTrader 5 Trade Server и MetaTrader 5 History Server» | Внутри сервера MT5 в виде плагина | Собственные правила для каждой сделки, бонусы, логика копирования |
| Gateway API | «используется для интеграции MetaTrader 5 с другими торговыми системами и создания собственных потоков данных» | В шлюзе (gateway), подключённом к платформе | Поставщики ликвидности, биржи, потоки данных |
| Report API | «расширяет отчёты, которые формируют торговые серверы MetaTrader 5» | Внутри компонента отчётности | Собственные регуляторные и управленческие отчёты |
MT5 Web API — это REST или WebSocket?
MT5 Web API работает по схеме «запрос — ответ»: ваше приложение отправляет команду и ждёт ответа. В текущих версиях это HTTPS-запросы к путям вроде /api/user/get или /api/tick/last с ответами в JSON, а также более старый бинарный протокол через постоянное сокет-соединение, который использует пример кода самой MetaQuotes. Мы используем оба — для разных задач.
Но это не WebSocket API. Web API ничего не отправляет вам по собственной инициативе — ни цену, ни изменение позиции; если нужны обновления в реальном времени, вы запрашиваете их с выбранной вами частотой. Когда провайдер пишет, что его «MT5 Web API работает на WebSocket», обычно имеется в виду, что он построил поверх WebSocket-слой — именно так мы и сделали в нашем брендированном WebTrader.
Есть и вторая путаница, которую стоит сразу прояснить. Ряд сервисов продаёт «MT5 API», который подключается к счёту трейдера через терминал, запущенный в их облаке, или через Python-пакет MetaQuotes для десктопного терминала. Это инструменты уровня счёта для трейдеров и сигнальных сервисов. Web API работает на уровне брокера: он видит все счета на сервере, которые разрешено видеть менеджеру.
Как устроена аутентификация в MT5 Web API?
Ваше приложение аутентифицируется как менеджер MT5 по схеме «запрос — ответ» (challenge-response), поэтому пароль менеджера никогда не передаётся в открытом виде. В HTTPS-варианте, который используем мы, для этого нужны два вызова:
- НачалоПриложение вызывает команду начала аутентификации со своим менеджерским логином и представляется агентом Web API. Сервер отвечает случайной строкой-вызовом (challenge).
- ОтветПриложение объединяет хеш пароля с этой строкой, отправляет результат и добавляет собственную случайную строку-вызов.
- Проверка сервераСервер отвечает на вызов клиента, а приложение проверяет этот ответ — так обе стороны доказывают, что знают пароль.
- Сохранение сессииАутентифицированная сессия привязана к нижележащему соединению. Если соединение оборвалось, аутентификацию нужно пройти заново.
Что можно построить на MetaTrader 5 Web API?
На Web API можно построить почти любую клиентскую систему, которая нужна брокеру, потому что он даёт доступ к объектам, с которыми эти системы работают: пользователям, счетам, группам, символам, ордерам, позициям, сделкам и истории цен. В таблице — группы команд, которые мы используем, и задачи, которые они решают.
| Группа | Что охватывает | Типичное применение |
|---|---|---|
| Пользователи и счета | Создание, изменение, удаление и чтение счетов; проверка и смена паролей; чтение баланса, средств (equity) и маржи | Открытие счёта после KYC в CRM, сброс паролей, дашборды в личном кабинете |
| Балансовые операции | Пополнения, выводы, кредит и корректировки по счёту | Автоматическое зачисление пополнения картой или банковским переводом |
| Группы и символы | Чтение и ведение настроек групп и символов | Корректные спецификации контрактов, маржа и торговые сессии в интерфейсе |
| Ордера, позиции, сделки, история | Текущие и исторические торговые данные, включая пакетные запросы по множеству счетов | История сделок, выписки, расчёт комиссий IB |
| Цены и графики | Последние тики, статистика тиков, история тиков и бары графиков | Котировки и графики в WebTrader или мобильном приложении |
| Торговые запросы | Запросы, исполняемые на сервере от имени счёта, с кодом результата | Выставление, изменение и закрытие ордеров из собственного интерфейса |
| Почта и новости | Внутренняя почта и новости в терминалы | Служебные сообщения клиентам |
Чего MT5 Web API не умеет?
Web API не может подключить ваш сервер к ликвидности, выполнять код внутри сервера и отправлять вам данные по своей инициативе. Эти ограничения заложены намеренно: для каждой из этих задач есть другие API MetaTrader 5.
- Нет подключения к ликвидности. Цены от банков и prime-of-prime-провайдеров поступают через шлюз (gateway), бридж ликвидности или Ultency — см. страницы MT5 Gateway API и интеграция ликвидности.
- Нет стакана LP и глубины рынка. Web API отдаёт последние тики и статистику по каждому символу. Он не транслирует агрегированный стакан от ваших провайдеров, поэтому интерфейс на Web API показывает bid и ask, а не лестницу глубины рынка.
- Нет логики внутри сервера. Правила, которые должны срабатывать для каждой сделки до её исполнения, требуют плагина на Server API. Приложение на Web API видит только то, что уже произошло.
- Нет push. Каждое обновление — это запрос; котировки и позиции в реальном времени означают опрос с частотой, которую выбираете вы и выдерживает сервер.
- Нет собственных серверных отчётов. Расширять отчёты, которые формирует сам торговый сервер, — задача Report API.
Как FXUP использует MT5 Web API в своём WebTrader?
Наш WebTrader и мобильные приложения никогда не обращаются к MT5 напрямую. Они подключаются по защищённому WebSocket к бэкенду на Go, а уже бэкенд работает с сервером MT5 через Web API — и по бинарному протоколу, и через HTTPS-запросы. Клиент получает обновления в push-режиме, а сервер MT5 видит небольшое и предсказуемое число менеджерских сессий.
Результат можно попробовать в демоверсии WebTrader и демоверсии мобильного приложения — обе подключены к реальной демосреде MT5. FXUP — независимый разработчик и не связана с MetaQuotes; мы строим решения на опубликованных интерфейсах, как и любой другой интегратор. Наша собственная CRM использует тот же бэкенд, а ещё мы работаем с партнёрскими CRM и предлагаем ту, что лучше подходит к инфраструктуре брокера.
Пакетный опрос
Один цикл каждые 100 миллисекунд запрашивает у MT5 тики, позиции, ордера и показатели счетов пакетными запросами, поэтому нагрузка на сервер не растёт с числом подключённых пользователей.
Push для каждого клиента
Каждый подключённый клиент получает только те символы и счета, на которые подписан, а неизменившиеся блоки повторно не отправляются. Крупные фреймы сжимаются.
Кеш истории
История графиков кешируется на диске и подгружается по мере необходимости, поэтому трейдер, листающий годы свечей H1, не обращается каждый раз к серверу MT5.
Безопасность сделок
Повторный идентичный ордер, пока первый ещё исполняется, отбрасывается как дубликат, и ни сервер, ни приложения не отправляют сделку повторно после тайм-аута автоматически: двойное исполнение хуже, чем повтор, который трейдер выбирает сам.
Как сделки отправляются через Web API?
Сделка через Web API — это запрос, исполняемый на сервере от имени счёта клиента, за которым следует результат. Ваше приложение отправляет запрос, получает идентификатор и затем считывает итог: код возврата, например 10009 (выполнено) или 10008 (ордер размещён), либо отказ — например, неверные стопы, закрытый рынок или недостаточно средств.
Из этого следуют два практических вывода. Во-первых, собственные права клиента продолжают действовать: настройки группы, режимы торговли символами, уровни стопов и маржу контролирует сервер, а не ваш интерфейс, поэтому последнее слово за сервером. Во-вторых, тайм-аут не означает, что ордер не прошёл. Если ответ не пришёл, правильно сначала проверить позиции и историю и только потом что-либо делать. Наши интерфейсы сообщают трейдеру, что результат неизвестен, а не отправляют тот же ордер повторно.
Ещё одна деталь, на которой спотыкаются команды, — метки времени. MT5 записывает время в часовом поясе, настроенном на торговом сервере; всё, что вы показываете клиентам или сохраняете в CRM, нужно один раз и в одном месте переводить в настоящее UTC.
Насколько безопасна интеграция с MT5 Web API?
Сам Web API использует аутентификацию по схеме challenge-response и поддерживает зашифрованные сессии; основной оставшийся риск — в том, как интегратор обращается с менеджерской учётной записью. Менеджер Web API часто может переводить деньги и изменять счета, поэтому относитесь к его учётным данным как к ключам от банковского счёта. MetaQuotes указывает на своей странице для брокеров, что обмен данными между компонентами системы идёт по зашифрованному соединению; ваши собственные системы требуют такой же дисциплины.
- Заведите для интеграции отдельную менеджерскую учётную запись только с нужными правами и группами; никогда не используйте логин дилера.
- Ограничьте, откуда этот менеджер может подключаться, и храните учётные данные в хранилище секретов, а не в исходном коде.
- Никогда не открывайте Web API браузерам или приложениям. Клиенты подключаются к вашему бэкенду, который сверяет каждый запрос с собственным счётом клиента.
- Ограничивайте частоту попыток и блокируйте повторные неудачные входы с одного IP-адреса на своей стороне.
- Записывайте в журнал каждую балансовую операцию — кто её инициировал и почему — и ежедневно сверяйте эти журналы с CRM.
Есть ли у MT5 Web API ограничения на частоту запросов?
MetaQuotes не публикует лимиты запросов на своих открытых страницах, а мы не будем называть цифры, на которые не можем сослаться. На практике предел задают мощность вашего сервера и поведение вашей интеграции, и небрежная интеграция может замедлить торговый сервер для всех.
У нас хорошо работает следующее: держать пул аутентифицированных сессий, отделять торговые запросы от обычных, везде, где возможно, использовать пакетные команды и кешировать всё, что не меняется ежесекундно, — например, настройки символов и закрытую историю. На стороне клиента мы применяем общее ограничение сообщений на соединение, но не ограничиваем сделки: клиент может отправлять ордера один за другим, потому что в этом и состоит торговля.
Если вы проектируете собственную интеграцию, до запуска распишите её профиль нагрузки: как часто вы опрашиваете каждый тип данных, по скольким счетам и через сколько сессий. Эта одна страница отвечает на большинство вопросов, которые задаст администратор сервера.
Кто может получить доступ к MT5 Web API?
Доступ к Web API даёт тот, кто управляет сервером MT5, потому что для него нужна менеджерская учётная запись на этом сервере. Что это значит для вас, зависит от вашей схемы. Чтобы увидеть, какая конфигурация FXUP даёт нужный вам доступ, — с текущими ценами и условиями на том же экране, — сравните варианты в подборе решения.
| Схема | Кто управляет сервером | Что обычно можно получить |
|---|---|---|
| Собственная лицензия MT5 | Ваша компания | Полный доступ; вы сами создаёте менеджеров и настраиваете права |
| White label MT5 | Владелец лицензии | Менеджера, ограниченного вашими группами, если это допускает договор |
| Grey label MT5 | Провайдер | Зависит от провайдера; с FXUP — выделенный аккаунт Manager, который видит только ваших пользователей, и доступ к Manager API и SDK после оплаты |
Что должно быть в чек-листе интеграции с MT5 Web API?
Прежде чем писать код, определитесь с тем, что потом дорого менять. Этот список мы проходим с клиентами, которые подключают CRM для брокера, личный кабинет или торговый интерфейс; тот же чек-лист применяется и к другим индивидуальным интеграциям, которые мы делаем:
- Какую сборку сервера и какой вариант Web API (HTTPS, бинарный или оба) вы будете использовать.
- Отдельная менеджерская учётная запись, её права и группы, которые она видит.
- Какие события запускают создание счетов, изменения баланса и перевод между группами — и кто их одобряет.
- Частота опроса для каждого типа данных и пакетные команды, которые её покрывают.
- Работа с часовыми поясами и единая точка конвертации.
- Что происходит при тайм-ауте каждой операции, особенно сделок и изменений баланса.
- Мониторинг: оповещение при обрыве соединения с MT5, а не жалоба клиента.
Частые вопросы
Что такое MetaTrader 5 Web API?
MT5 Web API — это REST?
Можно ли построить собственный WebTrader на MT5 Web API?
Даёт ли Web API доступ к глубине рынка?
Чем Web API отличается от Manager API?
Может ли grey label-брокер получить доступ к Web API?
Есть ли у MT5 Web API лимиты запросов?
Безопасен ли MT5 Web API?
Сколько времени занимает интеграция с MT5 Web API?
Нужно ли разрешение MetaQuotes на использование Web API?
Не нашли ответа? Откройте подбор решения и посмотрите конфигурацию, цены и условия для вашего случая.
Источники
- MetaQuotes — MetaTrader 5 trading platform for brokers and banks (дата обращения: октябрь 2026 г.)
- MetaQuotes — MetaTrader 5 for brokers (metaquotes.net) (дата обращения: октябрь 2026 г.)
- MetaQuotes — Liquidity providers for MetaTrader 5 (дата обращения: октябрь 2026 г.)
- MQL5 Reference — Python integration for the MetaTrader 5 terminal (дата обращения: октябрь 2026 г.)
FXUP — независимая консалтинговая и технологическая компания, не связанная с MetaQuotes Ltd. MetaTrader 4 и MetaTrader 5 — товарные знаки MetaQuotes Ltd. Материал носит информационный характер и не является юридической, налоговой или инвестиционной консультацией; регуляторные требования зависят от юрисдикции и меняются со временем. Актуальные цены и условия FXUP показаны в подборе решения.