PostOrderAsync — выставить заявку асинхронным методом

POST

https://invest-public-api.tinkoff.ru/rest/tinkoff.public.invest.api.contract.v1.OrdersService/PostOrderAsync

Особенности работы приведены в статье.

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

instrumentId

String

Идентификатор инструмента, принимает значения Figi или Instrument_uid.

Required

quantity

String<int64>

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

price

Object (v1Quotation)

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

units

String<int64>

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

nano

Integer<int32>

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

Required

direction

String (v1OrderDirection)

Requirements: [ORDER_DIRECTION_UNSPECIFIED, ORDER_DIRECTION_BUY, ORDER_DIRECTION_SELL]

Default: ORDER_DIRECTION_UNSPECIFIED

Направление операции.

ORDER_DIRECTION_UNSPECIFIED: Значение не указано
ORDER_DIRECTION_BUY: Покупка
ORDER_DIRECTION_SELL: Продажа

Required

accountId

String

Номер счета.

Required

orderType

String (v1OrderType)

Requirements: [ORDER_TYPE_UNSPECIFIED, ORDER_TYPE_LIMIT, ORDER_TYPE_MARKET, ORDER_TYPE_BESTPRICE]

Default: ORDER_TYPE_UNSPECIFIED

Тип заявки.

ORDER_TYPE_UNSPECIFIED: Значение не указано
ORDER_TYPE_LIMIT: Лимитная
ORDER_TYPE_MARKET: Рыночная
ORDER_TYPE_BESTPRICE: Лучшая цена

Required

orderId

String

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

timeInForce

String (Алгоритм исполнения заявки)

Requirements: [TIME_IN_FORCE_UNSPECIFIED, TIME_IN_FORCE_DAY, TIME_IN_FORCE_FILL_AND_KILL, TIME_IN_FORCE_FILL_OR_KILL]

Default: TIME_IN_FORCE_UNSPECIFIED

TIME_IN_FORCE_UNSPECIFIED: Значение не определено см. TIME_IN_FORCE_DAY
TIME_IN_FORCE_DAY: Заявка действует до конца торгового дня. Значение по умолчанию
TIME_IN_FORCE_FILL_AND_KILL: Если в момент выставления возможно исполнение заявки(в т.ч. частичное), заявка будет исполнена или отменена сразу после выставления
TIME_IN_FORCE_FILL_OR_KILL: Если в момент выставления возможно полное исполнение заявки, заявка будет исполнена или отменена сразу после выставления, недоступно для срочного рынка и торговли по выходным

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: Цена в валюте расчетов по инструменту.

Ответ

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

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

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

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