Zamówienie

Zobacz jako Markdown

Uwaga

Endpointy Order wymagają zgody na handel.

Kolejność miejsc

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

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}

Pola odpowiedzi:

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

Zamówienia na składanie partii

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

Ciało prośby:

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}

Pola odpowiedzi:

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

Kolejność warunków miejsca

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

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

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

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

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

Parametry żądania:

ParametrTypWymaganeOpis
symbolstringNieSymbol

Historyczne Porządki Normalne

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

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

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

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

Ciało prośby:

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

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

Rozporządzenie Zmiany

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

Ciało prośby:

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

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

Rozkazy zmian w partiach

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

Ciało prośby:

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

Zamówienia na anulowanie wsad

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

Ciało prośby:

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

Anuluj wszystko

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

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

Ciało prośby:

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

Szczegóły kolejności strategii

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