FAQ
Для чего используется параметр order_id метода PostOrder?
Сейчас у нас есть два параметра с одинаковым названием:
order_idкак входной параметр — ключ идемпотентности в форматеUID. Уникальность значений отслеживается только за последний месяц.order_idкак выходной параметр — биржевой идентификатор заявки, который в дальнейшем используется для отслеживания статуса заявки.
Если вы используете параметр как ключ идемпотентности, многократный вызов метода PostOrder с одинаковым order_id не приведёт к выставлению более одного торгового поручения.
При вызове метода проверяется уникальность связки order_id и account_id:
- Если указанная пара не найдена, создаётся новое торговое поручение.
- Если связка уже есть (поручение с этим
order_idпо данному номеру счёта было выставлено раньше) — метод PostOrder вернёт статус уже выставленного торгового поручения, то есть отработает согласно логике метода GetOrderState.
Можно ли увидеть ключ идемпотентности (order_id) в операциях, выставленных поручениях и т.п.?
Сейчас order_id используется только как ключ идемпотентности и не прокидывается в другие сущности системы.
В будущем мы планируем добавить отображение переданного ключа в операциях.
Сколько хранится ключ идемпотентности (order_id) на стороне брокера?
Ключ хранится один месяц, но пока мы не может дать гарантию его сохранности. Сейчас подразумевается полная уникальность переданного order_id в разрезе номера счёта — account_id.
Что передавать в параметре quantity метода PostOrder? Количество бумаг или количество лотов?
Требуемое количество лотов.
У многих инструментов лотность не равна единице — учитывайте это при выставлении торговых поручений.
Как рассчитать полную стоимость сделки?
Полная стоимость сделки включает в себя не только сумму операции покупки или продажи биржевого инструмента, но и комиссии брокера, сервисные комиссии, гарантийное обеспечение для операций с фьючерсами и другие параметры.
Рассчитать размеры комиссий можно из описания вашего тарифа. Учитывайте, что комиссии берутся за сделки, а не за поручение — то есть одно торговое поручение может рождать несколько сделок. Процент комиссии фиксированный в зависимости от тарифа.
Размер начальной и фактической комиссии можно узнать в деталях торгового поручения через метод GetOrderState.
Подробнее про расчёт стоимости сделок с фьючерсами и облигациями
Можно ли получить список уже исполненных торговых поручений?
Пока нет. Сейчас метод GetOrders возвращает только список активных торговых поручений — то есть поручений, которые ещё не исполнены и не отменены.
Какие есть статусы торговых поручений и что они означают?
Описание статусной модели торговых поручений
Алгоритм и особенности исполнения торговых поручений
Почему лимитная заявка исполнилась по другой цене?
Лимитное торговое поручение исполняется либо цене, указанной при её выставлении, либо по «лучшей цене» для определённого направления сделки. На бирже этот механизм называется Best Execution и подразумевает исполнение торгового поручения по цене, которая выгоднее указанной в поручении.
Как перевести цену поручения в тип Quotation?
Как изменить выставленную заявку?
Чтобы изменять уже выставленные поручения, используйте метод replaceOrder. Через него можно отменить существующую выставленную заявку и выставить новую с изменёнными параметрами.
Можно ли выставлять поручения по счёту Инвесткопилки?
Нет. Если попытаться выставить поручение по счёту Инвесткопилки через метод PostOrder, в ответе вернётся ошибка с кодом 40004 и сообщением Working with orders is not available with this account.
Нужно ли включать маржинальную торговлю для торгов на срочном рынке?
Да. Для выставления поручений на срочном рынке нужно включить маржинальную торговлю в приложении и терминале —
иначе вернётся ошибка 30051 из cписка кодов ошибок.
Чем отличается рыночная заявка от лимитной?
| Рыночная заявка | Лимитная заявка |
|---|---|
| Заявка на покупку или продажу активов по цене, которая есть на бирже в данный момент. | Указание брокеру, какую бумагу или валюту, сколько лотов и по какой цене вы хотите купить или продать. |
| Если сейчас на бирже по текущей цене торгуется меньше лотов, чем вы указали, но при этом есть другие лоты по цене, которая отличается в негативную для вас сторону — брокер купит имеющееся количество лотов по текущей цене, а оставшуюся часть заявки будет покупать по следующей по списку цене. | Для сделок покупки лимитную заявку исполнят по цене равной или дешевле той, которую вы указали. Для сделок продажи лимитную заявку исполнят по цене равной или выше той, которую вы указали. |
| Используйте, только когда вам срочно нужно купить или продать актив по любой цене и вы готовы к тому, что она может оказаться для вас невыгодной. | Используйте, чтобы не тратить время на постоянное отслеживание котировок на бирже и выполнить заявку по выгодной цене. |
Помимо рыночных и лимитных заявок, в T-Invest API можно выставлять заявки типа «Лучшая цена».
Чем отличаются методы GetOrders и GetOrderState?
| GetOrders | GetOrderState |
|---|---|
| Предполагает получение массива активных заявок. | Предполагает получение статуса конкретной заявок по order_id. |
| Возвращает только список активных торговых поручений, то есть поручений, которые ещё не исполнены и не отменены. | Возвращает торговое поручение конкретного инструмента в любом статусе, в том числе после исполнения. |
| Максимальный срок получения частично исполненной заявки через метод — до конца торгового дня, когда все неисполненные заявки отменяются и требуют повторного выставления. | Метод не предусмотрен для получения глубокой истории и может не возвращать информацию по поручениям, которым больше одного дня. |
Существуют ли ограничения на стоимость заявки?
Да, на данный момент такие ограничения есть. Сейчас в T-Invest API нельзя выставить заявку со стоимостью выше установленных значений для каждой из валют — её будет нужно подтверждать по СМС. Поэтому разбивайте такие заявки на заявки меньшего размера.
Если вы превысите лимит, вернётся ошибка 90003. Все коды ошибок.
Лимиты на стоимость заявки для разных валют
| Валюта | Полное название валюты | Лимит |
|---|---|---|
| RUB | Рубль | 30 000 000 |
| USD | Доллар США | 500 000 |
| EUR | Евро | 500 000 |
| GBP | Фунт стерлингов | 5 000 |
| CHF | Швейцарский франк | 5 000 |
| CNY | Юань | 50 000 |
| JPY | Иена | 500 000 |
| HKD | Гонконгский доллар | 50 000 |
| TRY | Турецкая лира | 50 000 |
| KZT | Казахстанский тенге | 500 000 |
| BYN | Белорусский рубль | 50 000 |
| AMD | Армянский драм | 500 000 |
| UZS | Узбекский сум | 5 000 000 |
| KGS | Киргизский сом | 50 000 |
| TJS | Таджикский сомони | 50 000 |
| XAU | Золото | 50 000 |
| XAG | Серебро | 50 000 |