🕐Changelog

18 Jan 2024:

'whitepaper' data is now available under 'links' for /coins/{id} endpoint

13 Dec 2023:

The following data is now deprecated for /coins/{id} endpoint:

• coingecko_rank

• coingecko_score

• developer_score

• community_score

• liquidity_score

• public_interest_score

• public_interest_stats

  • alexa_rank

  • bing_matches

12 Dec 2023:

Historical Total Supply data is now available for Enterprise plan subscribers via these 2 exclusive endpoints:

• /coins/{id}/total_supply_chart : get historical total supply of a coin, by number of days away from now.

• /coins/{id}/total_supply_chart/range : get historical total supply of a coin, within a range of timestamp.

7 Dec 2023:

/search/trending endpoint now supports up to 15 trending coins. Previously, this endpoint supported 7 coins.

21 Nov 2023:

web_slug data is now available in the following endpoints. This allows users to accurately link to a CoinGecko coin page. e.g. www.coingecko.com/en/{web_slug}:

• /coins/{id}

• /coins/{contract}/contract/{contract_address}

native_coin_id data is now available for /asset_platforms endpoint. Users can now get the coins id of different blockchain networks (or asset platforms), which usually do not have contract_address to lookup.

15 June 2023:

'precision' parameter allows to specify price data in full or 0-18 decimals, and previously was only made available for /simple/price and /simple/token_price/{id} endpoints. This parameter is now supported for more endpoints as listed below:

• /coins/markets

• /coins/market_chart

• /coins/{id}market_chart/range

• /coins/{id}/contract/{contract_address}/market_chart

• /coins/{id}/contract/{contract_address}/market_chart/range

• /coins/{id}/ohlc

1 June 2023:

Top 5 trending NFT data (based on high trading volume in the last 24 hours) is now included in the /search/trending endpoint.

Near Protocol contract address (e.g. wrap.near) is now supported for /coins/{asset_platform_id}/contract/{contract_address} endpoint.

22 May 2023:

Exclusive for paid plan users: "interval=daily" is now supported for v3/coins/{id}/ohlc endpoint, for up to 180 days of date range.

26 April 2023:

Added 'watchlist_portfolio_users' for v3/coins/{id} endpoint. This refers to number of users who added the coin into a watchlist or portfolio.

3 April 2023:

Added "symbol" for these NFT endpoints:

• v3/nfts/markets

• v3/nfts/{id}

• v3/nfts/{assets_platform}/contract/{contract_address}

27 March 2023:

• Added "links" (e.g. homepage, twitter, discord) for NFT endpoints

  • v3/nfts/{id}

  • v3/nfts/{asset_platform}/contract/{contract_address}

23 March 2023:

• Added v3/coins/top_gainers_losers Pro API endpoint. This endpoint is exclusive for paid plan users to get the top 30 coins with largest price gain and loss by a specific time duration.

23 Feb 2023:

• Update for v3/coins/categories endpoint: the market cap and volume data for 'ecosystem' categories will be returning 'null' until further notice. The team is working on improvements to provide more accurate data. If you have any feedback or suggestion, please reach out to us via [e-mail]

• Update for v3/token_price/{id} endpoint: previously this endpoint was unable to return data for some Solana coins. This is now fixed.

15 Feb 2023:

• Added v3/exchange/{id}/volume_chart/range Pro API endpoint. This endpoint is exclusive for paid plan users to query full historical volume data of an exchange.

9 Jan 2023:

• Added v3/coins/list/new Pro API endpoint. This endpoint is exclusive for paid plan users to retrieve the latest 200 coins (id & activated time) listed on CoinGecko.com

15 December 2022: More exclusive NFT endpoints!

• Added NFTS beta endpoint to get historical data and tickers. These endpoints are exclusive for paid plan users:

  • v3/nfts/{id}/market_chart

  • v3/nfts/{contract_address}/market_chart

  • v3/nfts/{id}/tickers (to get floor price & vol on each marketplace)

25 October 2022:

• Added filter (limited to “nft” at the moment) to v3/asset_platforms endpoint, to get the full list of NFT blockchain network supported by CoinGecko.

• Added v3/global/market_cap_chart Pro API endpoint. This endpoint is exclusive for paid plan users to query historical global marketcap and volume.

• Added “precision” param for /simple/price endpoint. You will now be able to return a coin price based on number of decimals you define or in full decimals.

29 September 2022: NFT endpoints are here!

• Added NFTs beta endpoints:

  • v3/nfts/list

  • v3/nfts/{id}

  • v3/nfts/{asset_platform_id}/contract/{contract_address}.

• Added NFTs beta Pro API endpoint: v3/nfts/market . This is exclusive for paid plan users to query large number of NFT market data.

• Added Token Lists Pro API endpoint. This endpoint is exclusive for Enterprise plan users only.

6 September 2022:

• Added “details_platform” to /coins/{id} and /coins/{asset_platform_id}/contract/{contract_Address} endpoints, it contains “decimal_places” of asset platforms.

21 February 2022:

• Added Historical Circulating Supply Pro API endpoint. This endpoint is exclusive for Enterprise plan users only.

23 November 2021:

• Event endpoint deprecate.

07 September 2020:

• Added public_notice and alert_notice output to v3/exchanges/{id} endpoint.

17 August 2020:

• Added v3/search/trending endpoint.

03 August 2020:

• Added category filter (limited to decentralized_finance_defi at the moment) to v3/coins/markets endpoint.

15 July 2020:

• Added v3/coins/{id}/ohlc endpoint.

23 April 2020:

• Added atl, atl_change_percentage and atl_date to coins/markets endpoint.

31 March 2020:

• When querying the coins//tickers API endpoint. The value returned under converted_last should be in terms of the price per coin of the . For example, if you query coins/tether/tickers and under the results there is a BTC/USDT ticker pair; in the old version you would see converted_last usd returning 6491.51. After this update, it will return 1, which is the actual market price of Tether itself. If you are using converted_last data for calculation, this change will most likely lead to breaking changes. Action needs to be taken on your end. If you are only displaying converted_last data, this change will more accurately reflect what you intended to display. No action needed on your end. This update will take place on April 14th, 2020.

9 January 2020:

• Updated include_tickers param for /derivatives/ and /derivatives/exchanges/:id, check the doc for the available values

8 November 2019:

• added finance and derivatives endpoints (BETA), feel free to check them out! Any suggestions are welcome!

22 July 2019:

• added v3/exchanges/{id}/volume_chart (data returned will be in BTC.)

13 June 2019:

• allow order param for v3/coins/{id}/tickers and v3/exchanges/{id}/tickers, defaults to trust_score_desc

12 June 2019:

• added trust_score to tickers (v3/coins/{id}/tickers and v3/exchanges/{id}/tickers)

10 June 2019:

• added last_traded_at and last_fetched_at to tickers, timestamp will be retained for compatibility (which observes last_traded_at value), timestamp may be deprecated in the future, please update to your app to utilize the new fields.

10 Apr 2019:

• exchange_ids optional params added for v3/coins/{id}/tickers

10 Apr 2019:

• coin_ids optional params added for v3/exchanges/{id}/tickers

24 Jan 2019:

• v3/exchanges/list added

18 Jan 2019:

• To reduce bandwidth wastage, our v3/coins/markets now defaults to top 100 coins by market_cap when param ids is blank

10 Dec 2018:

• We realized /coins (paginated) is not as useful due to the inability to query for selected coins thus we have it hidden from the DOC to prevent new users using it. Fret not, it WILL NOT be removed/deprecated in the near future however we recommend you to switch to /coins/list and coins/{id}

7 Dec 2018:

• Due to the overwhelming requests we are receiving, we are updating the api rate to 100/minute, that is more than 4 million requests per month!

30 Nov 2018:

• We released our /simple endpoints, with simplified response after hearing requests from our users for lower api payloads, more simple endpoints to come

13 Nov 2018:

• To maintain the uptime and scale of this API, we are only able to return up to 100 tickers for a given exchange for the /exchanges/{id} endpoint. Please use the /exchanges/{id}/tickers paginated API to retrieve more tickers.

7 Nov 2018:

• To maintain the uptime and scale of this API, we are only able to return up to 100 tickers for a given exchange for the /coins/{id} endpoint. Please use the /coins/{id}/tickers paginated API to retrieve more tickers.