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 درصد تغییر قیمت 1 ساعته به تفکیک واحد پول
- propertyنوع: number
Name
- priceنوع: number
_change _percentage _1y درصد تغییر قیمت 1 ساله
- priceنوع: object
_change _percentage _1y _in _currency درصد تغییر قیمت 1 ساله به تفکیک واحد پول
- 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 دادههای قیمت اسپارکلاین 7 روزه
- 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
}
]
}