Crypto Bubbles API: من أين تتدفق البيانات فعلاً وكيف تبني لوحتك الخاصة

بصراحة من العتبة

هل يملك Crypto Bubbles واجهة API عامة؟

لنبدأ بما يأتي معظم الناس من أجله إلى هنا. الموقع الرسمي cryptobubbles.net لا يعلن عن واجهة API عامة وموثقة للمطورين. لا بوابة مطورين هناك، ولا تسعيرة طلبات، ولا توثيق لنقاط النهاية. Crypto Bubbles منتج استهلاكي — تصوير لأكثر من ألف عملة، يتحدث تلقائياً، ومتاح في المتصفح وتطبيقات الهواتف (هكذا يقدّمه موقعه) — وليس مستودع بيانات بالجملة.

نكتب ذلك صراحة لأن الشبكة تعجّ بأدلة توحي بعكس ذلك، أو — وهذا أسوأ — تنتحل صفة «واجهة Crypto Bubbles API الرسمية» وتبيع مفاتيح لها. تعامل مع هذه العروض كما تتعامل مع ملفات APK المزيفة في المنتديات: أحدهم يحاول أن يبيعك ما لا يعرضه الصانع أصلاً. والقاعدة الواردة في دليل تحميل التطبيق سارية هنا أيضاً — مصدر الحقيقة الوحيد عن المنتج الرسمي هو cryptobubbles.net حصراً.

والآن الخبر السار: لبناء لوحة فقاعات خاصة بك لا تحتاج أصلاً إلى واجهة API لتطبيق بعينه. فالفقاعات ليست سوى طريقة لرسم بيانات ينشرها السوق على أي حال. تحتاج إلى أربعة أرقام لكل عملة وأربعين سطراً من الكود. ولهذا بالذات نخصص بقية هذه الصفحة.

كيف تحصل تطبيقات الفقاعات على بياناتها: سلسلة من ثلاث حلقات

كل تصوير للسوق — من الفقاعات إلى الخرائط الحرارية التي نتناولها في دليل خريطة السوق — يقوم على سلسلة التوريد نفسها:

• الحلقة 1: المنصات. المصدر الأولي لكل سعر هو دفتر أوامر منصة تداول محددة. هنا تُبرم الصفقات، وسعر «بيتكوين» هو في الحقيقة عشرات الأسعار من عشرات قاعات التداول، تتفاوت بأجزاء من النقطة المئوية.
• الحلقة 2: المجمّعات. خدمات البيانات تجمع الأسعار من مئات المنصات، وتحسب متوسطها (مرجحاً عادة بحجم التداول)، وتضيف المعروض المتداول، وتقدم مقاييس جاهزة: القيمة السوقية، والترتيب، والتغيرات المئوية في النوافذ الزمنية القياسية.
• الحلقة 3: التطبيقات. التصويرات مثل لوحة الفقاعات تسحب من المجمّعات ملف JSON موحّداً وتحوّل الأرقام إلى هندسة ولون. كل «السحر» يجري في متصفح المستخدم.

لهذا التقسيم نتيجة عملية على مشروعك: يمكنك التوصيل عند أي حلقة. المجمّع يمنحك الراحة — نقطة نهاية واحدة، وآلاف العملات، وقيم سوقية محسوبة. والمنصة تمنحك الطزاجة — بيانات مباشرة من دفتر الأوامر، بلا وسيط ولا تأخير متوسطات، لكن لأزواج تلك القاعة الواحدة فقط. المشاريع الناضجة كثيراً ما تمزج المصدرين: المجمّع للترتيب والقيم السوقية، والمنصة للأسعار اللحظية.

ورشة العمل

درس مصغّر: لوحة فقاعات خاصة بك في أمسية واحدة

في الأسفل هيكل بلغة JavaScript — كود شبه جاهز مبسّط عمداً، عليك إكماله بعنوان واجهة API التي اخترتها. المنطق من ثلاث مراحل: اجلب الأسعار، حوّل القيمة السوقية إلى نصف قطر والتغيّر المئوي إلى لون، ثم ارسم.

// 1. جلب البيانات (REST، تحديث كل 60 ثانية)
async function fetchCoins() {
  const res = await fetch(API_URL + '/tickers?limit=100'); // مفتاح API في الترويسة، أبداً ليس في الكود
  const coins = await res.json();
  return coins.filter(c => c.volume24h > 1_000_000); // استبعد العملات الميتة
}

// 2. التحجيم: نصف القطر ~ الجذر التربيعي للقيمة السوقية
//    (العين تقارن مساحات الدوائر، لا أنصاف الأقطار!)
function radius(cap, maxCap) {
  const R_MAX = 90, R_MIN = 6;
  return Math.max(R_MIN, R_MAX * Math.sqrt(cap / maxCap));
}

// 3. اللون: أخضر للارتفاع، أحمر للهبوط،
//    والتشبع يزداد مع القيمة المطلقة للتغيّر
function color(changePct) {
  const sat = Math.min(Math.abs(changePct) / 15, 1); // تشبع كامل ابتداءً من ±15%
  return changePct >= 0
    ? `rgba(34, 197, 94, ${0.35 + 0.65 * sat})`
    : `rgba(239, 68, 68, ${0.35 + 0.65 * sat})`;
}

// 4. الرسم: canvas + محاكاة تنافر بسيطة
setInterval(async () => {
  const coins = await fetchCoins();
  const maxCap = Math.max(...coins.map(c => c.marketCap));
  draw(coins.map(c => ({
    label: c.symbol,
    r: radius(c.marketCap, maxCap),
    fill: color(c.change24h)
  })));
}, 60_000);

نصيحتان تتجاوزان الهيكل. أولاً، فيزياء التوزيع: كي لا تتراكب الفقاعات، استخدم محاكاة قوى جاهزة — في مكتبة d3 هي الوحدة d3-force مع التصادمات (forceCollide)، وعلى canvas خام تكفي حلقة تُبعد الدوائر المتقاطعة عن بعضها. ثانياً، الجذر التربيعي في دالة نصف القطر ليس ترفاً: مساحة الدائرة تنمو مع مربع نصف القطر، فالتحجيم الخطي لنصف القطر سيجعل عملة أكبر بمئة مرة تشغل مساحة أكبر بعشرة آلاف مرة. نصف اللوحات «الهاوية» على الشبكة ترتكب هذا الخطأ بالضبط وتكذب بصرياً بشأن نسب السوق — والنسب هي جوهر هذا التصوير كله، كما نفصّل في دليل ما هو Crypto Bubbles.

كيف تختار واجهة API للبيانات: ستة معايير

المعيار	عمّ تسأل	ممّ تحذر
تغطية السوق	كم عملة ومنصة تشمل؟ هل تحسب القيم السوقية؟	«10000 عملة» قد تُحسب مع توكنات ميتة بلا حجم تداول
WebSocket	هل يوجد تدفق حي وما نطاقه (حركات أسعار، صفقات، دفتر أوامر)؟	بعض الخطط لا تقدم WS إلا من العتبة المدفوعة
حدود الطلبات	كم طلباً في الدقيقة/الشهر في خطتك؟	الحدود المحسوبة لكل نقطة نهاية قد تفاجئك منتصف الشهر
السعر	كلفة الخطة عند حجم حركتك الحقيقي، لا الحالي	القفزات السعرية بين العتبات قد تبلغ أضعافاً
البيانات التاريخية	إلى أي عمق تعود الشموع وبأي دقة؟	الخطط المجانية كثيراً ما تعطي أياماً فقط، لا سنوات
الاستقرار واتفاقية الخدمة	صفحة حالة، تاريخ الأعطال، ضمانات التوافر	غياب صفحة حالة علنية إجابةٌ بحد ذاته

ملاحظة مستقلة عن واجهات API الخاصة بالمنصات كمصدر كامل الأهلية: إذا كان مشروعك يخص التداول — اختبارات رجعية، أو بوت، أو مراقب أوامرك الخاصة — فواجهة API المنصة ليست بديلاً بل ضرورة، لأنها وحدها تمنحك دفتر الأوامر وتاريخ الصفقات وإمكانية إرسال الأوامر. توثيقات المنصات الناضجة تقدم REST وWebSocket، وبيئات تجريبية (sandbox) للاختبار، ومكتبات عملاء باللغات الشائعة. وهي أيضاً أقصر طريق لتصطدم نظرية هذه الصفحة بتدفق بيانات حقيقي.

المعلومات عن ميزات تطبيق Crypto Bubbles الرسمي (نطاق العملات، المنصات، تواتر التحديث) ننقلها عن cryptobubbles.net (حتى: يوليو 2026).