Ордер

View as Markdown

Примітка

Кінцеві точки замовлення потребують дозволу на торгівлю.

Зробити замовлення

POST /v1/private/order/place
Content-Type: application/json

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringТакСимвол
typestringТакLIMIT / MARKET
sidestringТакBUY / SELL
positionSidestringНіBOTH / LONG / SHORT, за замовчуванням BOTH
pricestringУмовно обов’язковийПотрібні для лімітних ордерів
quantitystringУмовно обов’язковийКількість. Можна опустити, коли closePosition=true
timeInForcestringНіGTC / IOC / FOK, за замовчуванням GTC
reduceOnlyboolНіЛише зменшення, стандартне false
makerOnlyboolНіТільки для виробника, стандартний false
closePositionboolНіЗакрити всю позицію за замовчуванням false
clientOrderIdstringНіІдентифікатор замовлення, визначений клієнтом
placeTypestringНіМаркер типу розміщення замовлення
priceTypeint32НіBBO тип ціни: 0 вказана ціна, 1 опонента ціна 1, 2 опонент ціна 5, 3 ціна на той самий бік 1, 4 ціна з того ж боку 5

Приклад запиту:

{
"symbol": "BTCUSDT",
"type": "LIMIT",
"side": "BUY",
"price": "85000",
"quantity": "0.1",
"timeInForce": "GTC",
"makerOnly": true,
"clientOrderId": "ext-1772710377808-001"
}

Поля відповіді:

ПолеТипОпис
orderIdstringІдентифікатор порядку сервера
clientOrderIdstringІдентифікатор замовлення, визначений клієнтом
statusstringСтатус ордену
timestampint64Часова мітка

Замовлення на розміщення пакетів

POST /v1/private/order/batch-place
Content-Type: application/json

Запитуйте тіло:

{
"orders": [
{
"symbol": "BTCUSDT",
"type": "LIMIT",
"side": "BUY",
"price": "85000",
"quantity": "0.1",
"clientOrderId": "ext-buy-001"
}
]
}

Поля відповіді:

ПолеТипОпис
successCountint32Кількість успішних замовлень
failedCountint32Кількість невдалих замовлень
results[]arrayРезультат для кожного порядку

Ордер умов розміщення

POST /v1/private/order/place-condition
Content-Type: application/json

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringТакСимвол
typestringТакSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringТакBUY / SELL
positionSidestringНіBOTH / LONG / SHORT
pricestringУмовно обов’язковийОбов’язково для STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringУмовно обов’язковийКількість. Можна опустити, коли closePosition=true
timeInForcestringНіGTC / IOC / FOK / GTE_GTC
reduceOnlyboolНіЛише редукція
clientOrderIdstringНіІдентифікатор замовлення, визначений клієнтом
stopPricestringУмовно обов’язковийТригерна ціна
workingTypestringНіMARK_PRICE / CONTRACT_PRICE, за замовчуванням CONTRACT_PRICE
priceProtectboolНіЧи увімкнено захист цін
activatePricestringУмовно обов’язковийЦіна активації трейлінгового замовлення
callbackRatestringУмовно обов’язковийЧастота зворотного виклику за наказом
closePositionboolНіЗакрийте всю позицію

Поля відповіді:

ПолеТипОпис
conditionIdstringІдентифікатор порядку стану
conditionStatusstringСтан порядку стану
timestampint64Часова мітка

Ордер розміщення стратегії

POST /v1/private/order/place-strategy
Content-Type: application/json

Параметри запиту:

ПараметрТипОбов’язковеОпис
strategyTypestringТакOTOCO / OTO / OCO
subOrderListarrayТакСписок підпорядків

Поля в subOrderList[] здебільшого збігаються з нормальними порядками та порядками умов, з додатковими полями залежностей:

ПараметрТипОпис
strategySubIdint64Ідентифікатор підпорядку
firstDrivenIdint64Перше посвідчення наказу на водіння. 0 означає відсутність залежності
firstDrivenOnstringПерша умова тригера
firstTriggerstringПерша спускова дія
secondDrivenIdint64Другий ідентифікатор наказу водіння
secondDrivenOnstringДруга умова тригера
secondTriggerstringДруга спускова дія

Поля відповіді:

ПолеТипОпис
strategyIdstringСтратегічний ідентифікатор
strategyStatusstringСтатус стратегії
timestampint64Часова мітка

Одиничний ордер запиту

GET /v1/private/order?symbol=BTCUSDT&orderId=2022543809547603968

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringТакСимвол
orderIdstringНіІдентифікатор порядку сервера
clientOrderIdstringНіІдентифікатор замовлення, визначений клієнтом

Має бути надано принаймні один із orderId і clientOrderId . Якщо обидва надані, сервер виконує точне співпадіння за обох умов.

Поточні нормальні порядки

GET /v1/private/order/current?symbol=BTCUSDT

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringНіСимвол
limitint32НіЛіміт кількості повернень
lastOrderIdint64НіКурсорне поле

Поля відповіді:

ПолеТипОпис
list[]arrayПоточний список нормальних порядків
totalint32Граф

Поточні накази щодо стану

GET /v1/private/order/current-condition?symbol=BTCUSDT

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringНіСимвол

Історичні нормальні порядки

GET /v1/private/order/history?symbol=BTCUSDT&page=1&pageSize=20

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringНіСимвол
orderIdstringНіФільтр ідентифікатора точного порядку
clientOrderIdstringНіТочний фільтр ідентифікатора замовлення клієнта
typeint32НіФільтр типу ордерів: 1 ліміт, 2 ринку
sideint32НіБічний фільтр: 1 купуєш, 2 продаєш
statusint32НіФільтр статусу
startTimeint64НіЧас початку
endTimeint64НіКінець часу
pageint64НіНомер сторінки, стандартний 1
pageSizeint64НіПункти на сторінку, стандартні 20

Історичні накази про стан

GET /v1/private/order/history-condition?symbol=BTCUSDT&page=1&pageSize=20

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringНіСимвол
sideint32НіБічний фільтр: 1 купуєш, 2 продаєш
statusint32НіФільтр статусу
startTimeint64НіЧас початку
endTimeint64НіКінець часу
pageint64НіНомер сторінки, стандартний 1
pageSizeint64НіПункти на сторінку, стандартні 20

Торгові рекорди

GET /v1/private/order/trades?symbol=BTCUSDT&page=1&pageSize=20

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringНіСимвол
orderIdstringНіФільтр Order ID
startTimeint64НіЧас початку
endTimeint64НіКінець часу
pageint64НіНомер сторінки, стандартний 1
pageSizeint64НіПункти на сторінку, стандартні 20

Поля відповіді:

ПолеТипОпис
list[].fillIdstringІдентифікатор деталей заповнення
list[].tradeIdstringІдентифікатор торгової записи
list[].orderIdstringІдентифікатор замовлення
list[].symbolstringСимвол
list[].sidestringБік
list[].roleTypestringmaker / taker
list[].pricestringЗаповнена ціна
list[].quantitystringЗаповнена кількість
list[].tradeValuestringТорговельна вартість
list[].handlingFeestringПлата за обробку
list[].realizedPnlstringРеалізований PnL
list[].positionSidestringПозиція
list[].createdAtint64Час обміну
totalint64Загальна кількість

Скасування замовлення

POST /v1/private/order/cancel
Content-Type: application/json

Запитуйте тіло:

{
"symbol": "BTCUSDT",
"orderId": "2022543809547603968"
}

clientOrderId також можна використати для скасування замовлення.

Наказ про внесення змін

POST /v1/private/order/move
Content-Type: application/json

Запитуйте тіло:

{
"symbol": "BTCUSDT",
"orderId": "2022543809547603968",
"price": "85100",
"quantity": "0.2"
}

quantity — це остаточна загальна кількість замовлення після внесення змін, а не залишкова величина.

Накази про внесення змін на групу

POST /v1/private/order/batch-move
Content-Type: application/json

Запитуйте тіло:

{
"symbol": "BTCUSDT",
"orders": [
{
"orderId": "2022543809547603968",
"price": "85100",
"quantity": "0.2"
}
]
}

Замовлення на скасування пакетів

POST /v1/private/order/batch-cancel
Content-Type: application/json

Запитуйте тіло:

{
"orders": [
{
"symbol": "BTCUSDT",
"orderId": "2022543809547603968"
}
]
}

Скасувати все

POST /v1/private/order/batch-cancel-all
Content-Type: application/json

Параметри запиту:

ПараметрТипОбов’язковеОпис
symbolstringНіСимвол
cancelTypeint32Ні0 всі звичайні ордери, 1 лише лімітні ордери, 2 всі умовні ордери. Стандартна 0

Скасування всіх для звичайних замовлень приймається асинхронно. Остаточний статус має визначатися WebSocket ORDER_TRADE_UPDATE або кінцевими точками запиту.

Наказ про скасування умов

POST /v1/private/order/cancel-condition
Content-Type: application/json

Запитуйте тіло:

{
"symbol": "BTCUSDT",
"conditionId": "2022543809547603968"
}

Деталі порядку стратегії

GET /v1/private/order/strategy?strategyId=2022543809547603968

Поля відповіді:

ПолеТипОпис
strategyIdstringСтратегічний ідентифікатор
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Час створення
subOrders[]arrayДеталі підпорядку
updateTimeint64Час оновлення