Асинхронный метод выставления заявки.

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

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

401

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

403

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

404

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

408

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

415

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

429

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

500

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

501

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

503

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

504

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

default

An unexpected error response.

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

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

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