FinamPy

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

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

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

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

Назначение

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

Установка

Установите библиотеку через pip в командной строке: pip install git+https://github.com/cia76/FinamPy.git

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

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

Вызовите библиотеку из Python с новым токеном: fp_provider = FinamPy('<Токен>'). Токен сохранится в бинарном виде в файле config.pkl. Далее можно вызывать библиотеку без токена: fp_provider = FinamPy()

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

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

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

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

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

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

Вопросы по работоспособности Finam Trade API обсуждаются в официальном Telegram-канале Финама здесь >>>

Что дальше

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

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

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