NEWORDER

8.18.0

Описание

Базовый экшн для создания ордеров на бирже. Является действием по умолчанию, если параметр action не указан в команде. Поддерживает все типы ордеров и рынков.

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

• ✅ Spot (спот)

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

Алиасы

Нет (экшн по умолчанию)

Синтаксис

[action=neworder;]mktype=MARKET;symbol=SYMBOL;side=SIDE;type=TYPE;qty=QTY[;дополнительные_параметры]

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

mktype / market (устаревший)

Современный способ (рекомендуется):

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

Устаревший способ:

market=binance       # спот Binance
market=binancefru    # USDT-фьючерсы Binance
market=binancefro    # COIN-M фьючерсы Binance
market=bybit         # спот Bybit
market=bybitfu       # USDT-фьючерсы Bybit
market=bybitfi       # инвертированные фьючерсы Bybit
market=okx           # спот OKX
market=okxfu         # фьючерсы OKX
# другие поддерживаемые биржи...

Система автоматически очищает символ от лишних данных справа (.P, .F и др.)

symbol

Торговый символ

symbol=BTCUSDT
symbol=ETHUSDT

side

Направление ордера

side=BUY    # покупка (лонг для фьючерсов)
side=SELL   # продажа (шорт для фьючерсов)

type

Тип ордера

type=MARKET        # рыночный ордер
type=LIMIT         # лимитный ордер
type=STOP_MARKET   # стоп-маркет
type=STOP_LIMIT    # стоп-лимит
type=TP_MARKET     # тейк-профит маркет
type=TP_LIMIT      # тейк-профит лимит

Количество (один из параметров обязателен)

Подробнее о формировании количества Детальную информацию о всех способах указания количества см. в разделе Формирование количества

Абсолютное количество:

qty=0.1           # точное количество в базовой валюте
quqty=100         # точное количество в квотовой валюте
ququantity=100    # устаревший аналог quqty

Процентное количество:

openpro=25        # 25% от свободного баланса для открытия
closepro=100      # 100% от позиции/баланса для закрытия
depopro=50        # 50% от общего депозита (свободный + заблокированный)

Устаревшие процентные параметры:

openquantityproc=25   # аналог openpro (устаревший)
closequantityproc=50  # аналог closepro (устаревший)

Дополнительные параметры

Цены

price=30000           # цена для лимитных ордеров
trgprice=29000        # триггерная цена для условных ордеров
stopprice=29000       # альтернативное название trgprice

Процентные цены

pricepro=5            # цена в % от текущей цены маркета
priceproc=5           # устаревший аналог pricepro
trgpricepro=5         # триггерная цена в % от текущей цены
stoppriceproc=-5      # устаревший аналог trgpricepro

Примеры процентных цен:

# Лимитный ордер на 5% выше текущей цены
type=LIMIT;pricepro=5

# Стоп-лосс на 3% ниже текущей цены
type=STOP_MARKET;trgpricepro=-3

# Тейк-профит на 10% выше текущей цены
type=TP_MARKET;trgpricepro=10

Управление ордером

clientid=my_order_1   # пользовательский ID ордера
clientorderid=order1  # устаревший аналог clientid
tif=GTC              # время жизни (GTC/IOC/FOK)
reduceonly=true      # только закрытие позиций (futures)
closeposition=true   # закрыть всю позицию (futures)

Плечо и маржа (только futures)

leverage=10          # плечо позиции
lev=10              # альтернативное название
levforqty=true      # использовать плечо для расчета qty
isisolated=true     # изолированная маржа
dualside=true       # режим хеджирования
positionside=LONG   # сторона для хедж-позиции (LONG/SHORT)

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

Спотовая торговля

Рыночная покупка на 50% свободного баланса:

mktype=spot;symbol=BTCUSDT;side=BUY;type=MARKET;openpro=50

Лимитная продажа с процентной ценой:

mktype=spot;symbol=ETHUSDT;side=SELL;type=LIMIT;qty=1;pricepro=5

Покупка на точную сумму в USDT:

mktype=spot;symbol=BTCUSDT;side=BUY;type=MARKET;quqty=1000

Фьючерсная торговля

Открытие лонга с плечом:

mktype=futures;symbol=BTCUSDT;side=BUY;type=MARKET;openpro=25;lev=10;levforqty=true

Стоп-лосс ордер с процентной ценой:

mktype=futures;symbol=ETHUSDT;side=SELL;type=STOP_MARKET;closepro=100;trgpricepro=-5;reduceonly=true

Тейк-профит лимит:

mktype=futures;symbol=ADAUSDT;side=SELL;type=TP_LIMIT;qty=100;trgpricepro=10;pricepro=11;clientid=tp1

Хедж-позиция:

mktype=futures;symbol=BTCUSDT;side=BUY;type=MARKET;qty=0.1;dualside=true;positionside=LONG

Процентные расчеты

Закрытие части позиции:

mktype=futures;symbol=SOLUSDT;side=SELL;type=MARKET;closepro=50;reduceonly=true

Использование всего депозита:

mktype=futures;symbol=BTCUSDT;side=BUY;type=MARKET;depopro=100;lev=5;levforqty=true

Особенности

Экшн по умолчанию Если параметр action не указан, система автоматически использует neworder

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

• MARKET: не требует price и trgprice

• LIMIT: требует price или pricepro

• STOP_*: требует trgprice или trgpricepro

• TP_*: требует trgprice или trgpricepro

Автоматический расчет При использовании процентных параметров и плеча система автоматически рассчитывает точное количество

Приоритет количества qty → quqty → openpro/closepro/depopro → устаревшие параметры

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

Возвращает информацию о созданном ордере с биржевым ID, статусом и параметрами исполнения.

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

• REPLACEORDER - замена ордера

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

• OPENPOSITION - открытие позиции с защитными ордерами

• Формирование количества - подробнее о количественных параметрах

• Процентные ордеры - подробнее о процентных расчетах

• Условные ордеры - как работают стопы и тейки Обязательные параметры для типов ордеров

• MARKET: не требует price и trgprice

• LIMIT: требует price

• STOP_*: требует trgprice

• TP_*: требует trgprice

Автоматический расчет количества При использовании процентных параметров система автоматически рассчитывает точное количество

Универсальность Единый интерфейс для всех типов ордеров и рынков

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

Возвращает информацию о:

• ID созданного ордера

• Статусе размещения

• Параметрах ордера

• Комиссии (если применимо)

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

• REPLACEORDER - замена ордера

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

• OPENPOSITION - открытие позиции с защитными ордерами

Рыночный ордер на покупку (спот)

mktype=spot;symbol=BTCUSDT;side=BUY;type=MARKET;qty=0.001

Лимитный ордер на продажу (фьючерсы)

mktype=futures;symbol=BTCUSDT;side=SELL;type=LIMIT;price=31000;qty=0.1

Стоп-лосс ордер

mktype=futures;symbol=BTCUSDT;side=SELL;type=STOP_MARKET;trgprice=29000;qty=0.1

Если параметр action не указан в команде, система автоматически использует экшн neworder

Подробное описание всех параметров ордера доступно в разделе Биржевой ордер