Популярные кейсы и их решение

Чтобы понимать алгоритм выполнения основных задач, ознакомьтесь с доступными SDK в разделе Языки программирования.

Также рекомендуем прочитать статью о создании торгового робота — в ней описаны популярные сценарии для пользователей Tinkoff Invest API.

Создать заявку на покупку или продажу инструмента

Когда стратегия даёт команду продавать или покупать, нужно создать заявку:

1. Проверьте, существует ли позиция по бумаге через метод FindInstrument.
2. Проверьте статус торгового инструмента через метод GetTradingStatus.
3. Получите последние цены на инструмент через метод GetLastPrice.
4. Получите параметр min_price_increment для расчёта цены, которую можно выставить, через метод GetInstrumentBy.
5. Проверьте свой счёт в аккаунте.
6. Выставите заявку через метод PostOrder и сохраните полученный параметр order_id.
7. Получите список активных заявок через метод GetOrders и по параметру order_id проверьте, есть ли заявка в списке активных.

Информацию об исполненной заявке можно получить через метод GetOrderState по параметру order_id.

Получить информации об аккаунте

Чтобы получить информацию об аккаунте:

1. Вызовите метод GetAccounts для получения списка счетов, их статусов и типов.

2. Вызовите метод GetInfo. С помощью него можно:

   • определить наличие у пользователя статуса квалифицированного инвестора и премиального клиента;
   • получить список типов инструментов, к которым пользователь имеет доступ по итогам тестирования.

   Это помогает определить ограничения в торговле.

3. Получите доступные лимиты через метод GetInfo.

4. Для торговли на срочном рынке периодически обновляйте информацию о маржинальных показателях счёта через метод GetMarginAttributes по параметру accountId.

Найти базовый актив фьючерса

Чтобы найти базовый актив фьючерса:

1. Вызовите один из методов: GetFutureBy или GetFutures.
2. Сохраните значение параметра basic_asset_position_uid — это уникальный идентификатор позиции основного инструмента.

Примечание Для поиска базового актива фьючерса можно также использовать метод FindInstrument — в query передайте значение параметра basic_asset_position_uid, который возвращается в методах GetFutureBy и GetFutures.

Ошибки с сертификатом

При работе с API могут возникнуть ошибки, связанные с сертификатом:

• failed to connect to all addresses;
• handshake failed;
• certificate verify failed;

Часто эта проблема возникает из-за недействительного сертификата, который используется в приложении.

Выпустите новый сертификат — например, через команду openssl s_client -connect invest-public-api.tinkoff.ru:443, и импортируйте его.

Загрузить сертификат вручную

Сертификат можно загрузить вручную. Пример шагов для Windows и Google Chrome:

1. Зайдите на сайт Tinkoff.
2. В адресной строке нажмите и выберите Безопасное подключение.
3. Нажмите Показать сертификат.
4. В открывшемся окне выберите вкладку Подробнее.
5. Нажмите Экспорт и сохраните сертификат на компьютер.
6. Откройте папку с сохранённым файлом, нажмите по нему правой кнопкой мыши и выберите Установить сертификат.
7. Установите сертификат через мастера импорта сертификатов, выбирая ответы по умолчанию.