ما هي WEEX API؟ الميزات وأدوات التداول وكيفية عملها

WEEX API هي مجموعة من واجهات البرمجة التي تتيح للمطورين والمتداولين الكميين ربط تطبيقاتهم وأنظمة التداول الخاصة بهم بمنصة WEEX Exchange. وبدلاً من الاعتماد على الإجراءات اليدوية عبر واجهة التداول فقط، يمكن للمستخدمين استرجاع بيانات السوق وتنفيذ عمليات التداول المدعومة برمجياً.

تدعم API كلاً من التداول الفوري والعقود الآجلة USDT-M، وتوفر إمكانية الوصول عبر REST API وWebSocket. ويمكن للمطورين استرجاع الأسعار وبيانات الشموع وعمق دفتر الطلبات والتداولات الآنية، بينما تتيح الواجهات الموثّقة تنفيذ عمليات الحساب والتداول. 

وهذا يجعل WEEX API مفيدة لمجموعة متنوعة من مسارات عمل التداول، بدءاً من مراقبة الأسواق وتحليل البيانات وصولاً إلى إنشاء أنظمة تداول آلية. كما توفر WEEX أذونات API وواجهات للتداول التجريبي تتيح للمستخدمين التحكم في الوصول واختبار مسارات عمل تداول العقود الآجلة المدعومة من دون استخدام أصول حقيقية. 

ما هي WEEX API؟

WEEX API هي الواجهة التقنية التي تتيح للتطبيقات الخارجية التواصل مع وظائف WEEX Exchange المدعومة.

ومن خلال API، يستطيع المطورون طلب معلومات السوق والوصول إلى البيانات المتعلقة بالحساب وتنفيذ عمليات التداول المدعومة من دون الحاجة إلى إجراء كل خطوة يدوياً عبر واجهة المنصة.

توفر WEEX وظائف API عامة وأخرى موثّقة. ويمكن استخدام واجهات بيانات السوق العامة لاسترجاع معلومات عن الأسواق المدعومة، بينما تتطلب الوظائف الخاصة المصادقة وتُستخدم لعمليات الحساب والتداول. 

تغطي API حالياً التداول الفوري والعقود الآجلة USDT-M. وتحتفظ WEEX بوثائق مخصصة لمنتجات API المختلفة، مع صفحات لنقاط النهاية تتضمن معلمات الطلب وأمثلة على الاستجابات للمطورين. 

ما الذي يمكنك فعله باستخدام WEEX API؟

يمكن استخدام WEEX API لمراقبة السوق وتنفيذ عمليات التداول.

بالنسبة إلى بيانات السوق، تتيح WEEX الوصول إلى معلومات تشمل أسعار 24 ساعة، وتغيرات الأسعار، وحجم التداول، وبيانات الشموع، وعمق دفتر الطلبات، والتداولات الآنية. ويمكن للتطبيقات التي تراقب الأسواق استخدام مصادر البيانات هذه أو الاستفادة منها كمدخلات لأنظمة التداول. 

أما في التداول، فتتيح واجهات API الموثّقة للمستخدمين تنفيذ العمليات المدعومة برمجياً. ويمكن لأذونات Spot API أن تتيح للتطبيقات وضع طلبات التداول الفوري وإلغاءها، بينما يدعم إذن Futures عمليات العقود الآجلة، مثل فتح المراكز وإغلاقها وتحديد أوامر جني الأرباح ووقف الخسارة.

وهذا يعني أن المطور يستطيع إنشاء مسار عمل يتلقى فيه التطبيق معلومات السوق، ويعالجها وفقاً لمنطقه الخاص، ثم يستخدم الواجهة الموثّقة المناسبة لتنفيذ عمليات التداول المدعومة.

ولا توفر API الاستراتيجية نفسها. فهي تتيح الاتصال بين تطبيق المستخدم ووظائف WEEX المدعومة، بينما يحدد المستخدم القواعد والمنطق الذي يستخدمه النظام الخارجي.

ما أبرز ميزات WEEX API؟

من أبرز ميزات WEEX API دعمها لاتصالات REST API وWebSocket.

تناسب REST API طلب معلومات محددة أو إرسال تعليمات مدعومة بشكل منفرد. أما WebSocket فيحافظ على اتصال نشط ويمكنه تلقي المعلومات المحدّثة باستمرار، ما يجعله مفيداً لبيانات السوق وتحديثات دفتر الطلبات. وتوصي وثائق WEEX باستخدام WebSocket للحصول على معلومات السوق التي تتغير بوتيرة متكررة.

كما تغطي WEEX API التداول الفوري والعقود الآجلة USDT-M. وبذلك يستطيع المطورون العمل على بيانات السوق ووظائف التداول المدعومة ضمن هاتين الفئتين من المنتجات عبر موارد API المقابلة.

ومن الميزات المهمة أيضاً إمكانية الوصول إلى أنواع مختلفة من بيانات السوق. إذ يمكن للمطورين استرجاع بيانات الشموع لتحليل الأسعار، ومراقبة عمق عروض الشراء والبيع عبر دفتر الطلبات، ومتابعة التداولات الأخيرة، والوصول إلى معلومات السوق الحالية.

ولمستخدمي العقود الآجلة، توفر WEEX أيضاً نقاط نهاية رسمية للتداول التجريبي (Paper Trading). وتدعم هذه الواجهات أرصدة الحسابات الافتراضية والمراكز ووضع الطلبات وسجل الطلبات، ما يتيح للمطورين اختبار عمليات التداول المدعومة من دون استهلاك أصول حقيقية.

كيف تعمل مفاتيح WEEX API وأذوناتها؟

تتطلب وظائف API الخاصة المصادقة باستخدام مفتاح API. ووفقاً لوثائق WEEX Spot V3 الحالية، يُمنح مفتاح API الجديد إذن القراءة فقط افتراضياً. وهذا يتيح الوصول للاستعلامات، لكنه لا يسمح بالتداول الفوري. وإذا أراد المستخدمون أن يتمكن التطبيق من وضع طلبات التداول الفوري أو إلغائها، فعليهم تفعيل إذن تداول Spot المناسب.

تستخدم WEEX Futures بنية أذونات مماثلة. ويمكن استخدام إذن القراءة فقط للاستعلام عن بيانات مثل الأرصدة والمراكز وسجل التداول، بينما يتيح إذن Futures تنفيذ عمليات العقود الآجلة المدعومة، بما في ذلك فتح المراكز وإغلاقها وتحديد TP/SL.

عند إنشاء مفتاح API، يحصل المستخدمون على ثلاث معلومات مهمة أو يضبطونها: APIKey وSecretKey وPassphrase. وتحذّر WEEX المستخدمين من ضرورة الحفاظ على أمان بيانات الاعتماد هذه وحذف مفتاح API إذا تعرّض للاختراق.

تدعم WEEX أيضاً ربط مفاتيح API بعناوين IP، وتوصي باستخدام قائمة سماح لعناوين IP لتعزيز الأمان.

وبالتالي، تحدد الأذونات المسندة إلى مفتاح API ما يمكن للتطبيق الخارجي تنفيذه. وينبغي للمستخدمين تفعيل الأذونات اللازمة فقط لمسار عمل API الذي يعتزمون استخدامه.

هل يمكنك اختبار WEEX API قبل استخدام أصول حقيقية؟

توفر WEEX حالياً واجهات للتداول التجريبي ضمن Futures API. وقد صُممت نقاط النهاية هذه لتصحيح الاستراتيجيات واختبار عمليات التداول من دون استهلاك أصول حقيقية.

تتضمن وثائق Futures API الرسمية نقاط نهاية افتراضية للتحقق من أرصدة الحسابات، وعرض المراكز، ووضع الطلبات، ومراجعة سجل الطلبات. وتشمل أنواع الطلبات الافتراضية المدعومة أوامر السوق والأوامر المحددة.

قد يكون التداول التجريبي مفيداً عند تطوير مسار عمل قائم على API أو اختباره، إذ يتيح للمطورين التحقق من طريقة تفاعل تطبيقاتهم مع وظائف التداول المدعومة قبل تطبيق مسار العمل نفسه على أصول حقيقية.

لكن التداول الافتراضي لا يحاكي جميع جوانب التنفيذ في السوق الفعلية. لذلك، لا ينبغي اعتبار نتائج بيئة الاختبار ضماناً لأداء التداول الفعلي مستقبلاً.

ما حدود معدل الطلبات في WEEX API؟

تفرض WEEX حدوداً لمعدل الطلبات على واجهات API للحفاظ على استقرار النظام. ويعتمد الحد المطبق على منتج API والعملية المستخدمة.

بالنسبة إلى Spot V3 API الحالية، يذكر قسم الأسئلة الشائعة الرسمي حداً لطلبات التداول الفوري يبلغ 100 طلب كل 10 ثوانٍ. ويُسمح بإلغاء طلبات التداول الفوري 80 مرة كل 10 ثوانٍ أو 200 مرة في الدقيقة، بينما يبلغ حد وزن عنوان IP للشبكة 500 لكل 10 ثوانٍ لكل IP. 

أما بالنسبة إلى Futures API، فيذكر قسم الأسئلة الشائعة الرسمي الحالي حداً لوضع الطلبات يبلغ 300 مرة في الدقيقة، وحد REST يبلغ 500 من الوزن لكل 10 ثوانٍ لكل IP، وحداً أقصى قدره 20 اتصال WebSocket لكل IP.

إذا تجاوز طلب REST حداً سارياً لمعدل الطلبات، فقد تُرجع WEEX استجابة HTTP 429 response. لذلك، ينبغي للمطورين مراعاة الحدود ذات الصلة عند تصميم نظام تداول قائم على API.

وبما أن قواعد API وحدودها قد تتغير، ينبغي مراجعة أحدث الوثائق الرسمية قبل نشر تكامل أو تعديله.

لمن صُممت WEEX API؟

يمكن للمطورين والمتداولين الكميين استخدام WEEX API للوصول برمجياً إلى وظائف المنصة المدعومة.

قد يستخدم المطور API لإنشاء تطبيق يسترجع معلومات السوق أو يتفاعل مع وظائف التداول المدعومة. وقد يستخدم المتداول الكمي بيانات السوق، مثل الأسعار والشموع ودفاتر الطلبات والتداولات الأخيرة، كمدخلات لنظام تداول.

كما يمكن للمستخدمين الاستفادة من الوصول عبر API لأتمتة عمليات محددة مسبقاً. فبدلاً من مراقبة السوق يدوياً وإرسال كل طلب مدعوم عبر واجهة التداول، يستطيع نظام خارجي تنفيذ الإجراءات وفق القواعد التي يحددها المستخدم.

وتدعم الأدوات المتاحة أيضاً مستويات مختلفة من استخدام API. إذ يمكن استخدام أذونات القراءة فقط للمراقبة والتحليل، بينما تتيح أذونات التداول الوصول إلى وظائف الطلبات المدعومة. ويوفر التداول التجريبي للعقود الآجلة بيئة إضافية لاختبار مسارات عمل API قبل استخدام أصول حقيقية.

الخلاصة

تربط WEEX API التطبيقات الخارجية وأنظمة التداول بوظائف WEEX Exchange المدعومة. وهي توفر إمكانية الوصول عبر REST API وWebSocket، ودعماً للتداول الفوري والعقود الآجلة USDT-M، وبيانات السوق، وعمليات التداول الموثّقة، وأذونات قابلة للضبط، وواجهات للتداول التجريبي للعقود الآجلة.

ينبغي للمطورين الرجوع إلى أحدث وثائق WEEX API الرسمية عند إنشاء تكامل، ولا سيما للتحقق من نقاط النهاية والأذونات وحدود معدل الطلبات الحالية.

الأسئلة الشائعة

1. ما هي WEEX API؟
WEEX API هي مجموعة من واجهات البرمجة التي تتيح للمطورين والمتداولين الكميين ربط التطبيقات الخارجية ببيانات السوق ووظائف التداول المدعومة في WEEX. وهي توفر إمكانية الوصول عبر REST وWebSocket.

2. ما منتجات التداول التي تدعمها WEEX API؟
توفر WEEX موارد API للتداول الفوري والعقود الآجلة USDT-M. وتعتمد الوظائف المتاحة على منتج API ونقطة النهاية والأذونات.

3. هل يمكنني استخدام WEEX API للتداول الآلي؟
نعم. تدعم واجهات WEEX API الموثّقة التداول البرمجي، لذا يمكن للمستخدمين إنشاء أنظمة ترسل تعليمات التداول المدعومة وفقاً لمنطقهم الخاص.

4. هل توفر WEEX API التداول التجريبي؟
نعم. توفر WEEX نقاط نهاية للتداول التجريبي ضمن Futures API، مع وظائف للأرصدة الافتراضية والمراكز ووضع الطلبات وسجل الطلبات.

5. هل تفرض WEEX API حدوداً لمعدل الطلبات؟
نعم. تختلف حدود معدل الطلبات باختلاف API والعملية، وقد تتغير بمرور الوقت. وينبغي للمطورين مراجعة الوثائق الرسمية الحالية قبل البدء في البناء.