--- title: "Coin Data by ID" method: GET path: "/coins/{id}" tags: ["Coins"] --- # Coin Data by ID `GET /coins/{id}` This endpoint allows you to **query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin from the CoinGecko coin page based on a particular coin ID** ## Path parameters - `id` string, required ## Query parameters - `localization` boolean - `tickers` boolean - `market_data` boolean - `community_data` boolean - `developer_data` boolean - `sparkline` boolean - `include_categories_details` boolean - `dex_pair_format` 'contract_address' | 'symbol' ## Response `200` Get current data for a coin - CoinsID - `id` string — coin ID - `symbol` string — coin symbol - `name` string — coin name - `web_slug` string — coin web slug - `asset_platform_id` string — coin asset platform ID - `platforms` object — coin asset platform and contract address - `detail_platforms` object — detailed coin asset platform and contract address - `block_time_in_minutes` number — blockchain block time in minutes - `hashing_algorithm` string — blockchain hashing algorithm - `categories` string[] — coin categories - `categories_details` object[] — detailed coin categories - `id` string — category ID - `name` string — category name - `preview_listing` boolean — preview listing coin - `public_notice` string — public notice - `additional_notices` string[] — additional notices - `localization` object — coin name localization - `description` object — coin description - `links` object — links - `homepage` string[] — coin website url - `whitepaper` string[] — coin whitepaper url - `blockchain_site` string[] — coin block explorer url - `official_forum_url` string[] — coin official forum url - `chat_url` string[] — coin chat url - `announcement_url` string[] — coin announcement url - `snapshot_url` string — coin snapshot url - `twitter_screen_name` string — coin twitter handle - `facebook_username` string — coin facebook username - `bitcointalk_thread_identifier` string — coin bitcointalk thread identifier - `telegram_channel_identifier` string — coin telegram channel identifier - `subreddit_url` string — coin subreddit url - `repos_url` object — coin repository url - `github` string[] — coin github repository url - `bitbucket` string[] — coin bitbucket repository url - `image` object — coin image url - `thumb` string - `small` string - `large` string - `country_origin` string — coin country of origin - `genesis_date` string, date-time — coin genesis date - `sentiment_votes_up_percentage` number — coin sentiment votes up percentage - `sentiment_votes_down_percentage` number — coin sentiment votes down percentage - `ico_data` object — coin ICO data - `ico_start_date` string, date-time — ICO start date - `ico_end_date` string, date-time — ICO end date - `short_desc` string — short description - `description` string — detailed description - `links` object — ICO related links - `softcap_currency` string — softcap currency - `hardcap_currency` string — hardcap currency - `total_raised_currency` string — total raised currency - `softcap_amount` number — softcap amount - `hardcap_amount` number — hardcap amount - `total_raised` number — total raised amount - `quote_pre_sale_currency` string — quote pre-sale currency - `base_pre_sale_amount` number — base pre-sale amount - `quote_pre_sale_amount` number — quote pre-sale amount - `quote_public_sale_currency` string — quote public sale currency - `base_public_sale_amount` number — base public sale amount - `quote_public_sale_amount` number — quote public sale amount - `accepting_currencies` string — accepting currencies - `country_origin` string — country of origin - `pre_sale_start_date` string, date-time — pre-sale start date - `pre_sale_end_date` string, date-time — pre-sale end date - `whitelist_url` string — whitelist url - `whitelist_start_date` string, date-time — whitelist start date - `whitelist_end_date` string, date-time — whitelist end date - `bounty_detail_url` string — bounty detail url - `amount_for_sale` number — amount for sale - `kyc_required` boolean — KYC required - `whitelist_available` boolean — whitelist available - `pre_sale_available` boolean — pre-sale available - `pre_sale_ended` boolean — pre-sale ended - `watchlist_portfolio_users` number — number of users watching this coin in portfolio - `market_cap_rank` number — coin rank by market cap - `market_data` object — coin market data - `current_price` object — coin current price in currency - `btc` number - `eur` number - `usd` number - `total_value_locked` number — total value locked - `mcap_to_tvl_ratio` number — market cap to total value locked ratio - `fdv_to_tvl_ratio` number — fully diluted valuation to total value locked ratio - `roi` number — coin return on investment - `ath` object — coin all time high (ATH) in currency - `btc` number - `eur` number - `usd` number - `ath_change_percentage` object — coin all time high (ATH) change in percentage - `btc` number - `eur` number - `usd` number - `ath_date` object — coin all time high (ATH) date - `btc` string - `eur` string - `usd` string - `atl` object — coin all time low (atl) in currency - `btc` number - `eur` number - `usd` number - `atl_change_percentage` object — coin all time low (atl) change in percentage - `btc` number - `eur` number - `usd` number - `atl_date` object — coin all time low (atl) date - `btc` string - `eur` string - `usd` string - `market_cap` object — coin market cap in currency - `btc` number - `eur` number - `usd` number - `market_cap_rank` number — coin rank by market cap - `fully_diluted_valuation` object — coin fully diluted valuation (fdv) in currency - `btc` number - `eur` number - `usd` number - `market_cap_fdv_ratio` number — market cap to fully diluted valuation ratio - `total_volume` object — coin total trading volume in currency - `btc` number - `eur` number - `usd` number - `high_24h` object — coin 24hr price high in currency - `btc` number - `eur` number - `usd` number - `low_24h` object — coin 24hr price low in currency - `btc` number - `eur` number - `usd` number - `price_change_24h` number — coin 24hr price change in currency - `price_change_percentage_24h` number — coin 24hr price change in percentage - `price_change_percentage_7d` number — coin 7d price change in percentage - `price_change_percentage_14d` number — coin 14d price change in percentage - `price_change_percentage_30d` number — coin 30d price change in percentage - `price_change_percentage_60d` number — coin 60d price change in percentage - `price_change_percentage_200d` number — coin 200d price change in percentage - `price_change_percentage_1y` number — coin 1y price change in percentage - `market_cap_change_24h` number — coin 24hr market cap change in currency - `market_cap_change_percentage_24h` number — coin 24hr market cap change in percentage - `price_change_percentage_1h_in_currency` object — coin 1h price change in currency - `btc` number - `eur` number - `usd` number - `price_change_percentage_24h_in_currency` object — coin 24hr price change in currency - `btc` number - `eur` number - `usd` number - `price_change_percentage_7d_in_currency` object — coin 7d price change in currency - `btc` number - `eur` number - `usd` number - `price_change_percentage_14d_in_currency` object — coin 14d price change in currency - `btc` number - `eur` number - `usd` number - `price_change_percentage_30d_in_currency` object — coin 30d price change in currency - `btc` number - `eur` number - `usd` number - `price_change_percentage_60d_in_currency` object — coin 60d price change in currency - `btc` number - `eur` number - `usd` number - `price_change_percentage_200d_in_currency` object — coin 200d price change in currency - `btc` number - `eur` number - `usd` number - `price_change_percentage_1y_in_currency` object — coin 1y price change in currency - `btc` number - `eur` number - `usd` number - `market_cap_change_24h_in_currency` object — coin 24hr market cap change in currency - `btc` number - `eur` number - `usd` number - `market_cap_change_percentage_24h_in_currency` object — coin 24hr market cap change in percentage - `btc` number - `eur` number - `usd` number - `total_supply` number — coin total supply - `max_supply` number — coin max supply - `circulating_supply` number — coin circulating supply - `last_updated` string, date-time — coin market data last updated timestamp - `community_data` object — coin community data - `facebook_likes` number — coin facebook likes - `reddit_average_posts_48h` number — coin reddit average posts in 48 hours - `reddit_average_comments_48h` number — coin reddit average comments in 48 hours - `reddit_subscribers` number — coin reddit subscribers - `reddit_accounts_active_48h` number — coin reddit active accounts in 48 hours - `telegram_channel_user_count` number — coin telegram channel user count - `developer_data` object — coin developer data - `forks` number — coin repository forks - `stars` number — coin repository stars - `subscribers` number — coin repository subscribers - `total_issues` number — coin repository total issues - `closed_issues` number — coin repository closed issues - `pull_requests_merged` number — coin repository pull requests merged - `pull_request_contributors` number — coin repository pull request contributors - `code_additions_deletions_4_weeks` object — coin code additions and deletions in 4 weeks - `additions` number - `deletions` number - `commit_count_4_weeks` number — coin repository commit count in 4 weeks - `last_4_weeks_commit_activity_series` number[] — coin repository last 4 weeks commit activity series - `status_updates` string[] — coin status updates - `last_updated` string, date-time — coin last updated timestamp - `tickers` object[] — coin tickers - `base` string — coin ticker base currency - `target` string — coin ticker target currency - `market` object — coin ticker exchange - `name` string — coin ticker exchange name - `identifier` string — coin ticker exchange identifier - `has_trading_incentive` boolean — coin ticker exchange trading incentive - `last` number — coin ticker last price - `volume` number — coin ticker volume - `converted_last` object — coin ticker converted last price - `btc` number - `eth` number - `usd` number - `converted_volume` object — coin ticker converted volume - `btc` number - `eth` number - `usd` number - `trust_score` string — coin ticker trust score - `bid_ask_spread_percentage` number — coin ticker bid ask spread percentage - `timestamp` string, date-time — coin ticker timestamp - `last_traded_at` string, date-time — coin ticker last traded timestamp - `last_fetch_at` string, date-time — coin ticker last fetch timestamp - `is_anomaly` boolean — coin ticker anomaly - `is_stale` boolean — coin ticker stale - `trade_url` string — coin ticker trade url - `token_info_url` string — coin ticker token info url - `coin_id` string — coin ticker base currency coin ID - `target_coin_id` string — coin ticker target currency coin ID ## Changes - **2025-12-18** `a23494dedfc2` — 3 info - added the new optional `query` request parameter `include_categories_details` - added `#/components/schemas/CoinsIDDataBase` to the response body `allOf` list for the response status `200` - removed `#/components/schemas/CoinsDataBase` from the response body `allOf` list for the response status `200` - **2025-07-20** `b3f067cef8c3` — 1 info - added the optional property `allOf[#/components/schemas/CoinsDataBase]/watchlist_portfolio_users` to the response with the `200` status - **2025-07-08** `4f8e578c640a` — 1 breaking, 2 info - the `allOf[#/components/schemas/CoinsDataBase]/detail_platforms/additionalProperties/` response's property type/format changed from `string`/`` to `object`/`` for status `200` - added the optional property `allOf[#/components/schemas/CoinsDataBase]/detail_platforms/additionalProperties/contract_address` to the response with the `200` status - added the optional property `allOf[#/components/schemas/CoinsDataBase]/detail_platforms/additionalProperties/decimal_place` to the response with the `200` status - **2025-06-23** `385cf003659b` — 1 warning - removed the optional property `allOf[#/components/schemas/CoinsDataBase]/community_data/twitter_followers` from the response with the `200` status - **2025-05-29** `672da434b7c1` — 1 info - added the new optional `query` request parameter `dex_pair_format` [Full history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/coins/:id/get.md) --- [API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/a23494dedfc2/schema)