Order

Als Markdown anzeigen

Anmerkung

Order-Endpunkte benötigen Handelsberechtigungen.

Platzanordnung

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

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

Antwortfelder:

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

ChargenOrders

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

Anfrage zum Inhalt:

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

Antwortfelder:

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

Platzzustandsreihenfolge

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

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

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

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol
limitint32NeinRücklauf-Zählbegrenzung
lastOrderIdint64NeinCursorfeld

Antwortfelder:

SpielfeldTypBeschreibung
list[]arrayAktuelle Normalordnungsliste
totalint32Graf

Befehle zum aktuellen Zustand

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

Anfrageparameter:

ParameterTypErforderlichBeschreibung
symbolstringNeinSymbol

Historische Normalordnungen

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

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

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

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

Anfrage zum Inhalt:

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

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

Änderungsanordnung

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

Anfrage zum Inhalt:

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

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

Chargenänderungsanordnungen

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

Anfrage zum Inhalt:

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

Orders in Chargen stornieren

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

Anfrage zum Inhalt:

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

Alle abbrechen

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

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

Anfrage zum Inhalt:

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

Details der Strategiereihenfolge

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

Antwortfelder:

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