T-Invest API: POST /tinkoff.public.invest.api.contract.v1.StopOrdersService/PostStopOrder — Выставить стоп-заявку

Параметр	Где	Тип	Обяз.	Описание
quantity	body	string	да	Количество лотов
price	body	v1Quotation	нет	Цена
stopPrice	body	v1Quotation	нет	Стоп-цена
direction	body	v1StopOrderDirection	да	Направление
accountId	body	string	да	Номер счёта
expirationType	body	v1StopOrderExpirationType	да	Тип срока действия
stopOrderType	body	v1StopOrderType	да	Тип стоп-заявки
expireDate	body	string	нет	Окончание действия по UTC; обязательно для GoodTillDate
instrumentId	body	string	да	figi или instrument_uid
orderId	body	string	да	Ключ идемпотентности в формате UID, до 36 символов
confirmMarginTrade	body	boolean	нет	Согласие на непокрытую позицию

Базовые 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