Ордер

Просмотр в формате 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НетТолько для Maker, по умолчанию 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}

Поля ответа:

ПолеТипОписание
orderIdstringID серверного ордера
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Второй спусковой механизм

Поля ответа:

ПолеТипОписание
strategyIdstringStrategy ID
strategyStatusstringСтатус стратегии
timestampint64Временная метка

Запрос по одному ордеру

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

Параметры запроса:

ПараметрТипОбязательноОписание
symbolstringДаСимвол
orderIdstringНетID серверного ордера
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НетТочный фильтр ID заказа клиента
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НетФильтр идентификатора заказа
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

Поля ответа:

ПолеТипОписание
strategyIdstringStrategy ID
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Время создания
subOrders[]arrayДетали подордеров
updateTimeint64Время обновления