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

2022-09-08

تداول عقود خيارات 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</symbol> أو <underlyingAsset>@trade</underlyingAsset>

ترسل قنوات بث التداولات معلومات أولية عن تداولات رمزٍ محدد أو أصلٍ أساسي. مثل: ETH@trade

50 ملي ثانية

بث المؤشر

<symbol>@index</symbol>

بث المؤشر الأساسي (مثل: ETHUSDT)

1,000 ملي ثانية

السعر العادل

<underlyingAsset>@markPrice</underlyingAsset>

السعر العادل لجميع رموز الخيارات الخاصة بأصلٍ أساسي محدد. مثل: ETH@markPrice

1,000 ملي ثانية

قنوات بث خط K/مخطط حركة الأسعار

<symbol>@kline_,<interval></interval></symbol>

ترسل قناة بث خط K/مخطط حركة الأسعار تحديثات لخط K/مخطط حركة الأسعار الحالي كل 1,000 ملي ثانية (إن وجدت)

1,000 ملي ثانية

شريط أخبار رموز التداول على مدار 24 ساعة

<symbol>@ticker</symbol>

شريط أخبار رموز التداول على مدار 24 ساعة لكل الرموز. لن تُرسل سوى أخبار الرموز التي تغيرت معلومات رموز تداولها

1,000 ملي ثانية

شريط أخبار رموز التداول على مدار 24 ساعة حسب الأصل الأساسي وتاريخ انتهاء الصلاحية

<underlyingAsset>@ticker@,<expirationDate></expirationDate></underlyingAsset>

شريط معلومات رموز التداول على مدار 24 ساعة حسب الأصل الأساسي وتاريخ انتهاء الصلاحية. مثل: ETH@ticker@220930

1,000 ملي ثانية

الفائدة المفتوحة

<underlyingAsset>@openInterest@,<expirationDate></expirationDate></underlyingAsset>

الفائدة المفتوحة لعقود الخيارات لأحد الأصول الأساسية في تاريخ انتهاء صلاحية محدد مثل: ETH@openInterest@221125

60 ثانية

معلومات الرموز الجديدة

option_pair

بث إدراج الرموز الجديدة

50 ملي ثانية  

قنوات بث مخطط الطلبات الجزئي

<symbol>@depth,<levels></levels></symbol> أو <symbol>@depth,<levels>@100ms أو ,<symbol>@depth,<levels>@1000ms</levels></symbol></levels></symbol>

أفضل العروض والطلبات. المستويات المتاحة هي 10 و 20 و 50 و 100

100 ملي ثانية، أو 500 ملي ثانية، أو 1000 ملي ثانية (الوضع الافتراضي في حالة عدم استخدام سرعة التحديث)

قنوات بث مخططات طلبات مختلفة

<symbol>@depth1000</symbol> 

عند ضبط مستوى عمق مخططات الطلبات على 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)

أنشِئ حسابًا الآن - احصل على ما يصل إلى 100 USDT من استرداد رسوم التداول (للمُستخدمين الموثّقين)