GetOrderState — получить статус торгового поручения

/tinkoff.public.invest.api.contract.v1.OrdersService/GetOrderState

POST

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

GetOrderState — получить статус торгового поручения

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

accountId

String

Номер счета.

Required

orderId

String

Идентификатор заявки.

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

orderIdType

String (Тип идентификатора заявки)

Requirements: [ORDER_ID_TYPE_UNSPECIFIED, ORDER_ID_TYPE_EXCHANGE, ORDER_ID_TYPE_REQUEST]

Default: ORDER_ID_TYPE_UNSPECIFIED

• ORDER_ID_TYPE_UNSPECIFIED: Тип идентификатора не указан.
• ORDER_ID_TYPE_EXCHANGE: Биржевой идентификатор
• ORDER_ID_TYPE_REQUEST: Ключ идемпотентности, переданный клиентом

Ответ

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

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

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

Запрос

Токен

​

Окружение

Работа в песочнице

{ "accountId": "string", "orderId": "string", "priceType": "PRICE_TYPE_UNSPECIFIED", "orderIdType": "ORDER_ID_TYPE_UNSPECIFIED" }

Пример запроса

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

{

"accountId":

"string",

"orderId":

"string",

"priceType":

"PRICE_TYPE_UNSPECIFIED",

"orderIdType":

"ORDER_ID_TYPE_UNSPECIFIED"

}

Пример ответа

200

400

401

403

404

408

415

429

500

501

503

504

default

Content type

application/json

{

"orderId":

"orderId",

"figi":

"figi",

"initialOrderPrice": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"initialCommission": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"averagePositionPrice": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"lotsExecuted":

"lotsExecuted",

"totalOrderAmount": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"lotsRequested":

"lotsRequested",

"instrumentUid":

"instrumentUid",

"stages": [

{ ... },

"executionTime":

"2000-01-23T04:56:07.000Z",

"quantity":

"quantity",

"price": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"tradeId":

"tradeId"

},

{ ... }

"executionTime":

"2000-01-23T04:56:07.000Z",

"quantity":

"quantity",

"price": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"tradeId":

"tradeId"

}

],

"orderRequestId":

"orderRequestId",

"executedOrderPrice": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"executedCommission": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"initialSecurityPrice": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"serviceCommission": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"currency":

"currency",

"orderDate":

"2000-01-23T04:56:07.000Z"

}