واجهات API لمنصات العملات المشفرة للمراجحة: REST مقابل WebSocket وحدود المعدل ومفاتيح API الآمنة 01/10/2026 – Posted in: Arbitrage Software, cryptoarbitrage software
الاتصال بواجهات API لمنصات العملات المشفرة لأغراض المراجحة: REST وWebSocket وحدود المعدل وزمن الاستجابة
لا توجد فرصة المراجحة إلا طالما كان بإمكان روبوتك رؤيتها والتصرف بناءً عليها، وكلا الأمرين يعتمد على طريقة اتصالك بكل منصة. يشرح هذا الدليل الخيارات التي تحدد ما إذا كانت فجوة السعر ستتحول إلى أمر منفَّذ أم إلى صفقة ضائعة: أي نوع من واجهات API تستخدم، وكيف تعمل حدود المعدل في Binance وBybit وOKX وMEXC وGate.io، وكيف تنشئ مفاتيح API آمنة، وأين تضيع أجزاء الثانية.
لماذا يحدد اتصال API نتائج المراجحة
تبدو المراجحة بين المنصات بسيطة على الورق: تشتري حيث السعر أدنى، وتبيع حيث السعر أعلى، وتحتفظ بالفرق بعد خصم الرسوم. أما في الواقع، فعادةً ما يستمر هذا الفرق من بضع مئات من أجزاء الثانية إلى بضع دقائق، وتُنفَّذ الصفقة بأكملها عبر واجهات API الخاصة بالمنصات. وهناك ثلاثة عوامل تقنية تحدد ما تحققه فعليًا:
- سرعة رؤيتك للسعر. إذا وصلتك الأسعار متأخرة، فقد تكون الفجوة التي تحسبها قد اختفت بالفعل.
- سرعة وصول أوامرك. يجب تنفيذ ساقَي الصفقة على منصتين مختلفتين، والساق الأبطأ هي التي تحدد سعر دخولك الحقيقي.
- عدد المرات المسموح لك فيها بالطلب. تضع حدود المعدل سقفًا لعدد الطلبات. والروبوت الذي يصطدم بها يُحظر تحديدًا عندما تكون السوق في ذروة نشاطها والفجوات في أوسع حالاتها.
لا يظهر أي من هذا في الاختبار الرجعي (backtest)، ولهذا قد يحقق روبوتان يعملان بالاستراتيجية نفسها نتائج مختلفة تمامًا. إذا لم تكن قد قست الفجوات بين منصاتك بعد، فابدأ بـماسح المراجحة المجاني للعملات المشفرة لدينا: فهو يُظهر أزواج التداول والمنصات التي تنتج فروقًا سعرية كبيرة بما يكفي لتغطية الرسوم.
REST مقابل WebSocket: فيمَ يصلح كل منهما
توفر كل منصة كبرى طريقتين للتواصل معها.
REST API يعمل بنظام الطلب والاستجابة. يرسل الروبوت طلب HTTP موقَّعًا (مثل “أعطني دفتر الأوامر” أو “ضع هذا الأمر”) وينتظر الرد. كل طلب مستقل وسهل التصحيح، ويُحتسب ضمن حد المعدل.
WebSocket API يُبقي اتصالًا واحدًا مفتوحًا. بعد اشتراكك في قناة ما، ترسل المنصة كل تحديث (تغييرات دفتر الأوامر، والصفقات، وحالة أوامرك) لحظة حدوثه. لا يوجد استطلاع دوري (polling) ولا فترات عمياء بين عمليات التحقق.
| REST | WebSocket | |
|---|---|---|
| بيانات السوق | لقطة عند الطلب؛ تفوتك التغييرات بين عمليات الاستطلاع | تدفق مستمر لتحديثات دفتر الأوامر والصفقات |
| الاستخدام المعتاد في المراجحة | مراجحة التحوّط (بين المنصات) حيث تستمر الفجوات ثوانيَ أو أكثر؛ الأرصدة؛ عمليات السحب | مراجحة زمن الاستجابة وأي استراتيجية تستمر فيها الفجوات أقل من ثانية |
| الضغط على حدود المعدل | مرتفع: كل فحص للسعر يستهلك وزنًا | منخفض للبيانات: اشتراك واحد بدلًا من آلاف الطلبات |
| التعقيد | منخفض | أعلى: إعادة الاتصال، والأرقام التسلسلية، وصيانة دفتر الأوامر محليًا |
تجمع معظم الأنظمة الاحترافية بين الاثنين: WebSocket لبيانات السوق وتحديثات الأوامر، وREST (أو نقطة التداول عبر WebSocket الخاصة بالمنصة إن توفرت) لوضع الأوامر، وREST للاستدعاءات الإدارية البطيئة مثل الأرصدة والتحويلات.
وهذا أيضًا هو الفرق العملي بين روبوتَي العملات المشفرة لدينا. يتصل VIP Crypto Arbitrage عبر REST بأكثر من 35 منصة، وهو مصمم لمراجحة التحوّط بين المنصات حيث تستمر الفجوات مدة كافية. أما SharpTrader Pro فيستخدم تدفقات WebSocket من أكثر من 40 منصة، وهو أمر ضروري لمراجحة زمن الاستجابة حيث تتراوح النافذة بين 100–500 مللي ثانية.
حدود المعدل في المنصات الكبرى
حدود المعدل هي السبب الأكثر شيوعًا لتوقف روبوتات المراجحة عن العمل في التداول الحي. تحتسب كل منصة طلباتك لكل عنوان IP أو لكل حساب (UID) أو لكل مفتاح API، وتحظرك أو تمنعك عندما تتجاوز الحصة المسموحة. يلخص الجدول أدناه القواعد المنشورة وقت كتابة هذا المقال (سبتمبر 2026). تتغير الحدود بانتظام، لذا راجع دائمًا وثائق المنصة واقرأ ترويسات الحدود في الاستجابات الحية.
| المنصة | حدود REST الرئيسية | ماذا يحدث عند التجاوز | تفاصيل مفيدة |
|---|---|---|---|
| Binance (Spot) | وزن طلبات قدره 6,000 في الدقيقة لكل IP؛ مع حدود منفصلة لعدد الأوامر. لكل نقطة نهاية وزنها الخاص | HTTP 429؛ والاستمرار بعد 429 يؤدي إلى HTTP 418 وحظر تلقائي لعنوان IP يتراوح من دقيقتين حتى 3 أيام للمخالفين المتكررين | تُظهر الترويسات X-MBX-USED-WEIGHT-* وX-MBX-ORDER-COUNT-* الاستهلاك الحالي؛ وتحدد Retry-After مدة الانتظار |
| Bybit (V5) | 600 طلب لكل 5 ثوانٍ لكل IP؛ وحدود لكل UID للتداول، مثل إنشاء الأوامر 20/ث في السوق الفورية و10/ث في العقود الخطية | حد IP: HTTP 403 “access too frequent”، ويُرفع بعد نحو 10 دقائق؛ حد UID: retCode 10006 | الترويسات X-Bapi-Limit وX-Bapi-Limit-Status وX-Bapi-Limit-Reset-Timestamp |
| OKX (V5) | تُحدَّد الحدود لكل نقطة نهاية ولكل أداة، وتحصل مستويات VIP الأعلى على سعة أكبر | استجابة خطأ لنقطة النهاية؛ وقد يؤدي التجاوز المتكرر إلى تقييد المفتاح | قنوات دفتر الأوامر: bbo-tbt (أفضل سعر شراء/بيع، كل 10 مللي ثانية)، وbooks5 (كل 100 مللي ثانية)، وbooks (تزايدي، 100 مللي ثانية)؛ وتتطلب قنوات L2 لحظة بلحظة مستويات VIP أعلى |
| MEXC (Spot v3) | تتشارك نقاط النهاية الموزونة حسب IP وزنًا قدره 300 لكل 10 ثوانٍ؛ ونقاط النهاية الموزونة حسب UID وزنًا قدره 500 لكل 10 ثوانٍ | HTTP 429 مع Retry-After؛ وتؤدي المخالفات المتكررة إلى حظر عنوان IP من دقيقتين إلى 3 أيام |
WebSocket: حتى 30 تدفقًا لكل اتصال، و100 رسالة في الثانية؛ ويُغلق الاتصال بعد 60 ثانية دون حركة بيانات (رُدّ على رسائل ping) |
| Gate.io (API v4) | حدود منشورة لكل مفتاح لنقاط النهاية العامة والخاصة في السوق الفورية، مع حد أعلى بكثير لإلغاء الأوامر | تُؤخَّر الطلبات القريبة من عتبة الذروة، وتُرفض الطلبات التي تتجاوزها | WebSocket: حتى 300 اتصال لكل IP |
ثلاث قواعد تُبقي الروبوت ضمن الحدود:
- احصل على بيانات السوق من WebSocket لا من REST. الروبوت الذي يستطلع دفتر أوامر 20 زوجًا على 5 منصات كل 200 مللي ثانية يرسل 500 طلب في الثانية. أما البيانات نفسها عبر WebSocket فلا تكلف سوى بضعة اشتراكات.
- اقرأ ترويسات الحدود وأبطئ قبل أن تفعل المنصة ذلك نيابةً عنك. الروبوت الذي يتراجع عند 80% من الحصة لا يتعرض للحظر أبدًا.
- افصل حركة البيانات. استخدم مفاتيح API مختلفة (أو حسابات فرعية) لكل روبوت، حتى لا يتمكن سكربت خارج عن السيطرة من حظر مفتاح التداول الخاص بك.
إنشاء مفاتيح API بأمان
يحتاج روبوت المراجحة إلى صلاحية قراءة الأرصدة ووضع الأوامر، ولا يحتاج أبدًا إلى صلاحية السحب. قد يتسبب مفتاح مسرَّب بلا صلاحيات سحب في خسائر عبر صفقات سيئة، لكنه لا يستطيع إفراغ الحساب.
- أنشئ مفتاحًا واحدًا لكل منصة ولكل روبوت، وسمِّه باسم الروبوت والخادم.
- فعّل القراءة وتداول السوق الفورية/العقود الآجلة فقط. وأبقِ عمليات السحب معطّلة.
- قيّد المفتاح بعنوان IP الخاص بخادم VPS لديك. تدعم معظم المنصات قائمة IP بيضاء؛ والمفتاح المقيد بعنوان IP واحد عديم الفائدة على أي جهاز آخر.
- خزّن المفاتيح السرية مشفّرة على الخادم، ولا تضعها أبدًا في لقطات الشاشة أو المحادثات أو المستندات المشتركة.
- بدّل المفاتيح بعد أي تغيير في الموظفين أو نقل للخادم أو اشتباه في تسريب، واحذف المفاتيح التي لم تعد تستخدمها.
- للاستراتيجيات المنفصلة، استخدم الحسابات الفرعية: فهي تعزل الأرصدة وحدود المعدل.
من أين يأتي زمن الاستجابة وكيف تقلّصه
من لحظة تغيّر السعر على المنصة إلى لحظة تنفيذ أمرك، يُستهلك الوقت في خمسة مواضع: انتقال تحديث السوق إلى خادمك، واكتشاف روبوتك للفجوة، وعودة الأمر الموقَّع، ومطابقة المنصة له، ثم عودة التأكيد. في الروبوت المكتوب جيدًا تستغرق المعالجة بضعة أجزاء من الثانية فقط، وعادةً ما تكون الشبكة هي العامل المهيمن.
- استضف الروبوت بالقرب من المنصة. تشغّل معظم المنصات الكبيرة محركات المطابقة لديها في مناطق سحابية محددة (كثير منها في طوكيو أو سنغافورة أو هونغ كونغ). ويمكن لخادم VPS في المنطقة نفسها أن يخفض زمن الذهاب والإياب من عشرات أجزاء الثانية إلى بضعة أجزاء فقط. يشرح دليل سرعة VPS لدينا كيفية قياسه.
- في الاستراتيجيات متعددة المنصات، اختر الموقع الذي يقلّص الساق الأبطأ، لا المتوسط: فسرعة الصفقة لا تتجاوز سرعة أبطأ تنفيذ فيها.
- حافظ على الاتصالات نشطة. أعد استخدام اتصالات HTTPS (keep-alive) ووقّع مسبقًا ما يمكنك توقيعه؛ ففتح اتصال TLS جديد لكل أمر يضيف رحلة ذهاب وإياب كاملة إضافية.
- قِس باستمرار. سجّل الطابع الزمني للمنصة لكل تحديث مقارنةً بساعتك المحلية (المتزامنة عبر NTP)، وتتبّع عمر الأسعار التي يتداول عليها روبوتك.
الحفاظ على موثوقية الاتصال
اتصالات WebSocket تنقطع. فالمنصات تغلق التدفقات الخاملة، وتعيد تشغيل الخوادم، وتحدّ من عمر الاتصال. والروبوت المتين يخطط لذلك مسبقًا:
- نبضات القلب (Heartbeats): رُدّ على رسائل ping (تغلق MEXC الاتصال بعد 60 ثانية دون حركة بيانات)، وأرسل رسائلك الخاصة إذا كانت المنصة تتطلب ذلك.
- التحقق من التسلسل: تحمل تدفقات دفتر الأوامر التزايدية معرّفات للتحديثات. إذا فُقد أحدها، فتخلّص من الدفتر المحلي وأعد المزامنة من لقطة جديدة بدلًا من التداول على دفتر تالف.
- إعادة الاتصال التلقائية مع التراجع التدريجي: أعد الاتصال بسرعة، ولكن ليس في حلقة متلاحقة؛ فمثلًا تحدّ Bybit من عدد الاتصالات الجديدة في كل نافذة مدتها 5 دقائق.
- الحماية من البيانات القديمة: إذا لم يصل أي تحديث لزوج ما خلال مدة محددة، فأوقف التداول على هذا الزوج حتى يتعافى التدفق.
- مطابقة حالة الأوامر: بعد إعادة الاتصال، استعلم عن الأوامر المفتوحة والمراكز عبر REST قبل وضع أي أمر جديد، حتى لا يُنسى أبدًا تحوّط منفَّذ جزئيًا.
- تابع إشعارات تغييرات API. توقف المنصات دعم نقاط النهاية وتغيّر الحدود عدة مرات في السنة. ويجمع متتبّع تغييرات API لمنصات العملات المشفرة لدينا هذه الإعلانات في مكان واحد.
قائمة التحقق قبل الإطلاق
- التأكد من فجوات الأسعار على أزواجك باستخدام الماسح، بعد احتساب الرسوم.
- مفتاح API واحد لكل منصة: للتداول فقط، مع تعطيل السحب، وضبط قائمة IP البيضاء.
- بيانات السوق عبر WebSocket؛ واستدعاءات REST مقتصرة على الأوامر وبيانات الحساب.
- تسجيل ترويسات حدود المعدل؛ والروبوت يتراجع قبل بلوغ 80% من الحصة.
- خادم VPS في المنطقة التي تقلّص الساق الأبطأ؛ مع قياس أزمنة الذهاب والإياب.
- اختبار آليات إعادة الاتصال وإعادة المزامنة والحماية من البيانات القديمة بقطع الشبكة عمدًا.
- أول تشغيل حي بأدنى حجم، ثم مقارنة التنفيذات بالأسعار التي رآها الروبوت.
دع البرنامج يتولى البنية التحتية
إدارة الاتصال، وتوقيع الطلبات، وحدود المعدل، وإعادة الاتصال، كلها مدمجة في روبوتاتنا. ابدأ بالماسح المجاني، ثم اختر الروبوت الذي يناسب استراتيجيتك.
ماسح المراجحة المجاني للعملات المشفرة قارن روبوتات مراجحة العملات المشفرة
الأسئلة الشائعة
هل أحتاج إلى WebSocket لمراجحة العملات المشفرة؟
في مراجحة زمن الاستجابة، نعم: فالفرصة تستمر أقل من ثانية، ولا يستطيع الاستطلاع الدوري رؤيتها في الوقت المناسب. أما في مراجحة التحوّط (بين المنصات)، حيث تستمر الفجوات ثوانيَ أو دقائق، فإن REST كافٍ، لكن WebSocket يظل يقلل من استهلاك حدود المعدل.
لماذا يتلقى روبوتي أخطاء HTTP 429 أو 418 على Binance؟
يعني الخطأ 429 أنك تجاوزت حدًا للطلبات؛ ويعني 418 أن عنوان IP قد حُظر لأن الطلبات استمرت بعد 429. انقل بيانات السوق إلى WebSocket، والتزم بالترويسة Retry-After، وتراجع قبل بلوغ الحد.
هل ينبغي أن يسمح مفتاح API المخصص للمراجحة بعمليات السحب؟
لا. التداول والقراءة كافيان. ويمكن إعادة توازن الأرصدة بين المنصات يدويًا أو عبر عملية منفصلة ومقيدة بإحكام.
ما أفضل موقع للخادم للمراجحة بين عدة منصات؟
الموقع الذي يقلّص الساق الأبطأ في صفقتك. قِس أزمنة الذهاب والإياب من المناطق المرشحة إلى واجهة API لكل منصة قبل اتخاذ القرار.
كم مرة تتغير واجهات API للمنصات؟
عدة مرات في السنة لكل منصة: نقاط نهاية جديدة، وإصدارات متوقفة، وحدود متغيرة. اشترك في إعلانات API لكل منصة، وتابع متتبّع تغييرات API لدينا.
