تقديم Bitculator Data API

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

اليوم نفتح هذا المحرك للجميع. أصبحت Bitculator Data API متاحة - وهي API بصيغة JSON تستخدم مصادقة 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, "..." : “...”} }

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

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

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

ستجد المرجع الكامل، مع أمثلة قابلة للتنفيذ لكل نقطة نهاية، في وثائق 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 صريحًا. لا تُقلّص API طلبك بصمت لتعيد لك أقل مما طلبت.
• webhooks موقَّعة. تحمل إشعارات التنبيه ترويسة 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-* التي تُعاد معه.

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