Ordre

Afficher en Markdown

Note

les terminaux d’ordre nécessitent une autorisation commerciale.

Ordre des places

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringOuiSymbole
typestringOuiLIMIT / MARKET
sidestringOuiBUY / SELL
positionSidestringNonBOTH / LONG / SHORT, BOTH par défaut
pricestringConditionnellement requisObligatoire pour les ordonnances à limite
quantitystringConditionnellement requisQuantité. Peut être omis quand closePosition=true
timeInForcestringNonGTC / IOC / FOK, GTC par défaut
reduceOnlyboolNonRéduction uniquement, false par défaut
makerOnlyboolNonFabricant uniquement, false par défaut
closePositionboolNonFermez toute la position, par défaut false
clientOrderIdstringNonID d’ordre défini par le client
placeTypestringNonMarqueur de type de placement de commande
priceTypeint32NonBBO type de prix : 0 prix spécifié, 1 prix de l’adversaire 1, 2 prix de l’adversaire 5, 3 prix du même côté 1, 4 prix du même côté 5

Demande d’exemple :

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}

Champs de réponse :

TerrainTypeDescription
orderIdstringID d’ordre serveur
clientOrderIdstringID d’ordre défini par le client
statusstringStatut de l’ordre
timestampint64Horodatage

Commandes par lots

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

Demande de corps :

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}

Champs de réponse :

TerrainTypeDescription
successCountint32Nombre d’ordres réussis
failedCountint32Nombre d’ordres non validés
results[]arrayRésultat pour chaque ordre

Ordre de la condition de lieu

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringOuiSymbole
typestringOuiSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringOuiBUY / SELL
positionSidestringNonBOTH / LONG / SHORT
pricestringConditionnellement requisObligatoire pour STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringConditionnellement requisQuantité. Peut être omis quand closePosition=true
timeInForcestringNonGTC / IOC / FOK / GTE_GTC
reduceOnlyboolNonRéduction uniquement
clientOrderIdstringNonID d’ordre défini par le client
stopPricestringConditionnellement requisPrix déclencheur
workingTypestringNonMARK_PRICE / CONTRACT_PRICE, CONTRACT_PRICE par défaut
priceProtectboolNonOu non la protection des prix est activée
activatePricestringConditionnellement requisTaux d’activation des ordres de fin
callbackRatestringConditionnellement requisTaux de rappel des ordres de fin
closePositionboolNonFermez toute la position

Champs de réponse :

TerrainTypeDescription
conditionIdstringID d’ordre de condition
conditionStatusstringÉtat de l’ordre de condition
timestampint64Horodatage

Place Stratégie Ordre

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
strategyTypestringOuiOTOCO / OTO / OCO
subOrderListarrayOuiListe des sous-ordres

Les champs dans subOrderList[] sont pour la plupart identiques aux ordres normaux et ordres de condition, avec des champs de dépendance supplémentaires :

ParamètreTypeDescription
strategySubIdint64ID de sous-ordre
firstDrivenIdint64Premier code d’identification de l’ordre de circulation. 0 signifie pas de dépendance
firstDrivenOnstringPremière condition déclenchante
firstTriggerstringPremière action de déclenchement
secondDrivenIdint64Deuxième identification de l’ordre de conduite
secondDrivenOnstringDeuxième condition déclencheuse
secondTriggerstringSeconde action de déclenchement

Champs de réponse :

TerrainTypeDescription
strategyIdstringID de stratégie
strategyStatusstringStatut de la stratégie
timestampint64Horodatage

Requête en ordre unique

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringOuiSymbole
orderIdstringNonID d’ordre serveur
clientOrderIdstringNonID d’ordre défini par le client

Au moins un des orderId et clientOrderId doit être fourni. Si les deux sont fournis, le serveur effectue une correspondance exacte sur les deux conditions.

Ordres normaux actuels

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringNonSymbole
limitint32NonLimite de rendement
lastOrderIdint64NonChamp de curseur

Champs de réponse :

TerrainTypeDescription
list[]arrayListe actuelle des ordres des normales
totalint32Comte

Ordres d’état actuel

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringNonSymbole

Ordres Normaux Historiques

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringNonSymbole
orderIdstringNonFiltre d’ID d’ordre exact
clientOrderIdstringNonFiltre exact de l’ID de commande client
typeint32NonType de commande filtre : 1 limite, 2 marché
sideint32NonFiltre latéral : 1 acheter, 2 vendre
statusint32NonFiltre d’état
startTimeint64NonHeure de début
endTimeint64NonFin des temps
pageint64NonNuméro de page, 1 par défaut
pageSizeint64NonÉléments par page, 20 par défaut

Ordonnances d’état historique

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringNonSymbole
sideint32NonFiltre latéral : 1 acheter, 2 vendre
statusint32NonFiltre d’état
startTimeint64NonHeure de début
endTimeint64NonFin des temps
pageint64NonNuméro de page, 1 par défaut
pageSizeint64NonÉléments par page, 20 par défaut

Records d’échanges

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringNonSymbole
orderIdstringNonFiltre d’ID d’ordre
startTimeint64NonHeure de début
endTimeint64NonFin des temps
pageint64NonNuméro de page, 1 par défaut
pageSizeint64NonÉléments par page, 20 par défaut

Champs de réponse :

TerrainTypeDescription
list[].fillIdstringID de détail de remplissage
list[].tradeIdstringIdentification du record commercial
list[].orderIdstringIdentifiant de l’ordre
list[].symbolstringSymbole
list[].sidestringCôté
list[].roleTypestringmaker / taker
list[].pricestringPrix rempli
list[].quantitystringQuantité remplie
list[].tradeValuestringValeur commerciale
list[].handlingFeestringFrais de manipulation
list[].realizedPnlstringPnL réalisé
list[].positionSidestringCôté position
list[].createdAtint64Heure des échanges
totalint64Comptage total

Annulation de la commande

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

Demande de corps :

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

clientOrderId peut aussi être utilisé pour annuler une commande.

Ordonnance de modification

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

Demande de corps :

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

quantity est la quantité totale finale de commande après modification, et non la quantité restante.

Ordres de modification de lots

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

Demande de corps :

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

Annulation des commandes par lots

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

Demande de corps :

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

Annuler tout

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

Paramètres de demande :

ParamètreTypeObligatoireDescription
symbolstringNonSymbole
cancelTypeint32Non0 tous les ordres normaux, 1 uniquement les ordres limites, 2 tous les ordres de condition. Par défaut 0

L’annulation totale pour les ordres normaux est acceptée de manière asynchrone. Le statut final doit être déterminé par WebSocket ORDER_TRADE_UPDATE ou par les points de terminaison de requête.

Annuler l’ordre de condition

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

Demande de corps :

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

Détails de l’ordre de stratégie

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

Champs de réponse :

TerrainTypeDescription
strategyIdstringID de stratégie
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Temps de création
subOrders[]arrayDétails des sous-ordres
updateTimeint64Temps de mise à jour