Skip to Content

Подключение к BCS API

Чтобы подключить БКС через BCS API, выпустите refresh-токен в веб-версии БКС Мир инвестиций и укажите его в настройках подключения JetScalp.

Каждый токен БКС привязан только к одному брокерскому счёту (trade-api.bcs.ru ). Выпускайте токен для того счёта, на котором собираетесь торговать из JetScalp.

1.Выпустите токен BCS API

Откройте веб-версию БКС Мир инвестиций  и авторизуйтесь.

В разделе Профиль под заголовком Счета и тарифы щёлкните по брокерскому счёту, к которому нужен доступ через API. В настройках счёта выберите Токены API, нажмите Выпустить токен и следуйте инструкциям.

BCS API выпускает токены с разными правами доступа:

  • Для торговли и чтения данных — выставление рыночных и лимитных заявок на Мосбирже, котировки и данные портфеля.
  • Только для чтения — котировки и данные портфеля, но без выставления заявок.

Чтобы торговать из JetScalp, выпустите токен для торговли и чтения данных.

2.Скопируйте токен

После выпуска БКС покажет токен. Скопируйте его и сохраните в надёжном месте.

Токен — это длинная строка из трёх частей, разделённых точками:

eyJhbGciOi...xxxxxxxx.eyJleHAiOi...xxxxxxxx.xxxxxxxxxxxxxxxx

Вставляйте токен целиком, без пробелов и переносов строк. Добавлять Bearer не нужно.

Токен — секретный ключ доступа к вашему брокерскому счёту: не передавайте его другим людям и не публикуйте.

3.Добавьте подключение в JetScalp

Откройте Настройки Настройки → Подключения, нажмите Добавить подключение под списком подключений и щёлкните по плитке BCS API. Подключение появится в списке, а справа — его настройки.

Заполните настройки подключения:

ПолеЗначение
НазваниеНазвание подключения в списке. По умолчанию — название биржи или брокера, его можно изменить.
Токен BCS Trade APIRefresh-токен, выпущенный в разделе Токены API БКС Мир инвестиций.
ПроксиПрокси из списка или Нет. Подробнее — Настройка прокси.
Получать котировкиПолучать рыночные данные (стаканы, ленту сделок) через это подключение. Включено по умолчанию; выключите, если котировки приходят из другого подключения.

Токен хранится в настройках JetScalp в зашифрованном виде.

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

4.Включите подключение и проверьте

Включите подключение переключателем справа в его строке в списке. Под названием подключения появится состояние: сначала подключение…, затем подключено. Если подключиться не удалось, там будет текст ошибки — полностью он виден в подсказке и в заголовке настроек подключения. Подробнее о состояниях — Подключения.

Проверьте:

  • BCS API подключён.
  • Доступен счёт BCS и его баланс.
  • Отображаются открытые позиции и активные заявки.
  • Заявки выставляются и отменяются.

Если включено Получать котировки, JetScalp начнёт получать рыночные данные по акциям, фьючерсам и валюте Мосбиржи.

Если подключение не работает

Проверьте, что:

  • токен скопирован полностью;
  • токен выпущен для торговли и чтения данных, а не только для чтения;
  • токен не удалён в разделе Токены API и не истёк;
  • токен выпущен для того брокерского счёта, на котором вы торгуете;
  • интернет-соединение работает;
  • настройки прокси верны, если вы его выбрали.

Сообщение Не задан токен BCS API. означает, что поле Токен BCS Trade API пустое.

Если появляется сообщение, начинающееся с Произошла ошибка при получении токена BCS API, и подключение отключается — БКС отклонил токен: он введён с ошибкой, удалён или истёк. Выпустите новый токен и укажите его в настройках подключения.

Срок действия токена

Refresh-токен BCS API действует 90 суток.

На его основе JetScalp сам получает короткоживущий токен доступа (access-токен, срок жизни 24 часа) и заранее обновляет его, кратковременно переподключаясь к БКС. Это плановая операция: уведомление о ней не показывается, позиции и заявки сохраняются.

Сам refresh-токен JetScalp не продлевает. Когда он истечёт, подключение перестанет устанавливаться — выпустите новый токен в разделе Профиль → Счета и тарифы → (брокерский счёт) → Токены API и замените его в поле Токен BCS Trade API настроек подключения. Ненужные токены удаляются в том же разделе значком удаления справа от токена.

Обновлено