Import CoinMarketCap Data to Google Sheets

Last Updated On
byAna
< Knowledge Base

CoinMarketCap is a cryptocurrency tracking platform. In this guide, we’ll walk through how to pull cryptocurrency data from the CoinMarketCap API directly into Google Sheets, using the API Connector add-on. We’ll first get an API key from CoinMarketCap, and then set up a request to pull in cryptocurrency exchange rate details to your spreadsheet.

For a quick start, get your API key and then skip ahead to the pre-built CoinMarketCap reporting template.

PART 1: GET YOUR COINMARKETCAP API KEY

  1. If you haven’t already, navigate to https://coinmarketcap.com/api/ and click Get Your API Key Now
    coinmarketcap-img1
  2. Fill out your details and click Create My Account
    coinmarketcap-img2
  3. A moment later you’ll receive an email. Click on the email to verify your account, and you’ll be redirected into your new CoinMarketCap dashboard. Congrats! You now have access to the CoinMarketCap API. Hover over the API Key box in the top left and copy the key to your clipboard.
    coinmarketcap-img3

PART 2: CREATE YOUR API REQUEST URL

We’ll follow the CoinMarketCap documentation to access the latest crypto quotes.

  • API root: https://pro-api.coinmarketcap.com
  • Endpoint: /v1/cryptocurrency/listings/latest

Putting it together, we get the full API Request URL:

https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest

PART 3: PULL COINMARKETCAP API DATA INTO GOOGLE SHEETS

We can now enter all our values into API Connector and import CoinMarketCap API data into Google Sheets.

  1. Open up Google Sheets and click Add-ons > API Connector > Create New API Request.
  2. In the Create Request interface, enter the Request URL we just created
    coinmarketcap-img4  
  3. Under Headers enter two sets of key-value pairs like this:
    X-CMC_PRO_API_KEYYOUR_API_KEY
    Acceptapplication/json
    Replace YOUR_API_KEY with the value provided above in step 3.

    coinmarketcap-img5

  4. Create a new tab and click ‘Set current’ to use that tab as your data destination.
  5. Name your request and click Run. A moment later you’ll see the latest market data for all active cryptocurrencies in your Google Sheet:
    coinmarketcap-img6

PART 4: HANDLE PAGINATION

Note that CoinMarketCap limits the number of records returned in each request. By default, only 100 records will be returned unless you use the ‘start’ and ‘limit’ parameters as described in their documentation.
coinmarketcap-img7

To retrieve paginated records, add these ‘start’ and ‘limit’ parameters like this:

page 1: https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?limit=5000
page 2: https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?start=5001&limit=5000

With API Connector, you can either set these up as separate requests or loop through them automatically with pagination (paid feature) for added efficiency, like this:
coinmarketcap-img8

PART 5: GET MORE COINMARKETCAP API DATA

  1. Experiment with endpoints and query strings as described in the documentation to see other types of cryptocurrency data. For example, this URL will retrieve the latest global cryptocurrency market metrics:
    https://pro-api.coinmarketcap.com/v1/global-metrics/quotes/latest
  2. The free version of CoinMarketCap limits the number of accessible endpoints and number of call credits. Check the pricing page for details.
If you’re looking for a more dynamic, ticker-like experience in Sheets, check out the API Connector custom function IMPORTAPI() for faster refresh rates.

APPENDIX: GET THE COINMARKETCAP FCAS TEMPLATE

CoinMarketCap offers the ability to get tokens’ current aggregated market status by either security or utility types based on the following GET request:

https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?cryptocurrency_type={CRYPTO_TYPE_HERE}

In this template, data from the latest listings along with the FCAS score for the top 3 crypto projects are listed. All of the requests are configured for you to simply add your API key along with the desired token type and get a dashboard like below:

coinmarketcap-img9

If you want to skip right to the dashboard, here is the link.

IMPORTANT SECURITY NOTE

Anyone with Owner or Edit access to your Google Sheet can view all the information you’ve saved within API Connector, including API keys and other credentials. Treat these keys as passwords and limit access to your sheet accordingly.

17 thoughts on “Import CoinMarketCap Data to Google Sheets”

  1. When I load the data into google sheets it only loads 100 coins. is there a way to export all coins in order to filter on market cap, circulating supply, volume?

    Reply

    • Good question! You can add the parameter limit=5000 to get 5000 rows of data. If that’s still not enough, you can combine it with the start parameter.
      I’ll update the article to reflect this.

      Reply

  2. Thakns so muc! I successfully did it. However, there are many critical coins that are not being reported. For example; Aion, WAX and Peerplays are all not there, even after I had imported over 1000 coins.

    Woat could be the issue?

    Reply

    • I just tested a request to https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?limit=5000 and found all 3 of those coins on the list. Which URL are you using?

      Reply

  5. hi Ana, I just downloaded the add on and followed this guide, but in the header seccion there is no place where to enter the data. What Is wrong with this? Thanks

    Reply

    • That’s strange, could you please send a screenshot of what you’re seeing? Which browser are you using?

      In general, if there is some usage or display issue with an addon, it means there’s some conflict with a browser extension or setting. So please also try disabling other extensions (especially anti-virus extensions) or reloading the addon in incognito mode.

      Reply

  6. At Part 3 when you mention:

    ”Open up Google Sheets and click Add-ons > API Connector > Create New API Request.”

    I don’t believe this is longer the case. When I press on (Add-ons) in Google Sheets, the only options given to me are ”Get add-ons and Manage add-ons”, and not anything about ”API Connector”.

    Did Google sheets change?

    Reply

    • I believe it’s still working as written. Can you please refresh your sheet and also make sure you’re logged into the same email account from which you installed API Connector?

      Reply

  7. Hello Ana,
    I am using the API based on your useful Article put here.
    When I run the request the timestamp shown is 2020-08-29T06:34:36.879Z .But the Actual time I run the API was 1:38 PM JST.Due to this current Price is not shown(The Binance Exchane price was 17 USDT but my Google sheet is showing 15 USDT).Could you help to fix this issue?

    Reply

    • The endpoint returns 3 different timestamps: 1) Timestamp (ISO 8601) of the last time this cryptocurrency’s market data was updated, 2) Timestamp (ISO 8601) of when the conversion currency’s current value was referenced, and 3) Current timestamp (ISO 8601) on the server. Are all of them looking off? In my own tests the timestamps don’t differ from API Connector’s own timestamps by more than about 30 seconds. Can you please add a timestamp (located at Output Options > Add timestamp) and compare the API Connector timestamp to the server timestamp?
      Keep in mind that the API Connector timestamp will reflect the time zone of your sheet, which can be viewed by clicking File > Spreadsheet settings.

      Reply

      • Hello Ana,
        I had selected “Append” in the Output mode and due to that nothing gets updated(Date,Price),Once I changed to “Overwrite” then everything gets updated properly.
        But I have some formulas put in the Page 1(limit 5000) and these formuals are lost when I select Overwrite.Could you let me know how to fix the update issue by having Append option as I don’t want to loose my Customer formulas added in page1.

      • Hi Ragu, append mode should return all data except the headers from the first row, to avoid repeating headers within the sheet. Are you seeing something different?

        Since overwrite mode overwrites everything in the sheet, I suggest using a formula like =query({Sheet1!A1:Z10000}) to pull all your data into a second sheet. Then you can apply your formulas to that second sheet, and won’t lose your formulas when the data refreshes. Let me know if that makes sense, and feel free to email a link to your sheet to support if you’d like us to take a look and help out with more specific advice.

Leave a Comment