Python SDK

Install the package

Code
pip install coinmarketcap-sdk

Or with uv / Poetry:

Code
uv add coinmarketcap-sdk
poetry add coinmarketcap-sdk

Create a client

Set your API key from the Developer Portal. For keyless endpoints, use environment="public".

Code
import os
from coinmarketcap import CoinMarketCap

cmc = CoinMarketCap(api_key=os.environ["CMC_PRO_API_KEY"])

Call an endpoint

Endpoints are grouped by category on the client instance:

Code
quotes = cmc.cryptocurrency.quotes_latest(id="1,1027")
listings = cmc.cryptocurrency.listings_latest(limit=10)

Async variants use the async_ prefix:

Code
quotes = await cmc.cryptocurrency.async_quotes_latest(id="1,1027")

Handle errors

The SDK raises typed exceptions for common HTTP failures:

Code
from coinmarketcap import CMCError, RateLimitError, AuthenticationError

try:
    quotes = cmc.cryptocurrency.quotes_latest(id="1")
except RateLimitError:
    # 429 — backoff or reduce request rate
    ...
except AuthenticationError:
    # 401 — check your API key
    ...
except CMCError as e:
    print(e.status_code, e)