CoinGecko
Cryptocurrency prices, market data and historical series.
بيانات العملة حسب المعرّف
كل ما تحتفظ به CoinGecko عن عملة واحدة، محددة بـ id: description وlinks وimage وcategories وplatforms وdetail_platforms (عناوين العقود لكل سلسلة) وmarket_cap_rank، وكتلة market_data تحمل current_price وmarket_cap وtotal_volume وfully_diluted_valuation وath وatl مع التواريخ ونسب التغيّر. الأقسام الثقيلة اختيارية عبر market_data وcommunity_data وdeveloper_data وtickers وsparkline وlocalization — اتركها معطّلة إلا عند الحاجة، فالحمولة الكاملة كبيرة. استخدمه لملف تعريف عملة. لجدول أسعار عبر عملات كثيرة استخدم get_coingecko_coins_markets؛ لبحث العملة نفسها بعنوان العقد استخدم get_coingecko_token_data.
مرجع التسعير
- القياس: وحدات موارد الخطة.
- تقدير الطلب المرجعي: 0.008 دولار أمريكي.
- أساس تكلفة الوحدة: 0.0 دولار أمريكي.
- وحدة المورد:
provider_credit. - لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.
بيانات مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringidمطلوب
معرّف العملة. *يشير إلى
/coins/list
- النوع: booleancommunity
_data مهملتضمين بيانات المجتمع. مهمل: لا أثر له اعتبارًا من 28 أغسطس 2026؛ فلم يعد الكائن
community_dataيُعاد. - النوع: booleandeveloper
_data مهملتضمين بيانات المطوّرين. مهمل: لا أثر له اعتبارًا من 28 أغسطس 2026؛ فلم يعد الكائن
developer_dataيُعاد. - النوع: string تعدادdex
_pair _format اضبطه على
symbolلعرض أساس زوج DEX وهدفه كرموز. الافتراضي:contract_addressالقيم- contract
_address - symbol
- النوع: booleaninclude
_categories _details تضمين تفاصيل الفئات. الافتراضي: false
- النوع: booleanlocalization
تضمين جميع اللغات المترجمة في الاستجابة. الافتراضي: true
- النوع: booleanmarket
_data تضمين بيانات السوق. الافتراضي: true
- النوع: booleansparkline
تضمين بيانات sparkline لسبعة أيام. الافتراضي: false
- النوع: booleantickers
تضمين بيانات رموز التداول. الافتراضي: true
- النوع: object · Response860C3Ae68Ea5_CoinsID200
بيانات العملة
- النوع: array string[]additional
_notices مطلوبإشعارات إضافية
- النوع: string | nullasset
_platform _id مطلوبمعرّف منصة أصول العملة
- النوع: numberblock
_time _in _minutes مطلوبزمن كتلة البلوكتشين بالدقائق
- النوع: array string[]categoriesمطلوب
فئات العملة
- النوع: stringcountry
_origin مطلوببلد المنشأ
- النوع: objectdescriptionمطلوب
وصف العملة
- propertyالنوع: string
Name
- النوع: objectdetail
_platforms مطلوبتفاصيل منصة أصول العملة وعنوان العقد
- propertyالنوع: object
Name - contractالنوع: string
_address عنوان عقد الرمز
- decimalالنوع: integer | null
_place عدد الخانات العشرية للرمز
- النوع: string | nullgenesis
_date مطلوبتاريخ التكوين
- النوع: booleanhas
_supply _breakdown مطلوبما إذا كانت بيانات تفصيل المعروض متاحة عبر /coins/supply_breakdown
- النوع: string | nullhashing
_algorithm مطلوبخوارزمية تجزئة البلوكتشين
- النوع: stringidمطلوب
معرّف العملة
- النوع: objectimageمطلوب
عنوان URL لصورة العملة
- largeالنوع: string
- smallالنوع: string
- thumbالنوع: string
- النوع: stringlast
_updated مطلوبالطابع الزمني لآخر تحديث
- النوع: objectlinksمطلوب
الروابط
- announcementالنوع: array string[]
_url عنوان URL للإعلان
- bitcointalkالنوع: integer | null
_thread _identifier معرّف موضوع Bitcointalk
- blockchainالنوع: array string[]
_site عنوان URL لمستكشف الكتل
- chatالنوع: array string[]
_url عنوان URL للدردشة
- facebookالنوع: string
_username اسم مستخدم Facebook
- homepageالنوع: array string[]
عنوان URL لموقع الويب
- officialالنوع: array string[]
_forum _url عنوان URL للمنتدى الرسمي
- reposالنوع: object
_url عنوان URL للمستودع
- bitbucketالنوع: array string[]
عنوان URL لمستودع Bitbucket
- githubالنوع: array string[]
عنوان URL لمستودع GitHub
- snapshotالنوع: string | null
_url عنوان URL للقطة
- subredditالنوع: string
_url عنوان URL لـSubreddit
- telegramالنوع: string
_channel _identifier معرّف قناة Telegram
- twitterالنوع: string
_screen _name معرّف Twitter
- whitepaperالنوع: string
عنوان URL للورقة البيضاء
- النوع: integer | nullmarket
_cap _rank مطلوبترتيب القيمة السوقية
- النوع: integer | nullmarket
_cap _rank _with _rehypothecated مطلوبترتيب القيمة السوقية شاملًا الرموز المعاد رهنها
- النوع: stringnameمطلوب
اسم العملة
- النوع: objectplatformsمطلوب
منصة أصول العملة وعنوان العقد
- propertyالنوع: string
Name
- النوع: booleanpreview
_listing مطلوبعملة في معاينة الإدراج
- النوع: string | nullpublic
_notice مطلوبإشعار عام
- النوع: number | nullsentiment
_votes _down _percentage مطلوبنسبة أصوات المشاعر السلبية
- النوع: number | nullsentiment
_votes _up _percentage مطلوبنسبة أصوات المشاعر الإيجابية
- النوع: array object[]status
_updates مطلوبتحديثات الحالة
- categoryالنوع: string
فئة تحديث الحالة
- createdالنوع: string
_at وقت إنشاء تحديث الحالة
- descriptionالنوع: string
وصف تحديث الحالة
- userالنوع: string
مستخدم تحديث الحالة
- userالنوع: string
_title عنوان المستخدم في تحديث الحالة
- النوع: stringsymbolمطلوب
رمز العملة
- النوع: numberwatchlist
_portfolio _users مطلوبعدد المستخدمين الذين يراقبون هذه العملة في المحفظة
- النوع: stringweb
_slug مطلوبمعرّف الويب للعملة
- النوع: array object[]categories
_details فئات العملات التفصيلية
- idالنوع: string
معرّف الفئة
- nameالنوع: string
اسم الفئة
- النوع: object | nullico
_data بيانات ICO
- acceptingالنوع: string
_currencies العملات المقبولة
- amountالنوع: number
_for _sale المبلغ المعروض للبيع
- baseالنوع: number
_pre _sale _amount مبلغ البيع المسبق الأساسي
- baseالنوع: number
_public _sale _amount مبلغ البيع العام الأساسي
- bountyالنوع: string
_detail _url عنوان URL لتفاصيل المكافأة
- countryالنوع: string
_origin بلد المنشأ
- descriptionالنوع: string
وصف تفصيلي
- hardcapالنوع: number
_amount مبلغ الحد الأقصى للتمويل
- hardcapالنوع: string
_currency عملة الحد الأقصى للتمويل
- icoالنوع: string
_end _date تاريخ انتهاء ICO
- icoالنوع: string
_start _date تاريخ بدء ICO
- kycالنوع: boolean
_required KYC مطلوب
- linksالنوع: object
روابط ICO ذات الصلة
- propertyالنوع: string
Name
- preالنوع: boolean
_sale _available البيع المسبق متاح
- preالنوع: string
_sale _end _date تاريخ انتهاء البيع المسبق
- preالنوع: boolean
_sale _ended انتهاء البيع المسبق
- preالنوع: string
_sale _start _date تاريخ بدء البيع المسبق
- quoteالنوع: number
_pre _sale _amount مبلغ البيع المسبق بعملة التسعير
- quoteالنوع: string
_pre _sale _currency عملة تسعير البيع المسبق
- quoteالنوع: number
_public _sale _amount مبلغ البيع العام بعملة التسعير
- quoteالنوع: string
_public _sale _currency عملة تسعير البيع العام
- shortالنوع: string
_desc وصف مختصر
- softcapالنوع: number
_amount مبلغ الحد الأدنى للتمويل
- softcapالنوع: string
_currency عملة الحد الأدنى للتمويل
- totalالنوع: number
_raised إجمالي المبلغ المجموع
- totalالنوع: string
_raised _currency عملة إجمالي المبلغ المجموع
- whitelistالنوع: boolean
_available القائمة البيضاء متاحة
- whitelistالنوع: string
_end _date تاريخ انتهاء القائمة البيضاء
- whitelistالنوع: string
_start _date تاريخ بدء القائمة البيضاء
- whitelistالنوع: string
_url عنوان URL للقائمة البيضاء
- النوع: objectlocalization
توطين اسم العملة
- propertyالنوع: string
Name
- النوع: objectmarket
_data بيانات السوق
- athالنوع: object
أعلى مستوى على الإطلاق بالعملة المستهدفة
- propertyالنوع: number
Name
- athالنوع: object
_change _percentage نسبة تغيّر أعلى مستوى على الإطلاق
- propertyالنوع: number
Name
- athالنوع: object
_date تاريخ أعلى مستوى على الإطلاق
- propertyالنوع: string
Name
- atlالنوع: object
أدنى مستوى على الإطلاق بالعملة المستهدفة
- propertyالنوع: number
Name
- atlالنوع: object
_change _percentage نسبة تغيّر أدنى مستوى على الإطلاق
- propertyالنوع: number
Name
- atlالنوع: object
_date تاريخ أدنى مستوى على الإطلاق
- propertyالنوع: string
Name
- circulatingالنوع: number
_supply المعروض المتداول
- currentالنوع: object
_price السعر الحالي بالعملة المستهدفة
- propertyالنوع: number
Name
- fdvالنوع: number | null
_to _tvl _ratio نسبة FDV إلى TVL
- fullyالنوع: object
_diluted _valuation القيمة المخفّفة بالكامل بالعملة المستهدفة
- propertyالنوع: number
Name
- highالنوع: object
_24h أعلى سعر خلال 24 ساعة بالعملة المستهدفة
- propertyالنوع: number
Name
- lastالنوع: string
_updated طابع وقت آخر تحديث لبيانات السوق
- lowالنوع: object
_24h أدنى سعر خلال 24 ساعة بالعملة المستهدفة
- propertyالنوع: number
Name
- marketالنوع: object
_cap القيمة السوقية بالعملة المستهدفة
- propertyالنوع: number
Name
- marketالنوع: number
_cap _change _24h تغيّر القيمة السوقية خلال 24 ساعة بالعملة المستهدفة
- marketالنوع: object
_cap _change _24h _in _currency تغيّر القيمة السوقية خلال 24 ساعة بالعملة المستهدفة
- propertyالنوع: number
Name
- marketالنوع: number
_cap _change _percentage _24h نسبة تغيّر القيمة السوقية خلال 24 ساعة
- marketالنوع: object
_cap _change _percentage _24h _in _currency نسبة تغيّر القيمة السوقية خلال 24 ساعة لكل عملة
- propertyالنوع: number
Name
- marketالنوع: number
_cap _fdv _ratio نسبة القيمة السوقية إلى FDV
- marketالنوع: integer | null
_cap _rank ترتيب القيمة السوقية
- marketالنوع: integer | null
_cap _rank _with _rehypothecated ترتيب القيمة السوقية شاملًا الرموز المعاد رهنها
- maxالنوع: number | null
_supply الحد الأقصى للمعروض
- maxالنوع: boolean
_supply _infinite الحد الأقصى للمعروض غير محدود
- mcapالنوع: number | null
_to _tvl _ratio نسبة القيمة السوقية إلى TVL
- outstandingالنوع: number | null
_supply الرموز المتداولة في السوق
- outstandingالنوع: number | null
_token _value _usd قيمة الرموز المتداولة بالدولار الأمريكي
- priceالنوع: number
_change _24h تغيّر السعر خلال 24 ساعة بالعملة المستهدفة
- priceالنوع: object
_change _24h _in _currency تغيّر السعر خلال 24 ساعة بالعملة المستهدفة
- propertyالنوع: number
Name
- priceالنوع: number
_change _percentage _14d نسبة تغيّر السعر خلال 14 يومًا
- priceالنوع: object
_change _percentage _14d _in _currency نسبة تغيّر السعر خلال 14 يومًا لكل عملة
- propertyالنوع: number
Name
- priceالنوع: object
_change _percentage _1h _in _currency نسبة تغيّر السعر خلال ساعة واحدة لكل عملة
- propertyالنوع: number
Name
- priceالنوع: number
_change _percentage _1y نسبة تغيّر السعر خلال سنة واحدة
- priceالنوع: object
_change _percentage _1y _in _currency نسبة تغيّر السعر خلال سنة واحدة لكل عملة
- propertyالنوع: number
Name
- priceالنوع: number
_change _percentage _200d نسبة تغيّر السعر خلال 200 يوم
- priceالنوع: object
_change _percentage _200d _in _currency نسبة تغيّر السعر خلال 200 يوم لكل عملة
- propertyالنوع: number
Name
- priceالنوع: number
_change _percentage _24h نسبة تغيّر السعر خلال 24 ساعة
- priceالنوع: object
_change _percentage _24h _in _currency نسبة تغيّر السعر خلال 24 ساعة لكل عملة
- propertyالنوع: number
Name
- priceالنوع: number
_change _percentage _30d نسبة تغيّر السعر خلال 30 يومًا
- priceالنوع: object
_change _percentage _30d _in _currency نسبة تغيّر السعر خلال 30 يومًا لكل عملة
- propertyالنوع: number
Name
- priceالنوع: number
_change _percentage _60d نسبة تغيّر السعر خلال 60 يومًا
- priceالنوع: object
_change _percentage _60d _in _currency نسبة تغيّر السعر خلال 60 يومًا لكل عملة
- propertyالنوع: number
Name
- priceالنوع: number
_change _percentage _7d نسبة تغيّر السعر خلال 7 أيام
- priceالنوع: object
_change _percentage _7d _in _currency نسبة تغيّر السعر خلال 7 أيام لكل عملة
- propertyالنوع: number
Name
- roiالنوع: object | null
العائد على الاستثمار
- currencyالنوع: string
عملة ROI
- percentageالنوع: number
نسبة ROI
- timesالنوع: number
مضاعف ROI
- sparklineالنوع: array number[]
_7d بيانات أسعار المخطط المصغّر لسبعة أيام
- totalالنوع: number
_supply إجمالي المعروض
- totalالنوع: number | null
_value _locked إجمالي القيمة المقفلة
- totalالنوع: object
_volume إجمالي حجم التداول بالعملة المستهدفة
- propertyالنوع: number
Name
- النوع: array object[]tickers
التيكرات
- baseالنوع: string
العملة الأساسية للتيكر
- bidالنوع: number
_ask _spread _percentage نسبة فرق سعر العرض والطلب للتيكر
- coinالنوع: string
_id معرّف العملة الأساسية للتيكر
- coinالنوع: number
_mcap _usd القيمة السوقية بالدولار الأمريكي
- convertedالنوع: object
_last آخر سعر محوّل للتيكر
- btcالنوع: number
- ethالنوع: number
- usdالنوع: number
- convertedالنوع: object
_volume الحجم المحوّل للتيكر
- btcالنوع: number
- ethالنوع: number
- usdالنوع: number
- isالنوع: boolean
_anomaly شذوذ التيكر
- isالنوع: boolean
_stale تقادم التيكر
- lastالنوع: number
آخر سعر للتيكر
- lastالنوع: string
_fetch _at طابع وقت آخر جلب للتيكر
- lastالنوع: string
_traded _at طابع وقت آخر تداول للتيكر
- marketالنوع: object
بورصة التيكر
- hasالنوع: boolean
_trading _incentive حافز التداول في البورصة
- identifierالنوع: string
معرّف البورصة
- nameالنوع: string
اسم البورصة
- targetالنوع: string
العملة المستهدفة للتيكر
- targetالنوع: string
_coin _id معرّف العملة المستهدفة للتيكر
- timestampالنوع: string
طابع وقت التيكر
- tokenالنوع: string | null
_info _url عنوان URL لمعلومات رمز التيكر
- tradeالنوع: string
_url عنوان URL لتداول التيكر
- trustالنوع: string | null
_score درجة ثقة التيكر
- volumeالنوع: 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/bitcoin \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"web_slug": "bitcoin",
"asset_platform_id": null,
"platforms": {
"": ""
},
"detail_platforms": {
"": {
"decimal_place": null,
"contract_address": ""
}
},
"block_time_in_minutes": 10,
"hashing_algorithm": "SHA-256",
"categories": [
"Cryptocurrency",
"Layer 1 (L1)"
],
"preview_listing": false,
"public_notice": null,
"additional_notices": [],
"has_supply_breakdown": false,
"description": {
"en": "Bitcoin is the first successful internet money based on peer-to-peer technology..."
},
"links": {
"homepage": [
"http://www.bitcoin.org",
"",
""
],
"whitepaper": "https://bitcoin.org/bitcoin.pdf",
"blockchain_site": [
"https://mempool.space/",
"https://blockchair.com/bitcoin/"
],
"official_forum_url": [
"https://bitcointalk.org/"
],
"chat_url": [
""
],
"announcement_url": [
"",
""
],
"snapshot_url": null,
"twitter_screen_name": "bitcoin",
"facebook_username": "bitcoins",
"bitcointalk_thread_identifier": null,
"telegram_channel_identifier": "",
"subreddit_url": "https://www.reddit.com/r/Bitcoin/",
"repos_url": {
"github": [
"https://github.com/bitcoin/bitcoin",
"https://github.com/bitcoin/bips"
],
"bitbucket": []
}
},
"image": {
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
"large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
},
"country_origin": "",
"genesis_date": "2009-01-03",
"sentiment_votes_up_percentage": 84.07,
"sentiment_votes_down_percentage": 15.93,
"watchlist_portfolio_users": 1541900,
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"status_updates": [],
"last_updated": "2024-04-07T15:24:51.021Z",
"market_data": {
"current_price": {
"btc": 1,
"eur": 64375,
"usd": 69840
},
"total_value_locked": null,
"mcap_to_tvl_ratio": null,
"fdv_to_tvl_ratio": null,
"roi": null,
"ath": {
"btc": 1.003301,
"eur": 67405,
"usd": 73738
},
"ath_change_percentage": {
"btc": -0.32896,
"eur": -4.54383,
"usd": -5.33399
},
"ath_date": {
"btc": "2024-03-02T16:05:19.446Z",
"eur": "2024-03-14T07:10:36.635Z",
"usd": "2024-03-14T07:10:36.635Z"
},
"atl": {
"btc": 0.99895134,
"eur": 51.3,
"usd": 67.81
},
"atl_change_percentage": {
"btc": 0.10408,
"eur": 125385.41242,
"usd": 102882.36498
},
"atl_date": {
"btc": "2019-10-21T00:00:00.000Z",
"eur": "2013-07-05T00:00:00.000Z",
"usd": "2013-07-06T00:00:00.000Z"
},
"market_cap": {
"btc": 19675377,
"eur": 1265825267281,
"usd": 1373296629498
},
"fully_diluted_valuation": {
"btc": 21000000,
"eur": 1351831155,
"usd": 1466577759
},
"market_cap_fdv_ratio": 1,
"market_cap_rank": 1,
"outstanding_token_value_usd": null,
"market_cap_rank_with_rehypothecated": 1,
"total_volume": {
"btc": 270165,
"eur": 17368113665,
"usd": 18867210007
},
"high_24h": {
"btc": 1,
"eur": 64343,
"usd": 69805
},
"low_24h": {
"btc": 1,
"eur": 62695,
"usd": 67985
},
"price_change_24h": 1619,
"price_change_percentage_24h": 2.37311,
"price_change_percentage_7d": -0.89706,
"price_change_percentage_14d": 6.36178,
"price_change_percentage_30d": 1.81171,
"price_change_percentage_60d": 62.54292,
"price_change_percentage_200d": 157.51875,
"price_change_percentage_1y": 149.76989,
"market_cap_change_24h": 31172487848,
"market_cap_change_percentage_24h": 2.32219,
"price_change_24h_in_currency": {
"btc": 0,
"eur": 1461.64,
"usd": 1618.95
},
"price_change_percentage_1h_in_currency": {
"btc": 0,
"eur": 0.79523,
"usd": 0.79523
},
"price_change_percentage_24h_in_currency": {
"btc": 0,
"eur": 2.32219,
"usd": 2.37311
},
"price_change_percentage_7d_in_currency": {
"btc": 0,
"eur": -1.01955,
"usd": -0.89706
},
"price_change_percentage_14d_in_currency": {
"btc": 0,
"eur": 5.84662,
"usd": 6.36178
},
"price_change_percentage_30d_in_currency": {
"btc": 0,
"eur": 2.28048,
"usd": 1.81171
},
"price_change_percentage_60d_in_currency": {
"btc": 0,
"eur": 60.98834,
"usd": 62.54292
},
"price_change_percentage_200d_in_currency": {
"btc": 0,
"eur": 148.68948,
"usd": 157.51875
},
"price_change_percentage_1y_in_currency": {
"btc": 0,
"eur": 138.20277,
"usd": 149.76989
},
"market_cap_change_24h_in_currency": {
"btc": -49432,
"eur": 28668703539,
"usd": 31172487848
},
"market_cap_change_percentage_24h_in_currency": {
"btc": -0.25084,
"eur": 2.31801,
"usd": 2.32219
},
"total_supply": 21000000,
"max_supply": 21000000,
"max_supply_infinite": false,
"circulating_supply": 19675377,
"outstanding_supply": null,
"last_updated": "2024-04-07T15:24:51.021Z"
},
"tickers": [
{
"base": "BTC",
"target": "USDT",
"market": {
"name": "Binance",
"identifier": "binance",
"has_trading_incentive": false
},
"last": 69816,
"volume": 19988.82111,
"converted_last": {
"btc": 0.99999255,
"eth": 20.441016,
"usd": 69835
},
"converted_volume": {
"btc": 19783,
"eth": 404380,
"usd": 1381537193
},
"trust_score": null,
"bid_ask_spread_percentage": 0.010014,
"timestamp": "2024-04-07T15:23:02+00:00",
"last_traded_at": "2024-04-07T15:23:02+00:00",
"last_fetch_at": "2024-04-07T15:24:00+00:00",
"is_anomaly": false,
"is_stale": false,
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
"token_info_url": null,
"coin_id": "bitcoin",
"target_coin_id": "tether",
"coin_mcap_usd": 230926944910.5146
}
]
}