Ордер

View as Markdown

Примітка

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

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

1POST /v1/private/order/place
2Content-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

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

1{
2 "symbol": "BTCUSDT",
3 "type": "LIMIT",
4 "side": "BUY",
5 "price": "85000",
6 "quantity": "0.1",
7 "timeInForce": "GTC",
8 "makerOnly": true,
9 "clientOrderId": "ext-1772710377808-001"
10}

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

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

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

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

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

1{
2 "orders": [
3 {
4 "symbol": "BTCUSDT",
5 "type": "LIMIT",
6 "side": "BUY",
7 "price": "85000",
8 "quantity": "0.1",
9 "clientOrderId": "ext-buy-001"
10 }
11 ]
12}

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

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

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

1POST /v1/private/order/place-condition
2Content-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Часова мітка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1GET /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

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

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

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

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

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

1GET /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Загальна кількість

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

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

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

1{
2 "symbol": "BTCUSDT",
3 "orderId": "2022543809547603968"
4}

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

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

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

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

1{
2 "symbol": "BTCUSDT",
3 "orderId": "2022543809547603968",
4 "price": "85100",
5 "quantity": "0.2"
6}

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

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

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

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

1{
2 "symbol": "BTCUSDT",
3 "orders": [
4 {
5 "orderId": "2022543809547603968",
6 "price": "85100",
7 "quantity": "0.2"
8 }
9 ]
10}

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

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

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

1{
2 "orders": [
3 {
4 "symbol": "BTCUSDT",
5 "orderId": "2022543809547603968"
6 }
7 ]
8}

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

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

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

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

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

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

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

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

1{
2 "symbol": "BTCUSDT",
3 "conditionId": "2022543809547603968"
4}

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

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

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

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