تحديد المعدل والحصص
افهم حدود معدل Smart Money API، والحصص اليومية لكل مستوى اشتراك، واستراتيجيات التحسين لتعظيم استخدامك لواجهة برمجة التطبيقات.
نظرة عامة
تطبق Smart Money API حصص الطلبات اليومية لضمان جودة الخدمة والعدل بين جميع المستخدمين. يتضمن كل مستوى اشتراك حدًا يوميًا مختلفًا. عند تجاوز الحصة اليومية، ستتلقى خطأ 429 Too Many Requests حتى يتم إعادة تعيين الحصة في منتصف الليل بالتوقيت العالمي المنسق (UTC).
يتم تطبيق حدود المعدل لكل مفتاح API. لكل مفتاح حصته المستقلة. يمكنك إنشاء مفاتيح متعددة لتطبيقات مختلفة ومراقبة الاستخدام لكل منها بشكل منفصل.
الحصص حسب مستوى الاشتراك
| المستوى | الطلبات اليومية | السعر | الميزات |
|---|---|---|---|
| مجاني | 100 طلبًا/يوم | $0 | BTC, ETH, SOL, معدلات التمويل، التصفيات |
| تاجر | 400 طلب/يوم | 29 دولارًا/شهر | جميع الرموز، مراكز الحيتان، بيانات OI |
| محترف | 4,000 طلب/يوم | 79 دولارًا/شهر | درجات التأكيد، بيانات السلسلة، webhooks |
| مؤسسة | مخصص | مخصص | دعم مخصص، تكاملات مخصصة |
رؤوس استجابة حد المعدل
تتضمن كل استجابة API رؤوسًا تشير إلى حالة الحصة الحالية:
| الرأس | الوصف |
|---|---|
X-Requests-Limit |
إجمالي الطلبات المسموح بها يوميًا (مثال: 200 للتاجر) |
X-Requests-Remaining |
الطلبات المتبقية في اليوم الحالي |
X-Requests-Reset |
طابع زمني يونيكس لإعادة تعيين الحصة |
X-Requests-Reset-ISO |
طابع زمني ISO 8601 لإعادة تعيين الحصة |
فحص الحصة قبل تقديم الطلبات
نافذة المعدل اليومية
تعمل حدود المعدل على نافذة متداولة مدتها 24 ساعة. يتم إعادة تعيين الحصة يوميًا في منتصف الليل بالتوقيت العالمي المنسق (00:00 UTC). يتم توفير وقت إعادة التعيين الدقيق في X-Requests-Reset-ISO الرأس.
مثال: مستوى التاجر (400 طلب/يوم)
- اليوم 1 (21 مارس): 200 طلب متاح في 00:00 UTC
- 10:30 UTC: تم تقديم 75 طلبًا، 125 متبقية
- 15:45 UTC: تم تقديم 100 طلب إضافي، 25 متبقية
- 23:59 UTC: لا يزال 25 طلبًا متبقية (لا يمكن ترحيلها)
- اليوم 2 (22 مارس، 00:00 UTC): تم إعادة تعيين الحصة إلى 200
استراتيجيات التحسين
1. تخزين استجابات API مؤقتًا
لا تتغير مراكز الحيتان كل ثانية. قم بتخزين النتائج لمدة 30-60 ثانية وخدم البيانات المخزنة بدلاً من إجراء مكالمات API جديدة.
2. استخدام WebSocket للبيانات في الوقت الحقيقي
توفر اتصالات WebSocket تحديثات فورية دون احتسابها ضمن حد المعدل الخاص بك. اشترك في التدفقات واستقبل التحديثات عند حدوثها، مما يقلل من عدد مكالمات REST API المطلوبة.
3. تجميع الطلبات بشكل استراتيجي
قم بتقديم طلب واحد يحتوي على رموز متعددة عندما يكون ذلك ممكنًا بدلاً من طلبات منفصلة لكل رمز. هذا يقلل من مكالمات API بمقدار يصل إلى 10x.
4. استخدام التصفية في وقت الطلب
قم بتطبيق عوامل التصفية (الرمز، البورصة، min_position_size) في معلمات الاستعلام للحصول على البيانات التي تحتاجها بالضبط، وتجنب الحاجة إلى المعالجة اللاحقة.
التعامل مع أخطاء حد المعدل
إعادة المحاولة مع التراجع الأسي
هل أنت مستعد للترقية؟
المستوى المجاني غير كافٍ؟ قم بالترقية إلى التاجر أو المحترف للحصول على حصص أعلى وإمكانية الوصول إلى ميزات متقدمة مثل درجات التأكيد وبيانات السلسلة.
عرض الأسعارقم بتحسين استخدامك لواجهة برمجة التطبيقات اليوم
قم بتنفيذ التخزين المؤقت، واستخدم WebSocket للبيانات في الوقت الحقيقي، وتعامَل مع حدود المعدل بأسلوب أنيق.
قراءة الوثائقاحصل على تدفق الحيتان المباشر، التمويل، الفائدة المفتوحة وبيانات السلسلة عبر 3 بورصات من واجهة برمجة تطبيقات واحدة. مستوى مجاني، بدون بطاقة ائتمان، قم بالترقية في أي وقت.
ابدأ مجانًا →هل أنت مستعد للبناء؟ احصل على مفتاح API مجاني (100 مكالمة/يوم، بدون بطاقة) وابدأ في سحب بيانات الحيتان المباشرة، التمويل وبيانات السلسلة.
احصل على مفتاح API الخاص بك →