CoinGecko
Cryptocurrency prices, market data and historical series.
أسواق العملات
جدول سوق مرتّب يغطي عملات كثيرة في استدعاء واحد: صف لكل عملة يضم current_price وmarket_cap وmarket_cap_rank وtotal_volume وhigh_24h وlow_24h وprice_change_percentage_24h وcirculating_supply وtotal_supply وmax_supply وath وatl مع تواريخها، وimage. انتقل بين الصفحات بـ per_page وpage، ورتّب بـ order (القيمة السوقية أو الحجم أو المعرّف، تصاعديًا أو تنازليًا)، وضيّق بـ ids أو category. تمرير price_change_percentage يضيف حقلًا مطابقًا price_change_percentage_24h_in_currency. استخدمه للوحات الصدارة ومسح القطاعات. لسعر بضع عملات معروفة، get_coingecko_simple_price أخف بكثير؛ ولعملة واحدة بالكامل استخدم get_coingecko_coins_id.
مرجع التسعير
- القياس: وحدات موارد الخطة.
- تقدير الطلب المرجعي: 0.008 دولار أمريكي.
- أساس تكلفة الوحدة: 0.0 دولار أمريكي.
- وحدة المورد:
provider_credit. - لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.
بيانات مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringcategory
التصفية حسب فئة العملات. *يشير إلى
/coins/categories/list - النوع: stringids
معرّفات العملات، مفصولة بفواصل عند الاستعلام عن أكثر من عملة. *يشير إلى
/coins/list - النوع: booleaninclude
_rehypothecated تضمين الرموز المعاد رهنها في النتائج. عند true، يُعاد الحقل
market_cap_rank_with_rehypothecated. الافتراضي: false - النوع: string تعدادinclude
_tokens لعمليات البحث بـ
symbols، حدّدallلتضمين جميع الرموز المطابقة. الافتراضيtopيرجع الرموز الأعلى ترتيبًا حسب القيمة السوقية أو الحجم.القيم- top
- all
- النوع: string تعدادlocale
لغة الخلفية. الافتراضي: en
القيم- ar
- bg
- cs
- da
- de
- النوع: stringnames
أسماء العملات، مفصولة بفواصل عند الاستعلام عن أكثر من عملة.
- النوع: string تعدادorder
ترتيب النتائج حسب الحقل. الافتراضي: market_cap_desc
القيم- market
_cap _asc - market
_cap _desc - volume
_asc - volume
_desc - id
_asc - id
_desc
- النوع: integerpage
التنقل بين صفحات النتائج. الافتراضي: 1
- النوع: integerper
_page إجمالي النتائج لكل صفحة. الافتراضي: 100 القيم الصالحة: 1...250
- النوع: string تعدادprecision
المنازل العشرية لقيمة سعر العملة
القيم- full
- 0
- 1
- 2
- 3
- النوع: stringprice
_change _percentage تضمين النسبة المئوية لتغيّر السعر للفترة الزمنية، مفصولة بفواصل عند الاستعلام عن أكثر من فترة. القيم الصالحة:
1h،24h،7d،14d،30d،200d،1y - النوع: booleansparkline
تضمين بيانات sparkline لسبعة أيام. الافتراضي: false
- النوع: stringsymbols
رموز العملات، مفصولة بفواصل عند الاستعلام عن أكثر من عملة.
- النوع: stringvs
_currency مطلوبالعملة الهدف لبيانات العملات والسوق. *يشير إلى
/simple/supported_vs_currencies
- النوع: array object[] · Response860C3Ae68Ea5_CoinsMarkets200
قائمة العملات مع بيانات السوق
- athالنوع: number | nullمطلوب
أعلى سعر على الإطلاق بالعملة المستهدفة
- athالنوع: number | null
_change _percentage مطلوبنسبة تغيّر أعلى مستوى على الإطلاق
- athالنوع: string | null التنسيق: date-time
_date مطلوبتاريخ أعلى مستوى على الإطلاق
- atlالنوع: number | nullمطلوب
أدنى سعر على الإطلاق بالعملة المستهدفة
- atlالنوع: number | null
_change _percentage مطلوبنسبة تغيّر أدنى مستوى على الإطلاق
- atlالنوع: string | null التنسيق: date-time
_date مطلوبتاريخ أدنى مستوى على الإطلاق
- circulatingالنوع: number | null
_supply مطلوبالمعروض المتداول
- currentالنوع: number | null
_price مطلوبالسعر الحالي بالعملة المستهدفة
- fullyالنوع: number | null
_diluted _valuation مطلوبالقيمة المخفّفة بالكامل بالعملة المستهدفة
- highالنوع: number | null
_24h مطلوبأعلى سعر خلال 24 ساعة بالعملة المستهدفة
- idالنوع: stringمطلوب
معرّف العملة
- imageالنوع: stringمطلوب
عنوان URL لصورة العملة
- lastالنوع: string التنسيق: date-time
_updated مطلوبالطابع الزمني لآخر تحديث
- lowالنوع: number | null
_24h مطلوبأدنى سعر خلال 24 ساعة بالعملة المستهدفة
- marketالنوع: number | null
_cap مطلوبالقيمة السوقية بالعملة المستهدفة
- marketالنوع: number | null
_cap _change _24h مطلوبتغيّر القيمة السوقية خلال 24 ساعة بالعملة المستهدفة
- marketالنوع: number | null
_cap _change _percentage _24h مطلوبنسبة تغيّر القيمة السوقية خلال 24 ساعة
- marketالنوع: integer | null
_cap _rank مطلوبترتيب القيمة السوقية
- maxالنوع: number | null
_supply مطلوبالحد الأقصى للمعروض
- nameالنوع: stringمطلوب
اسم العملة
- priceالنوع: number | null
_change _24h مطلوبتغيّر السعر خلال 24 ساعة بالعملة المستهدفة
- priceالنوع: number | null
_change _percentage _24h مطلوبنسبة تغيّر السعر خلال 24 ساعة
- roiالنوع: object | nullمطلوب
بيانات العائد على الاستثمار
- currencyالنوع: string
عملة ROI
- percentageالنوع: number
نسبة ROI
- timesالنوع: number
مضاعف ROI
- symbolالنوع: stringمطلوب
رمز العملة
- totalالنوع: number | null
_supply مطلوبإجمالي المعروض
- totalالنوع: number | null
_volume مطلوبإجمالي حجم التداول بالعملة المستهدفة
- marketالنوع: integer | null
_cap _rank _with _rehypothecated ترتيب القيمة السوقية شاملًا الرموز المعاد رهنها
- priceالنوع: number | null
_change _percentage _14d _in _currency نسبة تغيّر السعر خلال 14 يومًا بالعملة المستهدفة
- priceالنوع: number | null
_change _percentage _1h _in _currency نسبة تغيّر السعر خلال ساعة واحدة بالعملة المستهدفة
- priceالنوع: number | null
_change _percentage _1y _in _currency نسبة تغيّر السعر خلال سنة واحدة بالعملة المستهدفة
- priceالنوع: number | null
_change _percentage _200d _in _currency نسبة تغيّر السعر خلال 200 يوم بالعملة المستهدفة
- priceالنوع: number | null
_change _percentage _24h _in _currency نسبة تغيّر السعر خلال 24 ساعة بالعملة المستهدفة
- priceالنوع: number | null
_change _percentage _30d _in _currency نسبة تغيّر السعر خلال 30 يومًا بالعملة المستهدفة
- priceالنوع: number | null
_change _percentage _7d _in _currency نسبة تغيّر السعر خلال 7 أيام بالعملة المستهدفة
- sparklineالنوع: object
_in _7d بيانات أسعار المخطط المصغّر لآخر 7 أيام
- priceالنوع: array number[]
مصفوفة قيم الأسعار
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl 'https://openapi.felo.ai/v1/beta/coingecko/coins/markets?vs_currency=usd' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
{
"id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
"current_price": 77671,
"market_cap": 1555886872303,
"market_cap_rank": 1,
"fully_diluted_valuation": 1555914058873,
"total_volume": 33235034316,
"high_24h": 78419,
"low_24h": 76696,
"price_change_24h": -747.3360347281705,
"price_change_percentage_24h": -0.95302,
"market_cap_change_24h": -15184401491.513184,
"market_cap_change_percentage_24h": -0.9665,
"circulating_supply": 20030493,
"total_supply": 20030843,
"max_supply": 21000000,
"ath": 126080,
"ath_change_percentage": -38.39571,
"ath_date": "2025-10-06T18:57:42.558Z",
"atl": 67.81,
"atl_change_percentage": 114443.23093,
"atl_date": "2013-07-06T00:00:00.000Z",
"roi": null,
"last_updated": "2026-05-18T12:49:21.599Z",
"market_cap_rank_with_rehypothecated": 1,
"sparkline_in_7d": {
"price": [
81045.84776489827,
81001.73089268175,
80898.20817826076
]
},
"price_change_percentage_1h_in_currency": 0.5823392426906319,
"price_change_percentage_24h_in_currency": -0.9530164743774191,
"price_change_percentage_7d_in_currency": -4.042267423689584,
"price_change_percentage_14d_in_currency": -1.5720857443461431,
"price_change_percentage_30d_in_currency": 1.9453890367549207,
"price_change_percentage_200d_in_currency": -29.452371850925864,
"price_change_percentage_1y_in_currency": -25.214612207475373
}
]