БКС Торговое API: ИИ-агент для котировок

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

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

Это подключение к потоку по протоколу WebSocket, а не плагин к терминалу. Перед установкой соединения клиент передаёт access-токен в заголовке Authorization с типом Bearer. Токен выпускается в веб-версии брокера, в настройках счёта.

Все сообщения идут в формате JSON: клиент отправляет подписку или отписку, сервер отвечает подтверждением, данными и ошибками. Пароль от кабинета коннектор не хранит — только токен, права которого заданы при выпуске.

Документация описывает не только котировки, но и соседние потоки: стакан, последнюю свечу, обезличенные сделки, портфель, маржинальные показатели и поддержание соединения через ping и pong.

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

### Платёжный календарь: сроки и пустые дни

Агент держит подписку на котировки инструментов из вашего плана и записывает значения в таблицу по времени. В календаре видно, какие даты расчётов закрыты, где значение не пришло из-за обрыва связи и какие дни остались без данных.

### Поддержка на языке клиента

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

### Просроченные счета: напоминание клиенту

Агент сверяет расчётные даты по сделкам с платежами клиента и находит те, где оплата не пришла. В черновике напоминания — сумма, дата расчёта и ссылка на выписку, а не общий текст.

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

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

Не выставляет заявки вместо вас. Не переживает обрыв связи сам — сообщает об ошибке и переподключается по вашим правилам. Не обходит лимиты на число подписок и запросов.

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

Что такое коннектор к торговому API? Подключение по WebSocket с access-токеном в заголовке. Пароль не передаётся, права ограничены при выпуске токена.

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