Подключение к 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 API | Refresh-токен, выпущенный в разделе Токены 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 настроек подключения. Ненужные токены удаляются в том же разделе значком удаления справа от токена.