Начало работы
Что такое Tinkoff Invest API
Tinkoff Invest API — это gRPC-интерфейс для взаимодействия с торговой платформой Тинькофф Инвестиции. Все данные, предоставляемые Tinkoff Invest API, бесплатные.
С помощью Tinkoff Invest API вы можете:
- Выставлять все виды торговых поручений на биржи — лимитные, рыночные, стоп-заявки.
- Получать рыночные данные, в том числе исторические, в виде стриминга и через Unary-запросы.
- Получать информацию по своему портфелю и его доходности.
- Проверять алгоритмы торговли на исторических данных. Механизм проверки теорий разрабатывается клиентом самостоятельно.
Чтобы начать использовать Tinkoff Invest API, нужно:
- Быть клиентом Тинькофф Инвестиций.
- Ознакомиться с идентификаторами торговых инструментов.
- Выбрать подходящий протокол взаимодействия и язык программирования. Для некоторых разработаны SDK для упрощения разработки: Python, Java, С#, Golang).
- Изучить раздел с полезной информацией.
- Изучить термины и параметры, которые используются в методах Tinkoff Invest API.
- Посмотреть описание сервисов Tinkoff Invest API и ответы на часто задаваемые вопросы в разделе FAQ каждого сервиса.
- Получить токен доступа.
Подробнее о протоколе взаимодействия
С чего начать
| Если вы не работали с Tinkoff Invest API | Если вы не работали с Tinkoff Invest API, но чувствуете себя уверенно в предметной области | Если вы уже являетесь пользователем и у вас появился вопрос |
|---|---|---|
| 1. Изучите раздел Начало работы — в нём собраны страницы с информацией, которая нужна для старта. Если встретите незнакомый термин, смотрите глоссарий или воспользуйтесь поиском по документации. | 1. Изучите раздел Начало работы — в нём собраны страницы с информацией, которая нужна для старта. Если встретите незнакомый термин, смотрите глоссарий или воспользуйтесь поиском по документации. | 1. Попробуйте воспользоваться поиском по документации. Если это не поможет найти ответ, определите категорию своего вопроса. |
| 2. В разделе Начало работы обратите особое внимание на статьи: • Идентификаторы торговых инструментов • Доступные протоколы взаимодействия • Настройка grpc-клиента — для тестирования методов • Таблица конкурсных работ — для вдохновения | 2. В разделе Начало работы обратите особое внимание на статьи: • Идентификаторы торговых инструментов • Доступные протоколы взаимодействия • Настройка grpc-клиента — для тестирования методов • Таблица конкурсных работ — для вдохновения • Нестандартные типы данных • Торговые статусы инструментов и расписания торгов | 2. Ответ на вопрос по конкретному сервису можно найти в разделах Описание и FAQ каждого сервиса. Также вы можете ознакомиться с общим FAQ. |
| 3. Прочитайте ответы на популярные вопросы в общем FAQ и ознакомьтесь с разделом Полезная информация. | 3. Прочитайте ответы на популярные вопросы в общем FAQ, ознакомьтесь с разделом Полезная информация и изучите описания сервисов. | 3. Если ваш вопрос связан с возникнувшей ошибкой, ознакомиться с её описанием и методом устранения можно на странице с кодами ошибок. |
| 4. Потренируйтесь в песочнице. Подробнее про песочницу. | 4. Потренируйтесь в песочнице. Подробнее про песочницу. | 4. Если вы не нашли ответ на свой вопрос, его можно задать в issue на официальном GitHub или в Telegram канале. |
| 5. Ознакомьтесь с доступными SDK для упрощения разработки: Python, Java, С#, Golang. | 5. Ознакомьтесь с доступными SDK для упрощения разработки: Python, Java, С#, Golang. | 5. Если вы встретили неточность или хотите что-то дополнить, создайте pull request в нашем официальном GitHub. |
Адреса сервиса Tinkoff Invest API
-
Prod-контур для вызова методов —
invest-public-api.tinkoff.ru:443. -
Песочница —
sandbox-invest-public-api.tinkoff.ru:443.
Подробнее про различия работы контуров
Protobuf-файлы сервиса
Скачать полный список прото-контрактов Tinkoff Invest API
SDK для разработки с использованием Public API
Для упрощения разработки торгового робота разработан ряд официальных и неофициальных SDK для нескольких языков программирования.