yatis 0.2.1

Yet Another T-bank Investment Sdk
Documentation
# Начало работы

## Что такое T-Invest API

T-Invest API — это [gRPC-интерфейс](/investAPI/grpc) для взаимодействия с торговой платформой 
[Т-Инвестиции](https://www.tbank.ru/invest/). Все данные, предоставляемые T-Invest API, бесплатные.

С помощью T-Invest API вы можете:

* Выставлять все виды торговых поручений на биржи — лимитные, рыночные, стоп-заявки.
* Получать рыночные данные, в том числе исторические, в виде стриминга и через Unary-запросы.
* Получать информацию по своему портфелю и его доходности.
* Проверять алгоритмы торговли на исторических данных. Механизм проверки теорий разрабатывается клиентом самостоятельно.

## С чего начать

Чтобы начать использовать T-Invest API, нужно: 

* Быть клиентом [Т-Инвестиций](https://www.tbank.ru/invest/).
* Ознакомиться с [идентификаторами торговых инструментов](/investAPI/faq_identification/).
* Выбрать подходящий [протокол взаимодействия](/investAPI/api_protocols/) и язык программирования. Для некоторых разработаны SDK для упрощения разработки: [Python](/investAPI/faq_python/), [Java](/investAPI/faq_java/), [С#](/investAPI/faq_csharp/), [Golang](/investAPI/faq_golang).
* Изучить раздел с [полезной информацией](/investAPI/algorithmic_trading/).
* Изучить [термины и параметры](https://russianinvestments.github.io/investAPI/glossary/), которые используются в методах T-Invest API.
* Посмотреть описание сервисов T-Invest API и ответы на часто задаваемые вопросы в разделе FAQ каждого сервиса.
* Получить [токен доступа](/investAPI/token).

[Подробнее о протоколе взаимодействия](/investAPI/grpc/)

| Если вы не работали с T-Invest API                                                                                                                                                                                                                                                                                                                                          | Если вы не работали с T-Invest API, но чувствуете себя уверенно в предметной области                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Если вы уже являетесь пользователем и у вас появился вопрос                                                                                                                                                                               |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1. Изучите раздел **Начало работы** — в нём собраны страницы с информацией, которая нужна для старта. Если встретите незнакомый термин, смотрите [глоссарий](https://russianinvestments.github.io/investAPI/glossary/) или воспользуйтесь поиском по документации.                                                                                                                | 1. Изучите раздел **Начало работы** — в нём собраны страницы с информацией, которая нужна для старта. Если встретите незнакомый термин, смотрите [глоссарий](https://russianinvestments.github.io/investAPI/glossary/) или воспользуйтесь поиском по документации.                                                                                                                                                                                                                                                                            | 1. Попробуйте воспользоваться поиском по документации. Если это не поможет найти ответ, определите категорию своего вопроса.                                                                                                              |
| 2. В разделе **Начало работы** обратите особое внимание на статьи:</br> • [Идентификаторы торговых инструментов](/investAPI/tech_indicators/)</br> • [Доступные протоколы взаимодействия](/investAPI/api_protocols/) </br> • [Настройка grpc-клиента](/investAPI/grpc/) — для тестирования методов</br> • [Таблица конкурсных работ](/investAPI/robot_contest/) — для вдохновения | 2. В разделе **Начало работы** обратите особое внимание на статьи:</br> • [Идентификаторы торговых инструментов](/investAPI/tech_indicators/)</br> • [Доступные протоколы взаимодействия](/investAPI/api_protocols/) </br> • [Настройка grpc-клиента](/investAPI/grpc/) — для тестирования методов</br> • [Таблица конкурсных работ](/investAPI/robot_contest/) — для вдохновения </br> • [Нестандартные типы данных](/investAPI/faq_custom_types/) </br> • [Торговые статусы инструментов и расписания торгов](/investAPI/faq_custom_types/) | 2. Ответ на вопрос по конкретному сервису можно найти в разделах **Описание** и **FAQ** каждого сервиса. Также вы можете ознакомиться с [общим FAQ](/investAPI/faq/).                                                                     |
| 3. Прочитайте ответы на популярные вопросы в [общем FAQ](/investAPI/faq/) и ознакомьтесь с разделом **Полезная информация**.                                                                                                                                                                                                                                                      | 3. Прочитайте ответы на популярные вопросы в [общем FAQ](/investAPI/faq/), ознакомьтесь с разделом **Полезная информация** и изучите описания сервисов.                                                                                                                                                                                                                                                                                                                                                                                       | 3. Если ваш вопрос связан с возникнувшей ошибкой, ознакомиться с её описанием и методом устранения можно на [странице с кодами ошибок](/investAPI/errors/).                                                                               |
| 4. Потренируйтесь в песочнице. [Подробнее про песочницу](/investAPI/head-sandbox/).                                                                                                                                                                                                                                                                                               | 4. Потренируйтесь в песочнице. [Подробнее про песочницу](/investAPI/head-sandbox/).                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 4. Если вы не нашли ответ на свой вопрос, его можно задать в issue на [официальном GitHub](https://github.com/RussianInvestments/investAPI/tree/main/src/docs/contracts) или [в Telegram канале](https://t.me/joinchat/VaW05CDzcSdsPULM). |
| 5. Ознакомьтесь с доступными SDK для упрощения разработки: [Python](/investAPI/faq_python/), [Java](/investAPI/faq_java/), [С#](/investAPI/faq_csharp/), [Golang](/investAPI/faq_golang).                                                                                                                                                                                         | 5. Ознакомьтесь с доступными SDK для упрощения разработки: [Python](/investAPI/faq_python/), [Java](/investAPI/faq_java/), [С#](/investAPI/faq_csharp/), [Golang](/investAPI/faq_golang).                                                                                                                                                                                                                                                                                                                                                     | 5. Если вы встретили неточность или хотите что-то дополнить, создайте pull request в нашем [официальном GitHub](https://github.com/RussianInvestments/investAPI/tree/main/src/docs/contracts).                                                                                                                                              |

## Адреса сервиса T-Invest API

- Prod-контур для вызова методов — **`invest-public-api.tinkoff.ru:443`**.

- Песочница — **`sandbox-invest-public-api.tinkoff.ru:443`**.

[Подробнее про различия работы контуров](/investAPI/url_difference/)

## Protobuf-файлы сервиса

[Скачать полный список прото-контрактов T-Invest API](https://github.com/RussianInvestments/investAPI/tree/main/src/docs/contracts)

## SDK для разработки с использованием Public API

Для упрощения разработки торгового робота разработан ряд официальных и неофициальных SDK для нескольких языков программирования.

* [Python](/investAPI/faq_python/)
* [Java](/investAPI/faq_java/)
* [C#](/investAPI/faq_csharp/)