Skip to main content

GetOperationsByCursor — список операций по счету с пагинацией

/tinkoff.public.invest.api.contract.v1.OperationsService/GetOperationsByCursor

POST

https://invest-public-api.tinkoff.ru/rest/tinkoff.public.invest.api.contract.v1.OperationsService/GetOperationsByCursor

При работе с методом учитывайте особенности взаимодействия.

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

accountId

String

Идентификатор счета клиента, обязательный параметр. Остальные параметры опциональны.

instrumentId

String

Идентификатор инструмента — FIGI или UID инструмента.

from

String<date-time>

Начало периода по UTC.

to

String<date-time>

Окончание периода по UTC.

cursor

String

Идентификатор элемента, с которого начать формировать ответ.

limit

Integer<int32>

Лимит количества операций. По умолчанию — 100, максимальное значение — 1000.

operationTypes

Array

Requirements: [OPERATION_TYPE_UNSPECIFIED, OPERATION_TYPE_INPUT, OPERATION_TYPE_BOND_TAX, OPERATION_TYPE_OUTPUT_SECURITIES, OPERATION_TYPE_OVERNIGHT, OPERATION_TYPE_TAX, OPERATION_TYPE_BOND_REPAYMENT_FULL, OPERATION_TYPE_SELL_CARD, OPERATION_TYPE_DIVIDEND_TAX, OPERATION_TYPE_OUTPUT, OPERATION_TYPE_BOND_REPAYMENT, OPERATION_TYPE_TAX_CORRECTION, OPERATION_TYPE_SERVICE_FEE, OPERATION_TYPE_BENEFIT_TAX, OPERATION_TYPE_MARGIN_FEE, OPERATION_TYPE_BUY, OPERATION_TYPE_BUY_CARD, OPERATION_TYPE_INPUT_SECURITIES, OPERATION_TYPE_SELL_MARGIN, OPERATION_TYPE_BROKER_FEE, OPERATION_TYPE_BUY_MARGIN, OPERATION_TYPE_DIVIDEND, OPERATION_TYPE_SELL, OPERATION_TYPE_COUPON, OPERATION_TYPE_SUCCESS_FEE, OPERATION_TYPE_DIVIDEND_TRANSFER, OPERATION_TYPE_ACCRUING_VARMARGIN, OPERATION_TYPE_WRITING_OFF_VARMARGIN, OPERATION_TYPE_DELIVERY_BUY, OPERATION_TYPE_DELIVERY_SELL, OPERATION_TYPE_TRACK_MFEE, OPERATION_TYPE_TRACK_PFEE, OPERATION_TYPE_TAX_PROGRESSIVE, OPERATION_TYPE_BOND_TAX_PROGRESSIVE, OPERATION_TYPE_DIVIDEND_TAX_PROGRESSIVE, OPERATION_TYPE_BENEFIT_TAX_PROGRESSIVE, OPERATION_TYPE_TAX_CORRECTION_PROGRESSIVE, OPERATION_TYPE_TAX_REPO_PROGRESSIVE, OPERATION_TYPE_TAX_REPO, OPERATION_TYPE_TAX_REPO_HOLD, OPERATION_TYPE_TAX_REPO_REFUND, OPERATION_TYPE_TAX_REPO_HOLD_PROGRESSIVE, OPERATION_TYPE_TAX_REPO_REFUND_PROGRESSIVE, OPERATION_TYPE_DIV_EXT, OPERATION_TYPE_TAX_CORRECTION_COUPON, OPERATION_TYPE_CASH_FEE, OPERATION_TYPE_OUT_FEE, OPERATION_TYPE_OUT_STAMP_DUTY, OPERATION_TYPE_OUTPUT_SWIFT, OPERATION_TYPE_INPUT_SWIFT, OPERATION_TYPE_OUTPUT_ACQUIRING, OPERATION_TYPE_INPUT_ACQUIRING, OPERATION_TYPE_OUTPUT_PENALTY, OPERATION_TYPE_ADVICE_FEE, OPERATION_TYPE_TRANS_IIS_BS, OPERATION_TYPE_TRANS_BS_BS, OPERATION_TYPE_OUT_MULTI, OPERATION_TYPE_INP_MULTI, OPERATION_TYPE_OVER_PLACEMENT, OPERATION_TYPE_OVER_COM, OPERATION_TYPE_OVER_INCOME, OPERATION_TYPE_OPTION_EXPIRATION, OPERATION_TYPE_FUTURE_EXPIRATION]

Тип операции. Принимает значение из списка OperationType.

state

String (v1OperationState)

Requirements: [OPERATION_STATE_UNSPECIFIED, OPERATION_STATE_EXECUTED, OPERATION_STATE_CANCELED, OPERATION_STATE_PROGRESS]

Default: OPERATION_STATE_UNSPECIFIED

Статус запрашиваемых операций.

  • OPERATION_STATE_UNSPECIFIED: Статус операции не определен.
  • OPERATION_STATE_EXECUTED: Исполнена частично или полностью.
  • OPERATION_STATE_CANCELED: Отменена.
  • OPERATION_STATE_PROGRESS: Исполняется.

withoutCommissions

Boolean

Флаг возврата комиссии. По умолчанию — false.

withoutTrades

Boolean

Флаг получения ответа без массива сделок.

withoutOvernights

Boolean

Флаг показа overnight операций.

Ответ

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

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

Loading...

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie» с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.