Order

Als Markdown anzeigen

Anmerkung

Order-Endpunkte benötigen Handelsberechtigungen.

Platzanordnung

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringJaSymbol
typestringJaLIMIT / MARKET
sidestringJaBUY / SELL
positionSidestringNeinBOTH / LONG / SHORT, Standard BOTH
pricestringBedingt erforderlichErforderlich für Limit-Orders
quantitystringBedingt erforderlichQuantität. Kann ausgelassen werden, wenn closePosition=true
timeInForcestringNeinGTC / IOC / FOK, Standard GTC
reduceOnlyboolNeinNur reduzieren, Standard- false
makerOnlyboolNeinMaker-only, Standard- false
closePositionboolNeinSchließen Sie die gesamte Position, Standard false
clientOrderIdstringNeinClient-definierte Order-ID
placeTypestringNeinOrderplatzierungs-Typmarker
priceTypeint32NeinBBO Preistyp: 0 angegebener Preis, 1 Gegnerpreis 1, 2 Gegnerpreis 5, 3 gleichseitige Preis 1 4 gleichseitige Preis 5

Beispiel anfordern:

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}

Antwortfelder:

SpielfeldTypBeschreibung
orderIdstringServer-Order-ID
clientOrderIdstringClient-definierte Order-ID
statusstringStatus des Ordens
timestampint64Zeitstempel

ChargenOrders

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

Anfrage zum Inhalt:

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}

Antwortfelder:

SpielfeldTypBeschreibung
successCountint32Anzahl erfolgreicher Orders
failedCountint32Anzahl fehlgeschlagener Aufträge
results[]arrayErgebnis für jede Order

Platzzustandsreihenfolge

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringJaSymbol
typestringJaSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringJaBUY / SELL
positionSidestringNeinBOTH / LONG / SHORT
pricestringBedingt erforderlichErforderlich für STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringBedingt erforderlichQuantität. Kann ausgelassen werden, wenn closePosition=true
timeInForcestringNeinGTC / IOC / FOK / GTE_GTC
reduceOnlyboolNeinNur reduzieren
clientOrderIdstringNeinClient-definierte Order-ID
stopPricestringBedingt erforderlichAbzugspreis
workingTypestringNeinMARK_PRICE / CONTRACT_PRICE, Standard CONTRACT_PRICE
priceProtectboolNeinOb Preisschutz aktiviert ist
activatePricestringBedingt erforderlichNachlaufender Order-Aktivierungspreis
callbackRatestringBedingt erforderlichRückruf-Rate für nachfolgende Orders
closePositionboolNeinSchließen Sie die gesamte Position

Antwortfelder:

SpielfeldTypBeschreibung
conditionIdstringZustandsordnungs-ID
conditionStatusstringStatus der Zustandsordnung
timestampint64Zeitstempel

Platzierungsstrategie-Reihenfolge

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
strategyTypestringJaOTOCO / OTO / OCO
subOrderListarrayJaUnterordnungsliste

Felder in subOrderList[] sind größtenteils identisch mit Normalordnungen und Bedingungsordnungen, mit zusätzlichen Abhängigkeitsfeldern:

ParameterTypBeschreibung
strategySubIdint64Unterordnungs-ID
firstDrivenIdint64Erste Fahrbefehls-ID. 0 bedeutet keine Abhängigkeit
firstDrivenOnstringErste Auslöserbedingung
firstTriggerstringErste Abzugswirkung
secondDrivenIdint64Zweiter Fahrbefehls-ID
secondDrivenOnstringZweite Auslöserbedingung
secondTriggerstringZweite Abzugswirkung

Antwortfelder:

SpielfeldTypBeschreibung
strategyIdstringStrategie-ID
strategyStatusstringStrategiestatus
timestampint64Zeitstempel

Abfrage-Einzelordnung

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringJaSymbol
orderIdstringNeinServer-Order-ID
clientOrderIdstringNeinClient-definierte Order-ID

Mindestens eines von orderId und clientOrderId muss bereitgestellt werden. Wenn beide angegeben sind, führt der Server unter beiden Bedingungen eine exakte Übereinstimmung durch.

Aktuelle Normalordnungen

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol
limitint32NeinRücklauf-Zählbegrenzung
lastOrderIdint64NeinCursorfeld

Antwortfelder:

SpielfeldTypBeschreibung
list[]arrayAktuelle Normalordnungsliste
totalint32Graf

Befehle zum aktuellen Zustand

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol

Historische Normalordnungen

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol
orderIdstringNeinExakter Order-ID-Filter
clientOrderIdstringNeinExakter Client Order ID-Filter
typeint32NeinOrdertyp-Filter: 1 Grenze, 2 Markt
sideint32NeinSeitenfilter: 1 kaufen, 2 verkaufen
statusint32NeinStatusfilter
startTimeint64NeinStartzeit
endTimeint64NeinEndzeit
pageint64NeinSeitenzahl, Standard- 1
pageSizeint64NeinElemente pro Seite, Standard 20

Historische Zustandsordnungen

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol
sideint32NeinSeitenfilter: 1 kaufen, 2 verkaufen
statusint32NeinStatusfilter
startTimeint64NeinStartzeit
endTimeint64NeinEndzeit
pageint64NeinSeitenzahl, Standard- 1
pageSizeint64NeinElemente pro Seite, Standard 20

Handelsrekorde

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol
orderIdstringNeinOrder-ID-Filter
startTimeint64NeinStartzeit
endTimeint64NeinEndzeit
pageint64NeinSeitenzahl, Standard- 1
pageSizeint64NeinElemente pro Seite, Standard 20

Antwortfelder:

SpielfeldTypBeschreibung
list[].fillIdstringFülldetail-ID
list[].tradeIdstringHandelsdatensatz-ID
list[].orderIdstringOrder-ID
list[].symbolstringSymbol
list[].sidestringSeite
list[].roleTypestringmaker / taker
list[].pricestringGefüllter Preis
list[].quantitystringGefüllte Menge
list[].tradeValuestringHandelswert
list[].handlingFeestringBearbeitungsgebühr
list[].realizedPnlstringPnL realisiert
list[].positionSidestringPositionsseite
list[].createdAtint64Handelszeit
totalint64Gesamtanzahl

Order stornieren

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

Anfrage zum Inhalt:

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

clientOrderId kann auch verwendet werden, um eine Order zu stornieren.

Änderungsanordnung

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

Anfrage zum Inhalt:

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

quantity ist die endgültige GesamtOrdersmenge nach der Änderung, nicht die verbleibende Menge.

Chargenänderungsanordnungen

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

Anfrage zum Inhalt:

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

Orders in Chargen stornieren

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

Anfrage zum Inhalt:

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

Alle abbrechen

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol
cancelTypeint32Nein0 alle Normalbefehle, 1 nur Limitbefehle, 2 alle Bedingungsbefehle. Standard- 0

Stornieren-alle für normale Orders wird asynchron akzeptiert. Der Endstatus sollte durch WebSocket ORDER_TRADE_UPDATE - oder Abfrage-Endpunkte bestimmt werden.

Bedingungsbefehl abbrechen

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

Anfrage zum Inhalt:

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

Details der Strategiereihenfolge

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

Antwortfelder:

SpielfeldTypBeschreibung
strategyIdstringStrategie-ID
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Entstehungszeit
subOrders[]arrayDetails zur Unterordnung
updateTimeint64Aktualisierungszeit