تقديم Bitculator Data API

تعتمد كل الرسوم البيانية والجداول ومؤشرات القياس على Bitculator على محرك بيانات واحد: أسعار مباشرة تُحدَّث كل دقيقة تقريبًا، وآلاف الأسواق عبر منصات التداول، ومؤشرات المعنويات، والمؤشرات الفنية، والتصفيات، وسجل السوق العالمي.

واليوم نتيح الوصول إلى هذا المحرك. أصبحت واجهة Bitculator للبيانات API متاحة - واجهة JSON API موثّقة باستخدام Bearer، تضم 85 نقطة نهاية ضمن 15 مجموعة، وخطة مجانية، ووثائق بـ19 لغة.

أول طلب لك في سطر واحد:

curl "https://bitculator.com/api/v1/coins?per_page=5" \ -H “Authorization: Bearer YOUR_API_KEY”
{ "data": [ { "rank": 1, "name": "Bitcoin", "symbol": "BTC", "price": "67412.83451201", "..." : "..." } ], "meta": { "current_page": 1, "per_page": 5, "..." : “...”} }

أنشئ مفتاحًا في لوحة المطور وسيعمل هذا الطلب فورًا. 

تُنظَّم الواجهة في 15 مجموعة موارد، وتضم كل ما تعرضه المنصة:

• العملات والأسعار - كتالوج الأصول الكامل، والأسعار المباشرة، والأسعار التاريخية، وبيانات OHLC والعرض.
• الأسواق ومنصات التداول - أزواج التداول، والرموز، وأحجام التداول، وتفاصيل منصات التداول التي نتتبعها.
• المحافظ - دليل المحافظ مع مواصفاتها والأصول المدعومة.
• السوق العالمي - إجمالي القيمة السوقية، وحجم التداول والهيمنة، بما في ذلك السلاسل التاريخية.
• المعنويات والمؤشرات - مؤشر الخوف والطمع، وإشارات اتجاه السوق الصاعد/الهابط، والمؤشرات الفنية (RSI والمتوسطات المتحركة وغيرها) لكل أصل.
• التصفيات - بيانات تصفية مراكز الشراء/البيع.
• التحويل والحاسبات - تحويل العملات الرقمية↔العملات الورقية بأسعار مباشرة ونقاط نهاية الحاسبات في المنصة.
• المحتوى التحريري - المقالات ومحتوى المسرد.
• التنبيهات وخطافات الويب - أنشئ تنبيهات الأسعار عبر الواجهة واستقبل إشعارات خطافات ويب موقّعة عند تفعيلها.
• البيانات الوصفية - الاستخدام والخطط والمواصفات القابلة للقراءة آليًا.

تجد المرجع الكامل، مع أمثلة قابلة للتنفيذ لكل نقطة نهاية، في وثائق API.

بعض خيارات التصميم التي لم نقبل المساومة عليها:

• دقة السلاسل العشرية. تُعاد الأسعار وأسعار الصرف وبيانات العرض على هيئة سلاسل نصية، لا أعدادًا عائمة أبدًا. لا يستطيع العدد العائم تمثيل 0.00000001842 بدقة، لذا لا نعتمد عليه. يحافظ المحلل لديك على كل رقم أنتجه السوق.
• بنية موحّدة في كل مكان. تكون الاستجابات الناجحة بالشكل { data, meta }؛ أما كل خطأ من فئة 4xx أو 5xx فيكون بالشكل { "error": { "code", "message", "details" } }. اعتمد على error.code: قد تتغير صياغة الرسائل، لكن الرموز ثابتة.
• حصتك تظهر في كل استجابة. تعود ترويسات X-Quota-Limit وX-Quota-Used وX-Quota-Reset مع كل طلب، فلا داعي للتخمين بشأن رصيدك—ويمكنك أيضًا طلب GET /usage مباشرة. 
• حدود يمكن توقعها. تعتمد حدود per_page على الخطة، وتجاوز الحد يعيد خطأ 422 واضحًا. لا تخفّض الواجهة طلبك بصمت ولا تعيد نتائج أقل مما طلبت.
• خطافات ويب موقّعة. تتضمن إشعارات التنبيهات ترويسة X-Bitculator-Signature على نمط Stripe، لتتمكن من التحقق من صحتها قبل الوثوق بالبيانات.
• مواصفات عامة. توثّق مواصفات OpenAPI الواجهة بأكملها، كما توفر الوثائق مجموعة Postman جاهزة للاستخدام.

لواجهة Data API حصة شهرية خاصة بها، منفصلة عن أدوات Bitculator القابلة للتضمين. الخطة المجانية لا تتطلب بطاقة دفع - احصل على مفتاح وابدأ البناء. ترفع الخطط المدفوعة عدد الطلبات الشهري وحد per_page الأقصى؛ تجد التفاصيل والأسعار الحالية في صفحة Data API.

إلى جانب API، نوفر ثماني حزم SDK رسمية بترخيص MIT - TypeScript وPython وPHP وGo وRust وJava وC# وC++ - تدعم كل منها نقاط النهاية الـ85 مع ترقيم صفحات تلقائي، وأخطاء محددة الأنواع، وإعادة محاولات ذكية، وضمان استخدام السلاسل العشرية. تتوفر أوامر التثبيت والشعارات وروابط المستودعات للحزم الثماني في قسم SDK في صفحة API، كما أن الشيفرة المصدرية مفتوحة على github.com/bitculator. لكن للتوضيح: لست بحاجة إلى SDK. إنها طلبات HTTP عادية مع ترويسة Bearer - وتعمل curl وfetch وrequests وGuzzle تمامًا كما تتوقع.

1. ألقِ نظرة سريعة على صفحة Data API لمعرفة الخطط والحصص ودليل البدء السريع.
2. أنشئ مفتاحك في لوحة المطور
3. نفّذ طلبك الأول - وتحقق من ترويسات X-Quota-* التي تصلك معه.

أنشأنا هذه الواجهة لأننا أردنا وجودها. إذا بنيت شيئًا باستخدامها، فسيسعدنا حقًا أن تخبرنا عنه.