Παραγγελία

Προβολή ως Markdown

Σημείωση

Τα τελικά σημεία παραγγελίας απαιτούν άδεια συναλλαγής.

Παραγγέλνω

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΝαιΣύμβολο
typestringΝαιLIMIT / MARKET
sidestringΝαιBUY / SELL
positionSidestringΌχιBOTH / LONG / SHORT, προεπιλογή BOTH
pricestringΑπαιτείται υπό όρουςΑπαιτείται για οριακές εντολές
quantitystringΑπαιτείται υπό όρουςΠοσότητα. Μπορεί να παραλειφθεί όταν closePosition=true
timeInForcestringΌχιGTC / IOC / FOK, προεπιλογή GTC
reduceOnlyboolΌχιΜόνο σμίκρυνση, προεπιλεγμένη false
makerOnlyboolΌχιΜόνο για δημιουργό, προεπιλεγμένη false
closePositionboolΌχιΚλείστε ολόκληρη τη θέση, προεπιλογή false
clientOrderIdstringΌχιΑναγνωριστικός κωδικός παραγγελίας που ορίζεται από τον πελάτη
placeTypestringΌχιΔείκτης τύπου τοποθέτησης παραγγελίας
priceTypeint32ΌχιBBO τύπος τιμής: 0 καθορισμένη τιμή, 1 τιμή αντιπάλου 1, 2 τιμή αντιπάλου 5, 3 τιμή ίδιας πλευράς 1 4 τιμή ίδιας πλευράς 5

Παράδειγμα αιτήματος:

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}

Πεδία απόκρισης:

ΠεδίοΤύποςΠεριγραφή
orderIdstringΑναγνωριστικό παραγγελίας διακομιστή
clientOrderIdstringΑναγνωριστικός κωδικός παραγγελίας που ορίζεται από τον πελάτη
statusstringΚατάσταση παραγγελίας
timestampint64Χρονική σήμανση

Παραγγελίες παρτίδας

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

Σώμα αιτήματος:

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}

Πεδία απόκρισης:

ΠεδίοΤύποςΠεριγραφή
successCountint32Αριθμός επιτυχημένων παραγγελιών
failedCountint32Αριθμός παραγγελιών που απορρίφθηκαν
results[]arrayΑποτέλεσμα για κάθε παραγγελία

Παραγγελία κατάστασης

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΝαιΣύμβολο
typestringΝαιSTOP_MARKET / TAKE_PROFIT_MARKET / STOP_LIMIT / TAKE_PROFIT_LIMIT / TRAILING_STOP
sidestringΝαιBUY / SELL
positionSidestringΌχιBOTH / LONG / SHORT
pricestringΑπαιτείται υπό όρουςΑπαιτείται για STOP_LIMIT / TAKE_PROFIT_LIMIT
quantitystringΑπαιτείται υπό όρουςΠοσότητα. Μπορεί να παραλειφθεί όταν closePosition=true
timeInForcestringΌχιGTC / IOC / FOK / GTE_GTC
reduceOnlyboolΌχιΜόνο μείωση
clientOrderIdstringΌχιΑναγνωριστικός κωδικός παραγγελίας που ορίζεται από τον πελάτη
stopPricestringΑπαιτείται υπό όρουςΤιμή ενεργοποίησης
workingTypestringΌχιMARK_PRICE / CONTRACT_PRICE, προεπιλογή CONTRACT_PRICE
priceProtectboolΌχιΕάν είναι ενεργοποιημένη η προστασία των τιμών
activatePricestringΑπαιτείται υπό όρουςΤιμή ενεργοποίησης κυλιόμενης εντολής
callbackRatestringΑπαιτείται υπό όρουςΠοσοστό επανάκλησης κυλιόμενης παραγγελίας
closePositionboolΌχιΚλείστε ολόκληρη τη θέση

Πεδία απόκρισης:

ΠεδίοΤύποςΠεριγραφή
conditionIdstringΑναγνωριστικό παραγγελίας κατάστασης
conditionStatusstringΚατάσταση παραγγελίας κατάστασης
timestampint64Χρονική σήμανση

Παραγγελία στρατηγικής

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
strategyTypestringΝαιOTOCO / OTO / OCO
subOrderListarrayΝαιΛίστα υποπαραγγελιών

Τα πεδία στο subOrderList[] είναι ως επί το πλείστον τα ίδια με τις κανονικές εντολές και τις εντολές συνθηκών, με πρόσθετα πεδία εξάρτησης:

ΠαράμετροςΤύποςΠεριγραφή
strategySubIdint64Αναγνωριστικό δευτερεύουσας παραγγελίας
firstDrivenIdint64Αναγνωριστικό πρώτης εντολής οδήγησης. 0 σημαίνει ότι δεν υπάρχει εξάρτηση
firstDrivenOnstringΣυνθήκη πρώτης σκανδάλης
firstTriggerstringΕνέργεια πρώτης σκανδάλης
secondDrivenIdint64Δεύτερο αναγνωριστικό εντολής οδήγησης
secondDrivenOnstringΔεύτερη συνθήκη ενεργοποίησης
secondTriggerstringΔεύτερη ενέργεια σκανδάλης

Πεδία απόκρισης:

ΠεδίοΤύποςΠεριγραφή
strategyIdstringΑναγνωριστικό στρατηγικής
strategyStatusstringΚατάσταση στρατηγικής
timestampint64Χρονική σήμανση

Ερώτημα μεμονωμένης παραγγελίας

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΝαιΣύμβολο
orderIdstringΌχιΑναγνωριστικό παραγγελίας διακομιστή
clientOrderIdstringΌχιΑναγνωριστικός κωδικός παραγγελίας που ορίζεται από τον πελάτη

Πρέπει να παρέχεται τουλάχιστον ένα από orderId και clientOrderId . Εάν παρέχονται και τα δύο, ο διακομιστής εκτελεί ακριβή αντιστοίχιση και στις δύο συνθήκες.

Τρέχουσες κανονικές παραγγελίες

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΌχιΣύμβολο
limitint32ΌχιΌριο αριθμού επιστροφών
lastOrderIdint64ΌχιΠεδίο δρομέα

Πεδία απόκρισης:

ΠεδίοΤύποςΠεριγραφή
list[]arrayΤρέχουσα κανονική λίστα παραγγελιών
totalint32Καταμέτρηση

Παραγγελίες Τρέχουσας Κατάστασης

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΌχιΣύμβολο

Ιστορικές Κανονικές Τάξεις

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΌχιΣύμβολο
orderIdstringΌχιΦίλτρο ακριβούς αναγνωριστικού παραγγελίας
clientOrderIdstringΌχιΦίλτρο ακριβούς αναγνωριστικού παραγγελίας πελάτη
typeint32ΌχιΦίλτρο τύπου παραγγελίας: 1 όριο, 2 αγορά
sideint32ΌχιΠλαϊνό φίλτρο: 1 αγορά, 2 πώληση
statusint32ΌχιΦίλτρο κατάστασης
startTimeint64ΌχιΏρα έναρξης
endTimeint64ΌχιΏρα λήξης
pageint64ΌχιΑριθμός σελίδας, προεπιλεγμένη 1
pageSizeint64ΌχιΣτοιχεία ανά σελίδα, προεπιλεγμένη 20

Εντολές ιστορικής κατάστασης

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΌχιΣύμβολο
sideint32ΌχιΠλαϊνό φίλτρο: 1 αγορά, 2 πώληση
statusint32ΌχιΦίλτρο κατάστασης
startTimeint64ΌχιΏρα έναρξης
endTimeint64ΌχιΏρα λήξης
pageint64ΌχιΑριθμός σελίδας, προεπιλεγμένη 1
pageSizeint64ΌχιΣτοιχεία ανά σελίδα, προεπιλεγμένη 20

Εμπορικά αρχεία

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΌχιΣύμβολο
orderIdstringΌχιΦίλτρο αναγνωριστικού παραγγελίας
startTimeint64ΌχιΏρα έναρξης
endTimeint64ΌχιΏρα λήξης
pageint64ΌχιΑριθμός σελίδας, προεπιλεγμένη 1
pageSizeint64ΌχιΣτοιχεία ανά σελίδα, προεπιλεγμένη 20

Πεδία απόκρισης:

ΠεδίοΤύποςΠεριγραφή
list[].fillIdstringΣυμπληρώστε το αναγνωριστικό λεπτομερειών
list[].tradeIdstringΑναγνωριστικός κωδικός εμπορικού μητρώου
list[].orderIdstringΚωδικός παραγγελίας
list[].symbolstringΣύμβολο
list[].sidestringΠλευρά
list[].roleTypestringmaker / taker
list[].pricestringΣυμπληρωμένη τιμή
list[].quantitystringΓεμισμένη ποσότητα
list[].tradeValuestringΕμπορική αξία
list[].handlingFeestringΑμοιβή διεκπεραίωσης
list[].realizedPnlstringΠραγματοποιημένο PnL
list[].positionSidestringΠλευρική θέση
list[].createdAtint64Χρόνος συναλλαγών
totalint64Συνολικός αριθμός

Ακύρωση παραγγελίας

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

Σώμα αιτήματος:

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

clientOrderId μπορούν επίσης να χρησιμοποιηθούν για την ακύρωση μιας παραγγελίας.

Τροποποίηση Διατάγματος

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

Σώμα αιτήματος:

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

quantity είναι η τελική συνολική ποσότητα παραγγελίας μετά την τροποποίηση, όχι η υπόλοιπη ποσότητα.

Παραγγελίες Τροποποίησης Παρτίδας

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

Σώμα αιτήματος:

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

Μαζική ακύρωση παραγγελιών

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

Σώμα αιτήματος:

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

Ακύρωση όλων

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

Παράμετροι αιτήματος:

ΠαράμετροςΤύποςΑπαιτείταιΠεριγραφή
symbolstringΌχιΣύμβολο
cancelTypeint32Όχι0 όλες τις κανονικές εντολές, 1 μόνο τις οριακές εντολές 2 όλες τις εντολές κατάστασης. Προεπιλεγμένη 0

Η ακύρωση όλων για κανονικές παραγγελίες γίνεται αποδεκτή ασύγχρονα. Η τελική κατάσταση θα πρέπει να καθορίζεται από τα τελικά σημεία WebSocket ORDER_TRADE_UPDATE ή ερωτήματος.

Ακύρωση παραγγελίας κατάστασης

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

Σώμα αιτήματος:

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

Λεπτομέρεια παραγγελίας στρατηγικής

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

Πεδία απόκρισης:

ΠεδίοΤύποςΠεριγραφή
strategyIdstringΑναγνωριστικό στρατηγικής
strategyTypestringOTOCO / OTO / OCO
strategyStatusstringWORKING / ALL_DONE / CANCELLED
bookTimeint64Χρόνος δημιουργίας
subOrders[]arrayΛεπτομέρειες δευτερεύουσας παραγγελίας
updateTimeint64Χρόνος ενημέρωσης