БКС API: агент для торгового робота

БКС API — программный интерфейс брокера: через него торгуют и читают данные, не открывая терминал. Агент ведёт портфель и заявки по токену, который вы выпустили сами.

Агент — программа, которой ставят дело, а не вопрос. Она сама открывает ваши сервисы, добирает данные, сверяет их по правилам и возвращается с готовым результатом: файлом, заявкой, списком расхождений. Признаки три: работает в ваших сервисах, доводит дело до артефакта, работает без вас. Чат-бот отвечает текстом, агент приходит с результатом. Для трейдера это значит: робот получает доступ к счёту по токену, а не по логину с паролем.

Это подключение к торговому API по токену, а не плагин к терминалу. Токены выпускаются в веб-версии брокера: в профиле, под заголовком со счетами и тарифами, выбирается нужный счёт, дальше открываются настройки с пунктом выпуска токенов.

Токен, который вы получили в веб-версии, — это refresh-токен. Из него самостоятельно генерируется access-токен, которым подписываются запросы. Пароль от кабинета коннектор не хранит: он работает только с токеном, а права задаются при выпуске.

Документация описывает быстрый старт, работу биржи и технических процессов, HTTP и WebSocket интерфейсы, лимиты, портфель, рыночные данные, заявки, маржинальные показатели и поддержание соединения.

Отдельные разделы посвящены торговле вне биржи, ограничениям и MCP-серверу. Для старта нужен хотя бы один брокерский счёт, а в Postman можно собрать запросы по описанию.

### Проверка платёжного календаря: где не сходится

Агент читает портфель и заявки, сопоставляет даты расчётов с датами платежей в календаре. Если под платёж ещё не освободились деньги, он показывает строку целиком: дата, инструмент, сумма, свободный остаток.

### Остатки на счетах: сводка на утро

К утру агент собирает портфель и маржинальные показатели, считает свободные средства и доли позиций. Сводка приходит таблицей: что изменилось за ночь, где доля выше заданной, где уровень нагрузки близок к ограничению.

### Справки и сверка с бухгалтерией

Агент выгружает сделки за период и сверяет их с проводками бухгалтерии. Расхождения помечаются по типу: дата, инструмент, сумма, отсутствие пары. Итог — файл сверки и вопросы со ссылкой на сделку.

Решение о сделке, размер позиции и момент входа. Выпуск и отзыв токена, выбор прав доступа и двухфакторная защита тоже за человеком.

Откройте веб-версию брокера, зайдите в профиль, выберите счёт и пункт выпуска токенов. Нажмите выпуск, скопируйте refresh-токен и сохраните в надёжном месте. Затем сгенерируйте access-токен по инструкции и сделайте первый запрос.

Не торгует без вашего решения. Не обходит лимиты запросов. Не восстанавливает утерянный токен — его нужно выпустить заново в кабинете.

Что такое агент, если коротко? Программа, которая берёт дело и приносит результат: портфель, сверку, список заявок. Беседовать с ней не требуется.

Что такое коннектор к БКС API? Подключение по токену к торговому интерфейсу. Пароль не передаётся, права задаются при выпуске токена.

Чем refresh-токен отличается от access-токена? Первый вы получаете в кабинете и храните, второй генерируете из него для запросов. Обновление делает агент.