CoinMarketCap Cryptocurrency API Documentation

Cryptocurrency

Endpoints for cryptocurrency data. This category includes 19 endpoints:

/v1/cryptocurrency/map - Cryptocurrency ID Map
/v3/cryptocurrency/listings/latest - Listings Latest
/v1/cryptocurrency/listings/new - Listings New
/v1/cryptocurrency/listings/historical - Listings Historical
/v3/cryptocurrency/quotes/latest - Quotes Latest
/v3/cryptocurrency/quotes/historical - Quotes Historical
/v2/cryptocurrency/ohlcv/latest - OHLCV Latest
/v2/cryptocurrency/ohlcv/historical - OHLCV Historical
/v2/cryptocurrency/market-pairs/latest - Market Pairs Latest
/v2/cryptocurrency/price-performance-stats/latest - Price Performance Stats
/v2/cryptocurrency/info - Metadata
/v1/cryptocurrency/trending/latest - Trending Latest
/v1/cryptocurrency/trending/gainers-losers - Trending Gainers & Losers
/v1/cryptocurrency/trending/most-visited - Trending Most Visited
/v2/simple/price - Simple Price
/v1/cryptocurrency/categories - Categories
/v1/cryptocurrency/category - Category
/v1/cryptocurrency/airdrops - Airdrops
/v1/cryptocurrency/airdrop - Airdrop

Cryptocurrency ID Map

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/map

X-CMC_PRO_API_KEY (header)

Returns a mapping of all cryptocurrencies to unique CoinMarketCap ids. Per our Best practices we recommend utilizing CMC ID instead of cryptocurrency symbols to securely identify cryptocurrencies with our other endpoints and in your own application logic. Each cryptocurrency returned includes typical identifiers such as name, symbol, and token_address for flexible mapping to id.

By default this endpoint returns cryptocurrencies that have actively tracked markets on supported exchanges. You may receive a map of all inactive cryptocurrencies by passing listing_status=inactive. You may also receive a map of registered cryptocurrency projects that are listed but do not yet meet methodology requirements to have tracked markets via listing_status=untracked. Please review our methodology documentation for additional details on listing states.

Cryptocurrencies returned include first_historical_data and last_historical_data timestamps to conveniently reference historical date ranges available to query with historical time-series data endpoints. You may also use the aux parameter to only include properties you require to slim down the payload if calling this endpoint frequently.

This endpoint is available on the following API plans:

Basic
Builder
Startup
Growth
Professional
Enterprise

No credit is needed when querying this endpoint.

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/cryptocurrency/map. See the Keyless Public API for the full list, rate limits, and examples.

Cache / Update frequency: Mapping data is updated only as needed, every 30 seconds.
CMC equivalent pages: No equivalent, this data is only available via API.

Cryptocurrency ID Map › query Parameters

listing_status

string · pattern: ^(active|inactive|un…

Only active cryptocurrencies are returned by default. Pass inactive to get a list of cryptocurrencies that are no longer active. Pass untracked to get a list of cryptocurrencies that are listed but do not yet meet methodology requirements to have tracked markets available. You may pass one or more comma-separated values.

Default: active

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 5000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

sort

string · enum

What field to sort the list of cryptocurrencies by.

Enum values:

cmc_rank

Default: id

symbol

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally pass a comma-separated list of cryptocurrency symbols to return CoinMarketCap IDs for. If this option is passed, other options will be ignored.

aux

string · pattern: ^(platform|first_his…

Optionally specify a comma-separated list of supplemental data fields to return. Pass platform,first_historical_data,last_historical_data,is_active,status to include all auxiliary fields.

Default: platform,first_historical_data,last_historical_data,is_active

Cryptocurrency ID Map › Responses

Successful

Cryptocurrency_Map_-_Response_Model

Cryptocurrency_Map_-_Cryotocurrency_Object[] · required

Array of cryptocurrency object results.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/map

curl https://pro-api.coinmarketcap.com/v1/cryptocurrency/map \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "rank": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "is_active": 1,
      "first_historical_data": "2013-04-28T18:47:21.000Z",
      "last_historical_data": "2020-05-05T20:44:01.000Z",
      "platform": null
    },
    {
      "id": 1839,
      "rank": 3,
      "name": "Binance Coin",
      "symbol": "BNB",
      "slug": "binance-coin",
      "is_active": 1,
      "first_historical_data": "2017-07-25T04:30:05.000Z",
      "last_historical_data": "2020-05-05T20:44:02.000Z",
      "platform": {
        "id": 1027,
        "name": "Ethereum",
        "symbol": "ETH",
        "slug": "ethereum",
        "token_address": "0xB8c77482e45F1F44dE1745F52C74426C631bDD52"
      }
    },
    {
      "id": 825,
      "rank": 5,
      "name": "Tether",
      "symbol": "USDT",
      "slug": "tether",
      "is_active": 1,
      "first_historical_data": "2015-02-25T13:34:26.000Z",
      "last_historical_data": "2020-05-05T20:44:01.000Z",
      "platform": {
        "id": 1027,
        "name": "Ethereum",
        "symbol": "ETH",
        "slug": "ethereum",
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    }
  ],
  "status": {
    "timestamp": "2018-06-02T22:51:28.209Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1
  }
}

json

application/json

Listings Latest

GET

https://pro-api.coinmarketcap.com

/v3/cryptocurrency/listings/latest

X-CMC_PRO_API_KEY (header)

Returns a paginated list of all active cryptocurrencies with latest market data. The default "market_cap" sort returns cryptocurrency in order of CoinMarketCap's market cap rank (as outlined in our methodology) but you may configure this call to order by another market ranking field. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.

You may sort against any of the following:
market_cap: CoinMarketCap's market cap rank as outlined in our methodology.
market_cap_strict: A strict market cap sort (latest trade price x circulating supply).
name: The cryptocurrency name.
symbol: The cryptocurrency symbol.
date_added: Date cryptocurrency was added to the system.
price: latest average trade price across markets.
circulating_supply: approximate number of coins currently in circulation.
total_supply: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned).
max_supply: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency.
num_market_pairs: number of market pairs across all exchanges trading each currency.
market_cap_by_total_supply_strict: market cap by total supply.
volume_24h: rolling 24 hour adjusted trading volume.
volume_7d: rolling 24 hour adjusted trading volume.
volume_30d: rolling 24 hour adjusted trading volume.
percent_change_1h: 1 hour trading price percentage change for each currency.
percent_change_24h: 24 hour trading price percentage change for each currency.
percent_change_7d: 7 day trading price percentage change for each currency.

This endpoint is available on the following API plans:

Basic
Builder
Startup
Growth
Professional
Enterprise

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v3/cryptocurrency/listings/latest. See the Keyless Public API for the full list, rate limits, and examples.

Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first. CMC equivalent pages: Our latest cryptocurrency listing and ranking pages like coinmarketcap.com/all/views/all/, coinmarketcap.com/tokens/, coinmarketcap.com/gainers-losers/, coinmarketcap.com/new/.

NOTE: Use this endpoint if you need a sorted and paginated list of all cryptocurrencies. If you want to query for market data on a few specific cryptocurrencies use /v3/cryptocurrency/quotes/latest which is optimized for that purpose. The response data between these endpoints is otherwise the same.

Listings Latest › query Parameters

start

string

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

string

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

price_min

string

Optionally specify a threshold of minimum USD price to filter results by.

price_max

string

Optionally specify a threshold of maximum USD price to filter results by.

market_cap_min

string

Optionally specify a threshold of minimum market cap to filter results by.

market_cap_max

string

Optionally specify a threshold of maximum market cap to filter results by.

volume_24h_min

string

Optionally specify a threshold of minimum 24 hour USD volume to filter results by.

volume_24h_max

string

Optionally specify a threshold of maximum 24 hour USD volume to filter results by.

circulating_supply_min

string

Optionally specify a threshold of minimum circulating supply to filter results by.

circulating_supply_max

string

Optionally specify a threshold of maximum circulating supply to filter results by.

percent_change_24h_min

string

Optionally specify a threshold of minimum 24 hour percent change to filter results by.

percent_change_24h_max

string

Optionally specify a threshold of maximum 24 hour percent change to filter results by.

convert

string

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. Each conversion is returned in its own "quote" object.

convert_id

string

Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.

sort

string

What field to sort the list of cryptocurrencies by.

Default: market_cap

sort_dir

string

The direction in which to order cryptocurrencies against the specified sort.

Default: desc

cryptocurrency_type

string

The type of cryptocurrency to include.

Default: all

tag

string

The tag of cryptocurrency to include.

Default: all

aux

string

Optionally specify a comma-separated list of supplemental data fields to return. Pass num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply,market_cap_by_total_supply,volume_24h_reported,volume_7d,volume_7d_reported,volume_30d,volume_30d_reported,is_market_cap_included_in_calc to include all auxiliary fields.

Default: num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply

Listings Latest › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Listings Latest › Responses

CryptoListingDTO[] · required

API_Status_Object

Standardized status object for API calls.

GET/v3/cryptocurrency/listings/latest

curl https://pro-api.coinmarketcap.com/v3/cryptocurrency/listings/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "tags": [
        "mineable"
      ],
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "infinite_supply": false,
      "circulating_supply": 20044984,
      "total_supply": 20044984,
      "max_supply": 21000000,
      "date_added": "2010-07-13T00:00:00.000Z",
      "num_market_pairs": 12660,
      "cmc_rank": 1,
      "last_updated": "2026-06-19T14:02:00.000Z",
      "tvl_ratio": null,
      "platform": null,
      "self_reported_circulating_supply": null,
      "self_reported_market_cap": null,
      "minted_market_cap": 1265258535378.41,
      "quote": [
        {
          "id": 2781,
          "symbol": "USD",
          "price": 63120.95511667226,
          "volume_24h": 29127614493.574356,
          "volume_change_24h": -8.4273,
          "cex_volume_24h": 29080164577.906445,
          "dex_volume_24h": 47449915.66790789,
          "percent_change_1h": 0.61500999,
          "percent_change_24h": -1.19783194,
          "percent_change_7d": -0.28271701,
          "percent_change_30d": -18.14292343,
          "percent_change_60d": -16.03754846,
          "percent_change_90d": -10.78181948,
          "market_cap": 1265258535378.4136,
          "market_cap_dominance": 58.2494,
          "fully_diluted_market_cap": 1325540057450.12,
          "minted_market_cap": 1265258535378.41,
          "tvl": null,
          "last_updated": "2026-06-19T14:02:00.000Z"
        }
      ]
    },
    {
      "tags": [
        "stablecoin"
      ],
      "id": 825,
      "name": "Tether USDt",
      "symbol": "USDT",
      "slug": "tether",
      "infinite_supply": true,
      "circulating_supply": 186471454928.25275,
      "total_supply": 193153431960.50647,
      "max_supply": null,
      "date_added": "2015-02-25T00:00:00.000Z",
      "num_market_pairs": 186448,
      "cmc_rank": 3,
      "last_updated": "2026-06-19T14:01:00.000Z",
      "tvl_ratio": null,
      "platform": {
        "id": 1027,
        "slug": "ethereum",
        "name": "Ethereum",
        "symbol": "ETH",
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      },
      "self_reported_circulating_supply": null,
      "self_reported_market_cap": null,
      "minted_market_cap": 192954912191.18,
      "quote": [
        {
          "id": 2781,
          "symbol": "USD",
          "price": 0.9989722172300717,
          "volume_24h": 62071695050.04424,
          "volume_change_24h": -12.0707,
          "cex_volume_24h": 60510731381.50478,
          "dex_volume_24h": 1560963668.5394013,
          "percent_change_1h": -0.0150212,
          "percent_change_24h": 0.02100214,
          "percent_change_7d": 0.00457887,
          "percent_change_30d": -0.00471566,
          "percent_change_60d": -0.14441328,
          "percent_change_90d": -0.08226185,
          "market_cap": 186279802779.794,
          "market_cap_dominance": 8.5763,
          "fully_diluted_market_cap": 192954912191.18,
          "minted_market_cap": 192954912191.18,
          "tvl": null,
          "last_updated": "2026-06-19T14:01:00.000Z"
        }
      ]
    },
    {
      "tags": [
        "stablecoin"
      ],
      "id": 3408,
      "name": "USDC",
      "symbol": "USDC",
      "slug": "usd-coin",
      "infinite_supply": false,
      "circulating_supply": 74934715491.34196,
      "total_supply": 74934715491.34196,
      "max_supply": null,
      "date_added": "2018-10-08T00:00:00.000Z",
      "num_market_pairs": 40513,
      "cmc_rank": 5,
      "last_updated": "2026-06-19T14:01:00.000Z",
      "tvl_ratio": null,
      "platform": {
        "id": 1027,
        "slug": "ethereum",
        "name": "Ethereum",
        "symbol": "ETH",
        "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
      },
      "self_reported_circulating_supply": 60901219650.23,
      "self_reported_market_cap": 60891043102.079185,
      "minted_market_cap": 74922193956.56,
      "quote": [
        {
          "id": 2781,
          "symbol": "USD",
          "price": 0.9998329007496195,
          "volume_24h": 9375210843.24513,
          "volume_change_24h": -22.0589,
          "cex_volume_24h": 7294870263.140532,
          "dex_volume_24h": 2080340580.104594,
          "percent_change_1h": 0.00101421,
          "percent_change_24h": 0.01332693,
          "percent_change_7d": 0.00411852,
          "percent_change_30d": 0.0208214,
          "percent_change_60d": -0.00167445,
          "percent_change_90d": -0.00818018,
          "market_cap": 74922193956.55588,
          "market_cap_dominance": 3.4492,
          "fully_diluted_market_cap": 74922193956.56,
          "minted_market_cap": 74922193956.56,
          "tvl": null,
          "last_updated": "2026-06-19T14:01:00.000Z"
        }
      ]
    },
    {
      "tags": [
        "ethereum-ecosystem"
      ],
      "id": 5176,
      "name": "Tether Gold",
      "symbol": "XAUt",
      "slug": "tether-gold",
      "infinite_supply": false,
      "circulating_supply": 612823.659532,
      "total_supply": 707747.089,
      "max_supply": null,
      "date_added": "2020-02-07T00:00:00.000Z",
      "num_market_pairs": 401,
      "cmc_rank": 33,
      "last_updated": "2026-06-19T14:01:00.000Z",
      "tvl_ratio": 0.85231497,
      "platform": {
        "id": 1027,
        "slug": "ethereum",
        "name": "Ethereum",
        "symbol": "ETH",
        "token_address": "0x68749665FF8D2d112Fa859AA293F07A622782F38"
      },
      "self_reported_circulating_supply": 48450,
      "self_reported_market_cap": 200583379.1418529,
      "minted_market_cap": 2930078486.88,
      "quote": [
        {
          "id": 2781,
          "symbol": "USD",
          "price": 4140.00782542524,
          "volume_24h": 192201727.25124744,
          "volume_change_24h": -34.2878,
          "cex_volume_24h": 181966210.11893946,
          "dex_volume_24h": 10235517.13230798,
          "percent_change_1h": -0.57455114,
          "percent_change_24h": -2.25096351,
          "percent_change_7d": -0.78415585,
          "percent_change_30d": -7.59755401,
          "percent_change_60d": -13.72518949,
          "percent_change_90d": -7.84994801,
          "market_cap": 2537094746.068213,
          "market_cap_dominance": 0.1168,
          "fully_diluted_market_cap": 2930078486.88,
          "minted_market_cap": 2930078486.88,
          "tvl": 2976710281,
          "last_updated": "2026-06-19T14:01:00.000Z"
        }
      ]
    }
  ],
  "status": {
    "timestamp": "2026-06-19T14:03:33.664Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 8,
    "credit_count": 1
  }
}

json

application/json

Listings New

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/listings/new

X-CMC_PRO_API_KEY (header)

Returns a paginated list of most recently added cryptocurrencies.

This endpoint is available on the following API plans:

Startup
Growth
Professional
Enterprise

Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our "new" cryptocurrency page coinmarketcap.com/new/

NOTE: Use this endpoint if you need a sorted and paginated list of all recently added cryptocurrencies.

Listings New › query Parameters

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 5000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

sort_dir

string · enum

The direction in which to order cryptocurrencies against the specified sort.

Enum values:

asc

desc

Listings New › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Listings New › Responses

Successful

Cryptocurrency_Listings_New_-_Response_Model

Cryptocurrency_Listings_Latest_-_Cryptocurrency_object_2[] · required

Array of cryptocurrency objects matching the list options.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/listings/new

curl https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/new \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "cmc_rank": 5,
      "num_market_pairs": 500,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "minted_market_cap": 1802955697670.94,
      "quote": {
        "USD": {
          "price": 9283.92,
          "volume_24h": 7155680000,
          "volume_change_24h": -0.152774,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 852164659250.2758,
          "market_cap_dominance": 51,
          "fully_diluted_market_cap": 952835089431.14,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    },
    {
      "id": 1027,
      "name": "Ethereum",
      "symbol": "ETH",
      "slug": "ethereum",
      "num_market_pairs": 6360,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "minted_market_cap": 364793475572.53,
      "quote": {
        "USD": {
          "price": 1283.92,
          "volume_24h": 7155680000,
          "volume_change_24h": -0.152774,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "market_cap_dominance": 51,
          "fully_diluted_market_cap": 952835089431.14,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    }
  ],
  "status": {
    "timestamp": "2018-06-02T22:51:28.209Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1
  }
}

json

application/json

Listings Historical

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/listings/historical

X-CMC_PRO_API_KEY (header)

Returns a ranked and sorted list of all cryptocurrencies for a historical UTC date.

Technical Notes

This endpoint is identical in format to our /cryptocurrency/listings/latest endpoint but is used to retrieve historical daily ranking snapshots from the end of each UTC day.
Daily snapshots reflect market data at the end of each UTC day and may be requested as far back as 2013-04-28 (as supported by your plan's historical limits).
The required "date" parameter can be passed as a Unix timestamp or ISO 8601 date but only the date portion of the timestamp will be referenced. It is recommended to send an ISO date format like "2019-10-10" without time.
This endpoint is for retrieving paginated and sorted lists of all currencies. If you require historical market data on specific cryptocurrencies you should use /cryptocurrency/quotes/historical.

Cryptocurrencies are listed by cmc_rank by default. You may optionally sort against any of the following:
cmc_rank: CoinMarketCap's market cap rank as outlined in our methodology.
name: The cryptocurrency name.
symbol: The cryptocurrency symbol.
market_cap: market cap (latest trade price x circulating supply).
price: latest average trade price across markets.
circulating_supply: approximate number of coins currently in circulation.
total_supply: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned).
max_supply: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency.
num_market_pairs: number of market pairs across all exchanges trading each currency.
volume_24h: 24 hour trading volume for each currency.
percent_change_1h: 1 hour trading price percentage change for each currency.
percent_change_24h: 24 hour trading price percentage change for each currency.
percent_change_7d: 7 day trading price percentage change for each currency.

This endpoint is available on the following API plans:

Basic (1 year)
Builder (3 years)
Startup (from 2013)
Growth (from 2013)
Professional (from 2013)
Enterprise (from 2013)

Cache / Update frequency: The last completed UTC day is available 30 minutes after midnight on the next UTC day.
Plan credit use: 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our historical daily crypto ranking snapshot pages like this one on February 02, 2014.

Listings Historical › query Parameters

date

string · required

date (Unix or ISO 8601) to reference day of snapshot.

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 5000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

sort

string · enum

What field to sort the list of cryptocurrencies by.

Enum values:

cmc_rank

name

symbol

market_cap

price

circulating_supply

total_supply

max_supply

Default: cmc_rank

sort_dir

string · enum

The direction in which to order cryptocurrencies against the specified sort.

Enum values:

asc

desc

cryptocurrency_type

string · enum

The type of cryptocurrency to include.

Enum values:

all

coins

tokens

Default: all

aux

string · pattern: ^(platform|tags|date…

Optionally specify a comma-separated list of supplemental data fields to return. Pass platform,tags,date_added,circulating_supply,total_supply,max_supply,cmc_rank,num_market_pairs to include all auxiliary fields.

Default: platform,tags,date_added,circulating_supply,total_supply,max_supply,cmc_rank,num_market_pairs

Listings Historical › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Listings Historical › Responses

Successful

Cryptocurrency_Listings_Latest_-_Response_Model

Cryptocurrency_Listings_Latest_-_Cryptocurrency_object[] · required

Array of cryptocurrency objects matching the list options.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/listings/historical

curl 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/historical?date=<string>' \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "cmc_rank": 1,
      "num_market_pairs": 500,
      "circulating_supply": 17200062,
      "total_supply": 17200062,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 9283.92,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    },
    {
      "id": 1027,
      "name": "Ethereum",
      "symbol": "ETH",
      "slug": "ethereum",
      "num_market_pairs": 6089,
      "circulating_supply": 17200062,
      "total_supply": 17200062,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 1678.6501384942708,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      },
      "cmc_rank": 2
    }
  ],
  "status": {
    "timestamp": "2019-04-02T22:44:24.200Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1
  }
}

json

application/json

Quotes Latest

GET

https://pro-api.coinmarketcap.com

/v3/cryptocurrency/quotes/latest

X-CMC_PRO_API_KEY (header)

Returns the latest market quote for 1 or more cryptocurrencies. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.

Please note: This documentation relates to our updated V3 endpoint, which may be incompatible with our V2 versions. Documentation for deprecated endpoints can be found the deprecated section.

This endpoint is available on the following API plans:

Basic
Startup
Builder
Growth
Professional
Enterprise

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v3/cryptocurrency/quotes/latest. See the Keyless Public API for the full list, rate limits, and examples.

Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per `convert` option beyond the first.
CMC equivalent pages: Latest market data pages for specific cryptocurrencies like coinmarketcap.com/currencies/bitcoin/.

NOTE: Use this endpoint to request the latest quote for specific cryptocurrencies. If you need to request all cryptocurrencies use /v3/cryptocurrency/listings/latest which is optimized for that purpose. The response data between these endpoints is otherwise the same.

Quotes Latest › query Parameters

id

string

One or more comma-separated cryptocurrency CoinMarketCap IDs.

slug

string

Alternatively pass a comma-separated list of cryptocurrency slugs.

symbol

string

Alternatively pass one or more comma-separated cryptocurrency symbols.

convert

string

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols.

convert_id

string

Optionally calculate market quotes by CoinMarketCap ID instead of symbol.

aux

string

Optionally specify a comma-separated list of supplemental data fields to return.

skip_invalid

string

Pass true to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned.

Quotes Latest › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Quotes Latest › Responses

200

CryptoQuoteV3DTO[]

CryptoQuoteV3DTO

id

integer · int32

name

string

symbol

string

slug

string

Platform

Quote[]

CryptoTag[]

is_active

integer · int32

infinite_supply

boolean

is_market_cap_included_in_calc

integer · int32

is_fiat

integer · int32

circulating_supply

number · bigdecimal

Circulating supply of the cryptocurrency

total_supply

number · bigdecimal

Total supply of the cryptocurrency

max_supply

number · bigdecimal

Maximum supply of the cryptocurrency

date_added

string

num_market_pairs

integer · int32

cmc_rank

integer · int32

last_updated

string

tvl_ratio

number · bigdecimal

TVL to market cap ratio

self_reported_circulating_supply

number · bigdecimal

Self-reported circulating supply

self_reported_market_cap

number · bigdecimal

Self-reported market capitalization

unlocked_circulating_supply

number · bigdecimal

Unlocked circulating supply

unlocked_market_cap

number · bigdecimal

Unlocked market capitalization

GET/v3/cryptocurrency/quotes/latest

curl https://pro-api.coinmarketcap.com/v3/cryptocurrency/quotes/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

[
  {
    "id": 0,
    "name": "name",
    "symbol": "symbol",
    "slug": "slug",
    "platform": {
      "id": 0,
      "slug": "slug",
      "name": "name",
      "symbol": "symbol",
      "token_address": "token_address"
    },
    "quote": [
      {
        "id": 0,
        "symbol": "symbol",
        "price": 0,
        "volume_24h": 0,
        "cex_volume_24h": 0,
        "dex_volume_24h": 0,
        "volume_24h_reported": 0,
        "volume_7d": 0,
        "volume_7d_reported": 0,
        "volume_30d": 0,
        "volume_30d_reported": 0,
        "volume_change_24h": 0,
        "percent_change_1h": 0,
        "percent_change_24h": 0,
        "percent_change_7d": 0,
        "percent_change_30d": 0,
        "percent_change_60d": 0,
        "percent_change_90d": 0,
        "market_cap": 0,
        "market_cap_dominance": 0,
        "fully_diluted_market_cap": 0,
        "minted_market_cap": 0,
        "tvl": 0,
        "market_cap_by_total_supply": 0,
        "last_updated": "last_updated"
      }
    ],
    "tags": [
      {
        "slug": "slug",
        "name": "name",
        "category": "category"
      }
    ],
    "is_active": 0,
    "infinite_supply": true,
    "is_market_cap_included_in_calc": 0,
    "is_fiat": 0,
    "circulating_supply": 0,
    "total_supply": 0,
    "max_supply": 0,
    "date_added": "date_added",
    "num_market_pairs": 0,
    "cmc_rank": 0,
    "last_updated": "last_updated",
    "tvl_ratio": 0,
    "self_reported_circulating_supply": 0,
    "self_reported_market_cap": 0,
    "unlocked_circulating_supply": 0,
    "unlocked_market_cap": 0
  }
]

json

application/json

Quotes Historical

GET

https://pro-api.coinmarketcap.com

/v3/cryptocurrency/quotes/historical

X-CMC_PRO_API_KEY (header)

Returns an interval of historic market quotes for any cryptocurrency based on time and interval parameters.

Please note: This documentation relates to our updated V3 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found the deprecated section.

Technical Notes

A historic quote for every "interval" period between your "time_start" and "time_end" will be returned.
If a "time_start" is not supplied, the "interval" will be applied in reverse from "time_end".
If "time_end" is not supplied, it defaults to the current time.
At each "interval" period, the historic quote that is closest in time to the requested time will be returned.
If no historic quotes are available in a given "interval" period up until the next interval period, it will be skipped.

Implementation Tips

Want to get the last quote of each UTC day? Don't use "interval=daily" as that returns the first quote. Instead use "interval=24h" to repeat a specific timestamp search every 24 hours and pass ex. "time_start=2019-01-04T23:59:00.000Z" to query for the last record of each UTC day.
This endpoint supports requesting multiple cryptocurrencies in the same call. Please note the API response will be wrapped in an additional object in this case.

Interval Options
There are 2 types of time interval formats that may be used for "interval".

The first are calendar year and time constants in UTC time:
"hourly" - Get the first quote available at the beginning of each calendar hour.
"daily" - Get the first quote available at the beginning of each calendar day.
"weekly" - Get the first quote available at the beginning of each calendar week.
"monthly" - Get the first quote available at the beginning of each calendar month.
"yearly" - Get the first quote available at the beginning of each calendar year.

The second are relative time intervals.
"m": Get the first quote available every "m" minutes (60 second intervals). Supported minutes are: "5m", "10m", "15m", "30m", "45m".
"h": Get the first quote available every "h" hours (3600 second intervals). Supported hour intervals are: "1h", "2h", "3h", "4h", "6h", "12h".
"d": Get the first quote available every "d" days (86400 second intervals). Supported day intervals are: "1d", "2d", "3d", "7d", "14d", "15d", "30d", "60d", "90d", "365d".

This endpoint is available on the following API plans:

Basic (intraday: 1 month, daily: 1 year)
Builder (intraday: 1 month, daily: 3 years)
Startup (intraday: 1 month, daily: from 2010)
Growth (intraday: 3 months, daily: from 2010)
Professional (intraday: 12 months, daily: from 2010)
Enterprise (intraday: from 2010, daily: from 2010)

Note: Intraday = 5m-12h intervals, Daily = 1d-1y intervals

Cache / Update frequency: Every 5 minutes.
Plan credit use: 1 call credit per 100 historical data points returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our historical cryptocurrency charts like coinmarketcap.com/currencies/bitcoin/#charts.

Quotes Historical › query Parameters

id

string · pattern: ^\d+(?:,\d+)*$

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2"

symbol

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" or "symbol" is required for this request.

time_start

string

Timestamp (Unix or ISO 8601) to start returning quotes for. Optional, if not passed, we'll return quotes calculated in reverse from "time_end".

time_end

string

Timestamp (Unix or ISO 8601) to stop returning quotes for (inclusive). Optional, if not passed, we'll default to the current time. If no "time_start" is passed, we return quotes in reverse order starting from this time.

count

number · min: 1 · max: 10000

The number of interval periods to return results for. Optional, required if both "time_start" and "time_end" aren't supplied. The default is 10 items. The current query limit is 10000.

Default: 10

interval

string · enum

Interval of time to return data points for. See details in endpoint description.

Enum values:

yearly

monthly

weekly

daily

hourly

10m

15m

Default: 5m

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 other fiat currencies or cryptocurrencies.

convert_id

string · pattern: (^\d+(?:,\d+)*$|(\d,…

aux

string · pattern: ^(price|volume|marke…

Optionally specify a comma-separated list of supplemental data fields to return. Pass price,volume,market_cap,circulating_supply,total_supply,quote_timestamp,is_active,is_fiat,search_interval to include all auxiliary fields.

Default: price,volume,market_cap,circulating_supply,total_supply,quote_timestamp,is_active,is_fiat

skip_invalid

boolean

Pass true to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if no match is found for 1 or more requested cryptocurrencies. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned.

Default: true

Quotes Historical › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Quotes Historical › Responses

Successful

Cryptocurrency_Quotes_Historical_-_Response_Model

Cryptocurrency_Quotes_Historical_-_Results_map · required

Results of your query returned as an object map.

API_Status_Object

Standardized status object for API calls.

GET/v3/cryptocurrency/quotes/historical

curl https://pro-api.coinmarketcap.com/v3/cryptocurrency/quotes/historical \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "1": {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "is_active": 1,
      "is_fiat": 0,
      "quotes": [
        {
          "timestamp": "2018-06-22T00:00:00.000Z",
          "quote": {
            "USD": {
              "price": 6242.48,
              "volume_24h": 4894120000,
              "market_cap": 107057808682,
              "last_updated": "2018-06-22T00:04:16.000Z",
              "volume_24hr": 4894120000,
              "timestamp": "2018-06-22T00:04:16.000Z"
            }
          }
        }
      ]
    }
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": ""
  }
}

json

application/json

OHLCV Latest

GET

https://pro-api.coinmarketcap.com

/v2/cryptocurrency/ohlcv/latest

X-CMC_PRO_API_KEY (header)

Returns the latest OHLCV (Open, High, Low, Close, Volume) market values for one or more cryptocurrencies for the current UTC day. Since the current UTC day is still active these values are updated frequently. You can find the final calculated OHLCV values for the last completed UTC day along with all historic days using /cryptocurrency/ohlcv/historical.

Please note: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found the deprecated section.

This endpoint is available on the following API plans:

~~Basic~~
~~Builder~~
Startup
Growth
Professional
Enterprise

Cache / Update frequency: Every 10 minutes. Additional OHLCV intervals and 1 minute updates will be available in the future.
Plan credit use: 1 call credit per 250 OHLCV values returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: No equivalent, this data is only available via API.

OHLCV Latest › query Parameters

id

string · pattern: ^\d+(?:,\d+)*$

One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2

symbol

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" or "symbol" is required.

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

skip_invalid

boolean

Pass true to relax request validation rules. When requesting records on multiple cryptocurrencies an error is returned if any invalid cryptocurrencies are requested or a cryptocurrency does not have matching records in the requested timeframe. If set to true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned.

Default: true

OHLCV Latest › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

OHLCV Latest › Responses

Successful

Cryptocurrency_OHLCV_Latest_-_Response_Model

Cryptocurrency_OHLCV_Latest_-_Cryptocurrency_Results_map · required

A map of cryptocurrency objects by ID or symbol (as passed in query parameters).

API_Status_Object

Standardized status object for API calls.

GET/v2/cryptocurrency/ohlcv/latest

curl https://pro-api.coinmarketcap.com/v2/cryptocurrency/ohlcv/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "1": {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "last_updated": "2018-09-10T18:54:00.000Z",
      "time_open": "2018-09-10T00:00:00.000Z",
      "time_close": "2019-08-30T23:59:59.999Z",
      "time_high": "2018-09-10T00:00:00.000Z",
      "time_low": "2018-09-10T00:00:00.000Z",
      "quote": {
        "USD": {
          "open": 6301.57,
          "high": 6374.98,
          "low": 6292.76,
          "close": 6308.76,
          "volume": 3786450000,
          "last_updated": "2018-09-10T18:54:00.000Z"
        }
      }
    }
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": ""
  }
}

json

application/json

OHLCV Historical

GET

https://pro-api.coinmarketcap.com

/v2/cryptocurrency/ohlcv/historical

X-CMC_PRO_API_KEY (header)

Returns historical OHLCV (Open, High, Low, Close, Volume) data along with market cap for any cryptocurrency using time interval parameters. Currently daily and hourly OHLCV periods are supported. Volume is not currently supported for hourly OHLCV intervals before 2020-09-22.

Please note: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found the deprecated section.

Technical Notes

Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time for this "time_period".
One OHLCV quote will be returned for every "time_period" between your "time_start" (exclusive) and "time_end" (inclusive).
If a "time_start" is not supplied, the "time_period" will be calculated in reverse from "time_end" using the "count" parameter which defaults to 10 results.
If "time_end" is not supplied, it defaults to the current time.
If you don't need every "time_period" between your dates you may adjust the frequency that "time_period" is sampled using the "interval" parameter. For example with "time_period" set to "daily" you may set "interval" to "2d" to get the daily OHLCV for every other day. You could set "interval" to "monthly" to get the first daily OHLCV for each month, or set it to "yearly" to get the daily OHLCV value against the same date every year.

Implementation Tips

If querying for a specific OHLCV date your "time_start" should specify a timestamp of 1 interval prior as "time_start" is an exclusive time parameter (as opposed to "time_end" which is inclusive to the search). This means that when you pass a "time_start" results will be returned for the next complete "time_period". For example, if you are querying for a daily OHLCV datapoint for 2018-11-30 your "time_start" should be "2018-11-29".
If only specifying a "count" parameter to return latest OHLCV periods, your "count" should be 1 number higher than the number of results you expect to receive. "Count" defines the number of "time_period" intervals queried, not the number of results to return, and this includes the currently active time period which is incomplete when working backwards from current time. For example, if you want the last daily OHLCV value available simply pass "count=2" to skip the incomplete active time period.
This endpoint supports requesting multiple cryptocurrencies in the same call. Please note the API response will be wrapped in an additional object in this case.

Interval Options

There are 2 types of time interval formats that may be used for "time_period" and "interval" parameters. For "time_period" these return aggregate OHLCV data from the beginning to end of each interval period. Apply these time intervals to "interval" to adjust how frequently "time_period" is sampled.

The first are calendar year and time constants in UTC time:
"hourly" - Hour intervals in UTC.
"daily" - Calendar day intervals for each UTC day.
"weekly" - Calendar week intervals for each calendar week.
"monthly" - Calendar month intervals for each calendar month.
"yearly" - Calendar year intervals for each calendar year.

The second are relative time intervals.
"h": Get the first quote available every "h" hours (3600 second intervals). Supported hour intervals are: "1h", "2h", "3h", "4h", "6h", "12h".
"d": Time periods that repeat every "d" days (86400 second intervals). Supported day intervals are: "1d", "2d", "3d", "7d", "14d", "15d", "30d", "60d", "90d", "365d".

Please note that "time_period" currently supports the "daily" and "hourly" options. "interval" supports all interval options.

This endpoint is available on the following API plans:

~~Basic~~
~~Builder~~
Startup (intraday: 1 month, daily: from 2010)
Growth (intraday: 3 months, daily: from 2010)
Professional (intraday: 12 months, daily: from 2010)
Enterprise (intraday: from 2010, daily: from 2010)

Note: Intraday = 5m-12h intervals, Daily = 1d-1y intervals

Cache / Update frequency: Latest Daily OHLCV record is available ~5 to ~10 minutes after each midnight UTC. The latest hourly OHLCV record is available 5 minutes after each UTC hour.
Plan credit use: 1 call credit per 100 OHLCV data points returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our historical cryptocurrency data pages like coinmarketcap.com/currencies/bitcoin/historical-data/.

OHLCV Historical › query Parameters

id

string · pattern: ^\d+(?:,\d+)*$

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,1027"

slug

string · pattern: ^[0-9a-z-]+(?:,[0-9a…

Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"

symbol

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" or "slug" or "symbol" is required for this request.

time_period

string · enum

Time period to return OHLCV data for. The default is "daily". If hourly, the open will be 01:00 and the close will be 01:59. If daily, the open will be 00:00:00 for the day and close will be 23:59:99 for the same day. See the main endpoint description for details.

Enum values:

daily

hourly

Default: daily

time_start

string

Timestamp (Unix or ISO 8601) to start returning OHLCV time periods for. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time.

time_end

string

Timestamp (Unix or ISO 8601) to stop returning OHLCV time periods for (inclusive). Optional, if not passed we'll default to the current time. Only the date portion of the timestamp is used for daily OHLCV so it's recommended to send an ISO date format like "2018-09-19" without time.

count

number · min: 1 · max: 10000

Optionally limit the number of time periods to return results for. The default is 10 items. The current query limit is 10000 items.

Default: 10

interval

string · enum

Optionally adjust the interval that "time_period" is sampled. For example with interval=monthly&time_period=daily you will see a daily OHLCV record for January, February, March and so on. See main endpoint description for available options.

Enum values:

hourly

daily

weekly

monthly

yearly

Default: daily

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

By default market quotes are returned in USD. Optionally calculate market quotes in up to 3 fiat currencies or cryptocurrencies.

convert_id

string · pattern: ^\d+(?:,\d+)*$

skip_invalid

boolean

Default: true

OHLCV Historical › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

OHLCV Historical › Responses

Successful

Cryptocurrency_OHLCV_Historical_-_Response_Model

Cryptocurrency_OHLCV_Historical_-_Results_object · required

Results of your query returned as an object.

API_Status_Object

Standardized status object for API calls.

GET/v2/cryptocurrency/ohlcv/historical

curl https://pro-api.coinmarketcap.com/v2/cryptocurrency/ohlcv/historical \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "id": 1,
    "name": "Bitcoin",
    "symbol": "BTC",
    "quotes": [
      {
        "time_open": "2019-01-02T00:00:00.000Z",
        "time_close": "2019-01-02T23:59:59.999Z",
        "time_high": "2019-01-02T03:53:00.000Z",
        "time_low": "2019-01-02T02:43:00.000Z",
        "quote": {
          "USD": {
            "open": 3849.21640853,
            "high": 3947.9812729,
            "low": 3817.40949569,
            "close": 3943.40933686,
            "volume": 5244856835.70851,
            "market_cap": 68849856731.6738,
            "timestamp": "2019-01-02T23:59:59.999Z"
          }
        }
      },
      {
        "time_open": "2019-01-03T00:00:00.000Z",
        "time_close": "2019-01-03T23:59:59.999Z",
        "time_high": "2019-01-02T03:53:00.000Z",
        "time_low": "2019-01-02T02:43:00.000Z",
        "quote": {
          "USD": {
            "open": 3931.04863841,
            "high": 3935.68513083,
            "low": 3826.22287069,
            "close": 3836.74131867,
            "volume": 4530215218.84018,
            "market_cap": 66994920902.7202,
            "timestamp": "2019-01-03T23:59:59.999Z"
          }
        }
      }
    ]
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": ""
  }
}

json

application/json

Market Pairs Latest

GET

https://pro-api.coinmarketcap.com

/v2/cryptocurrency/market-pairs/latest

X-CMC_PRO_API_KEY (header)

Lists all active market pairs that CoinMarketCap tracks for a given cryptocurrency or fiat currency. All markets with this currency as the pair base or pair quote will be returned. The latest price and volume information is returned for each market. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.

Please note: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found the deprecated section.

This endpoint is available on the following API plans:

~~Basic~~
~~Builder~~
~~Startup~~
Growth
Professional
Enterprise

Cache / Update frequency: Every 1 minute.
Plan credit use: 1 call credit per 250 market pairs returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our active cryptocurrency markets pages like coinmarketcap.com/currencies/bitcoin/#markets.

Market Pairs Latest › query Parameters

id

string

A cryptocurrency or fiat currency by CoinMarketCap ID to list market pairs for. Example: "1"

slug

string · pattern: ^[0-9a-z-]*$

Alternatively pass a cryptocurrency by slug. Example: "bitcoin"

symbol

string · pattern: ^[0-9A-Za-z$@\-]*$

Alternatively pass a cryptocurrency by symbol. Fiat currencies are not supported by this field. Example: "BTC". A single cryptocurrency "id", "slug", or "symbol" is required.

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 5000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

sort_dir

string · enum

Optionally specify the sort direction of markets returned.

Enum values:

asc

desc

Default: desc

sort

string · enum

Optionally specify the sort order of markets returned. By default we return a strict sort on 24 hour reported volume. Pass cmc_rank to return a CMC methodology based sort where markets with excluded volumes are returned last.

Enum values:

volume_24h_strict

cmc_rank

cmc_rank_advanced

effective_liquidity

market_score

market_reputation

Default: volume_24h_strict

aux

string · pattern: ^(num_market_pairs|c…

Optionally specify a comma-separated list of supplemental data fields to return. Pass num_market_pairs,category,fee_type,market_url,currency_name,currency_slug,price_quote,notice,cmc_rank,effective_liquidity,market_score,market_reputation to include all auxiliary fields.

Default: num_market_pairs,category,fee_type

matched_id

string · pattern: ^\d+(?:,\d+)*$

Optionally include one or more fiat or cryptocurrency IDs to filter market pairs by. For example ?id=1&matched_id=2781 would only return BTC markets that matched: "BTC/USD" or "USD/BTC". This parameter cannot be used when matched_symbol is used.

matched_symbol

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally include one or more fiat or cryptocurrency symbols to filter market pairs by. For example ?symbol=BTC&matched_symbol=USD would only return BTC markets that matched: "BTC/USD" or "USD/BTC". This parameter cannot be used when matched_id is used.

category

string · enum

The category of trading this market falls under. Spot markets are the most common but options include derivatives and OTC.

Enum values:

all

spot

derivatives

otc

perpetual

Default: all

fee_type

string · enum

The fee type the exchange enforces for this market.

Enum values:

all

percentage

no-fees

transactional-mining

unknown

Default: all

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

Market Pairs Latest › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Market Pairs Latest › Responses

Successful

Cryptocurrency_Market_Pairs_Latest_-_Response_Model

Cryptocurrency_Market_Pairs_Latest_-_Results_object · required

Results of your query returned as an object.

API_Status_Object

Standardized status object for API calls.

GET/v2/cryptocurrency/market-pairs/latest

curl https://pro-api.coinmarketcap.com/v2/cryptocurrency/market-pairs/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "id": 1,
    "name": "Bitcoin",
    "symbol": "BTC",
    "num_market_pairs": 7526,
    "market_pairs": [
      {
        "exchange": {
          "id": 157,
          "name": "BitMEX",
          "slug": "bitmex"
        },
        "market_id": 4902,
        "market_pair": "BTC/USD",
        "category": "derivatives",
        "fee_type": "no-fees",
        "market_pair_base": {
          "currency_id": 1,
          "currency_symbol": "BTC",
          "exchange_symbol": "XBT",
          "currency_type": "cryptocurrency"
        },
        "market_pair_quote": {
          "currency_id": 2781,
          "currency_symbol": "USD",
          "exchange_symbol": "USD",
          "currency_type": "fiat"
        },
        "quote": {
          "exchange_reported": {
            "price": 7839,
            "volume_24h_base": 434215.85308502,
            "volume_24h_quote": 3403818072.33347,
            "last_updated": "2019-05-24T02:39:00.000Z"
          },
          "USD": {
            "price": 7839,
            "volume_24h": 3403818072.33347,
            "last_updated": "2019-05-24T02:39:00.000Z"
          }
        }
      },
      {
        "exchange": {
          "id": 108,
          "name": "Negocie Coins",
          "slug": "negocie-coins"
        },
        "market_id": 3377,
        "market_pair": "BTC/BRL",
        "category": "spot",
        "fee_type": "percentage",
        "market_pair_base": {
          "currency_id": 1,
          "currency_symbol": "BTC",
          "exchange_symbol": "BTC",
          "currency_type": "cryptocurrency"
        },
        "market_pair_quote": {
          "currency_id": 2783,
          "currency_symbol": "BRL",
          "exchange_symbol": "BRL",
          "currency_type": "fiat"
        },
        "quote": {
          "exchange_reported": {
            "price": 33002.11,
            "volume_24h_base": 336699.03559957,
            "volume_24h_quote": 11111778609.7509,
            "last_updated": "2019-05-24T02:39:00.000Z"
          },
          "USD": {
            "price": 8165.02539531659,
            "volume_24h": 2749156176.2491,
            "last_updated": "2019-05-24T02:39:00.000Z"
          }
        }
      }
    ]
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": ""
  }
}

json

application/json

Price Performance Stats

GET

https://pro-api.coinmarketcap.com

/v2/cryptocurrency/price-performance-stats/latest

X-CMC_PRO_API_KEY (header)

Returns price performance statistics for one or more cryptocurrencies including launch price ROI and all-time high / all-time low. Stats are returned for an all_time period by default. UTC yesterday and a number of rolling time periods may be requested using the time_period parameter. Utilize the convert parameter to translate values into multiple fiats or cryptocurrencies using historical rates.

Please note: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found the deprecated section.

This endpoint is available on the following API plans:

~~Basic~~
~~Builder~~
Startup
Growth
Professional
Enterprise

Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: The statistics module displayed on cryptocurrency pages like Bitcoin.

NOTE: You may also use /cryptocurrency/ohlcv/historical for traditional OHLCV data at historical daily and hourly intervals. You may also use /v1/cryptocurrency/ohlcv/latest for OHLCV data for the current UTC day.

Price Performance Stats › query Parameters

id

string · pattern: ^\d+(?:,\d+)*$

One or more comma-separated cryptocurrency CoinMarketCap IDs. Example: 1,2

slug

string · pattern: ^[0-9a-z-]+(?:,[0-9a…

Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"

symbol

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" or "slug" or "symbol" is required for this request.

time_period

string · pattern: ^(all_time|yesterday…

Specify one or more comma-delimited time periods to return stats for. all_time is the default. Pass all_time,yesterday,24h,7d,30d,90d,365d to return all supported time periods. All rolling periods have a rolling close time of the current request time. For example 24h would have a close time of now and an open time of 24 hours before now. Please note: yesterday is a UTC period and currently does not currently support high and low timestamps.

Default: all_time

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

Optionally calculate quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.

skip_invalid

boolean

Default: true

Price Performance Stats › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Price Performance Stats › Responses

Successful

Cryptocurrency_Price_Performance_Stats_Latest_-_Response_Model

Cryptocurrency_Price_Performance_Stats_Latest_-_Cryptocurrency_Results_map · required

An object map of cryptocurrency objects by ID, slug, or symbol (as used in query parameters).

API_Status_Object

Standardized status object for API calls.

GET/v2/cryptocurrency/price-performance-stats/latest

curl https://pro-api.coinmarketcap.com/v2/cryptocurrency/price-performance-stats/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "1": {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "last_updated": "2019-08-22T01:51:32.000Z",
      "periods": {
        "USD": {
          "open_timestamp": "2013-04-28T00:00:00.000Z",
          "high_timestamp": "2017-12-17T12:19:14.000Z",
          "low_timestamp": "2013-07-05T18:56:01.000Z",
          "close_timestamp": "2019-08-22T01:52:18.613Z",
          "quote": {
            "USD": {
              "open": 135.3000030517578,
              "open_timestamp": "2013-04-28T00:00:00.000Z",
              "high": 20088.99609375,
              "high_timestamp": "2017-12-17T12:19:14.000Z",
              "low": 65.5260009765625,
              "low_timestamp": "2013-07-05T18:56:01.000Z",
              "close": 65.5260009765625,
              "close_timestamp": "2019-08-22T01:52:18.618Z",
              "percent_change": 7223.718930042746,
              "price_change": 9773.691932798241
            }
          }
        }
      }
    }
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": ""
  }
}

json

application/json

Metadata

GET

https://pro-api.coinmarketcap.com

/v2/cryptocurrency/info

X-CMC_PRO_API_KEY (header)

Returns all static metadata available for one or more cryptocurrencies. This information includes details like logo, description, official website URL, social links, and links to a cryptocurrency's technical documentation.

Please note: This documentation relates to our updated V2 endpoint, which may be incompatible with our V1 versions. Documentation for deprecated endpoints can be found the deprecated section.

This endpoint is available on the following API plans:

Basic
Startup
Builder
Growth
Professional
Enterprise

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v2/cryptocurrency/info. See the Keyless Public API for the full list, rate limits, and examples.

Cache / Update frequency: Static data is updated only as needed, every 30 seconds.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up).
CMC equivalent pages: Cryptocurrency detail page metadata like coinmarketcap.com/currencies/bitcoin/.

Metadata › query Parameters

id

string · pattern: ^\d+(?:,\d+)*$

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: "1,2"

slug

string · pattern: ^[0-9a-z-]+(?:,[0-9a…

Alternatively pass a comma-separated list of cryptocurrency slugs. Example: "bitcoin,ethereum"

symbol

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Alternatively pass one or more comma-separated cryptocurrency symbols. Example: "BTC,ETH". At least one "id" or "slug" or "symbol" is required for this request. Please note that starting in the v2 endpoint, due to the fact that a symbol is not unique, if you request by symbol each data response will contain an array of objects containing all of the coins that use each requested symbol. The v1 endpoint will still return a single object, the highest ranked coin using that symbol.

address

string

Alternatively pass in a contract address. Example: "0xc40af1e4fecfa05ce6bab79dcd8b373d2e436c4e"

skip_invalid

boolean

Default: false

aux

string · pattern: ^(urls|logo|descript…

Optionally specify a comma-separated list of supplemental data fields to return. Pass urls,logo,description,tags,platform,date_added,notice,status to include all auxiliary fields.

Default: urls,logo,description,tags,platform,date_added,notice

Metadata › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Metadata › Responses

Successful

Cryptocurrencies_Info_-_Response_Model

Cryptocurrency_Info_-_Results_map · required

Results of your query returned as an object map.

API_Status_Object

Standardized status object for API calls.

GET/v2/cryptocurrency/info

curl https://pro-api.coinmarketcap.com/v2/cryptocurrency/info \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "1": {
      "urls": {
        "website": [
          "https://bitcoin.org/"
        ],
        "technical_doc": [
          "https://bitcoin.org/bitcoin.pdf"
        ],
        "twitter": [],
        "reddit": [
          "https://reddit.com/r/bitcoin"
        ],
        "message_board": [
          "https://bitcointalk.org"
        ],
        "announcement": [],
        "chat": [],
        "explorer": [
          "https://blockchain.coinmarketcap.com/chain/bitcoin",
          "https://blockchain.info/",
          "https://live.blockcypher.com/btc/"
        ],
        "source_code": [
          "https://github.com/bitcoin/"
        ]
      },
      "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png",
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "description": "Bitcoin (BTC) is a consensus network that enables a new payment system and a completely digital currency. Powered by its users, it is a peer to peer payment network that requires no central authority to operate. On October 31st, 2008, an individual or group of individuals operating under the pseudonym \"Satoshi Nakamoto\" published the Bitcoin Whitepaper and described it as: \"a purely peer-to-peer version of electronic cash would allow online payments to be sent directly from one party to another without going through a financial institution.\"",
      "date_added": "2013-04-28T00:00:00.000Z",
      "date_launched": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "category": "coin"
    }
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": ""
  }
}

json

application/json

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/trending/latest

X-CMC_PRO_API_KEY (header)

Returns a paginated list of all trending cryptocurrency market data, determined and sorted by CoinMarketCap search volume.

This endpoint is available on the following API plans:

Startup
Growth
Professional
Enterprise

Cache / Update frequency: Every 10 minutes.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our cryptocurrency Trending page coinmarketcap.com/trending-cryptocurrencies/.

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 1000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

time_period

string · enum

Adjusts the overall window of time for the latest trending coins.

Enum values:

24h

30d

Default: 24h

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Successful

Cryptocurrency_Trending_Latest_-_Response_Model

Cryptocurrency_Trending_Latest_-_Cryptocurrency_object[] · required

Array of cryptocurrency objects matching the list options.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/trending/latest

curl https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "cmc_rank": 5,
      "is_active": 1,
      "is_fiat": 0,
      "self_reported_circulating_supply": null,
      "self_reported_market_cap": null,
      "num_market_pairs": 500,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 9283.92,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    },
    {
      "id": 1027,
      "name": "Ethereum",
      "symbol": "ETH",
      "slug": "ethereum",
      "num_market_pairs": 6360,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 1283.92,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    }
  ],
  "status": {
    "timestamp": "2018-06-02T22:51:28.209Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1
  }
}

json

application/json

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/trending/gainers-losers

X-CMC_PRO_API_KEY (header)

Returns a paginated list of all trending cryptocurrencies, determined and sorted by the largest price gains or losses.

You may sort against any of the following:
percent_change_24h: 24 hour trading price percentage change for each currency.

This endpoint is available on the following API plans:

Startup
Growth
Professional
Enterprise

Cache / Update frequency: Every 10 minutes.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our cryptocurrency Gainers & Losers page coinmarketcap.com/gainers-losers/.

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 1000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

time_period

string · enum

Adjusts the overall window of time for the biggest gainers and losers.

Enum values:

24h

30d

Default: 24h

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

sort

string · enum

What field to sort the list of cryptocurrencies by.

Enum values:

percent_change_24h

Default: percent_change_24h

sort_dir

string · enum

The direction in which to order cryptocurrencies against the specified sort.

Enum values:

asc

desc

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Successful

Cryptocurrency_Trending_Gainers_Losers_-_Response_Model

Cryptocurrency_-_Cryptocurrency_object[] · required

Array of cryptocurrency objects matching the list options.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/trending/gainers-losers

curl https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/gainers-losers \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "cmc_rank": 5,
      "num_market_pairs": 500,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 9283.92,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    },
    {
      "id": 1027,
      "name": "Ethereum",
      "symbol": "ETH",
      "slug": "ethereum",
      "num_market_pairs": 6360,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 1283.92,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    }
  ],
  "status": {
    "timestamp": "2018-06-02T22:51:28.209Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1
  }
}

json

application/json

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/trending/most-visited

X-CMC_PRO_API_KEY (header)

Returns a paginated list of all trending cryptocurrency market data, determined and sorted by traffic to coin detail pages.

This endpoint is available on the following API plans:

Startup
Growth
Professional
Enterprise

Cache / Update frequency: Every 24 hours.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: The CoinMarketCap “Most Visited” trending list. coinmarketcap.com/most-viewed-pages/.

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 1000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

time_period

string · enum

Adjusts the overall window of time for most visited currencies.

Enum values:

24h

30d

Default: 24h

convert

string · pattern: ^[0-9A-Za-z$@\-,]+(?…

Optionally calculate market quotes in up to 120 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own "quote" object.

convert_id

string · pattern: ^\d+(?:,\d+)*$

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Successful

Cryptocurrency_Trending_Most_Visited_-_Response_Model

Cryptocurrency_-_Cryptocurrency_object[] · required

Array of cryptocurrency objects matching the list options.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/trending/most-visited

curl https://pro-api.coinmarketcap.com/v1/cryptocurrency/trending/most-visited \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "cmc_rank": 5,
      "num_market_pairs": 500,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 9283.92,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    },
    {
      "id": 1027,
      "name": "Ethereum",
      "symbol": "ETH",
      "slug": "ethereum",
      "num_market_pairs": 6360,
      "circulating_supply": 16950100,
      "total_supply": 16950100,
      "max_supply": 21000000,
      "last_updated": "2018-06-02T22:51:28.209Z",
      "date_added": "2013-04-28T00:00:00.000Z",
      "tags": [
        "mineable"
      ],
      "platform": null,
      "quote": {
        "USD": {
          "price": 1283.92,
          "volume_24h": 7155680000,
          "percent_change_1h": -0.152774,
          "percent_change_24h": 0.518894,
          "percent_change_7d": 0.986573,
          "market_cap": 158055024432,
          "last_updated": "2018-08-09T22:53:32.000Z"
        }
      }
    }
  ],
  "status": {
    "timestamp": "2018-06-02T22:51:28.209Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1
  }
}

json

application/json

Simple Price

GET

https://pro-api.coinmarketcap.com

/v2/simple/price

X-CMC_PRO_API_KEY (header)

Returns a lightweight latest price for one or more cryptocurrencies, with optional inline market cap, 24h volume, 24h change, and freshness timestamp. It is a slimmed-down alternative to /v3/cryptocurrency/quotes/latest, optimized for the single most common question - "what is X worth right now" - without returning the full quote object.

You can look assets up by id, slug, or symbol, and at least one of those is required. The endpoint deliberately does not return supply, rank, market pairs, or descriptive metadata; for any of those, use /v3/cryptocurrency/quotes/latest or /v2/cryptocurrency/info instead.

This endpoint is available on the following API plans:

Basic
Builder
Startup
Growth
Professional
Enterprise

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v2/simple/price. See the Keyless Public API for the full list, rate limits, and examples.

Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 250 cryptocurrencies returned (rounded up), plus 1 credit per convert / convert_id option beyond the first. The include_* flags do not add credits.

Simple Price › query Parameters

id

string · pattern: ^\d+(?:,\d+)*$

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,1027. The preferred identifier - stable and unambiguous. At least one of id, slug, or symbol is required.

slug

string · pattern: ^[0-9a-z-]+(?:,[0-9a…

Alternatively pass comma-separated cryptocurrency slugs. Example: bitcoin,ethereum.

symbol

string · pattern: ^[0-9A-Za-z$@\-]+(?:…

Alternatively pass comma-separated cryptocurrency symbols. Example: BTC,ETH. When a symbol matches multiple assets the highest-market-cap match is returned; use id to disambiguate.

convert

string · pattern: ^[0-9A-Za-z$@\-]+(?:…

Optionally calculate price in up to 120 fiat or cryptocurrency conversions at once by passing a comma-separated list of symbols. Each conversion beyond the first costs 1 additional call credit and is returned as its own entry in quotes[]. Cannot be used with convert_id.

Default: USD

convert_id

string · pattern: ^\d+(?:,\d+)*$

Same as convert, but by CoinMarketCap currency ID instead of symbol. Example: convert_id=2781. Cannot be used with convert.

include_market_cap

boolean

Include market_cap in each quote object.

Default: false

include_24h_volume

boolean

Include volume_24h in each quote object.

Default: false

include_24h_change

boolean

Include percent_change_24h in each quote object.

Default: false

include_last_updated

boolean

Include last_updated (ISO 8601) in each quote object.

Default: false

include_all

boolean

Shortcut to enable include_market_cap, include_24h_volume, include_24h_change, and include_last_updated together. When true it wins over an individual flag set to false. Does not add credits.

Default: false

precision

integer · min: 0 · max: 18

Round all price, market-cap, and volume values to this many decimal places. Omit for full precision.

skip_invalid

boolean

When multiple assets are requested, skip invalid lookups and return the valid ones rather than failing the whole request.

Default: true

Simple Price › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Simple Price › Responses

Successful

V2_Simple_Price_-_Response_Model

V2_Simple_Price_-_Item_Object[] · required

Array of asset objects, one per resolved identifier. With skip_invalid=true, unresolved identifiers are simply absent.

API_Status_Object

Standardized status object for API calls.

GET/v2/simple/price

curl https://pro-api.coinmarketcap.com/v2/simple/price \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "slug": "bitcoin",
      "quotes": [
        {
          "symbol": "USD",
          "price": 63319.879266088545,
          "market_cap": 1270345579794.0115,
          "volume_24h": 23424304928.73599,
          "percent_change_24h": -3.03610139,
          "last_updated": "2026-07-28T10:35:05.000Z"
        }
      ]
    },
    {
      "id": 1027,
      "name": "Ethereum",
      "symbol": "ETH",
      "slug": "ethereum",
      "quotes": [
        {
          "symbol": "USD",
          "price": 1875.3832420347037,
          "market_cap": 226326126225.45407,
          "volume_24h": 12578049044.855345,
          "percent_change_24h": -4.60239011,
          "last_updated": "2026-07-28T10:35:05.000Z"
        }
      ]
    }
  ],
  "status": {
    "timestamp": "2026-07-28T10:38:38.654Z",
    "error_code": "0",
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1
  }
}

json

application/json

Airdrops

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/airdrops

X-CMC_PRO_API_KEY (header)

Returns a list of past, present, or future airdrops which have run on CoinMarketCap.

This endpoint is available on the following API plans:

Builder
Startup
Growth
Professional
Enterprise

Cache / Update frequency: Data is updated only as needed, every 30 seconds.
Plan credit use: 1 API call credit per request no matter query size.
CMC equivalent pages: Our free airdrops page coinmarketcap.com/airdrop/.

Airdrops › query Parameters

start

integer · min: 1

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

integer · min: 1 · max: 5000

Optionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.

Default: 100

status

string · enum

What status of airdrops.

Enum values:

ENDED

ONGOING

UPCOMING

Default: ONGOING

id

string · pattern: ^\d*$

Filtered airdrops by one cryptocurrency CoinMarketCap IDs. Example: 1

slug

string · pattern: ^[0-9a-z-]*$

Alternatively filter airdrops by a cryptocurrency slug. Example: "bitcoin"

symbol

string · pattern: ^[0-9A-Za-z$@\-]*$

Alternatively filter airdrops one cryptocurrency symbol. Example: "BTC".

Airdrops › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Airdrops › Responses

Successful

Airdrops_-_Response_Model

Airdrops_-_Airdrop_Object[] · required

Array of airdrop object results.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/airdrops

curl https://pro-api.coinmarketcap.com/v1/cryptocurrency/airdrops \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "id": "60e59b99c8ca1d58514a2322",
      "project_name": "DeRace Airdrop",
      "description": "For 7 days starting from August 15, 2021, CoinMarketCap will host an Airdrop event...",
      "status": "UPCOMING",
      "coin": {
        "id": 10744,
        "name": "DeRace",
        "slug": "derace",
        "symbol": "DERC"
      },
      "start_date": "2021-06-01T22:11:00.000Z",
      "end_date": "2021-07-01T22:11:00.000Z",
      "total_prize": 20000000000,
      "winner_count": 1000,
      "link": "https://coinmarketcap.com/currencies/derace/airdrop/"
    }
  ],
  "status": {
    "timestamp": "2021-08-01T22:51:28.209Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 3,
    "credit_count": 1
  }
}

json

application/json

Airdrop

GET

https://pro-api.coinmarketcap.com

/v1/cryptocurrency/airdrop

X-CMC_PRO_API_KEY (header)

Returns information about a single airdrop available on CoinMarketCap. Includes the cryptocurrency metadata.

This endpoint is available on the following API plans:

Builder
Startup
Growth
Professional
Enterprise

Airdrop › query Parameters

id

string · required

Airdrop Unique ID. This can be found using the Airdrops API.

Airdrop › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Airdrop › Responses

Successful

Airdrop_-_Response_Model

Airdrop_-_Results_map · required

Results of your query returned as an object map.

API_Status_Object

Standardized status object for API calls.

GET/v1/cryptocurrency/airdrop

curl 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/airdrop?id=<string>' \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "1": {
      "id": "60e59b99c8ca1d58514a2322",
      "project_name": "DeRace Airdrop",
      "description": "For 7 days starting from August 15, 2021, CoinMarketCap will host an Airdrop event...",
      "status": "UPCOMING",
      "coin": {
        "id": 10744,
        "name": "DeRace",
        "slug": "derace",
        "symbol": "DERC"
      },
      "start_date": "2021-06-01T22:11:00.000Z",
      "end_date": "2021-07-01T22:11:00.000Z",
      "total_prize": 20000000000,
      "winner_count": 1000,
      "link": "https://coinmarketcap.com/currencies/derace/airdrop/"
    }
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": ""
  }
}

json

application/json

Choose an Endpoint Exchange

Cryptocurrency

Endpoints for cryptocurrency data. This category includes 19 endpoints:

Cryptocurrency ID Map

Cryptocurrency ID Map › query Parameters

Cryptocurrency ID Map › Responses

Listings Latest

Listings Latest › query Parameters

Listings Latest › Headers

Listings Latest › Responses

Listings New

Listings New › query Parameters

Listings New › Headers

Listings New › Responses

Listings Historical

Listings Historical › query Parameters

Listings Historical › Headers

Listings Historical › Responses

Quotes Latest

Quotes Latest › query Parameters

Quotes Latest › Headers

Quotes Latest › Responses

Quotes Historical

Quotes Historical › query Parameters

Quotes Historical › Headers

Quotes Historical › Responses

OHLCV Latest

OHLCV Latest › query Parameters

OHLCV Latest › Headers

OHLCV Latest › Responses

OHLCV Historical

OHLCV Historical › query Parameters

OHLCV Historical › Headers

OHLCV Historical › Responses

Market Pairs Latest

Market Pairs Latest › query Parameters

Market Pairs Latest › Headers

Market Pairs Latest › Responses

Price Performance Stats

Price Performance Stats › query Parameters

Price Performance Stats › Headers

Price Performance Stats › Responses

Metadata

Metadata › query Parameters

Metadata › Headers

Metadata › Responses

Trending Latest

Trending Latest › query Parameters

Trending Latest › Headers

Trending Latest › Responses

Trending Gainers & Losers

Trending Gainers & Losers › query Parameters

Trending Gainers & Losers › Headers

Trending Gainers & Losers › Responses

Trending Most Visited

Trending Most Visited › query Parameters

Trending Most Visited › Headers

Trending Most Visited › Responses

Simple Price

Simple Price › query Parameters

Simple Price › Headers

Simple Price › Responses

Categories

Categories › query Parameters

Categories › Headers

Categories › Responses

Category

Category › query Parameters

Category › Headers

Category › Responses

Airdrops

Airdrops › query Parameters

Airdrops › Headers

Airdrops › Responses

Airdrop

Airdrop › query Parameters

Airdrop › Headers

Airdrop › Responses