К содержимому
logologo-text

API

Лонгрид 8 из 13Курс

Безопасно выставить и отменить заявку

~5 мин чтенияОбновлено 28 сентября 2026

Содержание

В этом уроке будет настоящая торговая команда. Используйте только демо-счёт и токен с полным доступом.

Лимитная цена не гарантирует отсутствие исполнения

Даже очень далёкая от рынка заявка теоретически может исполниться при резком движении или неверно выбранном инструменте. Демо-счёт — обязательное условие примера, а не дополнительная страховка.

Подготовьте явные параметры

Bash

Перед запуском проверьте, что цена кратна шагу инструмента. Если демо-сервис отклоняет слишком далёкую цену, выберите другую допустимую цену ниже текущего рынка.

Из чего состоит лимитная заявка

Поле

Значение в примере

symbol

Полный символ ticker@mic

quantity

1 штука, не один лот

side

SIDE_BUY

type

ORDER_TYPE_LIMIT

time_in_force

TIME_IN_FORCE_DAY

limit_price

Цена из FINAM_LIMIT_PRICE

client_order_id

Уникальная строка не длиннее 20 символов

order.mjs

Что важно исправить в боевом клиенте

client_order_id помогает сопоставить заявку с локальной командой, но сам по себе не даёт права вслепую повторять POST. Если соединение оборвалось после отправки, неизвестно, принял ли сервер заявку. Сначала выполните сверку активных заявок и событий, и только затем решайте, нужна ли новая команда.

UUID не помещается в поле

Стандартный UUID содержит 36 символов, а client_order_id — максимум 20. В примерах используется 10 случайных байт в hex: ровно 20 символов.

Основные статусы

Статус

Смысл

ORDER_STATUS_NEW

Заявка принята

ORDER_STATUS_PARTIALLY_FILLED

Исполнена частично

ORDER_STATUS_FILLED

Исполнена полностью

ORDER_STATUS_PENDING_CANCEL

Отмена ещё обрабатывается

ORDER_STATUS_CANCELED

Заявка отменена

ORDER_STATUS_REJECTED

Заявка отклонена

ORDER_STATUS_EXPIRED

Срок заявки закончился

Полный список шире. Логику завершения стройте по актуальной enum-схеме и полям executed_quantity и remaining_quantity, а не только по одному удобному статусу.

Что должно получиться

Частые вопросы

  • Заявка отклонена сразу после отправки — что смотреть первым?

    Счёт и права токена. Токен только на чтение и неторгуемый инструмент дают отказ ещё до проверки цены.

  • Ответ на отправку не пришёл. Можно повторить?

    Нет. Сначала запросите активные заявки и найдите свою по client_order_id, и только потом решайте, нужна ли новая команда.

  • Почему цена не проходит проверку?

    Лимитная цена должна быть кратна шагу цены инструмента. Шаг считается из min_step и decimals — это тема «Найти инструмент и проверить торговые параметры».

Конец лонгрида

Дочитаете до конца — засчитается автоматически
Лонгрид 8 из 13

Предложить идею

Заполните форму ниже, и мы свяжемся с вами.

Увеличить лимиты API

Заполните форму ниже, и мы свяжемся с вами.