نظرة عامة
نظام إدارة حدود السرعة المتقدمة في MagicTradeBot يتحكم بذكاء في تدفق طلبات API ليحترم حدود السرعة في البورصات مع زيادة تدفق البيانات إلى الحد الأقصى. يتعامل النظام مع آلاف العمليات المتزامنة عبر عدة بورصات دون مخاطر الحظر المؤقت أو قيود API.
الميزات الأساسية
1. تقييد السرعة متعدد الطبقات
خوارزمية Token Bucket
- يطبق token bucket تكيفي لتوزيع الطلبات بسلاسة
- يعيد ملء التوكنز بالمعدل المُعد (مثال: 10 طلبات/ثانية)
- يمنع تدفق الطلبات المفاجئ الذي قدبه يُفعّل دفاعات البورصة
- يحتفظ بدلو منفصل لكل بورصة ونوع نقطة نهاية
حماية هامش الأمان
rateLimits:
maxRequestsPerSecond: 10 # الحد المُعلن من البورصة
safeBuffer: 0.2 # هامش أمان 20%
effectiveRate: 8 # معدل التشغيل الفعلي (80% من الحد الأقصى)
2. تجميع الطلبات الذكي
تحسين التجميع التلقائي
- يجمع الطلبات المشابهة (klines، بيانات التيكر، دفتر الأوامر) في حزم فعالة
- يقلل إجمالي استدعاءات API بنسبة 60-80% في العمليات الكبيرة
- مثال: مسح 100 رمز يحتاج ~15 استدعاء مجمع مقابل 100 استدعاء فردي
طابور مبني على الأولوية
- حرجة: إدارة الأوامر النشطة، تحديثات المراكز (فوري)
- عالية: بيانات الأسعار في الوقت الحقيقي للرموز المراقبة (< 1 ثانية تأخير)
- متوسطة: تحميل klines التاريخية، حسابات المؤشرات (< 5 ثوانٍ تأخير)
- منخفضة: مسوحات الخلفية، التحليلات التاريخية (< 30 ثانية تأخير)
3. عميل HTTP موسع مع وعي بالرؤوس
تحليل رؤوس حدود السرعة
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1637280000
X-MBX-USED-WEIGHT-1M: 354
يقرأ النظام ويتكيف مع:
- الحصص المتبقية من الطلبات في الوقت الحقيقي
- الحدود المبنية على الوزن (Binance، Bybit)
- طوابع إعادة التعيين لتوقيت دقيق
- حدود خاصة بكل نقطة نهاية
تقييد سرعة تكيفي
- يبطئ تلقائيًا عندما تكون الحصة المتبقية < 20%
- يوقف الطلبات غير الحرجة عندما تكون الحصة < 10%
- يعاود العمل بالمعدل الأمثل بعد نافذة إعادة التعيين
4. تحسين خاص بكل بورصة
دعم متعدد البورصات – استراتيجيات مختلفة حسب البورصة:
- Binance – نظام الوزن (1200 وزن/دقيقة)، نقاط نهاية ثقيلة، حساب وزن تلقائي
- Bybit – حدود منفصلة للنقاط العامة (50/ث) والخاصة (20/ث)، حدود مختلفة حسب نوع العقد
- OKX – حدود لكل نقطة نهاية مع نوافذ 2 ثانية، حدود اتصال متزامن (5 لكل IP)
- Gate.io، Kraken، KuCoin – تنفيذات مخصصة مع آليات احتياطية
5. تحميل ذكي لـ Klines & بيانات التيك
استراتيجية التحميل التدريجي
المسح الأولي: تحميل آخر 100 شمعة (طلب واحد)
↓
كشف الاهتمام: تحميل 500 شمعة (1-2 طلب)
↓
التحليل العميق: تحميل التاريخ الكامل في قطع (5-10 طلبات موزعة زمنيًا)
بيانات تاريخية مقسمة
- يقسم طلبات الفترات الكبيرة إلى قطع صغيرة
- يوزع الطلبات عبر نوافذ حدود سرعة متعددة
- مثال: سنة واحدة من بيانات 5 دقائق = 105,120 شمعة
→ تُحمّل في 10 قطع بحجم ~500 طلب لكل منها
→ موزعة على 50 ثانية لاحترام حد 10 طلب/ث
6. إدارة الطلبات الموزعة
تتبع الطلبات لكل رمز ومثال على تقييد مسح (أكثر من 1000 رمز):
Batch 1 (رموز 1-100): 0.0s - 10.0s
Batch 2 (رموز 101-200): 10.0s - 20.0s
...
Batch 10 (رموز 901-1000): 90.0s - 100.0s
الوقت الإجمالي: 100 ثانية لـ 1000 رمز
مقابل غير محدود: حظر API في 10 ثوانٍ
7. آليات إعادة المحاولة والتراجع
- 429 (حد السرعة): تراجع أُسي (2ث → 4ث → 8ث → 16ث)
- 418 (حظر IP): إيقاف فوري، استئناف بعد انتهاء مدة الحظر
- 5xx (خطأ خادم): تراجع خطي مع قاطع دائرة (circuit breaker)
8. لوحة مراقبة في الوقت الحقيقي
Exchange: Binance
├─ المعدل الحالي: 7.8 طلب/ث (78% من الحد)
├─ الوزن المستخدم: 342/1200 (28%)
├─ عمق الطابور: 23 طلب
├─ الانتظار المتوقع: 2.9ث
└─ إعادة التعيين التالية: 34ث
أمثلة على الإعدادات
محافظ (آمن للتشغيل 24/7)
rateLimits:
maxRequestsPerSecond: 10
safeBuffer: 0.3 # 70% استغلال
burstAllowance: 1.2 # يسمح بـ 20% انفجار لمدة 2 ثوانٍ
batchSize: 50 # تجميعات بحجم 50
retryAttempts: 5
backoffMultiplier: 2
عدواني (أقصى إنتاجية)
rateLimits:
maxRequestsPerSecond: 10
safeBuffer: 0.1 # 90% استغلال
burstAllowance: 1.5 # يسمح بـ 50% انفجار لمدة 5 ثوانٍ
batchSize: 100
retryAttempts: 3
backoffMultiplier: 1.5
فائق الأمان (IP مشترك أو VPN)
rateLimits:
maxRequestsPerSecond: 10
safeBuffer: 0.5 # 50% استغلال
burstAllowance: 1.0 # لا انفجار
batchSize: 20
retryAttempts: 10
backoffMultiplier: 3
الفوائد
- صفر حظر API: هامش الأمان يمنع القيود المؤقتة
- أقصى إنتاجية: يستخدم 80-90% من الحد المتاح
- قابل للتوسع: يتعامل بكفاءة مع مسح أكثر من 1000 رمز
- متعدد البورصات: يعمل على جميع البورصات الرئيسية
- تكيف في الوقت الحقيقي: يستجيب لتغذية رؤوس البورصة
- شفافية: رؤية واضحة لحالة حدود السرعة
- موثوقية: آليات إعادة محاولة واستعادة تلقائية
حالات الاستخدام
- مسح السوق الشامل – مسح أكثر من 2000 رمز كل 5 دقائق
- توليد إشارات عالية التردد – مراقبة 100 رمز بتحديثات كل ثانية (<500 ملث تأخير)
- اختبارات خلفية تاريخية – تحميل سنوات من بيانات kline ليلاً دون تدخل
- تداول متعدد الحسابات – تجمعات حدود سرعة منفصلة لكل مفتاح API
الخلاصة
تحول إدارة حدود السرعة المتقدمة في MagicTradeBot قيود API من عوائق إلى موارد مُدارة. يضمن النظام تشغيل البوت بأقصى كفاءة مع الامتثال التام لقواعد البورصات – مما يمنحك وصولًا تنافسيًا للبيانات دون مخاطر انقطاع الخدمة.