واجهة برمجة تطبيق منصة خيارات Binance و WebSocket

تداول عقود خيارات Binance (بينانس) متاح من خلال مجموعة أدوات الاتصال في واجهة برمجة تطبيق منصة عقود Binance الآجلة وهو متاح للمستخدمين الذين مكَّنوا واجهة التداول بواجهة برمجة تطبيق Binance (بينانس).

1. نقاط نهاية بيانات السوق

سيتيح رابط Github لكل طلب الوصول إلى أوزان نقاط النهاية المتوافقة ومتغيراتها واستجاباتها.

الطلب	الوصف	نقاط النهاية والتفاصيل
اختبار الاتصال	اختبار اتصال واجهة برمجة التطبيق المصممة بنمط نقل الحالة التمثيلية (REST API)	GET /eapi/v1/ping
التحقق من توقيت الخادم	اختبار الاتصال بواجهة برمجة التطبيق المصممة بنمط نقل الحالة التمثيلية والحصول على توقيت الخادم الحالي	GET /eapi/v1/time
المعلومات الخاصة بمنصة التداول	قواعد التداول الحالية للمنصة ومعلومات عن الرموز	GET /eapi/v1/exchangeInfo
قائمة الطلب	الحصول على بيانات قائمة الطلب	GET /eapi/v1/depth
قائمة أحدث التداولات	الحصول على أحدث تداولات السوق	GET /eapi/v1/trades
البحث عن التداولات القديمة (بيانات_السوق)	الحصول على سِجِل تداولات السوق القديمة	GET /eapi/v1/historicalTrades
بيانات خط K/مخطط حركة الأسعار	شرائط خط K/مخطط حركة الأسعار الخاصة برمز الخيار. تُعرَف خطوط K على نحوٍ فريد حسب وقت افتتاح كلٍّ منها	GET /eapi/v1/klines
السعر العادل للخيارات	معلومات عن السعر العادل والمقاييس اليونانية للخيارات	GET /eapi/v1/mark
إحصاءات تغير أسعار رموز التداول على مدار 24 ساعة	إحصاءات تغير أسعار النافذة المتجددة على مدار 24 ساعة	GET /eapi/v1/ticker
رمز تداول أسعار الرموز	الحصول على سعر المؤشر الفوري للأصل الأساسي للخيار	GET /eapi/v1/index
سِجِلات التنفيذ التاريخية	الحصول على سِجِلات التنفيذ التاريخية	GET /eapi/v1/exerciseHistory
الفائدة المفتوحة	الحصول على الفائدة المفتوحة لأحد الأصول الأساسية في تاريخ انتهاء صلاحية محدد	GET /eapi/v1/openInterest

2. نقاط نهاية الحساب/التداولات

سيتيح رابط Github لكل طلب الوصول إلى أوزان نقاط النهاية المتوافقة ومتغيراتها واستجاباتها.

الطلب	الوصف	نقاط النهاية والتفاصيل
معلومات حساب الخيارات (تداول)	الحصول على معلومات الحساب الحالية	GET /eapi/v1/account (HMAC SHA256)
تحويل الأموال (تداول)	عرض المزيد من التفاصيل من هنا
طلب جديد (تداول)	إرسال طلب جديد	POST /eapi/v1/order (HMAC SHA256)
تقديم عدة طلبات (تداول)	إرسال عدة طلبات خيارات	POST /eapi/v1/batchOrders (HMAC SHA256)
استعلام عن طلب واحد (تداول)	التحقق من حالة طلب	GET /eapi/v1/order (HMAC SHA256)
إلغاء طلب الخيارات (تداول)	إلغاء طلب نشط	DELETE /eapi/v1/order (HMAC SHA256)
إلغاء عدة طلبات خيارات (تداول)	إلغاء عدة طلبات نشطة	DELETE /eapi/v1/batchOrders (HMAC SHA256)
إلغاء جميع طلبات الخيارات لرمزٍ محدد (تداول)	إلغاء جميع الطلبات النشطة لأحد الرموز	DELETE /eapi/v1/allOpenOrders (HMAC SHA256)
إلغاء جميع طلبات الخيارات بالأصل الأساسي (تداول)	إلغاء جميع الطلبات النشطة لأصلٍ أساسي محدد	DELETE /eapi/v1/allOpenOrdersByUnderlying (HMAC SHA256)
الاستعلام عن طلبات الخيارات المفتوحة الحالية (USER_DATA)	الاستعلام عن جميع الطلبات المفتوحة: الحالة: مقبولة منفذة_جزئيًّا	GET /eapi/v1/openOrders (HMAC SHA256)
الاستعلام عن سِجِل طلبات الخيارات (تداول)	الاستعلام عن جميع الطلبات المنتهية خلال 5 أيام. حالة الطلب: مُلغى، منفَّذ، مرفوض	GET /eapi/v1/historyOrders (HMAC SHA256)
معلومات صفقات الخيارات (بيانات_المستخدم)	الحصول على معلومات الصفقة الحالية	GET /eapi/v1/position (HMAC SHA256)
قائمة تداولات الحساب (بيانات_المستخدم)	الحصول على التداولات الخاصة بحسابٍ ورمزٍ محددين	GET /eapi/v1/userTrades (HMAC SHA256)
سِجِل تنفيذ المستخدم (بيانات_المستخدم)	الحصول على سِجِلات تنفيذ الحساب	GET /eapi/v1/exerciseRecord (HMAC SHA256)
تدفق الأموال للحساب (بيانات_المستخدم)	الاستعلام عن التدفقات المالية للحساب	GET /eapi/v1/bill (HMAC SHA256)

3. قنوات بث السوق من WebSocket

يمكنك الاشتراك في أي من قنوات البث المدرجة أدناه أو إلغاء الاشتراك فيها باستخدام الطلبات المدرجة في قسم WebSocket.

البث	اسم البث	الوصف	سرعة التحديث
بث التداولات	<symbol>@trade أو <underlyingAsset>@trade	ترسل قنوات بث التداولات معلومات أولية عن تداولات رمزٍ محدد أو أصلٍ أساسي. مثل: ETH@trade	50 ملي ثانية
بث المؤشر	<symbol>@index	بث المؤشر الأساسي (مثل: ETHUSDT)	1,000 ملي ثانية
السعر العادل	<underlyingAsset>@markPrice	السعر العادل لجميع رموز الخيارات الخاصة بأصلٍ أساسي محدد. مثل: ETH@markPrice	1,000 ملي ثانية
قنوات بث خط K/مخطط حركة الأسعار	<symbol>@kline_<interval>	ترسل قناة بث خط K/مخطط حركة الأسعار تحديثات لخط K/مخطط حركة الأسعار الحالي كل 1,000 ملي ثانية (إن وجدت)	1,000 ملي ثانية
شريط أخبار رموز التداول على مدار 24 ساعة	<symbol>@ticker	شريط أخبار رموز التداول على مدار 24 ساعة لكل الرموز. لن تُرسل سوى أخبار الرموز التي تغيرت معلومات رموز تداولها	1,000 ملي ثانية
شريط أخبار رموز التداول على مدار 24 ساعة حسب الأصل الأساسي وتاريخ انتهاء الصلاحية	<underlyingAsset>@ticker@<expirationDate>	شريط معلومات رموز التداول على مدار 24 ساعة حسب الأصل الأساسي وتاريخ انتهاء الصلاحية. مثل: ETH@ticker@220930	1,000 ملي ثانية
الفائدة المفتوحة	<underlyingAsset>@openInterest@<expirationDate>	الفائدة المفتوحة لعقود الخيارات لأحد الأصول الأساسية في تاريخ انتهاء صلاحية محدد مثل: ETH@openInterest@221125	60 ثانية
معلومات الرموز الجديدة	option_pair	بث إدراج الرموز الجديدة	50 ملي ثانية
قنوات بث مخطط الطلبات الجزئي	<symbol>@depth<levels> أو <symbol>@depth<levels>@100ms أو <symbol>@depth<levels>@1000ms	أفضل العروض والطلبات. المستويات المتاحة هي 10 و 20 و 50 و 100	100 ملي ثانية، أو 500 ملي ثانية، أو 1000 ملي ثانية (الوضع الافتراضي في حالة عدم استخدام سرعة التحديث)
قنوات بث مخططات طلبات مختلفة	<symbol>@depth1000	عند ضبط مستوى عمق مخططات الطلبات على 1,000، يُرسل البث بيانات مختلفة عن مخطط الطلبات كل 50 ثانية. يرجى اتباع التعليمات اللاحقة بشأن كيفية إدارة قائمة طلبات محلية على شكلٍ صحيح	50 ملي ثانية

4. قنوات بث بيانات المستخدم من WebSocket

يمكنك الوصول إلى قنوات بث بيانات المستخدم من خلال مفتاح listenKey. يرجى الرجوع إلى قسم قنوات بث بيانات المستخدم من WeSocket.

الحدث	نوع الحدث	الوصف	سرعة التحديث
بيانات الحساب	تحديث الحساب	التحديث في الظروف التالية: الإيداع في الحساب أو السحب منه تغيير معلومات الصفقة. تتضمن السمة P إذا كانت هناك تغييرات، وفيما عدا ذلك لا تتضمن السمة P. تحديث المقاييس اليونانية	50 ملي ثانية
تحديث الطلب	تحديث تداول الطلب	التحديث في الظروف التالية: تنفيذ الطلبات تقديم الطلب إلغاء الطلب	50 ملي ثانية

5. نقاط نهاية صُنَّاع السوق

نقاط نهاية واجهة برمجة التطبيق التالية غير متاحة إلا لصُنَّاع السوق. سيتيح رابط Github لكل طلب الوصول إلى أوزان نقاط النهاية المتوافقة ومتغيراتها واستجاباتها.

الطلب	الوصف	نقاط النهاية والتفاصيل
معلومات حساب التداول الاقتراضي للخيارات (بيانات المستخدم)	الحصول على معلومات الحساب الحالية	GET /eapi/v1/marginAccount (HMAC SHA256)
ضبط إعدادات حماية صانع السوق (تداول)	ضبط إعدادات حماية صانع السوق. حماية صانع السوق (MMP) هي مجموعة من آليات الحماية لصُنَّاع سوق الخيارات. يمكن لهذه الآلية منع التداول الضخم خلال فترة قصيرة. عندما يتجاوز حساب صانع السوق الحدّ، ستُفعَّل آلية حماية صانع السوق. ستُلغى جميع طلبات حماية صانع السوق الحالية وستُرفض جميع طلبات حماية صانع السوق الجديدة. يمكن لصُنَّاع السوق استغلال هذا الفراغ لإعادة تقييم السوق وتعديل أسعار الطلبات.	POST /eapi/v1/mmpSet (HMAC SHA256)
الحصول على إعدادات حماية صانع السوق (تداول)	الحصول على إعدادات حماية صانع السوق	Get /eapi/v1/mmp (HMAC SHA256)
إعادة ضبط إعدادات حماية صانع السوق (تداول)	إعادة ضبط حماية صانع السوق وبدء طلبات حماية صانع السوق مرة أخرى	POST /eapi/v1/mmpReset (HMAC SHA256)
ضبط إعدادات الإلغاء التلقائي لجميع الطلبات المفتوحة (مفتاح الإنهاء) (تداول)	تحدد نقطة النهاية هذه متغيرات خاصية الإلغاء التلقائي. إذا لم تُرسَل أي إشارات تفاعل، ستلغي جميع الطلبات المفتوحة (طلبات حماية صانع السوق وغيرها من الطلبات) الخاصة بالرمز الأساسي في نهاية مدة العد التنازلي المحددة. بعد مدة العد التنازلي، ستُلغى جميع الطلبات المفتوحة. ستُرفَض جميع الطلبات الجديدة برمز خطأ -2010 حتى إرسال إشارة تفاعل أو إيقاف خاصية الإلغاء التلقائي بضبط توقيت العد التنازلي على 0.	POST /eapi/v1/countdownCancelAll (HMAC SHA256)
الحصول على إعدادات الإلغاء التلقائي لجميع الطلبات المفتوحة (مفتاح الإنهاء) (تداول)	تردّ نقطة النهاية هذه متغيرات الإلغاء التلقائي لكل رمز أساسي. يرجى العلم أنه لن يُرد سوى متغيرات الإلغاء التلقائي النشطة فقط. إذا تم ضبط توقيت العد التنازلي على 0 (أي تم إيقاف العد التنازلي)، فلن تكون الاستجابة برد الرمز الأساسي ولن يُرد متغير توقيت العد التنازلي المتوافق.	GET /eapi/v1/countdownCancelAll (HMAC SHA256)
إشارة تفاعل الإلغاء التلقائي لجميع الطلبات المفتوحة (مفتاح الإنهاء) (تداول)	تعيد نقطة النهاية هذه ضبط الوقت الذي سيبدأ منه العد التنازلي ليكون وقت استلام هذه الرسالة. ويجب أن يُستدعى بشكلٍ متكرر على هيئة إشارات تفاعل. يمكن تحديث عدة إشارات تفاعل في وقتٍ واحد بتحديد الرموز الأساسية لتشكِّل قائمةً (باستثناء BTCUSDT و ETHUSDT) بالمتغير الأساسي.	POST /eapi/v1/countdownCancelAllHeartBeat (HMAC SHA256)