Стрим заявок
orders_state — cтрим-соединение T-Invest API для получения изменений состояния заявок.
Используется для получения событий по заявкам с момента выставления до момента исполнения или отмены. Переход заявки от одного статуса в другой формирует событие в стриме.
В статусе PARTYALLY_FILL события формируются по мере исполнения заявки.
Особенности работы
В методе передаются все заявки по счету из подписки, но связать заявку в стриме с поручением, которое отправлено через метод PostOrder, можно не всегда.
Заявки, которые транслируются в стриме, можно идентифицировать по order_request_id — ключу идемпотентности. Он передается при выставлении заявки.
Чтобы поддержать клиентский идентификатор в стриме, передавайте ключ идемпотентности в формате UID.
Ключ идемпотентности в формате UID
order_request_id в сообщениях стрима передается только формате UID. Если в PostOrderRequest передать значение в другом формате, оно будет подменено в сообщениях стрима на сгенерированный API UID. Однозначно связать выставленное поручение не получится.
Возможные ответы стрима в зависимости от параметов, переданных в PostOrderRequest:
| Ключ идемпотентности | Ответы стрима |
|---|---|
| Не передан Передан не в UID | В сообщениях order_request_id, сгенерированный API |
| Передан в UID | В сообщениях order_request_id из PostOrder |
ReplaceOrder
В методе изменения выставленной заявки пока не поддерживается новая маршрутизация. Мы доработаем это в ближайшее время.
Сообщения стрима
Статусы
Первое сообщение по поручению в стриме соответствует получению заявки брокером. На этом этапе еще не определен биржевой номер заявки, в order_id передается внутренний номер.
Состав сообщений
Некоторые параметры ответа, например, список сделок и маркер, опциональные и ориентированы на будущее развитие метода.