COcoingecko

Coin Data by ID

Changed on

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}

Request

  • Base URL
    https://pro-api.coingecko.com/api/v3
  • Auth
    • API key in header x-cg-pro-api-key
    • or API key in query parameter x_cg_pro_api_key

Path parameters

idstring required
Example:bitcoin

Coin ID. *refers to /coins/list

Query parameters

localizationboolean

Include all localized languages in the response. Default: true

tickersboolean

Include tickers data. Default: true

market_databoolean

Include market data. Default: true

community_databoolean

Include community data. Deprecated: has no effect as of 28 August 2026; the community_data object is no longer returned.

developer_databoolean

Include developer data. Deprecated: has no effect as of 28 August 2026; the developer_data object is no longer returned.

sparklineboolean

Include sparkline 7-day data. Default: false

include_categories_detailsboolean

Include categories details. Default: false

dex_pair_format'contract_address' | 'symbol'

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

Response

Coin data

idstring required

Coin ID

symbolstring required

Coin symbol

namestring required

Coin name

web_slugstring required

Coin web slug

asset_platform_idstring nullable required

Coin asset platform ID

platformsobject required

Coin asset platform and contract address

detail_platformsobject required

Detailed coin asset platform and contract address

block_time_in_minutesnumber required

Blockchain block time in minutes

hashing_algorithmstring nullable required

Blockchain hashing algorithm

categoriesstring[] required

Coin categories

preview_listingboolean required

Preview listing coin

public_noticestring nullable required

Public notice

additional_noticesstring[] required

Additional notices

has_supply_breakdownboolean required

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

localizationobject

Coin name localization

descriptionobject required

Coin description

country_originstring required

Country of origin

genesis_datestring nullable required

Genesis date

sentiment_votes_up_percentagenumber nullable required

Sentiment votes up percentage

sentiment_votes_down_percentagenumber nullable required

Sentiment votes down percentage

watchlist_portfolio_usersnumber required

Number of users watching this coin in portfolio

market_cap_rankinteger nullable required

Market cap rank

market_cap_rank_with_rehypothecatedinteger nullable required

Market cap rank including rehypothecated tokens

last_updatedstring required

Last updated timestamp

Changes

  • 11cc9e00fd86Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      api tag Coins removed

    • info

      removed from the response body allOf list for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • fb6b6a203ce6Revision changes
    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property //// became nullable for the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ////// to the response with the status