Выставить стоп-заявку.

POST

https://invest-public-api.tinkoff.ru/rest//tinkoff.public.invest.api.contract.v1.StopOrdersService/PostStopOrder

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

quantity

String<int64>

Количество лотов.

price

Object (v1Quotation)

Котировка — денежная сумма без указания валюты.

units

String<int64>

Целая часть суммы, может быть отрицательным числом.

nano

Integer<int32>

Дробная часть суммы, может быть отрицательным числом.

stopPrice

Object (v1Quotation)

Котировка — денежная сумма без указания валюты.

units

String<int64>

Целая часть суммы, может быть отрицательным числом.

nano

Integer<int32>

Дробная часть суммы, может быть отрицательным числом.

Required

direction

String (v1StopOrderDirection)

Requirements: [STOP_ORDER_DIRECTION_UNSPECIFIED, STOP_ORDER_DIRECTION_BUY, STOP_ORDER_DIRECTION_SELL]

Default: STOP_ORDER_DIRECTION_UNSPECIFIED

Направление сделки стоп-заявки.

STOP_ORDER_DIRECTION_UNSPECIFIED: Значение не указано.
STOP_ORDER_DIRECTION_BUY: Покупка.
STOP_ORDER_DIRECTION_SELL: Продажа.

Required

accountId

String

Номер счета.

Required

expirationType

String (v1StopOrderExpirationType)

Requirements: [STOP_ORDER_EXPIRATION_TYPE_UNSPECIFIED, STOP_ORDER_EXPIRATION_TYPE_GOOD_TILL_CANCEL, STOP_ORDER_EXPIRATION_TYPE_GOOD_TILL_DATE]

Default: STOP_ORDER_EXPIRATION_TYPE_UNSPECIFIED

Тип экспирации стоп-заявке.

STOP_ORDER_EXPIRATION_TYPE_UNSPECIFIED: Значение не указано.
STOP_ORDER_EXPIRATION_TYPE_GOOD_TILL_CANCEL: Действительно до отмены.
STOP_ORDER_EXPIRATION_TYPE_GOOD_TILL_DATE: Действительно до даты снятия.

Required

stopOrderType

String (v1StopOrderType)

Requirements: [STOP_ORDER_TYPE_UNSPECIFIED, STOP_ORDER_TYPE_TAKE_PROFIT, STOP_ORDER_TYPE_STOP_LOSS, STOP_ORDER_TYPE_STOP_LIMIT]

Default: STOP_ORDER_TYPE_UNSPECIFIED

Тип стоп-заявки.

STOP_ORDER_TYPE_UNSPECIFIED: Значение не указано.
STOP_ORDER_TYPE_TAKE_PROFIT: Take-profit-заявка.
STOP_ORDER_TYPE_STOP_LOSS: Stop-loss-заявка.
STOP_ORDER_TYPE_STOP_LIMIT: Stop-limit-заявка.

expireDate

String<date-time>

Дата и время окончания действия стоп-заявки по UTC. Для ExpirationType = GoodTillDate заполнение обязательно, для GoodTillCancel игнорируется.

Required

instrumentId

String

Идентификатор инструмента. Принимает значение figi или instrument_uid.

exchangeOrderType

String (v1ExchangeOrderType)

Requirements: [EXCHANGE_ORDER_TYPE_UNSPECIFIED, EXCHANGE_ORDER_TYPE_MARKET, EXCHANGE_ORDER_TYPE_LIMIT]

Default: EXCHANGE_ORDER_TYPE_UNSPECIFIED

Тип выставляемой заявки.

EXCHANGE_ORDER_TYPE_UNSPECIFIED: Значение не указано.
EXCHANGE_ORDER_TYPE_MARKET: Заявка по рыночной цене.
EXCHANGE_ORDER_TYPE_LIMIT: Лимитная заявка.

takeProfitType

String (v1TakeProfitType)

Requirements: [TAKE_PROFIT_TYPE_UNSPECIFIED, TAKE_PROFIT_TYPE_REGULAR, TAKE_PROFIT_TYPE_TRAILING]

Default: TAKE_PROFIT_TYPE_UNSPECIFIED

Тип TakeProfit-заявки.

TAKE_PROFIT_TYPE_UNSPECIFIED: Значение не указано.
TAKE_PROFIT_TYPE_REGULAR: Обычная заявка, значение по умолчанию.
TAKE_PROFIT_TYPE_TRAILING: Трейлинг-стоп.

trailingData

Object (v1PostStopOrderRequestTrailingData)

indent

Object (v1Quotation)

Котировка — денежная сумма без указания валюты.

units

String<int64>

Целая часть суммы, может быть отрицательным числом.

nano

Integer<int32>

Дробная часть суммы, может быть отрицательным числом.

indentType

String (v1TrailingValueType)

Requirements: [TRAILING_VALUE_UNSPECIFIED, TRAILING_VALUE_ABSOLUTE, TRAILING_VALUE_RELATIVE]

Default: TRAILING_VALUE_UNSPECIFIED

Тип параметров значений трейлинг-стопа.

TRAILING_VALUE_UNSPECIFIED: Значение не указано.
TRAILING_VALUE_ABSOLUTE: Абсолютное значение в единицах цены.
TRAILING_VALUE_RELATIVE: Относительное значение в процентах.

spread

Object (v1Quotation)

Котировка — денежная сумма без указания валюты.

units

String<int64>

Целая часть суммы, может быть отрицательным числом.

nano

Integer<int32>

Дробная часть суммы, может быть отрицательным числом.

spreadType

String (v1TrailingValueType)

Requirements: [TRAILING_VALUE_UNSPECIFIED, TRAILING_VALUE_ABSOLUTE, TRAILING_VALUE_RELATIVE]

Default: TRAILING_VALUE_UNSPECIFIED

Тип параметров значений трейлинг-стопа.

TRAILING_VALUE_UNSPECIFIED: Значение не указано.
TRAILING_VALUE_ABSOLUTE: Абсолютное значение в единицах цены.
TRAILING_VALUE_RELATIVE: Относительное значение в процентах.

priceType

String (v1PriceType)

Requirements: [PRICE_TYPE_UNSPECIFIED, PRICE_TYPE_POINT, PRICE_TYPE_CURRENCY]

Default: PRICE_TYPE_UNSPECIFIED

Тип цены.

PRICE_TYPE_UNSPECIFIED: Значение не определено.
PRICE_TYPE_POINT: Цена в пунктах (только для фьючерсов и облигаций).
PRICE_TYPE_CURRENCY: Цена в валюте расчетов по инструменту.

Required

orderId

String

Идентификатор запроса выставления поручения для целей идемпотентности в формате UID. Максимальная длина — 36 символов.

Ответ

200

A successful response.

400

Запрос составлен неверно, проверьте параметры вызова и синтаксические ошибки.

401

Токен доступа не найден или не активен.

403

Недостаточно прав для выполнения запроса, проверьте соответствие токена и передаваемого в запросе счета.

404

Неверный URL запроса или переданный параметр не определен.

408

Время передачи запроса клиентом истекло. Проверьте работу приложения.

415

Неверный тип данных, проверьте формат передаваемого сообщения.

429

Превышен лимит запросов в минуту.

500

Внутренняя ошибка сервера, попробуйте повторить запрос позже

501

Метод не реализован, проверьте путь вызова в запросе.

503

Сервис временно недоступен, попробуйте повторить запрос позже.

504

Превышен интервал ожидания ответа от сервера, попробуйте повторить запрос позже.

default

An unexpected error response.

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции