Links
🕐

Changelog

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 [email protected]
  • 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.