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 برای نمایش پایه و هدف جفت DEX بهصورت نمادها، آن را روی
symbolبگذارید. پیشفرض: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 درصد تغییر قیمت 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/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
}
]
}