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

Параметр	Где	Тип	Обяз.	Описание
quantity	body	string	да	Количество лотов
price	body	v1Quotation	нет	Цена (для лимитной заявки)
price.units	body	string	нет	Целая часть суммы
price.nano	body	integer	нет	Дробная часть суммы
direction	body	v1OrderDirection	да	ORDER_DIRECTION_BUY или ORDER_DIRECTION_SELL
accountId	body	string	да	Номер счёта
orderType	body	v1OrderType	да	ORDER_TYPE_LIMIT, ORDER_TYPE_MARKET, ORDER_TYPE_BESTPRICE
orderId	body	string	да	Идентификатор запроса для идемпотентности в формате UID, до 36 символов
instrumentId	body	string	нет	Figi или Instrument_uid
timeInForce	body	v1TimeInForceType	нет	Срок действия заявки
priceType	body	v1PriceType	нет	Тип цены
confirmMarginTrade	body	boolean	нет	Согласие на заявку, которая может привести к непокрытой позиции; по умолчанию false

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