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

GET /coins/{id}

Coin Data by ID

cURL

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id} \
  --header 'x-cg-pro-api-key: <api-key>'

200

{
  "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

TypeScript

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

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

Authorizations

headerAuthqueryAuth

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

Show child attributes

detail_platforms · object · required

Detailed coin asset platform and contract address

Show child attributes

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

Show child attributes

links · object · required

Links

Show child attributes

image · object · required

Coin image URL

Show child attributes

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

Show child attributes

last_updated · string · required

Last updated timestamp

categories_details · object[]

Detailed coin categories

Show child attributes

localization · object

Coin name localization

Show child attributes

ico_data · object

ICO data

Show child attributes

market_data · object

Market data

Show child attributes

community_data · object

Community data

Show child attributes

developer_data · object

Developer data

Show child attributes

tickers · object[]

Tickers

Show child attributes