منهجية حساب الأسعار

1. مصادر البيانات

2.1 تكامل المنصات

تتكامل CoinPaprika مع منصات تداول العملات المشفرة عبر واجهات برمجة التطبيقات العامة الخاصة بها. يجب أن توفر كل منصة معرّفات أزواج السوق (مثل BTC/USD وETH/BTC)، وآخر سعر تداول لكل زوج سوق، وحجم التداول خلال 24 ساعة لكل زوج سوق.

2.2 النطاق

تُدرج في معالجة حساب الأسعار أسواق السلع الفورية فقط. وتُستبعد الأسواق المشتقة (العقود الآجلة والعقود الدائمة والخيارات)، إذ يمكن أن تنحرف أسعارها بشكل ملحوظ عن سعر السلعة الفورية الأساسية بسبب أسعار التمويل وآليات انتهاء الصلاحية وديناميكيات الرافعة المالية.

2.3 بيانات المرجع الخارجية

تُستقى أسعار صرف العملات الورقية من Open Exchange Rates للتحويل بين العملات الورقية (EUR وGBP وJPY وغيرها) وUSD. تُحوَّل معدلات ربط العملات المستقرة — USDT وUSDC وغيرها من العملات المستقرة الرئيسية — إلى USD باستخدام مؤشر مرجح بالحجم مشتق من أسواق الدخول بالدولار الأمريكي.

2. معالجة حساب الأسعار

صُمم الخوارزم لحساب الأسعار بناءً فقط على الحالة الراهنة للسوق، دون أي اعتماد على أسعار من عمليات تشغيل سابقة. يبدأ كل تنفيذ من الصفر، حيث يُقرّ معدلات التحويل الخاصة به من بيانات السوق الحية، ويتقارب نحو أسعار دقيقة عبر تكرارات متعددة. تُنفَّذ المعالجة بأكملها كل 60 ثانية.

1. جمع البيانات

   تجلب CoinPaprika من كل منصة متكاملة جميع أسواق السلع الفورية المتاحة. يوفر كل سوق: اسم زوج السوق (مثل BTC/USD)، وآخر سعر تداول بعملة الاقتباس، وحجم التداول خلال 24 ساعة بعملة الاقتباس.

2. تأسيس السعر المرجعي BTC/USD

   يبدأ الخوارزم بأسعار مفترضة صفرية. الحساب الأول هو متوسط سعر BTC/USD المرجح بالحجم، المشتق مباشرة من جميع أسواق BTC/USD الفورية. يُختار Bitcoin لأن أسواق BTC هي الأكثر سيولة عادةً عبر المنصات.

   BTC_USD = Σ(Price_i × Volume_i) / Σ(Volume_i)
   where i = each BTC/USD market across all exchanges

3. التمرير الأول: أسواق BTC والعملات الورقية فقط

   باستخدام سعر BTC/USD، يعالج الخوارزم الأسواق التي يكون أحد طرفي الزوج فيها إما BTC أو عملة ورقية. الأسواق المقوّمة بـ BTC (مثل ETH/BTC وSOL/BTC):

   Price_USD = Price_BTC × BTC_USD

   الأسواق المقوّمة بالعملات الورقية (مثل ETH/EUR وBTC/JPY):

   Price_BTC = Price_USD / BTC_USD

4. التمريرات اللاحقة: دمج جميع الأسواق

   تتداول كثير من العملات المشفرة أيضاً مقابل عملات مشفرة أخرى. يستخدم الخوارزم معدلات التحويل من التمرير السابق لحل هذه الأسواق بصورة تكرارية.

   Pass 1: BTC/USD markets → BTC_USD rate
   Pass 2: BTC + fiat markets → conversion rates for major coins
   Pass 3: All markets using Pass 2 rates → refined rates, more coins covered
   Pass N: Repeat until convergence → all reachable coins have prices

5. اكتشاف القيم الشاذة وإزالتها

   قبل التجميع النهائي، تُحدَّد أسعار السوق الشاذة وتُستبعد. الأسواق المستبعدة مسبقاً تشمل تلك ذات رسوم تداول صفرية وحوافز تعدين المعاملات والبيانات القديمة (أكثر من 30 دقيقة) والأزواج المدرجة في القائمة السوداء. يستخدم اكتشاف القيم الشاذة الإحصائية حدوداً قائمة على الوسيط معدَّلة لعمق السيولة.

6. السعر النهائي: المتوسط المرجح بالحجم

   بعد إزالة القيم الشاذة، يكون السعر النهائي هو المتوسط المرجح بالحجم لجميع الأسواق الصالحة المتبقية:

   Price_USD = Σ(Price_i_USD × Volume_i_USD) / Σ(Volume_i_USD)

   تحمل الأسواق ذات السيولة الأعلى وزناً أكبر بطبيعتها، مما يضمن أن السعر المجمَّع يعكس أين تجري غالبية نشاط التداول الفعلي.

3. حساب حجم التداول

4.1 حجم كل منصة

حجم التداول خلال 24 ساعة لكل منصة هو مجموع الأحجام المحوَّلة إلى USD عبر جميع أزواج التداول النشطة غير المدرجة في القائمة السوداء. الأزواج التي لم تُحدَّث خلال 30 دقيقة تُستبعد.

Exchange_Volume = Σ(Volume_pair_i × Price_pair_i_USD)

4.2 حجم كل أصل

حجم التداول خلال 24 ساعة لأصل فردي هو مجموع الأحجام عبر جميع أزواج السوق الصالحة لديه على جميع المنصات المتكاملة.

4.3 الحجم العالمي

حجم تداول العملات المشفرة العالمي هو مجموع جميع أحجام المنصات.

4. درجة ثقة المنصة

تحصل كل منصة على درجة ثقة على مقياس من 0 إلى 100، تعكس موثوقية وجودة البيانات المُبلَّغ عنها. تؤثر درجة الثقة على كيفية ترجيح بيانات المنصة وتصفيتها في معالجة حساب الأسعار.

5.1 معايير التقييم

5.2 تطبيق درجة الثقة

• المنصات قيد المراجعة تُستبعد كلياً من حسابات الأسعار والأحجام.
• تُراجَع درجات الثقة وتُحدَّث بشكل دوري، وقد تتغير فوراً استجابةً للأحداث الجسيمة (الاختراقات والإجراءات التنظيمية وانقطاعات API الممتدة وغيرها).
• بيانات المنصة تخضع لتدقيق إضافي من خلال مؤشر سيولة الزوج السوقي (انظر القسم 5).

5.3 الحجم الحقيقي المُقدَّر (ERV)

الحجم الحقيقي المُقدَّر مقياس أُدخل عام 2019 لمكافحة الحجم المزيف وتداول الغسيل. يُشتق ERV من مؤشرات السيولة لجميع الأسواق على منصة معينة. يُعدَّل حجم التداول المُبلَّغ عنه لكل سوق لمدة 24 ساعة باستخدام أوزان مخصصة لفئة مؤشر السيولة الخاصة به (جيد أو متوسط أو سيء).

5. مؤشر سيولة الزوج السوقي (النقاط)

تحصل أزواج السوق الفردية على تقييم سيولة في الوقت الفعلي بناءً على فارق دفتر الأوامر (الفرق النسبي بين أفضل سعر بيع وأفضل سعر شراء)، وعمق دفتر الأوامر (القيمة ضمن ±1% و±10% من السعر الوسط)، واتساق الحجم، وفحوصات القيم الشاذة.

6.1 فئات المؤشر

• جيد — سيولة قوية وظروف سوق طبيعية.
• متوسط — ظروف سوق مقيدة أو متذبذبة؛ السيولة أقل مما يوحي به الحجم المُبلَّغ عنه.
• سيء — سيولة غير كافية بالنسبة للحجم المُبلَّغ عنه، أو ظروف سوق شديدة الاختلال.

أزواج السوق التي تفشل في فحوصات السيولة يُخفَّض وزنها في حساب VWAP. إذا لم يكن هناك مصدر آخر لحساب سعر الأصل وحجمه، يُستخدم الزوج على أي حال — مع إشارة واضحة إلى أنه لا يمكن التحقق من السيولة.

6. المعروض المتداول

7.1 عملات Proof-of-Work

بالنسبة للعملات المشفرة القائمة على PoW (مثل Bitcoin وLitecoin)، يُستعلم عن المعروض المتداول مباشرةً من واجهات برمجة تطبيقات مستكشف الكتل. تُتحقق القيم عبر مستكشفات كتل مستقلة متعددة وتُحدَّث تلقائياً مع تعدين كتل جديدة.

7.2 الرموز المميزة (القائمة على العقود الذكية)

بالنسبة لرموز ERC-20 والرموز المشابهة، يُحسب المعروض المتداول على النحو التالي:

Circulating Supply = Total Supply - Locked Tokens

Locked Tokens includes:
  - Team/founder vesting wallets
  - Treasury or reserve wallets
  - Burn addresses
  - Locked staking contracts

7.3 التحقق

تُقارن أرقام المعروض المتداول مع البيانات التي يُفصح عنها فرق المشاريع وتُحدَّث عند وقوع أحداث الإفراج والحرق وغيرها من الأحداث المؤثرة على المعروض. تُحجب حدود محددة عمداً لمنع التحايل.

7. المقاييس المشتقة

8.1 القيمة السوقية

Per-asset:  Market Cap = Current Price (USD) × Circulating Supply
Global:     Global Market Cap = Σ(Market Cap of all tracked assets)

8.2 أعلى سعر على الإطلاق (ATH)

تتتبع CoinPaprika لكل أصل أعلى سعر مجمَّع تم تسجيله على الإطلاق، والتاريخ الذي حدث فيه، والمسافة الحالية عن ATH:

ATH Distance (%) = (ATH Price − Current Price) / ATH Price × 100%

8. معايير الإدراج

9.1 أصول العملات المشفرة

لكي تُدرج على CoinPaprika، يجب أن تستوفي العملة المشفرة المتطلبات التالية:

• موقع ويب وظيفي تمتلكه المشروع مع معلومات واضحة عن المشروع
• مستكشف كتل يعمل مع بيانات على السلسلة قابلة للتحقق
• تداول نشط على منصة واحدة على الأقل متكاملة مع CoinPaprika
• تواصل شفاف — يحافظ المشروع على قنوات عامة (X/Twitter وTelegram وDiscord) مع تحديثات منتظمة واستجابة لمشاكل المجتمع

9.2 المنصات

لكي تُدمج منصة كمصدر بيانات، يجب أن تستوفي الشروط التالية:

• تشغيل موقع ويب وظيفي مع نشاط تداول قابل للتحقق
• توفير REST API عام يلبي معايير بيانات CoinPaprika (أزواج السوق والأسعار والأحجام)
• الحفاظ على توثيق API محدَّث
• توفير نقطة اتصال مخصصة لمشاكل جودة البيانات

9. تكرار التحديث