REPLACEORDER

8.12.0

Описание

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

Поддерживаемые рынки

• ✅ Spot (спот)

• ✅ Futures (фьючерсы)

Алиасы

Нет

Синтаксис

action=replaceorder;orderid=ORDER_ID[;новые_параметры]

или

action=replaceorder;clientid=CLIENT_ID[;новые_параметры]

Обязательные параметры

Идентификация ордера

Один из параметров обязателен:

orderid

ID ордера на бирже

orderid=1234567890

clientid

Пользовательский ID ордера

clientid=my_order_123

symbol

Торговый символ (обязательный)

symbol=BTCUSDT

mktype

Тип рынка (обязательный)

mktype=spot       # спотовый рынок
mktype=futures    # фьючерсный рынок

Изменяемые параметры

price

Новая цена ордера

price=30000       # новая цена

qty

Новое количество

qty=0.5           # новое количество

type

Новый тип ордера

type=LIMIT        # лимитный ордер
type=MARKET       # рыночный ордер
type=STOP_MARKET  # стоп-ордер (только futures)
type=STOP_LIMIT   # стоп-лимит (только futures)

side

Сторона торговли (если поддерживается биржей)

side=BUY          # покупка
side=SELL         # продажа

stopPrice

Стоп-цена (для стоп-ордеров)

stopPrice=29000   # цена активации стопа

timeInForce

Время жизни ордера

timeInForce=GTC   # до отмены
timeInForce=IOC   # исполнить или отменить
timeInForce=FOK   # исполнить полностью или отменить

newclientid

Новый пользовательский ID ордера

newclientid=updated_order_456

Примеры использования

Изменение цены ордера

action=replaceorder;orderid=123456789;symbol=BTCUSDT;price=31000;mktype=futures

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

action=replaceorder;clientid=my_order;symbol=ETHUSDT;qty=2.0;mktype=spot

Изменение цены и количества

action=replaceorder;orderid=987654321;symbol=ADAUSDT;price=0.45;qty=1000;mktype=spot

Изменение типа ордера

action=replaceorder;clientid=stop_order;symbol=BTCUSDT;type=STOP_LIMIT;price=30000;stopPrice=29500;mktype=futures

Изменение времени жизни

action=replaceorder;orderid=456789123;symbol=ETHUSDT;timeInForce=IOC;mktype=futures

Полная замена ордера

action=replaceorder;clientid=trade_001;symbol=BTCUSDT;price=32000;qty=0.8;type=LIMIT;timeInForce=GTC;mktype=futures

Замена с новым client ID

action=replaceorder;orderid=111222333;symbol=SOLUSDT;price=25;newclientid=updated_sol_order;mktype=spot

В составе сцепки команд

action=replaceorder;orderid=123456;symbol=BTCUSDT;price=31500;mktype=futures::action=neworder;symbol=ETHUSDT;side=BUY;qty=1;price=2000;mktype=futures

Заменяет ордер по Bitcoin, затем создает новый ордер по Ethereum

Особенности

Атомарная операция Замена происходит как единая операция, избегая риска частичного исполнения

Поддержка биржи Не все биржи поддерживают замену ордеров. На некоторых биржах будет выполнена отмена + создание

Сохранение позиции в очереди При поддержке биржей ордер сохраняет свою позицию в торговой очереди

Ограничения на изменения Некоторые биржи ограничивают какие параметры можно изменять

Обработка ошибок Если замена невозможна, будет возвращена соответствующая ошибка

Результат выполнения

Возвращает информацию о замененном ордере с новыми параметрами или сообщение об ошибке.

Связанные экшены

• NEWORDER - создание новых ордеров

• CANCELORDER - отмена ордеров

• GET - получение информации об ордерах

• CHPORDERS - изменение ордеров по шаблону

Изменяемые параметры

price

Новая цена ордера

price=30000

qty

Новое количество для ордера

qty=0.1

type

Новый тип ордера (если поддерживается биржей)

type=LIMIT

Пример команды

mktype=futures;symbol=BTCUSDT;action=replaceorder;orderid=123456;price=31000;qty=0.2

Данная команда заменит ордер с ID 123456 на новую цену 31000 и количество 0.2.

Не все биржи поддерживают замену всех параметров ордера. Обычно можно изменить только цену и количество.

Если замена ордера не поддерживается биржей, система автоматически отменит старый ордер и создаст новый.