Как протестировать API БКС без кода: первые запросы через Postman
Автоматическая торговля начинается не с написания робота, а с простого вопроса: «А как вообще выглядит общение с биржей через программу?» Хорошая новость — чтобы это понять, не обязательно сразу писать код. Можно отправить первые запросы к API руками, в удобном визуальном интерфейсе, и сразу увидеть, как все работает.
В этой статье разберем, как сделать это через Postman — бесплатный инструмент, в котором можно обращаться к API БКС без единой строки кода. Получим токен, запросим цену Сбербанка и даже выставим реальную заявку — все за несколько кликов.
Коротко: что такое торговый API и зачем он нужен
API БКС — это интерфейс, через который ваши программы общаются с торговой системой напрямую. Вместо того чтобы вручную кликать в торговом терминале, вы отправляете команды по сети: «дай текущую цену», «выставь заявку», «покажи мои позиции». Биржа отвечает — программа реагирует.
Это фундамент алгоритмической торговли: робот может следить за рынком и выставлять заявки круглосуточно, без участия человека, без эмоций и задержек. Но прежде чем доверять роботу реальные сделки, полезно своими руками понять, как устроены эти запросы. Здесь и пригодится Postman.
Что такое Postman и чем он удобен
Postman — это популярный бесплатный инструмент для работы с API. Он позволяет отправлять запросы к серверу в наглядном визуальном интерфейсе: вы видите поля для адреса, параметров и заголовков, нажимаете «Отправить» и сразу получаете ответ сервера на экране.
Главное преимущество для новичка: не нужно ничего программировать. Не нужно настраивать сервер, устанавливать Python, разбираться с синтаксисом. Вы работаете с API напрямую и сразу видите результат — так логика запросов сразу понятна, еще до переноса их в код.
Готовая коллекция запросов
Чтобы вам не пришлось вручную создавать каждый запрос, мы подготовили готовую коллекцию всех методов API БКС. Перейдите по ссылке — и сразу сможете выбирать нужные запросы и отправлять их, подставив свой токен.
Выпускаем токен для торговли
Чтобы Postman мог обращаться к API от вашего имени, нужен ключ доступа — refresh-токен. Он выпускается один раз в личном кабинете БКС:
- Войдите в веб-версию личного кабинета БКС Мир инвестиций.
- Откройте раздел Профиль и выберите счет, к которому подключаете API.
- В разделе о счете найдите пункт Токены API.
- Выберите тип «Для торговли» — он позволяет выставлять заявки.
- Нажмите «Выпустить токен» и сразу скопируйте его.
Токен показывается только один раз. Скопируйте и сохраните его в надежном месте. Это ключ от вашего торгового счета — не передавайте его третьим лицам.
Авторизация: получаем доступ к API
Зачем это нужно
Refresh-токен из кабинета — долгоживущий ключ, но напрямую в запросах он не используется. Сначала его нужно обменять на access-токен — короткий ключ на 24 часа, которым подписываются все остальные запросы. Это делается ради безопасности: если access-токен перехватят, через сутки он станет бесполезным.
В Postman этот обмен — первый запрос в коллекции. Откройте запрос «Авторизация», вставьте свой refresh-токен в нужное поле и нажмите «Отправить».
В ответе сервер вернет access_token — длинную строку. Именно она открывает доступ ко всем остальным запросам.
Удобство готовой коллекции
В нашей коллекции access-токен из ответа сохраняется автоматически и сам подставляется в следующие запросы. Вам не нужно копировать его вручную — достаточно один раз выполнить авторизацию, и остальные запросы уже будут работать.
Узнаем текущую цену Сбера
Зачем это нужно
Прежде чем выставлять заявку, логично узнать, по какой цене бумага торгуется сейчас. Запрос котировок возвращает полный набор данных по инструменту: цену последней сделки, лучшие цены покупки и продажи, максимум и минимум за день.
Откройте в коллекции запрос «Котировки». В теле запроса уже указан инструмент — тикер SBER и класс TQBR (это код, под которым акции Сбербанка торгуются на Мосбирже). Нажмите «Отправить».
В ответе найдите поле last — это цена последней сделки, актуальный рыночный ориентир. Запомните это значение: оно понадобится, чтобы назначить цену заявки на следующем шаге.
Выставляем заявку на покупку
Что произойдет
Теперь самое интересное — отправим на биржу настоящую заявку на покупку 1 лота Сбербанка. Мы используем лимитную заявку: это заявка с конкретной ценой, «куплю не дороже, чем за столько-то». Чтобы заявка не исполнилась мгновенно, поставим цену чуть ниже текущей — например, на 1% меньше значения last из прошлого шага. Так у вас будет время увидеть заявку в терминале и при желании отменить.
Это реальная заявка — прочитайте перед отправкой
Postman отправит настоящую биржевую заявку, которая может быть исполнена. Перед нажатием «Отправить» убедитесь:
• Количество (orderQuantity) равно 1.
• Цена (price) на 1% ниже текущей — мгновенного исполнения не будет.
• На счете достаточно средств для покупки 1 лота SBER.
• После отправки проверьте заявку в терминале БКС и при необходимости отмените.
Откройте запрос «Создать заявку». В теле запроса заполните параметры:
clientOrderId — уникальный ID заявки (генерируется автоматически)
side — 1 (покупка)
orderType — 2 (лимитная заявка)
orderQuantity — 1 (количество лотов)
ticker — SBER
classCode — TQBR
price — цена на 1% ниже last из Шага 2
Нажмите «Отправить». Если все заполнено верно, сервер примет заявку и вернет ее идентификатор и статус.
Проверяем, что заявка встала в стакан
Зачем это нужно
Успешный ответ на создание заявки означает лишь, что API принял команду. Сама заявка еще может быть отклонена биржей — например, из-за ограничений по цене или нехватки средств. Поэтому стоит проверить ее статус отдельным запросом.
Откройте запрос «Статус заявки» и отправьте его. В ответе придет текущее состояние:
- NEW — заявка принята и ждет исполнения в стакане. Это то, что нам нужно.
- FILLED — заявка исполнена, сделка прошла.
- CANCELLED — заявка отменена.
- REJECTED — заявка отклонена. Проверьте цену и остаток средств.
Получили NEW? Откройте торговый терминал БКС — заявка должна быть в списке активных. Поздравляем: вы только что совершили полный цикл работы с API, не написав ни строки кода.
Итоговый чеклист
- Выпустили токен «Для торговли» в личном кабинете БКС.
- Открыли готовую коллекцию запросов в Postman.
- Выполнили авторизацию и получили access-токен.
- Запросили цену Сбера — нашли поле last.
- Выставили заявку на покупку 1 лота.
- Проверили статус — получили NEW — и нашли заявку в терминале.
Что дальше?
Вы разобрались, как устроены запросы к API БКС, и проверили их вживую. Следующий логичный шаг — перенести эти запросы в код и собрать настоящего торгового робота, который работает сам. Как это сделать на Python, мы подробно разобрали в статье «Первый скрипт за 15 минут».
Все методы API, их параметры и примеры ответов описаны в официальной документации: trade-api.bcs.ru.
🔥 Читайте и обсуждайте новости в телеграм-канале БКС Экспресс.
