PostStopOrder — выставить стоп-заявку

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

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

408

Request Timeout

415

Unsupported Media Type

429

Too Many Requests

500

Internal Server Error

501

Not Implemented

503

Service Unavailable

504

Gateway Timeout

default

An unexpected error response

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

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

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