الأمر

View as 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[].realizedPnlstringPnL المحقق
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وقت التحديث