MetaTrader API — Центр поддержки
Воспользуйтесь поиском или выберите категорию слева. У каждого вопроса есть собственная ссылка, которой можно поделиться.
Воспользуйтесь поиском или выберите категорию слева. У каждого вопроса есть собственная ссылка, которой можно поделиться.
MetaTrader API — это размещённый REST API-сервис, позволяющий программно работать с торговыми счетами MT4 и MT5 без запущенного терминала MetaTrader на вашем компьютере.
Вы подключаете торговый счёт один раз и с этого момента можете исполнять сделки, получать данные счёта и читать рыночные цены из любого языка программирования с помощью стандартных HTTP-запросов.
Полные технические подробности — в официальной документации.
Начало работы занимает менее 30 минут:
/RegisterAccount.Пошаговое руководство — в документации по аутентификации.
С MetaTrader API работает любой язык, способный выполнять HTTP-запросы. Поскольку это обычный REST API по HTTPS, подойдут Python, JavaScript/Node.js, Go, C#, Java, Ruby, PHP и любой другой язык.
Он также работает с no-code инструментами: Postman, Make (Integromat), n8n, Zapier и всем, что умеет вызывать HTTP-эндпоинт.
Да. API поддерживает счёта MetaTrader 4 (MT4) и MetaTrader 5 (MT5). Вы можете подключать счёта обеих платформ одновременно — в зависимости от вашего тарифа.
Наборы доступных эндпоинтов у MT4 и MT5 немного различаются (например, у MT5 больше типов ордеров и опций истории). Полный справочник по эндпоинтам для каждой платформы — в документации.
Нет. В этом и состоит основное назначение сервиса. MetaTrader API работает полностью на стороне сервера. Вы один раз указываете учётные данные брокера, и API поддерживает соединение с брокером от вашего имени.
Вам не нужно устанавливать MetaTrader, держать терминал запущенным или писать Expert Advisors на MQL.
Аутентификация зависит от вашего тарифа:
Передавайте API-ключ в заголовке x-api-key, а UUID счёта — в параметре запроса id (или accountId):
curl -X GET "https://api.metatraderapi.net/AccountSummary?id=YOUR_ACCOUNT_UUID" \
-H "x-api-key: YOUR_API_KEY"API-ключ находится на вкладке Настройки в панели управления.
Пользователи тарифов Pro получают выделенный базовый URL, а также имя пользователя и пароль. Все запросы аутентифицируются через Basic Auth:
Authorization: Basic BASE64_ENCODED(USERNAME:PASSWORD)Ваш API-ключ находится на вкладке Настройки в панели управления на app.metatraderapi.net.
Рекомендуемая практика: храните ключ в переменной окружения (например MTAPI_KEY) и подставляйте его во время выполнения.
Подключить счёт можно двумя способами:
Войдите на app.metatraderapi.net, перейдите в раздел Счета и добавьте данные MT4/MT5 (номер счёта, пароль, имя сервера брокера). После подключения вы получите уникальный UUID для этого счёта.
Используйте эндпоинт /RegisterAccount. Точные параметры и формат ответа — в документации API.
BrokerName-Live или BrokerName-Demo.Используйте эндпоинт /CheckConnect. Он проверяет состояние соединения для указанного UUID счёта и автоматически попытается переподключиться, если соединение было потеряно.
Подробности о формате запроса и значениях ответа — в документации.
Используйте эндпоинт /DeleteAccount, чтобы отключить и удалить подключённый торговый счёт. Получить список всех подключённых счетов можно через эндпоинт /GetAccounts.
Параметры запроса — в документации API.
Зависит от тарифа:
API покрывает весь торговый цикл:
Полные сведения об эндпоинтах, параметрах и форматах ответов — в документации API.
Используйте эндпоинт /OrderSend. Укажите символ, тип операции (Buy, Sell, Buy Limit и т. д.), объём и при необходимости stop loss, take profit и комментарий.
Параметры /OrderSend у MT4 и MT5 немного различаются: MT5 поддерживает дополнительные поля, например expirationType и stopLimitPrice.
Используйте эндпоинты /OrderHistory или /OrderHistoryPagination. Доступны фильтры по диапазону дат, номеру тикета и порядку сортировки. У MT5 есть также /PendingOrderHistory и /HistoryDealsByPositionId для более детальных запросов.
Полный справочник параметров — в документации.
Да. API предоставляет WebSocket-соединение (события) для потоковой передачи в реальном времени. Это позволяет получать обновления сразу, вместо постоянного опроса REST-эндпоинтов.
Через WebSocket-поток можно получать текущие рыночные котировки, а для MT4 — асинхронные ответы на некоторые запросы, например историю цен.
Для текущих цен bid/ask можно использовать REST-эндпоинт /GetQuote (или /GetQuoteMany для нескольких символов), либо подписаться на котировки через WebSocket-поток для непрерывных обновлений в реальном времени.
Эндпоинт /GetQuote принимает параметр msNotOlder, который определяет, будет ли API ждать нового тика или вернёт последний известный.
Для исторических данных свечей OHLC используйте /QuoteHistory (MT4) или /PriceHistory (MT5) — варианты таймфреймов и параметры см. в документации.
Доступны три действующих тарифа (цены без НДС):
Также доступен годовой тариф с экономией до 25 % в зависимости от плана. Все цены подтверждены на странице тарифов.
Нет. Сейчас мы не предлагаем бесплатный пробный период. Если у вас есть вопросы о том, как оценить возможности API, напишите нам в Telegram или на [email protected].
Если пробный период когда-либо согласован индивидуально, Условия требуют направить отказ по электронной почте на [email protected] до его окончания: точкой отсчёта служит время покупки, и письмо необходимо даже в том случае, если платёж уже был обработан.
Да. Тариф Single Account включает одно подключение каждые 30 дней. Если нужно больше счетов, каждый дополнительный счёт тарифицируется по 10 € за счёт в месяц с автоматическим списанием в конце каждого расчётного периода.
Если счетов требуется много, переход на тариф Pro (неограниченно счетов*) выгоднее начиная примерно с 50 счетов.
Платежи обрабатываются через Stripe. Принимаются кредитные и дебетовые карты, криптовалюта и банковский перевод.
Оформляя заказ, вы также принимаете Соглашение об услугах Stripe.
Да, отменить можно в любой момент. Отмена вступает в силу в конце текущего 30-дневного расчётного периода — частичный возврат за неиспользованные дни не производится.
Чтобы отменить в течение пробного периода, отправьте письмо на [email protected] до его окончания. Если платёж уже списан, письмо об отмене всё равно необходимо, чтобы прекратить подписку.
Сервисом управляет Apex Vanguard Dynamics LLC — компания с ограниченной ответственностью (LLC), зарегистрированная в США, с юридическим адресом 30 N Gould St Ste R, Sheridan, WY 82801, США.
Электронная почта: [email protected] · Телефон: +1 (929) 333-6422
Полные правовые сведения — в выходных данных.
Условия и положения регулируются правом штата Вайоминг, США. Любые споры подлежат исключительной юрисдикции судов Вайоминга, и обе стороны соглашаются сначала попытаться урегулировать спор путём добросовестных переговоров.
Полные Условия и положения опубликованы на сайте.
Нет. Условия обслуживания прямо требуют сохранять конфиденциальность учётных данных и API-ключей и не передавать их третьим лицам без предварительного письменного согласия MetaTrader API.
Если вы создаёте продукт или сервис на основе API (например, для своих клиентов), реализуйте собственный слой аутентификации и держите ключ MetaTrader API только на сервере — никогда не раскрывайте его конечным пользователям.
Нет. Условия обслуживания запрещают сбор (scraping) и перепродажу данных сервиса без прямого письменного разрешения MetaTrader API. Подписки также не передаются другим лицам.
Если у вас есть конкретный бизнес-сценарий, напишите на [email protected].
Да. Соглашения о неразглашении доступны по запросу и должны быть согласованы обеими сторонами в письменной форме. Применяются стандартные условия NDA, если не согласовано иное.
Чтобы запросить NDA, напишите на [email protected].
MetaTrader API заявляет о применении ряда мер безопасности:
Подробнее о практиках безопасности — в Политике конфиденциальности.
MetaTrader API управляется компанией из США (см. Кто управляет MetaTrader API?) и заявляет о соблюдении применимого законодательства о защите данных, включая GDPR в тех случаях, когда он применяется к пользователям из ЕС/ЕЭЗ.
Какие персональные данные собираются: сведения аккаунта (имя, электронная почта, платёжные данные), данные использования (логи API, IP-адрес, браузер и операционная система), а также платёжная информация, обрабатываемая через Stripe.
Компания заявляет, что не продаёт и не передаёт персональные данные третьим лицам. Полные сведения — в Политике конфиденциальности.
Согласно Политике конфиденциальности, могут собираться следующие данные:
Данные могут обрабатываться в пределах ЕЭЗ или в других странах с адекватным уровнем защиты данных (с учётом 11 дата-центров по всему миру).
Полную информацию см. в Политике конфиденциальности.
Наиболее частые причины неудачного подключения:
ICMarkets-Live02). Найти его можно в MetaTrader в меню Файл → Открыть счёт.Проверить текущее состояние соединения можно эндпоинтом /CheckConnect. Если проблема сохраняется, напишите на [email protected].
Ошибки аутентификации обычно означают, что API-ключ отсутствует, указан неверно или передаётся в неправильном формате. Проверьте следующее:
x-api-key, а не Authorization: Bearer.api.metatraderapi.net.Правильные форматы для каждого типа тарифа — в документации по аутентификации.
MetaTrader API заявляет доступность 99,95 % в своих 11 дата-центрах по всему миру со средним временем отклика около 47 мс.
Обратите внимание: согласно Условиям обслуживания сервис предоставляется «как есть» и «по мере доступности» — бесперебойная или безошибочная работа договором формально не гарантируется. Для продакшн-систем всегда реализуйте на своей стороне логику повторных попыток и обработку ошибок.
Отклонение ордера приходит от торгового сервера брокера, а не от MetaTrader API. Частые причины:
EURUSD, а не EURUSDm).Проверьте ответ API с ошибкой — в нём будут поля message и code от брокера с причиной отклонения.