FinamPy

Библиотека-обертка, которая позволяет работать с Finam Trade API версии 2.13.0 брокера Финам из Python.

Что такое библиотека-обертка?

Компактная библиотека, содержащая только самый необходимый код для работы с API брокера из Python:

• Подключение к API. Отслеживание корректности подключения (обновление токенов, переподключение)
• Выполнение запросов и получение ответов от API
• Механизмы подписок, отмены подписок. Получение и разбор данных подписок
• Конвертация типов данных брокера в типы данных Python и обратно. Например, цена, лоты/штуки, дата/время
• Конвертация типов данных брокера в универсальные типы и обратно. Например, название тикера, режимы торгов, временнОй интервал
• Ведение лога отправляемых и получаемых данных от API

Назначение

• Создание автоматических торговых систем любой сложности
• Написание дополнений к системам Технического Анализа
• Тестирование торговых систем и автоматическая торговля в BackTrader через систему "Финансовая Лаборатория".

Особенности

• Из спецификации фьючерса невозможно выделить фьючерсы на сырье

Установка

Установите библиотеку через командную строку:

pip install git+https://github.com/cia76/FinamPy.git

Начало работы

Если нет торгового токена, то получите его здесь >>>

Установите токен в защищенное системное хранилище через командную строку. Вместо <Токен> вставьте полученный токен:

Linux:

python3 -c "from FinamPy import FinamPy; fp_provider = FinamPy('<Токен>')"

Windows:

python -c "from FinamPy import FinamPy; fp_provider = FinamPy('<Токен>')"

Если команда выполнилась без ошибок, то токен указан верно. Иначе, проверьте правильность ввода токена и выполните команду снова.

Далее можно вызывать библиотеку без токена:

from FinamPy import FinamPy

fp_provider = FinamPy()

В папке Examples находится хорошо документированный код примеров. С них лучше начать разбираться с библиотекой.

• Connect.py - Проверка работоспособности запросов/ответов и подписок
• Accounts.py - Получение позиций, свободных средств, активных заявок (лимитные и стоп) для каждого счета
• Ticker.py - Спецификация тикеров с лотом, шагом цены, кол-вом десятичных знаков
• Bars.py - Получение дневных свечек с начала истории
• Stream.py - Подписка на котировки, стакан, последние сделки
• Transactions.py - Получение последней цены. Выставление/исполнение рыночных заявок на покупку и продажу. Выставление/отмена лимитной заявки. Выставление/отмена стоп заявки.

❓ Вопросы по работоспособности Finam Trade API задавайте на официальном сайте в разделе Контакты - Чат на сайте здесь >>>

Авторство, право использования, развитие

Библиотека написана в рамках проекта Финансовая Лаборатория. Авторские и имущественные права на библиотеку принадлежат Чечету Игорю Александровичу.

Исправление ошибок, доработка и развитие библиотеки осуществляется автором и сообществом частных алготрейдеров проекта Финансовая Лаборатория.

Для личного использования библиотека предоставляется бесплатно в исходном коде, с подробными комментариями и видеоразборами. При распространении ссылка на автора и проект обязательны.

Система "Финансовая Лаборатория", в которую входит библиотека, зарегистрирована в Реестре российского Программного Обеспечения. Реестровая запись №31711 от 30.12.2025.

Для коммерческого внедрения / коммерческого использования необходимо заключить лицензионный договор с автором. Заявку с описанием реализуемого коммерческого проекта можно оставить в форме обратной связи на сайте Финансовая Лаборатория.

Что дальше

• Бесплатный курс Автоторговля по идеям, концепциям и процессам алгоритмической/автоматической торговли смотрите здесь >>>

• Бесплатный курс BackTrader: Быстрый старт ждет вас здесь >>>

• Подписывайтесь на канал "Финансовой Лаборатории здесь >>>", чтобы быть в курсе всех новинок алгоритмической и автоматической торговли.