curl --request GET \
--url https://api.coingecko.com/api/v3/coins/{id} \
--header 'x-cg-demo-api-key: <api-key>'{
"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
}
]
}Coin Data by ID
To query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin based on a particular coin ID
curl --request GET \
--url https://api.coingecko.com/api/v3/coins/{id} \
--header 'x-cg-demo-api-key: <api-key>'{
"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
}
]
}Notes
- Find a coin’s API ID on its CoinGecko page, via Coins List, or this Google Sheet.
- Tickers are limited to 100 items. Use Coin Tickers for more.
- Coin descriptions may contain
\r\nescape sequences that require processing for proper formatting. - When
dex_pair_format=symbol, DEX pairbaseandtargetdisplay as symbols (e.g.WETH,USDC) instead of contract addresses. - Use
last_updatedin the response to check whether the price is stale.
community_data and developer_data objects are no longer returned. The community_data and developer_data query params are kept for backward compatibility but have no effect. See the changelog for details.SDK Examples
const response = await client.coins.getID('bitcoin');
console.log(JSON.stringify(response, null, 2));
response = client.coins.get_id("bitcoin")
print(response.model_dump_json(indent=2))
Authorizations
Learn how to set up your API key
Path Parameters
Coin ID.
*refers to /coins/list
"bitcoin"
Query Parameters
Include all localized languages in the response. Default: true
Include tickers data. Default: true
Include market data. Default: true
Include community data.
Deprecated: has no effect as of 28 August 2026; the community_data object is no longer returned.
Include developer data.
Deprecated: has no effect as of 28 August 2026; the developer_data object is no longer returned.
Include sparkline 7-day data. Default: false
Include categories details. Default: false
Set to symbol to display DEX pair base and target as symbols.
Default: contract_address
contract_address, symbol Response
Coin data
Coin ID
Coin symbol
Coin name
Coin web slug
Coin asset platform ID
Blockchain block time in minutes
Blockchain hashing algorithm
Coin categories
Preview listing coin
Public notice
Additional notices
Whether detailed supply breakdown data is available via /coins/supply_breakdown
Links
Hide child attributes
Hide child attributes
Website URL
Whitepaper URL
Block explorer URL
Official forum URL
Chat URL
Announcement URL
Snapshot URL
Twitter handle
Facebook username
Bitcointalk thread identifier
Telegram channel identifier
Subreddit URL
Country of origin
Genesis date
Sentiment votes up percentage
Sentiment votes down percentage
Number of users watching this coin in portfolio
Market cap rank
Market cap rank including rehypothecated tokens
Status updates
Last updated timestamp
ICO data
Hide child attributes
Hide child attributes
ICO start date
ICO end date
Short description
Detailed description
Softcap currency
Hardcap currency
Total raised currency
Softcap amount
Hardcap amount
Total raised amount
Quote pre-sale currency
Base pre-sale amount
Quote pre-sale amount
Quote public sale currency
Base public sale amount
Quote public sale amount
Accepting currencies
Country of origin
Pre-sale start date
Pre-sale end date
Whitelist URL
Whitelist start date
Whitelist end date
Bounty detail URL
Amount for sale
KYC required
Whitelist available
Pre-sale available
Pre-sale ended
Market data
Hide child attributes
Hide child attributes
Total value locked
Market cap to TVL ratio
FDV to TVL ratio
Market cap to FDV ratio
Market cap rank
Outstanding token value in USD
Market cap rank including rehypothecated tokens
24h price change in target currency
24h price change percentage
7d price change percentage
14d price change percentage
30d price change percentage
60d price change percentage
200d price change percentage
1y price change percentage
24h market cap change in target currency
24h market cap change percentage
Total supply
Max supply
Max supply infinite
Circulating supply
Tokens outstanding in the market
Market data last updated timestamp
Sparkline 7-day price data
Tickers
Hide child attributes
Hide child attributes
Ticker base currency
Ticker target currency
Ticker last price
Ticker volume
Ticker trust score
Ticker bid-ask spread percentage
Ticker timestamp
Ticker last traded timestamp
Ticker last fetch timestamp
Ticker anomaly
Ticker stale
Ticker trade URL
Ticker token info URL
Ticker base currency coin ID
Ticker target currency coin ID
Market cap in USD
Was this page helpful?