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

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.

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

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

401

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

403

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

404

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

408

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

415

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

429

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

500

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

501

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

503

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

504

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

default

An unexpected error response.

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

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

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