- T-Invest
- Начало работы
- Где взять токен аутентификации?
- Документация
- Быстрый старт
- У меня есть вопрос
- Примеры
- Streaming
- Синхронный REST API Client
- Асинхронный REST API Client
- Sandbox
- Environments
- Contributing
- Установка зависимостей
- Запуск тестов
- Tinkoff Invest
- Начало работы
- Возможности
- Как пользоваться
- Получить список аккаунтов
- Переопределить target
- Contribution
- Saved searches
- Use saved searches to filter your results more quickly
- License
- Tinkoff/invest-python
- Name already in use
- Sign In Required
- Launching GitHub Desktop
- Launching GitHub Desktop
- Launching Xcode
- Launching Visual Studio Code
- Latest commit
- Git stats
- Files
- README.md
T-Invest
Данный проект представляет собой инструментарий на языке Python для работы с OpenAPI Тинькофф Инвестиции, который можно использовать для создания торговых роботов.
Клиент предоставляет синхронный и асинхронный API для взаимодействия с Тинькофф Инвестиции.
Есть возможность делать запросы через командную строку, подробнее тут.
pip install tinvest[cli] # Пример использования tinvest openapi --token TOKEN portfolio
pip install tinvest[uvloop] pip install tinvest[orjson]
Начало работы
Где взять токен аутентификации?
В разделе инвестиций вашего личного кабинета tinkoff. Далее:
- Перейдите в настройки
- Проверьте, что функция «Подтверждение сделок кодом» отключена
- Выпустите токен для торговли на бирже и режима «песочницы» (sandbox)
- Скопируйте токен и сохраните, токен отображается только один раз, просмотреть его позже не получится, тем не менее вы можете выпускать неограниченное количество токенов
Документация
Быстрый старт
Для непосредственного взаимодействия с OpenAPI нужно создать клиента. Клиенты разделены на streaming и rest.
Примеры использования SDK находятся ниже.
У меня есть вопрос
Основной репозиторий с документацией — в нем вы можете задать вопрос в Issues и получать информацию о релизах в Releases. Если возникают вопросы по данному SDK, нашёлся баг или есть предложения по улучшению, то можно задать его в Issues.
Примеры
Для работы с данным пакетом вам нужно изучить OpenAPI Тинькофф Инвестиции
Streaming
Предоставляет асинхронный интерфейс.
При сетевых сбоях будет произведена попытка переподключения.
import asyncio import tinvest as ti async def main(): async with ti.Streaming('TOKEN') as streaming: await streaming.candle.subscribe('BBG0013HGFT4', ti.CandleResolution.min1) await streaming.orderbook.subscribe('BBG0013HGFT4', 5) await streaming.instrument_info.subscribe('BBG0013HGFT4') async for event in streaming: print(event) asyncio.run(main())
Синхронный REST API Client
Для выполнения синхронных http запросов используется библиотека requests . С описанием клиентов можно ознакомиться по этой ссылке.
import tinvest TOKEN = "" client = tinvest.SyncClient(TOKEN) response = client.get_portfolio() # tinvest.PortfolioResponse print(response.payload)
# Handle error . client = tinvest.SyncClient(TOKEN) try: response = client.get_operations("", "") except tinvest.BadRequestError as e: print(e.response) # tinvest.Error
Асинхронный REST API Client
Для выполнения асинхронных http запросов используется библиотека aiohttp . Клиенты имеют такой же интерфейс как в синхронной реализации, за исключением того, что функции возвращают объект корутина.
import asyncio import tinvest TOKEN = "" async def main(): client = tinvest.AsyncClient(TOKEN) response = await client.get_portfolio() # tinvest.PortfolioResponse print(response.payload) await client.close() asyncio.run(main())
Sandbox
Sandbox позволяет вам попробовать свои торговые стратегии, при этом не тратя реальные средства. Протокол взаимодействия полностью совпадает с Production окружением.
client = tinvest.AsyncClient(SANDBOX_TOKEN, use_sandbox=True) # client = tinvest.SyncClient(SANDBOX_TOKEN, use_sandbox=True)
Environments
name | required | default |
---|---|---|
TINVEST_TOKEN | optional | » |
TINVEST_SANDBOX_TOKEN | optional | » |
TINVEST_USE_ORJSON | optional | True |
TINVEST_USE_UVLOOP | optional | True |
Contributing
Предлагайте свои пулл реквесты, проект с открытым исходным кодом.
Установка зависимостей
python install poetry make install
Запуск тестов
Tinkoff Invest
Данный репозиторий предоставляет клиент для взаимодействия с торговой платформой Тинькофф Инвестиции на языке Python.
Начало работы
Возможности
- ☑ Синхронный и асинхронный GRPC клиент
- ☑ Возможность отменить все заявки
- ☑ Выгрузка истории котировок «от» и «до»
- ☑ Кеширование данных
- ☑ Торговая стратегия
Как пользоваться
Получить список аккаунтов
from tinkoff.invest import Client TOKEN = 'token' with Client(TOKEN) as client: print(client.users.get_accounts())
Переопределить target
В Tinkoff Invest API есть два контура — «боевой», предназначенный для исполнения ордеров на бирже и «песочница», предназначенный для тестирования API и торговых гипотез, заявки с которого не выводятся на биржу, а исполняются в эмуляторе.
Переключение между контурами реализовано через target, INVEST_GRPC_API — «боевой», INVEST_GRPC_API_SANDBOX — «песочница»
from tinkoff.invest import Client from tinkoff.invest.constants import INVEST_GRPC_API TOKEN = 'token' with Client(TOKEN, target=INVEST_GRPC_API) as client: print(client.users.get_accounts())
:warning: Не публикуйте токены в общедоступные репозитории
Остальные примеры доступны в examples.
Contribution
Для тех, кто хочет внести свои изменения в проект.
Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
Tinkoff Invest Python gRPC client
License
Tinkoff/invest-python
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
Git stats
Files
Failed to load latest commit information.
README.md
Данный репозиторий предоставляет клиент для взаимодействия с торговой платформой Тинькофф Инвестиции на языке Python.
$ pip install tinkoff-investments
- ☑ Синхронный и асинхронный GRPC клиент
- ☑ Возможность отменить все заявки
- ☑ Выгрузка истории котировок «от» и «до»
- ☑ Кеширование данных
- ☑ Торговая стратегия
Получить список аккаунтов
from tinkoff.invest import Client TOKEN = 'token' with Client(TOKEN) as client: print(client.users.get_accounts())
В Tinkoff Invest API есть два контура — «боевой», предназначенный для исполнения ордеров на бирже и «песочница», предназначенный для тестирования API и торговых гипотез, заявки с которого не выводятся на биржу, а исполняются в эмуляторе.
Переключение между контурами реализовано через target, INVEST_GRPC_API — «боевой», INVEST_GRPC_API_SANDBOX — «песочница»
from tinkoff.invest import Client from tinkoff.invest.constants import INVEST_GRPC_API TOKEN = 'token' with Client(TOKEN, target=INVEST_GRPC_API) as client: print(client.users.get_accounts())
⚠️ Не публикуйте токены в общедоступные репозитории
Остальные примеры доступны в examples.
Для тех, кто хочет внести свои изменения в проект.