Finam Trade API: как подключить робота к брокерскому счёту Финама

Данные на 02.10.2026. Finam Trade API даёт программный доступ к брокерскому счёту АО «ФИНАМ»: котировки, свечи, стакан, заявки и отчёты через REST, gRPC и WebSocket. Лимит, который Финам прописал в справочнике, — 200 запросов в минуту. Ниже я разбираю, какой счёт для этого нужен (спойлер: не форекс-дилерский), как дойти от токена до первого запроса на Python и когда вместо API разумнее взять MT5, DMA или автоследование.

Источники только первичные: лендинг экосистемы broker.finam.ru/landing/quantum, портал api.finam.ru и его справочник REST, репозиторий FinamWeb/finam-trade-api на GitHub, пакет finam-sdk версии 2.23.0 в PyPI и страница тарифов брокера. Всё, что Финам говорит о себе в маркетинговых блоках, я помечаю как слова Финама.

Что Финам собрал для алготрейдеров: карта продуктов

На лендинге «Экосистема для профессиональных трейдеров» (раньше его искали как Finam Quantum) Финам раскладывает восемь продуктов по цепочке «аналитика → исполнение → автоматизация». Цифры в таблице — с карточек самого Финама на 01.10.2026, я их не проверял на практике.

Если код вы пишете сами, ваша строка в этой таблице одна: Trade API. MT5, DMA и Comon выигрывают в других сценариях, они собраны в таблицу в разделе про альтернативы.

Брокерский счёт или форекс-дилер: где работает API

Путаница «Финам = Финам Форекс» дорого обходится именно алготрейдеру. Это два юрлица с разными договорами:

Итог простой: если вы пишете робота на Python для Мосбиржи или американских бирж, нужен брокерский счёт АО «ФИНАМ». Если хотите автоматизировать форекс у лицензированного дилера, ваш путь — советник в MT5, а не Trade API. Подробности по дилеру — в обзоре Финам Форекс, про советники — на странице про торговых роботов.

Что умеет Trade API и какие у него ограничения

По справочнику REST 2.0 и описанию gRPC-сервисов в SDK API закрывает весь цикл: счета, позиции, сделки и транзакции; инструменты, биржи, расписания и опционные доски; свечи, котировки, стакан и ленту сделок; выставление и отмену заявок, включая SL/TP; отчёты; корпоративные действия — дивиденды, сплиты, облигационные события; метрики использования API.

• Протоколы. REST для быстрого старта, gRPC для скорости и потоков, WebSocket для подписок. Финам на портале отдельно упоминает HTTP/2 и HTTP/3.
• Формат тикеров. Тикер@биржа: SBER@MISX, YDEX@MISX.
• Лимит. 200 запросов в минуту, при превышении сервер отвечает 429. В базе знаний Финама этому посвящён отдельный разбор «Что делать, когда API отвечает не так»: лимит и ответ 429 там идут первым пунктом.
• Авторизация. Секретный токен с портала обменивается на JWT (POST /v1/sessions), JWT передаётся в заголовке Authorization. SDK делает это сам и обновляет токен в фоне.
• Рынки. На api.finam.ru Финам перечисляет MOEX, NYSE и NASDAQ, а также 3 500+ акций Гонконга, Шанхая, Шэньчжэня и Токио, 3 000+ американских опционов и 50+ товарных фьючерсов CME. Что из этого доступно именно вам, зависит от счёта и статуса.

О скорости Финам пишет так: доступность сервиса 99%, обработка ордера 68,7 мс, обновление данных 43,4 мс, «скорость исполнения от 7 мс». Это метрики с главной страницы портала на 01.10.2026. Методику замера Финам не раскрывает, и в договор эти цифры не входят. Свои задержки я бы мерил сам — из того дата-центра, где будет жить робот.

Подключение за 4 шага: от токена до первого запроса

1. Счёт. Демо-счёт на портале API или брокерский счёт АО «ФИНАМ». Курс Финама «от первого запроса до надёжного клиента» требует одно из двух плюс Python 3.10+, Node.js 20+ или Go 1.24+.
2. Токен. В разделе «Токены» на api.finam.ru выпускаете секретный ключ. Держите его в переменной окружения, а не в коде и не в репозитории.
3. SDK. python -m pip install finam-sdk. Импорт: finam_trade_api. Пакет finam-trade-api в PyPI сторонний, Финам в README прямо предупреждает об этом.
4. Первый запрос. Без заявок: смотрим, какие счета видит токен, и забираем дневные свечи.

Пример ниже я собрал по README и исходникам finam-sdk 2.23.0 (PyPI, 02.10.2026). Он только читает данные:

import os
from datetime import datetime, timedelta, timezone

from google.protobuf.timestamp_pb2 import Timestamp
from google.type.interval_pb2 import Interval

from finam_trade_api import FinamClient
from finam_trade_api.auth_messages import TokenDetailsRequest
from finam_trade_api.market_data import BarsRequest, TimeFrame


def ts(dt):
    t = Timestamp()
    t.FromDatetime(dt)
    return t


end = datetime.now(timezone.utc)
start = end - timedelta(days=30)

with FinamClient(secret=os.environ["TRADE_API_SECRET"]) as client:
    token = client.get_token()
    details = client.auth.TokenDetails(TokenDetailsRequest(token=token))
    print("Счета:", list(details.account_ids))

    bars = client.market_data.Bars(BarsRequest(
        symbol="SBER@MISX",
        timeframe=TimeFrame.TIME_FRAME_D,
        interval=Interval(start_time=ts(start), end_time=ts(end)),
    ))
    for bar in bars.bars[-5:]:
        print(bar.timestamp.ToDatetime().date(), bar.close.value)

Как проверял: код компилируется, объекты запросов собираются, а запуск с выдуманным ключом доходит до сервера Финама и честно падает с AuthError: Api token could not be verified — значит, адрес, класс клиента и вызовы верные. С настоящим токеном скрипт выведет номера счетов и пять последних закрытий SBER. Глубина истории в одном запросе ограничена: по справочнику для минутных свечей — 7 дней, для таймфреймов от 5 минут до 8 часов — 30 дней, для дневных — 365 дней.

Открыть брокерский счёт в Финаме

Заявки: какие типы есть и как не выстрелить себе в ногу

В SDK заявка — объект Order: счёт, тикер, количество, сторона, тип и срок действия. Перечень типов в версии 2.23.0: рыночная, лимитная, стоп, стоп-лимит и многоногая (multi-leg). Сроки действия: до конца дня, до отмены, IOC, FOK, на открытие и закрытие и ещё несколько. Отдельный метод PlaceSLTPOrder ставит связку стоп-лосса и тейк-профита.

Официальный пример Финама place_limit_order.py полезен даже тем, кто не пишет на Python: он отказывается работать без переменной TRADE_API_EXECUTE=1, требует явно задать цену и проверяет, что токен видит ровно один счёт. Эти три предохранителя я бы скопировал в любой собственный код. Плюс уникальный client_order_id на каждую заявку — по нему вы найдёте заявку, если ответ сервера потерялся.

Логику MT5-ордеров, если сравниваете с дилерским терминалом, я разбирал в типах ордеров MT5.

Данные: что можно получить и где граница

Методы рыночных данных в SDK: Bars (свечи от 1 минуты до месяца), LastQuote, OrderBook, LatestTrades и их потоковые версии — подписки на котировки, стакан, сделки и свечи. Для фундаментального слоя есть сервис корпоративных действий: дивиденды, сплиты, купоны.

Граница проходит по истории. Год дневных свечей в одном запросе хватит для свинг-идеи, но для серьёзного бэктеста на минутках придётся собирать архив самому: регулярно выгружать свежие 7 дней и складывать в базу. Как строить исследовательскую часть на pandas и бэктестерах, я описал в обзоре Python-библиотек для квант-трейдинга.

Сколько стоит: тарифы брокера, а не API

Отдельной цены за Trade API на страницах Финама на 01.10.2026 нет; портал обещает «никаких скрытых платежей». Значит, ваша стоимость — это тариф брокерского счёта. Для робота с частыми сделками важны комиссия за оборот и абонплата:

«Долгосрочный портфель» с нулём за покупку для робота почти бесполезен: алгоритм продаёт так же часто, как покупает. Если вы участвуете в «Финам Бонус», учтите: обороты через Trade API идут там по отдельной шкале из Приложения № 4 к Условиям программы (ред. № 22 от 01.10.2026), подробнее на странице о бонусах Финам. Прежде чем выбирать тариф, прогоните свою частоту сделок через калькуляторы — издержки съедают тонкое преимущество быстрее, чем кажется.

Когда вместо API лучше MT5, DMA, Comon или ZipLime

Про DMA и прямой доступ к бирже у Финама был отдельный разбор: проп-трейдинг и DMA. Как ИИ-агенты пишут торговый код и где ошибаются, описано в гид по трейдингу с ИИ.

Риски: чек-лист перед запуском на реальном счёте

• Робот сначала неделю работает на демо, и только потом переходит на реальный счёт с минимальным объёмом.
• Есть ограничитель частоты запросов на своей стороне, с запасом до 200 в минуту, и обработка 429 с паузой.
• Поток после обрыва переподписывается сам, а состояние позиций сверяется через GetAccount, а не по памяти программы.
• У каждой заявки свой client_order_id; при таймауте робот сначала ищет заявку и только потом отправляет новую.
• Есть «рубильник»: дневной лимит убытка и число сделок, после которых робот только закрывает позиции.
• Секретный токен лежит в переменной окружения или менеджере секретов; у отдельного счёта для робота свой токен.
• Размер позиции и просадка посчитаны заранее: критерий Келли и калькулятор просадки помогут не поставить на одну сделку больше, чем выдержит счёт.
• Налоги: брокер выступает налоговым агентом, НДФЛ считается по итогам сделок, как и при ручной торговле.

Частые вопросы

Что дальше

Если вы выбираете между брокерами, а не только изучаете Финам, я сравнил API Финама, Т-Банка, Алора и БКС по протоколам, лимитам и тестовым контурам в материале «Алготрейдинг через API брокера». Если решили начинать с Финама — счёт открывается онлайн.

Открыть брокерский счёт в Финаме

Ссылка «Открыть брокерский счёт в Финаме» партнёрская.

✍️ Авторы статьи

Дмитрий Волков

Эксперт по техническому анализу

Автор раздела. Специализируется на психологии трейдинга и управлении рисками.

Елена Морозова

Эксперт по риск-менеджменту

Проверила информацию о рисках, проанализировала требования к управлению капиталом.

Александр Иванов

Главный редактор RichFX.ru

✅ Проверил статью на соответствие фактам
✅ Утвердил к публикации

→ О нашей команде