API للمطوّرين

REST v1

بيانات سوق CryptoJam عبر REST API.

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

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

GET/api/v1/developer/coins

معلمات الطلب

المعلمة	النوع	الوصف
`page`	integer	رقم الصفحة، بدءًا من 1
`pageSize`	integer	عدد النتائج، 1–250
`search`	string	اسم العملة أو رمزها
`sort`	string	rank, price, marketCap, volume24h, change24h
`order`	string	asc أو desc

حقول الاستجابة وتقسيم الصفحات

تتضمن الاستجابات data وmeta. الحقول الرئيسية: id وslug وname وsymbol وrank وpriceUsd وchange24h وmarketCapUsd وvolume24h وupdatedAt وsource. السعر غير المتاح هو null. الحجم الافتراضي للصفحة 50. الرموز ليست فريدة: استخدم id أو slug.

تاريخ السعر

أسعار مخزنة لعملة رقمية محددة.

GET/api/v1/developer/history/{slug}

معلمات الطلب

المعلمة	النوع	الوصف
`range`	string	24h, 7d, 30d, 90d, 1y, all, max
`from / to`	string	نطاق مخصص، ISO 8601
`granularity`	string	1d أو tick

تغطية التاريخ والمصادر

تتضمن كل نقطة timestamp وpriceUsd والمؤشرات الإضافية المتاحة. تستخدم التواريخ UTC. يعني نطاق all كامل التاريخ المخزن محليًا؛ وقد تختلف بدايته عن تاريخ إطلاق العملة.

راجع meta.coverageStart وmeta.coverageEnd وmeta.source وmeta.gaps وmeta.truncated وmeta.isDemo. اطلب فترات أصغر للاستجابات المقتطعة. تُخزن أسعار USD وUSDT بشكل منفصل.

حول بيانات السوق

مثال التفويض والطلب

أرسل مفتاحك في ترويسة X-API-Key. احتفظ به على خادم تطبيقك.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://cryptojam.net/api/v1/developer/history/bitcoin?range=30d"

market:readدليل العملات الرقميةhistory:readتاريخ السعر

جرّب طلبًا

OpenAPI

بنية نموذجيةJSON

{
  "data": [
    {
      "timestamp": "2025-01-01T00:00:00.000Z",
      "priceUsd": 93429.20,
      "source": "coingecko"
    }
  ],
  "meta": {
    "source": "coingecko",
    "coverageStart": "2025-01-01T00:00:00.000Z",
    "gaps": [],
    "isDemo": false
  }
}

مفاتيح API الخاصة بي

سجّل الدخول لإنشاء مفتاح

إدارة الوصول إلى بيانات السوق والبيانات التاريخية.

المتابعة بالبريد الإلكتروني

تسجيل الدخول غير متاح مؤقتًا.

إنشاء حساب

الشروط·الخصوصية

تواصل [email protected]

الوصول والحدود

الحالة غير متاحة

تعذّر التحقق من توفر API.

تفاصيل الوصول والأخطاء

يُفعّل تقديم البيانات بعد تأكيد حقوق إعادة التوزيع من المزوّدين. CoinGecko هو المزوّد المسموح به افتراضيًا. تُستبعد بيانات Coin Metrics Community من API للمطوّرين.

تستخدم الحصص اليومية UTC. يُعرض الحد والطلبات المتبقية في X-RateLimit-Limit وX-RateLimit-Remaining.

400: معلمات غير صالحة
401: المفتاح مفقود أو غير صالح
403: صلاحيات غير كافية
404: لم يُعثر على المورد
429: تجاوز حد الطلبات
503: البيانات غير متاحة

تتضمن الأخطاء code وmessage داخل كائن error. بعد استجابة 429، اتبع ترويسة Retry-After إن وُجدت.

تواصل [email protected]