Подключение XPBee (форекс)

XPBee — форекс/CFD-брокер на платформе cTrader. Терминал подключается к нему через cTrader Open API: вы регистрируете собственное приложение в панели cTrader, а затем входите через OAuth в браузере — пароль от счёта в терминал вводить не нужно. Инструменты — валютные пары, металлы, индексы и другие CFD, которые доступны у брокера. В терминале тикеры XPBee имеют суффикс _xp: EURUSD_xp, XAUUSD_xp, US500_xp.

Что понадобится

Счёт у брокера XPBee — регистрация на xpbee.io.
cTrader ID — учётная запись cTrader, к которой привязан счёт.
Приложение в панели cTrader, от которого нужны Client ID и Client Secret — как его создать, описано ниже.

Регистрация приложения cTrader

Откройте панель приложений openapi.ctrader.com/apps и войдите по cTrader ID. Та же ссылка есть в форме подключения — кнопка «Открыть панель приложений cTrader».
Нажмите «Add new app» и заполните форму. В названии приложения не используйте названия брендов (cTrader, IC Markets и т. п.) — модерация отклонит заявку. Пример названия: XPBeePro_100.
В поле Redirect URLs добавьте ровно http://localhost:7766/ — с завершающим слэшем. cTrader сравнивает адрес посимвольно; в форме терминала это значение показано в поле Redirect URI с кнопкой Copy.
В блоке «Allow this application to» отметьте «Access your accounts and trade» — доступ к своим счетам и торговля. Пункт «Any account» не нужен.
Нажмите «Save». Приложение получит статус «Submitted»; после проверки Spotware — «Active». Ответ приходит по e-mail, обычно в течение трёх рабочих дней.
Скопируйте Client ID и Client Secret приложения.

Подключение в Space Terminal

Подсказка над формой и кнопка открытия панели cTrader показываются на языке интерфейса, а подписи полей (Name, Client ID, Client Secret, Access Token, Refresh Token, Trading Account) и кнопки Connect via OAuth, Load accounts, Copy и Connect — всегда на английском.

В верхней панели терминала нажмите иконку шестерёнки (Настройки) и откройте вкладку Подключения.
Нажмите + Добавить подключение. Откроется список бирж, разбитый на секции CEX, DEX, FOREX и MOEX — в секции FOREX нажмите плитку Xpbee.
Над формой — подсказка с шагами, кнопка «Открыть панель приложений cTrader» и поле Redirect URI со значением http://localhost:7766/ (только для чтения, рядом кнопка Copy) — оно нужно на шаге регистрации приложения.
Name — имя подключения; по умолчанию Xpbee, можно задать любое.
Client ID и Client Secret — вставьте значения из панели cTrader. Поле Client Secret скрыто; значок глаза показывает его содержимое.
Нажмите Connect via OAuth — кнопка становится активной, когда заполнены оба поля. В браузере откроется страница cTrader; подтвердите доступ. На авторизацию даётся 180 секунд; пока она идёт, кнопка показывает Authorizing in browser.... Терминал сам получит токены — поля Access Token и Refresh Token заполнятся автоматически — и загрузит список счетов. Повторный вход — кнопка Re-authorize.
Trading Account — выберите торговый счёт. В списке счета показаны в виде «номер · брокер · live/demo · валюта · баланс»; если счёт один, он выбирается автоматически.
При необходимости выберите прокси в поле Proxy — оно работает так же, как для криптобирж.
Нажмите Connect.

Если у вас уже есть токены (например, полученные вручную в Playground cTrader), их можно вставить в поля Access Token и Refresh Token — тогда появится кнопка Load accounts, которая загружает список счетов без входа через браузер. Учтите, что refresh-токен cTrader одноразовый: терминал использует текущий токен доступа и обновляет его только при истечении.

Обновление токенов

Токен доступа терминал обновляет сам и сохраняет новые значения. Если токены всё же истекли, терминал сообщит об этом: откройте подключение на редактирование и нажмите Connect via OAuth заново.

Что поддерживается

Стакан и график — таймфреймы 1м, 5м, 15м, 30м, 1ч, 4ч, 1д и 1н; история догружается при прокрутке влево.
Торговля из стакана — лимитные и рыночные заявки; позиции, заявки, баланс и ваши сделки в реальном времени.
Объёмы — в лотах, шаг обычно 0,01 лота. Если объём недопустим, терминал покажет минимальный и максимальный объём и шаг для инструмента.
Валюта счёта — USD.
Значок рынка в панелях — X (подсказка Forex).
cTrader работает в режиме хеджирования и может держать несколько позиций по одному инструменту. Терминал сводит их в одну: встречные позиции закрываются по очереди, остаток открывается новой позицией.

Ограничения

Ленты сделок и кластеров по сделкам нет — cTrader не отдаёт публичную ленту сделок форекса.
История сделок с брокера не подгружается: журнал сделок и финрез наполняются только сделками, совершёнными во время работы терминала.
Плечо настраивается на стороне брокера — из терминала его не изменить.
Разворот позиции одной кнопкой не поддерживается.
Автоматические функции терминала недоступны; скринер по форексу не работает.
Облачная торговля с подключением XPBee не работает.

Безопасность

Client Secret, Access Token и Refresh Token — это доступ к торговле от вашего имени. Не публикуйте их нигде: ни в скриншотах, ни на форумах, ни в чатах поддержки.
Терминал хранит их локально, в файле настроек на вашем компьютере, в открытом виде; никуда они не отправляются. Защищайте доступ к компьютеру и не передавайте папку настроек другим.
При подозрении на утечку удалите приложение в панели cTrader или пересоздайте его секрет, затем заново пройдите вход через Connect via OAuth в подключении терминала.