https://github.com/dboyara/finamtradeapipy
Асинхронный REST-клиент для API Finam: https://finamweb.github.io/trade-api-docs/
https://github.com/dboyara/finamtradeapipy
aiohttp asyncio finam pydantic python-library python3 trading
Last synced: 4 months ago
JSON representation
Асинхронный REST-клиент для API Finam: https://finamweb.github.io/trade-api-docs/
- Host: GitHub
- URL: https://github.com/dboyara/finamtradeapipy
- Owner: DBoyara
- License: gpl-3.0
- Created: 2022-10-29T08:32:15.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-05-09T11:05:53.000Z (about 1 year ago)
- Last Synced: 2025-05-09T11:17:29.471Z (about 1 year ago)
- Topics: aiohttp, asyncio, finam, pydantic, python-library, python3, trading
- Language: Python
- Homepage: https://trade-api.finam.ru/swagger/index.html
- Size: 395 KB
- Stars: 33
- Watchers: 1
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FinamTradeApiPy
[](https://github.com/Dboyara/FinamTradeApiPy/actions/workflows/py-checks.yaml)
[](https://pypi.org/project/finam-trade-api/)
[](https://pre-commit.com/)
[](https://deepwiki.com/DBoyara/FinamTradeApiPy)
---
FinamTradeApiPy — это Python-библиотека для лёгкого взаимодействия с публичным торговым API Finam.
Библиотека только предоставляет удобную обертку для доступа к API и не несет ответственность за полученные и отправленные через нее данные.
Асинхронный REST-клиент для API [Finam](https://tradeapi.finam.ru/docs/about/).
Используется:
1. [aiohttp](https://github.com/aio-libs/aiohttp) для создания клиента;
2. [pydantic](https://github.com/pydantic/pydantic) для удобной работы с моделями данных;
3. [ruff](https://github.com/astral-sh/ruff) для линтинга;
4. [mypy](https://github.com/python/mypy) для статической типизации;
5. [pytest](https://github.com/pytest-dev/pytest) для тестирования;
6. [bandit](https://github.com/PyCQA/bandit) для статического анализа безопасности;
7. [pre-commit](https://github.com/pre-commit/pre-commit) для автоматизации линтинга и тестирования;
## Requirements
Python >= 3.11; < 3.14 - проверки в CI.
## Installation
```bash
pip install finam-trade-api
poetry add finam-trade-api
uv add finam-trade-api
```
## Usage/Examples
### Получение токена
```python
import os
from finam_trade_api import Client
from finam_trade_api import TokenManager
async def main():
# Получение токена из переменных окружения
token = os.getenv("TOKEN")
# Инициализация клиента с менеджером токенов
client = Client(TokenManager(token))
# Установка JWT-токена
await client.access_tokens.set_jwt_token()
# Получение деталей JWT-токена
return await client.access_tokens.get_jwt_token_details()
if __name__ == "__main__":
import asyncio
# Запуск асинхронного main
print(asyncio.run(main()))
```
### Информация об аккаунте
```python
import os
from pprint import pprint
from finam_trade_api import Client
from finam_trade_api import TokenManager
from finam_trade_api.account import GetTransactionsRequest, GetTradesRequest
token = os.getenv("TOKEN")
account_id = os.getenv("ACCOUNT_ID")
async def main():
client = Client(TokenManager(token))
await client.access_tokens.set_jwt_token()
# Получение информации об аккаунте
pprint(await client.account.get_account_info(account_id))
# Получение списка транзакций
pprint(await client.account.get_transactions(GetTransactionsRequest(
account_id=account_id,
start_time="2024-01-01T00:00:00Z",
end_time="2025-03-15T00:00:00Z",
limit=10,
)))
# Получение списка сделок
pprint(await client.account.get_trades(GetTradesRequest(
account_id=account_id,
start_time="2024-01-01T00:00:00Z",
end_time="2025-03-15T00:00:00Z",
)))
if __name__ == "__main__":
import asyncio
asyncio.run(main())
```
### Больше примеров в папке [examples](https://github.com/DBoyara/FinamTradeApiPy/tree/master/examples)
## Authors
- [@DBoyara](https://www.github.com/DBoyara)
## License
[GNU GPL v.3.0](https://choosealicense.com/licenses/gpl-3.0/)