cmc-api

Unofficial wrapper for coinmarketcap api

This is up to date for coinmarketcap pro-api v1.27.0.

Endpoints and their associated function

Endpoint	Method
/v1/cryptocurrency/map	map()
/v1/cryptocurrency/info	info()
/v1/cryptocurrency/listings/latest	listings()
/v1/cryptocurrency/listings/historical	historical_listings()
/v1/cryptocurrency/quotes/latest	quotes()
/v1/cryptocurrency/quotes/historical	historical_quotes()
/v1/cryptocurrency/market-pairs/latest	market_pairs()
/v1/cryptocurrency/ohlcv/latest	ohlcv()
/v1/cryptocurrency/ohlcv/historical	historical_ohlcv()
/v1/cryptocurrency/price-performance-stats/latest	price_performance_stats()
/v1/exchange/map	map('exchange')
/v1/exchange/info	info('exchange')
/v1/exchange/listings/latest	listings('exchange')
/v1/exchange/listings/historical	historical_listings('exchange')
/v1/exchange/quotes/latest	quotes('exchange')
/v1/exchange/quotes/historical	historical_quotes('exchange')
/v1/exchange/market-pairs/latest	market_pairs('exchange')
/v1/global-metrics/quotes/latest	quotes('global-metrics')
/v1/global-metrics/quotes/historical	historical_quotes('global-metrics')
/v1/tools/price-conversion	price_conversion()
/v1/blockchain/statistics/latest	blockchain_stats()
/v1/fiat/map	map('fiat')
/v1/partners/flipside-crypto/fcas/listings/latest	flipside_fcas_listings()
/v1/partners/flipside-crypto/fcas/quotes/latest	flipside_fcas_quotes()
/v1/key/info	key_info() or info('key')

Note: Every method takes in parameters as kwargs. - would be added later.

Installation

Method 1

pip install cmc-api

Method 2

pip install git+https://github.com/bizzyvinci/cmc-api.git

Method 3

git clone https://github.com/bizzyvinci/cmc-api.git
cd cmc-api
python setup.py install

Quick start guide

Import

from cmc_api import CoinMarketCap

Quick start with sandbox.

cmc = CoinMarketCap(root='sandbox')

# List all cryptocurrency in coinmarketcap
cmc.map()

# Get latest listings
cmc.listings()

To use pro-api, A registered key from coinmarketcap is required. This key can be added to environment variable as CMC_PRO_API_KEY. After, the api can be used as:

cmc = CoinMarketCap()

If CMC_PRO_API_KEY is not in environment variable, then the key needs to be passed as argument.

cmc = CoinMarketCap(YOUR_API_KEY)

Passing parameters

You can pass parameters to send along with the request in each method. This can be passed in as keyword arguments.

keyword arguments

cmc.info('exchange', id=[2,270])

kwargs as dict

Get all listing with price between $1 and $10, and market cap between $1B and $10B.

parameters = {
    'price_min': 1,
    'price_max': 10,
    'market_cap_min': 1000000000,
    'market_cap_max': 10000000000
}
data = cmc.listings(**parameters)

Foot note

• Coinmarketcap best practices

• I need help with building documentation with sphinx. I just couldn't get it right. So please contribute if you can.