FutureBy — получить фьючерс по его идентификатору

/tinkoff.public.invest.api.contract.v1.InstrumentsService/FutureBy

POST

https://invest-public-api.tbank.ru/rest/tinkoff.public.invest.api.contract.v1.InstrumentsService/FutureBy

FutureBy — получить фьючерс по его идентификатору

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

idType

String (v1InstrumentIdType)

Requirements: [INSTRUMENT_ID_UNSPECIFIED, INSTRUMENT_ID_TYPE_FIGI, INSTRUMENT_ID_TYPE_TICKER, INSTRUMENT_ID_TYPE_UID, INSTRUMENT_ID_TYPE_POSITION_UID]

Default: INSTRUMENT_ID_UNSPECIFIED

Тип идентификатора инструмента. Подробнее об идентификации инструментов.

• INSTRUMENT_ID_UNSPECIFIED: Значение не определено.
• INSTRUMENT_ID_TYPE_FIGI: FIGI.
• INSTRUMENT_ID_TYPE_TICKER: Ticker.
• INSTRUMENT_ID_TYPE_UID: Уникальный идентификатор.
• INSTRUMENT_ID_TYPE_POSITION_UID: Идентификатор позиции.

classCode

String

Идентификатор class_code. Обязательный, если id_type = ticker.

Required

id

String

Идентификатор запрашиваемого инструмента.

Ответ

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

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

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

Запрос

Токен

​

Окружение

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

{ "idType": "INSTRUMENT_ID_UNSPECIFIED", "classCode": "string", "id": "string" }

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

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

{

"idType":

"INSTRUMENT_ID_UNSPECIFIED",

"classCode":

"string",

"id":

"string"

}

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

200

400

401

403

404

408

415

429

500

501

503

504

default

Content type

application/json

{

"instrument": { ... }

"initialMarginOnSell": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"figi":

"figi",

"dshortMin": {

"nano":

6,

"units":

"units"

},

"countryOfRisk":

"countryOfRisk",

"lot":

0,

"uid":

"uid",

"requiredTests": [

"requiredTests",

"requiredTests"

],

"futuresType":

"futuresType",

"blockedTcaFlag":

true,

"dlong": {

"nano":

6,

"units":

"units"

},

"dlongClient": {

"nano":

6,

"units":

"units"

},

"lastTradeDate":

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

"sellAvailableFlag":

true,

"currency":

"currency",

"first1dayCandleDate":

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

"sector":

"sector",

"brand": {

"logoName":

"logoName",

"logoBaseColor":

"logoBaseColor",

"textColor":

"textColor"

},

"minPriceIncrementAmount": {

"nano":

6,

"units":

"units"

},

"expirationDate":

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

"buyAvailableFlag":

true,

"weekendFlag":

true,

"classCode":

"classCode",

"ticker":

"ticker",

"firstTradeDate":

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

"basicAssetSize": {

"nano":

6,

"units":

"units"

},

"forQualInvestorFlag":

true,

"forIisFlag":

true,

"positionUid":

"positionUid",

"apiTradeAvailableFlag":

true,

"dlongMin": {

"nano":

6,

"units":

"units"

},

"shortEnabledFlag":

true,

"kshort": {

"nano":

6,

"units":

"units"

},

"first1minCandleDate":

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

"assetType":

"assetType",

"minPriceIncrement": {

"nano":

6,

"units":

"units"

},

"otcFlag":

true,

"basicAssetPositionUid":

"basicAssetPositionUid",

"dshortClient": {

"nano":

6,

"units":

"units"

},

"klong": {

"nano":

6,

"units":

"units"

},

"dshort": {

"nano":

6,

"units":

"units"

},

"initialMarginOnBuy": {

"nano":

5,

"currency":

"currency",

"units":

"units"

},

"name":

"name",

"basicAsset":

"basicAsset",

"exchange":

"exchange",

"countryOfRiskName":

"countryOfRiskName"

}

}