CoinMarketCap API

CoinMarketCap listings, coin detail, historical OHLCV, exchanges and trending coins as JSON.

The API.SH CoinMarketCap API turns public CoinMarketCap pages into structured JSON. Pull ranked listings with sort and range filters, one coin's price, supply, all-time high and links, daily or hourly OHLCV between two dates, where a coin trades with depth and liquidity, exchange rankings and detail, top gainers and losers and the most-searched coins.

Get a free API key Try it in the playground

8 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

CoinMarketCap most-searched coins

GET https://api.api.sh/coinmarketcap/v1/trending

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the CoinMarketCap API

Price and market dashboards

Fetch ranked listings with price, market cap, volume, supply and multi-period change, filtered by tag, coins or tokens and value ranges.

/listings /coin

Historical price data

Download daily or hourly open, high, low, close, volume and market cap for backtests and charts.

/historical

Exchange comparison

Rank exchanges by score, liquidity, volume and fees, and open one exchange for reserves, fees and its markets.

/exchanges /exchange

Liquidity and market-pair analysis

See every exchange and pair a coin trades on, with volume share, depth, effective liquidity and market score.

/coin-markets

Movers and trend alerts

Watch top gainers and losers by timeframe and the most-searched, trending and recently added coins for alerts.

/movers /trending

CoinMarketCap data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

CoinMarketCap API endpoints and prices

Every CoinMarketCap endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

CoinMarketCap top gainers and losers /coinmarketcap/v1/movers	$1 · $2 PAYG 1 credit
CoinMarketCap most-searched coins /coinmarketcap/v1/trending	$1 · $2 PAYG 1 credit

Products, listings and places1

CoinMarketCap cryptocurrency listings

/coinmarketcap/v1/listings

$1 · $2 PAYG

1 credit

More data5

CoinMarketCap coin detail /coinmarketcap/v1/coin	$1 · $2 PAYG 1 credit
CoinMarketCap markets of a coin /coinmarketcap/v1/coin-markets	$1 · $2 PAYG 1 credit
CoinMarketCap exchange detail /coinmarketcap/v1/exchange	$1 · $2 PAYG 1 credit
CoinMarketCap exchange ranking /coinmarketcap/v1/exchanges	$1 · $2 PAYG 1 credit
CoinMarketCap historical OHLCV /coinmarketcap/v1/historical	$1 · $2 PAYG 1 credit

Call the CoinMarketCap API

CoinMarketCap most-searched coins: GET https://api.api.sh/coinmarketcap/v1/trending

curl "https://api.api.sh/coinmarketcap/v1/trending" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/coinmarketcap/v1/trending",
    params={},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/coinmarketcap/v1/trending");


const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/coinmarketcap/v1/trending")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "CoinMarketCap" and "CoinMarketCap most-searched coins".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for CoinMarketCap data

Public data only: no CoinMarketCap login, cookies or account needed
One key and one response shape for CoinMarketCap and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official CoinMarketCap API

CoinMarketCap has an official API with a free Basic plan and paid tiers, authenticated with an API key header, plus an MCP server and a keyless public tier according to search results. Higher plans add endpoints and limits. API.SH reads public CoinMarketCap pages with one key shared across many sites and the same JSON shape.

Skip writing your own CoinMarketCap scraper or juggling plan limits across vendors on Apify and RapidAPI: API.SH gives you one key and a fixed price per call.

CoinMarketCap API questions

What CoinMarketCap data can I get?+

Ranked listings (/coinmarketcap/v1/listings), coin detail (/coinmarketcap/v1/coin), historical OHLCV (/coinmarketcap/v1/historical), a coin's markets (/coinmarketcap/v1/coin-markets), exchange ranking and detail (/coinmarketcap/v1/exchanges, /coinmarketcap/v1/exchange), top movers (/coinmarketcap/v1/movers) and trending coins (/coinmarketcap/v1/trending).

How much does the CoinMarketCap API cost?+

Every CoinMarketCap endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /coinmarketcap/v1/coin at 1 credit each.

Is there an official CoinMarketCap API?+

Yes. CoinMarketCap offers an official API with a free Basic plan and paid tiers, using an API key header. API.SH is an alternative if you want one key and one JSON format across many websites.

Do I need a CoinMarketCap account or login?+

No. API.SH reads public CoinMarketCap pages only. No endpoint uses a login, cookies or anyone's account.

Is there a free CoinMarketCap API?+

CoinMarketCap's own API has a free Basic plan with limits. With API.SH, every account gets 1,000 free credits every month to try listings, coin detail, OHLCV and exchange data.

Can I use the CoinMarketCap API from Python?+

Yes. It is a plain HTTPS API that returns JSON, so any language works. Use the Python SDK or call /coinmarketcap/v1/listings with requests and your API key. Pass sort, limit and convert to shape the ranking.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /coinmarketcap/v1/listings to get the top coins by market cap. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.