FinamPy

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #claude-code #cli #windows #codex #developer-tools #dsh

★ 71 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FinamPy
Библиотека-обертка, которая позволяет работать с [Finam Trade API](https://tradeapi.finam.ru) версии [2.13.0](https://tradeapi.finam.ru/docs/versions/) брокера [Финам](https://www.finam.ru/) из Python.

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

Чтобы досконально разобраться в библиотеках-обёртках, смотрите бесплатный курс **Библиотеки-обёртки для автоторговли** [здесь >>>](https://finlab.vip/wpm-category/xpy/)

### Назначение
 - Создание автоматических торговых систем любой сложности
 - Написание дополнений к системам Технического Анализа
 - Тестирование торговых систем и автоматическая торговля в [BackTrader](https://www.backtrader.com/) через [систему "Финансовая Лаборатория"](https://github.com/cia76/FinLabPy).

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

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

### Начало работы
Если нет торгового токена, то получите его [здесь >>>](https://tradeapi.finam.ru/tokens/)

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

**Linux:**
```bash
python3 -c "from FinamPy import FinamPy; fp_provider = FinamPy('<Токен>')"
 ```
**Windows:**
```cmd
python -c "from FinamPy import FinamPy; fp_provider = FinamPy('<Токен>')"
```

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

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

```python
from FinamPy import FinamPy

fp_provider = FinamPy()
```

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

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

❓ Вопросы по работоспособности Finam Trade API задавайте на [официальном сайте в разделе Контакты - Чат на сайте здесь >>>](https://tradeapi.finam.ru)

### Авторство, право использования, развитие
Библиотека написана в рамках проекта [Финансовая Лаборатория](https://finlab.vip/). Авторские и имущественные права на библиотеку принадлежат Чечету Игорю Александровичу.

Исправление ошибок, доработка и развитие библиотеки осуществляется автором и сообществом частных алготрейдеров проекта [Финансовая Лаборатория](https://finlab.vip/).

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

Система "Финансовая Лаборатория", в которую входит библиотека, зарегистрирована в Реестре российского Программного Обеспечения. [Реестровая запись №31711 от 30.12.2025](https://reestr.digital.gov.ru/reestr/5702051/).

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

### Что дальше
- Бесплатный курс **Автоторговля** по идеям, концепциям и процессам алгоритмической/автоматической торговли [смотрите здесь >>>](https://finlab.vip/wpm-category/autotrading2021/)

- Бесплатный курс **BackTrader: Быстрый старт** [ждет вас здесь >>>](https://finlab.vip/wpm-category/btquickstart/)

- [Подписывайтесь на канал "Финансовой Лаборатории" здесь >>>](https://finlab.vip/channel), чтобы быть в курсе всех новинок алгоритмической и автоматической торговли.

FinamPy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README