VOOZH about

URL: https://docs.coingecko.com/reference/coins-id

⇱ Coin Data by ID - CoinGecko API


Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

Skip to main content
Coin Data by ID
curl --request GET \
 --url https://pro-api.coingecko.com/api/v3/coins/{id} \
 --header 'x-cg-pro-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"
 },
 "community_data": {
 "facebook_likes": null,
 "reddit_average_posts_48h": 7.333,
 "reddit_average_comments_48h": 384.667,
 "reddit_subscribers": 6127543,
 "reddit_accounts_active_48h": 3498,
 "telegram_channel_user_count": null
 },
 "developer_data": {
 "forks": 36433,
 "stars": 76697,
 "subscribers": 3967,
 "total_issues": 7743,
 "closed_issues": 7379,
 "pull_requests_merged": 11204,
 "pull_request_contributors": 829,
 "code_additions_deletions_4_weeks": {
 "additions": 1264,
 "deletions": -1314
 },
 "commit_count_4_weeks": 108,
 "last_4_weeks_commit_activity_series": [
 0,
 3,
 2,
 0,
 1,
 0,
 0
 ]
 },
 "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
 }
 ]
}
GET
/
coins
/
{id}
Coin Data by ID
curl --request GET \
 --url https://pro-api.coingecko.com/api/v3/coins/{id} \
 --header 'x-cg-pro-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"
 },
 "community_data": {
 "facebook_likes": null,
 "reddit_average_posts_48h": 7.333,
 "reddit_average_comments_48h": 384.667,
 "reddit_subscribers": 6127543,
 "reddit_accounts_active_48h": 3498,
 "telegram_channel_user_count": null
 },
 "developer_data": {
 "forks": 36433,
 "stars": 76697,
 "subscribers": 3967,
 "total_issues": 7743,
 "closed_issues": 7379,
 "pull_requests_merged": 11204,
 "pull_request_contributors": 829,
 "code_additions_deletions_4_weeks": {
 "additions": 1264,
 "deletions": -1314
 },
 "commit_count_4_weeks": 108,
 "last_4_weeks_commit_activity_series": [
 0,
 3,
 2,
 0,
 1,
 0,
 0
 ]
 },
 "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\n escape sequences that require processing for proper formatting.
  • When dex_pair_format=symbol, DEX pair base and target display as symbols (e.g. WETH, USDC) instead of contract addresses.
  • Use last_updated in the response to check whether the price is stale.
The has_supply_breakdown field indicates whether supply breakdown data is available for this coin. When true, use /coins/{id}/supply_breakdown to get the full breakdown.
Community data for Telegram is updated weekly. Reddit and Twitter community data are no longer supported.

SDK Examples

const response = await client.coins.getID('bitcoin');

console.log(JSON.stringify(response, null, 2));

Authorizations

x-cg-pro-api-key
string
header
required

Learn how to set up your API key

Path Parameters

id
string
default:bitcoin
required

Coin ID. *refers to /coins/list

Example:

"bitcoin"

Query Parameters

localization
boolean

Include all localized languages in the response. Default: true

tickers
boolean

Include tickers data. Default: true

market_data
boolean

Include market data. Default: true

community_data
boolean

Include community data. Default: true

developer_data
boolean

Include developer data. Default: true

sparkline
boolean

Include sparkline 7-day data. Default: false

include_categories_details
boolean

Include categories details. Default: false

dex_pair_format
enum<string>

Set to symbol to display DEX pair base and target as symbols. Default: contract_address

Available options:
contract_address,
symbol

Response

200 - application/json

Coin data

id
string
required

Coin ID

symbol
string
required

Coin symbol

name
string
required

Coin name

web_slug
string
required

Coin web slug

asset_platform_id
string | null
required

Coin asset platform ID

platforms
object
required

Coin asset platform and contract address

detail_platforms
object
required

Detailed coin asset platform and contract address

block_time_in_minutes
number
required

Blockchain block time in minutes

hashing_algorithm
string | null
required

Blockchain hashing algorithm

categories
string[]
required

Coin categories

preview_listing
boolean
required

Preview listing coin

public_notice
string | null
required

Public notice

additional_notices
string[]
required

Additional notices

has_supply_breakdown
boolean
required

Whether detailed supply breakdown data is available via /coins/supply_breakdown

description
object
required

Coin description

Links

image
object
required

Coin image URL

country_origin
string
required

Country of origin

genesis_date
string | null
required

Genesis date

sentiment_votes_up_percentage
number | null
required

Sentiment votes up percentage

sentiment_votes_down_percentage
number | null
required

Sentiment votes down percentage

watchlist_portfolio_users
number
required

Number of users watching this coin in portfolio

market_cap_rank
integer | null
required

Market cap rank

market_cap_rank_with_rehypothecated
integer | null
required

Market cap rank including rehypothecated tokens

status_updates
object[]
required

Status updates

last_updated
string
required

Last updated timestamp

categories_details
object[]

Detailed coin categories

localization
object

Coin name localization

ico_data
object

ICO data

market_data
object

Market data

community_data
object

Community data

developer_data
object

Developer data

tickers
object[]

Tickers

Was this page helpful?