Zamówienie

Zobacz jako Markdown

Uwaga

Endpointy Order wymagają zgody na handel.

Kolejność miejsc

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringTakSymbol
typestringTakLIMIT / MARKET
sidestringTakBUY / SELL
positionSidestringNieBOTH / LONG / SHORT, domyślny BOTH
pricestringWarunkowo wymaganeWymagane dla zleceń limitujących
quantitystringWarunkowo wymaganeIlość. Można pominąć, gdy closePosition=true
timeInForcestringNieGTC / IOC / FOK, domyślny GTC
reduceOnlyboolNieTylko redukcja, domyślny false
makerOnlyboolNieTylko dla twórców, domyślny false
closePositionboolNieZamykam całą pozycję, domyślnie false
clientOrderIdstringNieIdentyfikator zamówienia definiowany przez klienta
placeTypestringNieZnacznik typu rozkazu
priceTypeint32NieBBO typ ceny: 0 określoną cenę, 1 przeciwnika 1, 2 przeciwnika 5, 3 cena tej samej strony 1 4 cena tej samej strony 5

Przykład prośby:

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

Pola odpowiedzi:

PoleTypOpis
orderIdstringID zamówienia serwera
clientOrderIdstringIdentyfikator zamówienia definiowany przez klienta
statusstringStatus zamówienia
timestampint64Znacznik czasu

Zamówienia na składanie partii

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

Ciało prośby:

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

Pola odpowiedzi:

PoleTypOpis
successCountint32Liczba udanych zamówień
failedCountint32Liczba nieudanych zamówień
results[]arrayWynik dla każdego zamówienia

Kolejność warunków miejsca

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringTakSymbol
typestringTakSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringTakBUY / SELL
positionSidestringNieBOTH / LONG / SHORT
pricestringWarunkowo wymaganeWymagane dla STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringWarunkowo wymaganeIlość. Można pominąć, gdy closePosition=true
timeInForcestringNieGTC / IOC / FOK / GTE_GTC
reduceOnlyboolNieRedukująca tylko
clientOrderIdstringNieIdentyfikator zamówienia definiowany przez klienta
stopPricestringWarunkowo wymaganeCena wyzwalająca
workingTypestringNieMARK_PRICE / CONTRACT_PRICE, domyślny CONTRACT_PRICE
priceProtectboolNieCzy ochrona cen jest możliwa
activatePricestringWarunkowo wymaganeCena aktywacji kolejnych zamówień
callbackRatestringWarunkowo wymaganeWskaźnik odwołań kolejnych zamówień
closePositionboolNieZamknąć całą pozycję

Pola odpowiedzi:

PoleTypOpis
conditionIdstringIdentyfikator kolejności warunków
conditionStatusstringStatus kolejności warunków
timestampint64Znacznik czasu

Kolejność strategii placowania

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

Parametry żądania:

ParametrTypWymaganeOpis
strategyTypestringTakOTOCO / OTO / OCO
subOrderListarrayTakLista podporządkowań

Pola w subOrderList[] są w większości takie same jak porządki normalne i porządki warunkowe, z dodatkowymi polami zależności:

ParametrTypOpis
strategySubIdint64ID podrzędu
firstDrivenIdint64Pierwszy identyfikator z rozkazu jazdy. 0 oznacza brak zależności
firstDrivenOnstringPierwszy warunek wyzwalacza
firstTriggerstringPierwszy ruch spustu
secondDrivenIdint64Drugi identyfikator nakazu jazdy
secondDrivenOnstringDrugi warunek wyzwalacza
secondTriggerstringDruga akcja spustu

Pola odpowiedzi:

PoleTypOpis
strategyIdstringID strategii
strategyStatusstringStatus strategii
timestampint64Znacznik czasu

Zapytanie o pojedynczy rząd

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringTakSymbol
orderIdstringNieID zamówienia serwera
clientOrderIdstringNieIdentyfikator zamówienia definiowany przez klienta

Należy podać co najmniej jeden z orderId i clientOrderId . Jeśli oba są dostępne, serwer wykonuje dokładne dopasowanie pod obiema warunkami.

Obecne rozkazy normalne

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringNieSymbol
limitint32NieLimit liczby zwrotów
lastOrderIdint64NiePole kursora

Pola odpowiedzi:

PoleTypOpis
list[]arrayAktualna lista kolejności normalnej
totalint32Hrabia

Rozkazy dotyczące obecnego stanu

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringNieSymbol

Historyczne Porządki Normalne

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringNieSymbol
orderIdstringNieFiltr ID dokładnego porządku
clientOrderIdstringNieDokładny filtr ID zamówienia klienta
typeint32NieFiltr typu zamówienia: 1 limit, 2 rynek
sideint32NieFiltr boczny: 1 kupować, 2 sprzedawać
statusint32NieFiltr statusu
startTimeint64NieCzas rozpoczęcia
endTimeint64NieKoniec czasu
pageint64NieNumer strony, domyślny 1
pageSizeint64NieLiczba elementów na stronę, domyślny 20

Ordery stanu historycznego

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringNieSymbol
sideint32NieFiltr boczny: 1 kupować, 2 sprzedawać
statusint32NieFiltr statusu
startTimeint64NieCzas rozpoczęcia
endTimeint64NieKoniec czasu
pageint64NieNumer strony, domyślny 1
pageSizeint64NieLiczba elementów na stronę, domyślny 20

Rekordy handlowe

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringNieSymbol
orderIdstringNieFiltr ID zamówienia
startTimeint64NieCzas rozpoczęcia
endTimeint64NieKoniec czasu
pageint64NieNumer strony, domyślny 1
pageSizeint64NieLiczba elementów na stronę, domyślny 20

Pola odpowiedzi:

PoleTypOpis
list[].fillIdstringIdentyfikator szczegółów wypełniania
list[].tradeIdstringIdentyfikacja rekordu handlowego
list[].orderIdstringID zamówienia
list[].symbolstringSymbol
list[].sidestringStrona
list[].roleTypestringmaker / taker
list[].pricestringCena wypełniona
list[].quantitystringWypełniona ilość
list[].tradeValuestringWartość handlowa
list[].handlingFeestringOpłata za obsługę
list[].realizedPnlstringZrealizowane PnL
list[].positionSidestringStrona pozycyjna
list[].createdAtint64Czas wymiany
totalint64Łączna liczba

Anuluj zamówienie

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

Ciało prośby:

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

clientOrderId można również użyć do anulowania zamówienia.

Rozporządzenie Zmiany

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

Ciało prośby:

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

quantity to ostateczna całkowita ilość zamówienia po zmianie, a nie pozostała ilość.

Rozkazy zmian w partiach

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

Ciało prośby:

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

Zamówienia na anulowanie wsad

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

Ciało prośby:

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

Anuluj wszystko

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringNieSymbol
cancelTypeint32Nie0 wszystkie normalne rozkazy, 1 tylko limit, 2 wszystkie porządki warunkowe. Domyślne 0

Anulowanie wszystkich dla zwykłych zamówień jest akceptowane asynchronicznie. Ostateczny status powinien być określany przez WebSocket ORDER_TRADE_UPDATE lub punkty końcowe zapytania.

Zamówienie warunkowe anulowania

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

Ciało prośby:

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

Szczegóły kolejności strategii

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

Pola odpowiedzi:

PoleTypOpis
strategyIdstringID strategii
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Czas tworzenia
subOrders[]arraySzczegóły podrzędów
updateTimeint64Czas aktualizacji