{"id":17477729,"url":"https://github.com/dboyara/finamtradeapipy","last_synced_at":"2026-02-06T14:30:26.536Z","repository":{"id":62997707,"uuid":"559157541","full_name":"DBoyara/FinamTradeApiPy","owner":"DBoyara","description":"Асинхронный REST-клиент для API Finam: https://finamweb.github.io/trade-api-docs/","archived":false,"fork":false,"pushed_at":"2025-05-09T11:05:53.000Z","size":404,"stargazers_count":33,"open_issues_count":0,"forks_count":9,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-09T11:17:29.471Z","etag":null,"topics":["aiohttp","asyncio","finam","pydantic","python-library","python3","trading"],"latest_commit_sha":null,"homepage":"https://trade-api.finam.ru/swagger/index.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DBoyara.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-29T08:32:15.000Z","updated_at":"2025-05-09T11:04:52.000Z","dependencies_parsed_at":"2024-10-31T20:17:54.257Z","dependency_job_id":null,"html_url":"https://github.com/DBoyara/FinamTradeApiPy","commit_stats":{"total_commits":49,"total_committers":3,"mean_commits":"16.333333333333332","dds":"0.22448979591836737","last_synced_commit":"f4451d467ff42c451adc269d407a5d872d97b267"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DBoyara%2FFinamTradeApiPy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DBoyara%2FFinamTradeApiPy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DBoyara%2FFinamTradeApiPy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DBoyara%2FFinamTradeApiPy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DBoyara","download_url":"https://codeload.github.com/DBoyara/FinamTradeApiPy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253757482,"owners_count":21959409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aiohttp","asyncio","finam","pydantic","python-library","python3","trading"],"created_at":"2024-10-18T20:09:15.240Z","updated_at":"2026-01-06T13:19:54.993Z","avatar_url":"https://github.com/DBoyara.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# FinamTradeApiPy\n\n[![Build](https://github.com/Dboyara/FinamTradeApiPy/actions/workflows/py-checks.yaml/badge.svg)](https://github.com/Dboyara/FinamTradeApiPy/actions/workflows/py-checks.yaml)\n[![PyPI version](https://badge.fury.io/py/finam-trade-api.svg)](https://pypi.org/project/finam-trade-api/)\n![Python](https://img.shields.io/pypi/pyversions/finam-trade-api)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://pre-commit.com/)\n![License](https://img.shields.io/github/license/Dboyara/FinamTradeApiPy)\n![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-informational?logo=python\u0026logoColor=white)\n![Type Checked: mypy](https://img.shields.io/badge/type%20checked-mypy-blue.svg)\n![Formatted with: black](https://img.shields.io/badge/format-black-black)\n![Security Check](https://img.shields.io/badge/security-passed-brightgreen)\n![GitHub stars](https://img.shields.io/github/stars/Dboyara/FinamTradeApiPy?style=social)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/DBoyara/FinamTradeApiPy)\n\n---\n\nFinamTradeApiPy — это Python-библиотека для лёгкого взаимодействия с публичным торговым API Finam.\nБиблиотека только предоставляет удобную обертку для доступа к API и не несет ответственность за полученные и отправленные через нее данные.\n\nАсинхронный REST-клиент для API [Finam](https://tradeapi.finam.ru/docs/about/).\n\nИспользуется:\n1. [aiohttp](https://github.com/aio-libs/aiohttp) для создания клиента;\n2. [pydantic](https://github.com/pydantic/pydantic) для удобной работы с моделями данных;\n3. [ruff](https://github.com/astral-sh/ruff) для линтинга;\n4. [mypy](https://github.com/python/mypy) для статической типизации;\n5. [pytest](https://github.com/pytest-dev/pytest) для тестирования;\n6. [bandit](https://github.com/PyCQA/bandit) для статического анализа безопасности;\n7. [pre-commit](https://github.com/pre-commit/pre-commit) для автоматизации линтинга и тестирования;\n\n## Requirements\nPython \u003e= 3.11; \u003c 3.14 - проверки в CI.\n\n## Installation\n\n```bash\npip install finam-trade-api\npoetry add finam-trade-api\nuv add finam-trade-api\n```\n\n## Usage/Examples\n\n### Получение токена\n\n```python\nimport os\n\nfrom finam_trade_api import Client\nfrom finam_trade_api import TokenManager\n\n\nasync def main():\n    # Получение токена из переменных окружения\n    token = os.getenv(\"TOKEN\")\n    \n    # Инициализация клиента с менеджером токенов\n    client = Client(TokenManager(token))\n    \n    # Установка JWT-токена\n    await client.access_tokens.set_jwt_token()\n    \n    # Получение деталей JWT-токена\n    return await client.access_tokens.get_jwt_token_details()\n\n\nif __name__ == \"__main__\":\n    import asyncio\n\n    # Запуск асинхронного main\n    print(asyncio.run(main()))\n```\n\n### Информация об аккаунте\n\n```python\nimport os\nfrom pprint import pprint\n\nfrom finam_trade_api import Client\nfrom finam_trade_api import TokenManager\nfrom finam_trade_api.account import GetTransactionsRequest, GetTradesRequest\n\ntoken = os.getenv(\"TOKEN\")\naccount_id = os.getenv(\"ACCOUNT_ID\")\n\n\nasync def main():\n    client = Client(TokenManager(token))\n    await client.access_tokens.set_jwt_token()\n\n    # Получение информации об аккаунте\n    pprint(await client.account.get_account_info(account_id))\n\n    # Получение списка транзакций\n    pprint(await client.account.get_transactions(GetTransactionsRequest(\n        account_id=account_id,\n        start_time=\"2024-01-01T00:00:00Z\",\n        end_time=\"2025-03-15T00:00:00Z\",\n        limit=10,\n    )))\n\n    # Получение списка сделок\n    pprint(await client.account.get_trades(GetTradesRequest(\n        account_id=account_id,\n        start_time=\"2024-01-01T00:00:00Z\",\n        end_time=\"2025-03-15T00:00:00Z\",\n    )))\n\n\nif __name__ == \"__main__\":\n    import asyncio\n    asyncio.run(main())\n```\n\n### Больше примеров в папке [examples](https://github.com/DBoyara/FinamTradeApiPy/tree/master/examples)\n\n## Authors\n\n- [@DBoyara](https://www.github.com/DBoyara)\n\n\n## License\n\n[GNU GPL v.3.0](https://choosealicense.com/licenses/gpl-3.0/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdboyara%2Ffinamtradeapipy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdboyara%2Ffinamtradeapipy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdboyara%2Ffinamtradeapipy/lists"}