Skip to main content

CoinMarketCap Python API Wrapper

Project description

Python-CoinMarketCap API Wrapper

This is a non-official (but working) Python package to wrap the CoinMarketCap API. With this you can monitor and watch the crypto market.



Via pip

  • pip install python-coinmarketcap

/!\ Don't confuse this with the coinmarketcap package.


from coinmarketcapapi import CoinMarketCapAPI

cmc = CoinMarketCapAPI()
rep = cmc.cryptocurrency_info(symbol='BTC') # See methods below

print(                 # Whole repsonse payload
print(["BTC"]["logo"])  # Some data in response
print(rep.credit_count)         # API credits
print(rep.total_elapsed)        # Request time in ms
# ...

Wrapper References



CoinMarketCapAPI(api_key=None, [debug=False, logger=None, sandbox=False, version='v1'])
  • debug: set verbosity.
  • sandbox: In case of default sandbox API key changes, see Issue #1.
  • logger: you can give a custom logger.
  • version: set the version in the URL, for futures version.


You have to pass to the following methods the parameters detailed in the official documentation.

Methods and documentation Endpoint (version)
๐Ÿ“„ cryptocurrency_map /cryptocurrency/map
๐Ÿ“„ cryptocurrency_info /cryptocurrency/info (v2)
๐Ÿ“„ cryptocurrency_listings_latest /cryptocurrency/listings/latest
๐Ÿ“„ cryptocurrency_listings_historical /cryptocurrency/listings/historical
๐Ÿ“„ cryptocurrency_quotes_latest /cryptocurrency/quotes/latest (v2)
๐Ÿ“„ cryptocurrency_quotes_historical /cryptocurrency/quotes/historical (v2)
๐Ÿ“„ cryptocurrency_marketpairs_latest /cryptocurrency/market-pairs/latest (v2)
๐Ÿ“„ cryptocurrency_ohlcv_latest /cryptocurrency/ohlcv/latest (v2)
๐Ÿ“„ cryptocurrency_ohlcv_historical /cryptocurrency/ohlcv/historical (v2)
๐Ÿ“„ cryptocurrency_priceperformancestats_latest /cryptocurrency/price-performance-stats/latest (v2)
๐Ÿ“„ cryptocurrency_categories /cryptocurrency/categories
๐Ÿ“„ cryptocurrency_category /cryptocurrency/category
๐Ÿ“„ cryptocurrency_airdrops /cryptocurrency/airdrops
๐Ÿ“„ cryptocurrency_airdrop /cryptocurrency/airdrop
๐Ÿ“„ cryptocurrency_trending_latest /cryptocurrency/trending/latest
๐Ÿ“„ cryptocurrency_trending_mostvisited /cryptocurrency/trending/most-visited
๐Ÿ“„ cryptocurrency_trending_gainerslosers /cryptocurrency/trending/gainers-losers
๐Ÿ“„ exchange_map /exchange/map
๐Ÿ“„ exchange_info /exchange/info
๐Ÿ“„ exchange_listings_latest /exchange/listings/latest
๐Ÿ“„ exchange_listings_historical /exchange/listings/historical
๐Ÿ“„ exchange_quotes_latest /exchange/quotes/latest
๐Ÿ“„ exchange_quotes_historical /exchange/quotes/historical
๐Ÿ“„ exchange_marketpairs_latest /exchange/market-pairs/latest
๐Ÿ“„ globalmetrics_quotes_latest /global-metrics/quotes/latest
๐Ÿ“„ globalmetrics_quotes_historical /global-metrics/quotes/historical
๐Ÿ“„ tools_priceconversion /tools/price-conversion (v2)
๐Ÿ“„ tools_postman /tools/postman
๐Ÿ“„ blockchain_statistics_latest /blockchain/statistics/latest
๐Ÿ“„ fiat_map /fiat/map
๐Ÿ“„ partners_flipsidecrypto_fcas_listings_latest /partners/flipside-crypto/fcas/listings/latest
๐Ÿ“„ partners_flipsidecrypto_fcas_quotes_latest /partners/flipside-crypto/fcas/quotes/latest
๐Ÿ“„ key_info /key/info
๐Ÿ“„ content_posts_top /content/posts/top
๐Ÿ“„ content_posts_latest /content/posts/latest
๐Ÿ“„ content_posts_comments /content/posts/comments
๐Ÿ“„ content_latest /content/latest

Additionnal Parameters

  • api_version (str): if given, will fetch the given version of the endpoint (default is equal to the given version in the CoinMarketCapAPI instance wich is actually v1). As mentioned in the list above, some endpoints are "v2" by default.


Assuming you want to get informations about bitcoin. First, read the documentation of the corresponding cryptocurrency_info endpoint.

  • You can pass the symbol parameter like : cmc.cryptocurrency_info(symbol='BTC')
  • or with the slug parameter : cmc.cryptocurrency_info(slug='bitcoin')

You can switch easly in the sandbox mode without giving an API key or by setting it to None :

  • cmc = CoinMarketCapAPI() # You are in sandbox environnement

You can enable a debuging mode, just set debug to True to main class:

cmc = CoinMarketCapAPI(debug=True)

This will produce this output :

2019-04-06 16:03:04,716 root         DEBUG    GET SANDBOX 'v1/cryptocurrency/info'
PARAMETERS: {'symbol': 'BTC'}
2019-04-06 16:03:05,004 root         DEBUG    RESPONSE: 288ms OK: {u'BTC': {u'category': u'coin', u'name': u'Bitcoin', u'tags': [u'mineable'], u'symbol': u'BTC', u'id': 1, [...]}

Optionnaly, you can pass (on-the-fly) a specific version of an endpoint by given the api_version keyword argument directly to a method:

cmc.cryptocurrency_listings_latest(..., api_version="v1.1")

See also



You get results of the API in a Response instance.


Corresponding to standards and conventions:

  • data (dict): will give you the result.
  • status (dict): the status object always included for both successful calls and failures.
  • credit_count (int): the number of credits this call utilized.
  • elapsed (int): the number of milliseconds it took to process the request to the server.
  • total_elapsed (int): the total number of milliseconds it took to process the request.
  • timesamp (str): current time on the server when the call was executed.
  • error_code (str | None): In case of an error has been raised, this property will give you the status error code.
  • error_message (str | None): In case of an error has been raised, this property will give details about error.
  • error (bool): True if an error has been raised.


r = cmc.cryptocurrency_info(symbol='BTC')



If API returns an error, CoinMarketCapAPI will raise a CoinMarketCapAPIError.


  • rep (Response | None): will give you a Response instance or None if request failed for an other reason than a server error.


from coinmarketcapapi import CoinMarketCapAPI, CoinMarketCapAPIError

cmc = CoinMarketCapAPI('{YOUR_API_KEY}') # Pro environnement
# cmc = CoinMarketCapAPI() # Sandbox environnement

  r = cmc.cryptocurrency_info(symbol='BTC')
except CoinMarketCapAPIError as e:
  r = e.rep

See this project on

Some reading about the wrapper


  • 4 nov 2022: Version 0.5
    • Remove an unfortunate debug that could display text unnecessarily during an error.
    • Yanked version 0.4
  • 4 nov 2022: Version 0.4
    • Adding new endpoints (Aug 18/Sep 19):
      • /v1/content/posts/top
      • /v1/content/posts/latest
      • /v1/content/posts/comments
      • /v1/content/latest
      • /v1/tools/postman
        • This last one will clearly be useful to extend the wrapper according to the received schemes.
    • Fix api_key default to Sandbox mode.
    • Fix the logger, Issue#4 from AlverGan.
    • Fix install_requires, requests was missing.
    • Changing the default API version to v2 for some endpoints :
      • /v2/cryptocurrency/info
      • /v2/cryptocurrency/quotes/latest
      • /v2/cryptocurrency/quotes/historical
      • /v2/cryptocurrency/market-pairs/latest
      • /v2/cryptocurrency/ohlcv/latest
      • /v2/cryptocurrency/ohlcv/historical
      • /v2/cryptocurrency/price-performance-stats/latest
      • /v2/tools/price-conversion
    • On the Readme:
      • Adding new methods references.
      • Modification of the methods table to improve readability.
      • Some grammatical corrections in README (Thanks to @tactipus !).
      • Small changes and removal of some unnecessary spaces in the example codes.
      • Adding reading references about the API and the package (Thanks to their respective authors !).
    • Adding docstring to classes.
  • 31 aug 2021: Version 0.3
    • Adding new endpoints (Aug 17):
      • /v1/cryptocurrency/categories
      • /v1/cryptocurrency/category
      • /v1/cryptocurrency/airdrops
      • /v1/cryptocurrency/airdrop
      • /v1/cryptocurrency/trending/latest
      • /v1/cryptocurrency/trending/most-visited
      • /v1/cryptocurrency/trending/gainers-losers
    • PEP 8 style
    • Adding api_version keyword argument to all endpoints to change on-the-fly the api version to use.
  • 8 sept 2020: Version 0.2
    • Adding missing endpoints
    • Fixing sandbox mode (see Issue #1)
    • Adding deflate, gzip encoding to receive data fast and efficiently.
    • Documentation: adding usefull links
  • 6 apr 2019: Version 0.1

Give me a coffee

  BTC: 39aosiow4nsUvYVA2kP1hZPNZ7ZbJ6ouKr
  ETH: 0x45d940FDA3F1Ce91cA7CB478af72170bb6560201

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-coinmarketcap-0.5.tar.gz (13.3 kB view hashes)

Uploaded source

Built Distribution

python_coinmarketcap-0.5-py3-none-any.whl (10.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page