# CoinMarketCap Crypto Prices API

> Crypto rankings, prices, market caps, coin details, price history, market pairs and global metrics

- Vendor: `coinmarketcapcryptopricesapi` · version 1.0 · category Crypto Market Data · tags coinmarketcap api, crypto prices api, bitcoin price api, crypto market cap api, crypto historical prices, crypto rankings api, defi metrics api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/coinmarketcapcryptopricesapi
- This document: https://apiclay.com/docs/coinmarketcapcryptopricesapi.md
- OpenAPI 3.1: https://apiclay.com/api/coinmarketcapcryptopricesapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `coinmarketcapcryptopricesapi`
- Updated: 2026-11-18

## About

## CoinMarketCap Crypto Prices API

Ranked crypto assets with price, market cap, volume, supply and % change (1h to 1y), a coin's details (description, links, platform, stats), daily or hourly price history, the exchanges and pairs it trades on, and global market metrics (BTC and ETH dominance, total market cap, DeFi and stablecoin volume).

Data comes from **coinmarketcap.com** (https://coinmarketcap.com). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://coinmarketcap.com) and returns it unchanged.

Typical flow: `/listing` to find a coin's `id`, then `/detail`, `/historical` or `/market-pairs`.

### Routes

#### GET `/listing` - Ranked coins
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| start | query | number | no | Rank to start from (1). |
| limit | query | number | no | Coins per page, up to 200. |
| sortBy | query | string | no | `market_cap`, `volume_24h`, `percent_change_24h`... |
| sortType | query | string | no | `desc` or `asc`. |
| convert | query | string | no | Quote currency, e.g. `USD`, `EUR`, `BTC`. |
| cryptoType | query | string | no | `all`, `coins` or `tokens`. |
| tagType | query | string | no | Tag filter, e.g. `defi`. |

Returns: `data.cryptoCurrencyList[]` (`id`, `name`, `symbol`, `slug`, `cmcRank`, `circulatingSupply`, `quotes[0]` with `price`, `marketCap`, `volume24h`, `percentChange24h`...) and `data.totalCount`.

#### GET `/detail` - Coin details
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | query | number | no | CoinMarketCap id, e.g. `1027` (Ethereum). |
| slug | query | string | no | Or the slug, e.g. `ethereum`. |

Returns: `data` with `description`, `urls`, `platforms`, `statistics` (price, rank, supply, ATH).

#### GET `/historical` - Price history
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | query | number | yes | Coin id. |
| convertId | query | number | no | Quote currency id: `2781` USD, `2790` EUR, `1` BTC. |
| timeStart | query | number | no | Unix seconds. |
| timeEnd | query | number | no | Unix seconds. |
| interval | query | string | no | `daily`, `hourly`, `5m`... |

Returns: `data.quotes[]` with `timeOpen`, `quote` (`open`, `high`, `low`, `close`, `volume`, `marketCap`).

#### GET `/market-pairs` - Market pairs
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| slug | query | string | yes | Coin slug, e.g. `bitcoin`. |
| start | query | number | no | From 1. |
| limit | query | number | no | Pairs per page. |
| category | query | string | no | `spot`, `perpetual` or `futures`. |

Returns: `data.marketPairs[]` (`exchangeName`, `marketPair`, `price`, `volumeUsd`, `depthUsdPositiveTwo`).

#### GET `/global` - Global metrics
No parameters.

Returns: `data` with `btcDominance`, `ethDominance`, `activeCryptoCurrencies`, `activeExchanges`, `quotes` (total market cap, volume, DeFi, stablecoins).

### Caveats

- These are the endpoints coinmarketcap.com's own pages call, not the keyed CoinMarketCap Pro API.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by coinmarketcap.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /listing — Listing (ranked coins)
- Gateway: `GET https://api.apiclay.com/v1/api/coinmarketcapcryptopricesapi/listing`
- Public query params: `start` (number), `limit` (number), `sortBy` (string), `sortType` (string), `convert` (string), `cryptoType` (string), `tagType` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /detail — Coin details
- Gateway: `GET https://api.apiclay.com/v1/api/coinmarketcapcryptopricesapi/detail`
- Public query params: `id` (number), `slug` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /historical — Price history
- Gateway: `GET https://api.apiclay.com/v1/api/coinmarketcapcryptopricesapi/historical`
- Public query params: `id` (number, required), `convertId` (number), `timeStart` (number), `timeEnd` (number), `interval` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /market-pairs — Market pairs
- Gateway: `GET https://api.apiclay.com/v1/api/coinmarketcapcryptopricesapi/market-pairs`
- Public query params: `slug` (string, required), `start` (number), `limit` (number), `category` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /global — Global metrics
- Gateway: `GET https://api.apiclay.com/v1/api/coinmarketcapcryptopricesapi/global`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/coinmarketcapcryptopricesapi/listing" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
