CoinGecko
Cryptocurrency prices, market data and historical series.
بيانات العملة حسب عنوان الرمز
ملف تعريف كامل لعملة يُبحث عنه بعنوان العقد بدلًا من معرّف CoinGecko. id هو منصة الأصول وcontract_address هو الرمز؛ كلاهما مطلوب ولا توجد معاملات أخرى. يعيد الشكل نفسه الذي يعيده get_coingecko_coins_id — description وlinks وimage وcategories وplatforms وdetail_platforms وmarket_cap_rank وكتلة market_data ومصفوفة tickers مضمّنة — إضافةً إلى contract_address نفسه. استخدمه لتحديد رمز غير معروف من عنوان. إذا كنت تحتاج السعر الحالي فقط، فإن get_coingecko_simple_token_price_id أخف بكثير.
مرجع التسعير
- القياس: وحدات موارد الخطة.
- تقدير الطلب المرجعي: 0.008 دولار أمريكي.
- أساس تكلفة الوحدة: 0.0 دولار أمريكي.
- وحدة المورد:
provider_credit. - لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.
بيانات مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringcontract
_address مطلوبعنوان عقد الرمز.
- النوع: stringidمطلوب
معرّف منصة الأصول. *يشير إلى
/asset_platforms.
- النوع: object · Response860C3Ae68Ea5_CoinsContractAddress200
بيانات العملة حسب عنوان عقد الرمز
- النوع: array string[]additional
_notices مطلوبإشعارات إضافية
- النوع: string | nullasset
_platform _id مطلوبمعرّف منصة أصول العملة
- النوع: numberblock
_time _in _minutes مطلوبزمن كتلة البلوكتشين بالدقائق
- النوع: array string[]categoriesمطلوب
فئات العملة
- النوع: stringcontract
_address مطلوبعنوان عقد العملة
- النوع: stringcountry
_origin مطلوببلد المنشأ
- النوع: objectdescriptionمطلوب
وصف العملة
- propertyالنوع: string
Name
- النوع: objectdetail
_platforms مطلوبتفاصيل منصة أصول العملة وعنوان العقد
- propertyالنوع: object
Name - contractالنوع: string
_address عنوان عقد الرمز
- decimalالنوع: integer | null
_place عدد الخانات العشرية للرمز
- geckoterminalالنوع: string
_url عنوان URL لـGeckoTerminal
- النوع: 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 | null
_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 مطلوبمعرّف الويب للعملة
- النوع: 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/ethereum/contract/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"id": "weth",
"symbol": "weth",
"name": "WETH",
"web_slug": "weth",
"asset_platform_id": "ethereum",
"platforms": {
"ethereum": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"terra-2": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674",
"tron": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
},
"detail_platforms": {
"ethereum": {
"decimal_place": 18,
"contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"geckoterminal_url": "https://www.geckoterminal.com/eth/tokens/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
},
"terra-2": {
"decimal_place": 18,
"contract_address": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674"
},
"tron": {
"decimal_place": 18,
"contract_address": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF",
"geckoterminal_url": "https://www.geckoterminal.com/tron/tokens/THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
}
},
"block_time_in_minutes": 0,
"hashing_algorithm": null,
"categories": [
"Crypto-Backed Tokens",
"Wrapped-Tokens",
"Terra Ecosystem",
"Ethereum Ecosystem",
"FTX Holdings",
"Tron Ecosystem",
"Index Coop Defi Index"
],
"preview_listing": false,
"public_notice": null,
"additional_notices": [],
"has_supply_breakdown": false,
"localization": {
"en": "WETH",
"de": "",
"es": "",
"fr": "",
"it": "",
"pl": "",
"ro": "",
"hu": "",
"nl": "",
"pt": ""
},
"description": {
"en": "What is WETH (Wrapped ETH)?\nWETH is the tokenized/packaged form of ETH..."
},
"links": {
"homepage": [
"https://ethereum.org/en/wrapped-eth"
],
"whitepaper": "",
"blockchain_site": [
"https://etherscan.io/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"https://intel.arkm.com/explorer/token/weth"
],
"official_forum_url": [],
"chat_url": [],
"announcement_url": [],
"snapshot_url": null,
"twitter_screen_name": "",
"facebook_username": "",
"bitcointalk_thread_identifier": null,
"telegram_channel_identifier": "",
"subreddit_url": null,
"repos_url": {
"github": [],
"bitbucket": []
}
},
"image": {
"thumb": "https://coin-images.coingecko.com/coins/images/2518/thumb/weth.png?1696503332",
"small": "https://coin-images.coingecko.com/coins/images/2518/small/weth.png?1696503332",
"large": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332"
},
"country_origin": "",
"genesis_date": "2016-06-17",
"contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"sentiment_votes_up_percentage": null,
"sentiment_votes_down_percentage": null,
"watchlist_portfolio_users": 34782,
"market_cap_rank": null,
"market_cap_rank_with_rehypothecated": 30,
"market_data": {
"current_price": {
"btc": 0.02728343,
"eth": 0.99972363,
"usd": 2115.04
},
"total_value_locked": null,
"mcap_to_tvl_ratio": null,
"fdv_to_tvl_ratio": null,
"roi": null,
"ath": {
"btc": 0.14280504,
"eth": 3.614831,
"usd": 4950.08
},
"ath_change_percentage": {
"btc": -80.89678,
"eth": -72.33124,
"usd": -57.2622
},
"ath_date": {
"btc": "2018-09-02T00:00:00.000Z",
"eth": "2018-09-13T00:00:00.000Z",
"usd": "2025-08-24T19:28:11.411Z"
},
"atl": {
"btc": 0.00890197,
"eth": 0.22395179,
"usd": 82.1
},
"atl_change_percentage": {
"btc": 206.45314,
"eth": 346.6045,
"usd": 2476.69436
},
"atl_date": {
"btc": "2025-09-02T07:56:48.935Z",
"eth": "2025-09-02T07:56:48.935Z",
"usd": "2018-12-15T00:00:00.000Z"
},
"market_cap": {
"btc": 61868,
"eth": 2267403,
"usd": 4793905266
},
"market_cap_rank": null,
"outstanding_token_value_usd": null,
"market_cap_rank_with_rehypothecated": 30,
"fully_diluted_valuation": {
"btc": 61868,
"eth": 2267403,
"usd": 4793905266
},
"market_cap_fdv_ratio": 1,
"total_volume": {
"btc": 107.294,
"eth": 3931,
"usd": 8317546
},
"high_24h": {
"btc": 0.02756131,
"eth": 1.00272,
"usd": 2125.08
},
"low_24h": {
"btc": 0.02717062,
"eth": 0.99799697,
"usd": 2068.79
},
"price_change_24h": -3.316519511214,
"price_change_percentage_24h": -0.15656,
"price_change_percentage_7d": -0.0669,
"price_change_percentage_14d": -9.45938,
"price_change_percentage_30d": -8.82256,
"price_change_percentage_60d": 1.63545,
"price_change_percentage_200d": -37.57849,
"price_change_percentage_1y": -14.56267,
"market_cap_change_24h": -12121742.79577,
"market_cap_change_percentage_24h": -0.25222,
"price_change_24h_in_currency": {
"btc": -0.000274386252168236,
"eth": -0.000212661454704888,
"usd": -3.3165195112137553
},
"price_change_percentage_1h_in_currency": {
"btc": -0.19183,
"eth": 0.00019,
"usd": -0.00865
},
"price_change_percentage_24h_in_currency": {
"btc": -0.99568,
"eth": -0.02127,
"usd": -0.15656
},
"price_change_percentage_7d_in_currency": {
"btc": -0.89914,
"eth": -0.05304,
"usd": -0.0669
},
"price_change_percentage_14d_in_currency": {
"btc": -5.49184,
"eth": -0.04201,
"usd": -9.45938
},
"price_change_percentage_30d_in_currency": {
"btc": -8.68383,
"eth": -0.02751,
"usd": -8.82256
},
"price_change_percentage_60d_in_currency": {
"btc": -8.8249,
"eth": 0.0505,
"usd": 1.63545
},
"price_change_percentage_200d_in_currency": {
"btc": -17.15793,
"eth": -0.10813,
"usd": -37.57849
},
"price_change_percentage_1y_in_currency": {
"btc": 18.09057,
"eth": 0.19761,
"usd": -14.56267
},
"market_cap_change_24h_in_currency": {
"btc": -635.7460114267669,
"eth": -986.7877555103041,
"usd": -12121742.795770645
},
"market_cap_change_percentage_24h_in_currency": {
"btc": -1.01713,
"eth": -0.0435,
"usd": -0.25222
},
"total_supply": 2267926.915444636,
"max_supply": null,
"max_supply_infinite": true,
"circulating_supply": 2267926.915444636,
"outstanding_supply": null,
"last_updated": "2026-05-25T10:09:02.821Z"
},
"status_updates": [],
"last_updated": "2026-05-25T10:09:02.821Z",
"tickers": [
{
"base": "WETH",
"target": "USDC",
"market": {
"name": "Native",
"identifier": "native",
"has_trading_incentive": false
},
"last": 2114.7318378964214,
"volume": 2999.739679821518,
"converted_last": {
"btc": 0.02728106,
"eth": 1.000065,
"usd": 2114.1
},
"converted_volume": {
"btc": 81.256,
"eth": 2979,
"usd": 6296774
},
"trust_score": null,
"bid_ask_spread_percentage": 0.04287,
"timestamp": "2026-05-25T10:04:42+00:00",
"last_traded_at": "2026-05-25T10:04:42+00:00",
"last_fetch_at": "2026-05-25T10:04:42+00:00",
"is_anomaly": false,
"is_stale": false,
"trade_url": "https://native.org/app/swap/",
"token_info_url": null,
"coin_id": "weth",
"target_coin_id": "usd-coin",
"coin_mcap_usd": 4793905265.563903
}
]
}