T-Invest API: POST /tinkoff.public.invest.api.contract.v1.OrdersService/GetOrderState — Статус торгового поручения

Параметр	Где	Тип	Обяз.	Описание
accountId	body	string	да	Номер счёта
orderId	body	string	да	Идентификатор заявки
priceType	body	v1PriceType	нет	Тип цены
orderIdType	body	v1OrderIdType	нет	Тип идентификатора заявки

Базовые URL

• Боевой (REST): https://invest-public-api.tbank.ru/rest
• Тестовый (REST, песочница): https://sandbox-invest-public-api.tbank.ru/rest
• Боевой (gRPC): invest-public-api.tinkoff.ru:443
• Тестовый (gRPC, песочница): sandbox-invest-public-api.tinkoff.ru:443

Авторизация

Тип: Bearer-токен

Токен выпускается в настройках профиля Т-Инвестиций (https://www.tbank.ru/invest/settings/). Функция «Подтверждение сделок кодом» должна быть отключена. Токен показывается один раз, выпускать можно неограниченное количество. Виды токенов: Readonly (только чтение), Full-access (все методы), токен с доступом к конкретному счёту и Sandbox token (только для песочницы; для обычных методов вернёт ошибку). Токен передаётся в заголовке Authorization в формате Bearer t.QtEo8ahkNFX4RTpbqp0u4z4GDZq27HzUp6AotJASBx7_DVqmqZMHfM2Cy7JmUjS80boI9eVg, в gRPC — в metadata каждого запроса и стрима.

Срок жизни токена — три месяца с даты последнего использования. Неактуальный токен даёт ошибку:

"code": "40003"
"message": "authentication token is missing or invalid"

Нюансы

• Для PostOrder и PostStopOrder обязателен orderId — ключ идемпотентности в формате UID до 36 символов; у ReplaceOrder новый ключ передаётся в idempotencyKey.
• Суммы и цены передаются не числом, а объектом Quotation/MoneyValue: целая часть в units (строка) и дробная в nano.
• Песочница работает почти со всеми теми же методами, но в ней недоступны GetBrokerReport, GetDividendsForeignIssuer и сервис стоп-заявок; для неё нужен отдельный Sandbox token.
• Сделки на сумму больше 30 000 000 рублей требуют подтверждения и через API недоступны.
• Лимиты считаются суммарно по всем счетам пользователя; с одного адреса рекомендуется не больше 50 запросов в секунду по всем счетам и токенам.
• Разработчикам публичного ПО нужно зарегистрировать название приложения через invest-public-api@tbank.ru.

Сценарии с этим методом

• Выставить заявку и проверить исполнение

---

Если этого недостаточно — официальная документация: https://developer.tbank.ru/invest/intro/intro/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/t-invest.md