CoinMarketCapCoinMarketCap
PricingAPI StatusGet API Key
  • Overview
  • API Reference
  • WebSocket
  • AI Agent Hub
  • Changelog
  • FAQ
If you are an AI agent, LLM, or automated tool, this documentation provides clean Markdown versions of pages. Use the HTTP Link header for the exact Markdown alternate, append .md to documentation page URLs, or start from https://pro.coinmarketcap.com/llms.txt.

© 2026 CoinMarketCap. All rights reserved.

xgithub
Choose an Endpoint
Market Data
    Cryptocurrency
    Exchange
    Real World Assets
    Derivatives
    CMC AI
      CMC AI MapgetMarket Feed LatestgetCoin Insights Latestget
    Global Metrics
    Content
    Community
    CMC Index
    Others
DEX Data
    Token
    Platform
    Holder
    OHLCV
Utilities
    Fiat ID MapgetKey InfogetPostman Conversion v1getPrice Conversion v2get
Legacy
CoinMarketCap Cryptocurrency API Documentation
CoinMarketCap Cryptocurrency API Documentation

CMC AI

Endpoints for CMC AI question-and-answer content shown on the CoinMarketCap homepage and Coin Detail Pages. This category includes 3 endpoints:
  • /v5/cmc-ai/coins/map - CMC AI Map
  • /v5/cmc-ai/latest - Market Feed Latest
  • /v5/cmc-ai/coins/latest - Coin Insights Latest

CMC AI Map

GET
https://pro-api.coinmarketcap.com
/v5/cmc-ai/coins/map
X-CMC_PRO_API_KEY (header)

Returns the cryptocurrencies for which CMC AI currently writes Coin Detail Page content. Call this before /v5/cmc-ai/coins/latest when you need to know which coins are covered, and which of those currently have an empty insights[]. No answer bodies are returned here.

Current coverage is the top 100 cryptocurrencies by market cap. The set rotates as the ranking changes. All filters are optional. A filter that matches a coin we do not cover is not an error. That coin is simply absent from data.coins[], and total_size reflects the matched count. A param-less call returns the full supported set.

This endpoint is available on the following API plans:

  • Basic
  • Builder
  • Startup
  • Growth
  • Professional
  • Enterprise

Cache / Update frequency: Responses may be up to 1 minute old.
Plan credit use: 1 call credit per request. Repeat calls that return the same content are not charged.
CMC equivalent page: No equivalent, API only.

CMC AI Map › query Parameters

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

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,1027. Mutually exclusive with slug and symbol.

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

Alternatively pass comma-separated cryptocurrency slugs. Example: bitcoin,ethereum. Mutually exclusive with crypto_id and symbol.

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

Alternatively pass comma-separated cryptocurrency symbols. Example: BTC,ETH. Mutually exclusive with crypto_id and slug.

sort
​string · enum

Field used to sort the list. One of cmc_rank, crypto_id, name. Default cmc_rank.

Enum values:
cmc_rank
crypto_id
name
Default: cmc_rank
start
​integer · min: 1

1-based offset of the paginated list to return.

Default: 1
limit
​integer · min: 1 · max: 250

Number of results to return. Use with start to page through the list. Default 100, max 250.

Default: 100

CMC AI Map › Headers

X-CMC_PRO_API_KEY
​string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

CMC AI Map › Responses

Successful

CMC_AI_Coins_Map_-_Response_Model
​CMC_AI_Coins_Map_-_Results_object · required

Results of your query returned as an object.

​API_Status_Object

Standardized status object for API calls.

GET/v5/cmc-ai/coins/map
curl https://pro-api.coinmarketcap.com/v5/cmc-ai/coins/map \ --header 'X-CMC_PRO_API_KEY: <api-key>'
Example Responses
{ "data": { "coins": [ { "crypto_id": 1, "name": "Bitcoin", "symbol": "BTC", "slug": "bitcoin", "url": "https://coinmarketcap.com/currencies/bitcoin/", "available_question_keys": [ "price_up", "future_price", "latest_news", "overview", "roadmap", "codebase" ], "num_insights": 8, "last_generated_at": "2026-08-17T09:14:14Z" }, { "crypto_id": 1027, "name": "Ethereum", "symbol": "ETH", "slug": "ethereum", "url": "https://coinmarketcap.com/currencies/ethereum/", "available_question_keys": [ "price_down", "future_price", "sentiment", "overview", "roadmap" ], "num_insights": 6, "last_generated_at": "2026-08-17T09:10:03Z" }, { "crypto_id": 825, "name": "Tether USDt", "symbol": "USDT", "slug": "tether", "url": "https://coinmarketcap.com/currencies/tether/", "available_question_keys": [ "overview", "latest_news" ], "num_insights": 3, "last_generated_at": "2026-08-16T21:04:00Z" } ], "total_size": 100, "has_more": true }, "status": { "timestamp": "2026-03-05T22:43:48.471Z", "error_code": 0, "error_message": "", "elapsed": 10, "credit_count": 1, "notice": "" } }
json
application/json

Market Feed Latest

GET
https://pro-api.coinmarketcap.com
/v5/cmc-ai/latest
X-CMC_PRO_API_KEY (header)

Returns the CMC AI questions, answers, and top news from the CoinMarketCap homepage. Use it when you want a market briefing as structured data in a dashboard, terminal, or research product.

On the homepage these insights appear as the blue question pills above the cryptocurrency list. Some questions are a fixed template. Others are written for current market conditions and then go away.

  • fixed_question is a stable template that stays in the rotation. Examples include "What are the trending narratives?", "Are altcoins outperforming Bitcoin?", and "What is the market sentiment?". The question text does not change. The answer is rewritten as the market moves.
  • trending_question is a market-dependent question with no fixed template. The question itself appears and disappears with current conditions, for example a one-off prompt about a sudden sector rotation or a catalyst dominating discussion that week.
  • top_news is a headline plus recap of a current story, for example "BTC stuck near $63K as US spot ETFs see $390M outflows". Headlines change as the news cycle changes.

This endpoint is market-wide. Coin-specific questions appear as blue pills below the charts on a Coin Detail Page. Use /v5/cmc-ai/coins/latest and /v5/cmc-ai/coins/map for those.

Refresh cadence:

  • fixed_question: about every 30 minutes.
  • trending_question: about every 30 minutes.
  • top_news: about every 30 minutes.

Content is fetched from the database. This endpoint does not generate answers on request. Answers are English only.

This endpoint is available on the following API plans:

  • Basic
  • Builder
  • Startup
  • Growth
  • Professional
  • Enterprise

Cache / Update frequency: Responses may be up to 1 minute old. See the cadence list above for how often content is regenerated.
Plan credit use: 1 call credit per request. Repeat calls that return the same content are not charged.
CMC equivalent page: The blue question pills above the list on coinmarketcap.com.

Market Feed Latest › query Parameters

type
​string

Optionally filter by insight type. Comma-separated. Allowed: fixed_question, trending_question, top_news. Example: top_news or fixed_question,trending_question.

sources_limit
​integer · min: 0 · max: 100

Max source URLs to return per insight. Default 10, max 100. Pass 0 to return an empty sources[] while still populating sources_count.

Default: 10
start
​integer · min: 1

1-based offset of the paginated list to return.

Default: 1
limit
​integer · min: 1 · max: 250

Number of results to return. Use with start to page through the list. Default 100, max 250.

Default: 100

Market Feed Latest › Headers

X-CMC_PRO_API_KEY
​string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Market Feed Latest › Responses

Successful

CMC_AI_Latest_-_Response_Model
​CMC_AI_Latest_-_Results_object · required

Results of your query returned as an object.

​API_Status_Object

Standardized status object for API calls.

GET/v5/cmc-ai/latest
curl https://pro-api.coinmarketcap.com/v5/cmc-ai/latest \ --header 'X-CMC_PRO_API_KEY: <api-key>'
Example Responses
{ "data": { "insights": [ { "type": "fixed_question", "title": "What are the trending narratives?", "answer_id": "6a82d003e66d8e4bf5368dcf", "question_key": "trending_narratives", "answer": { "tldr": "## TLDR\nAI, RWA, and ETF-flow narratives are leading attention this session, while meme-coin volume has cooled.", "body": "## Deep Dive\nBitcoin dominance is steady and sector rotation is concentrated in a handful of large-cap themes.\n\n## Conclusion\nWatch BTC dominance and spot-ETF flows into the next session." }, "sources": [ { "url": "https://coinmarketcap.com/trending-cryptocurrencies/" }, { "url": "https://x.com/coinmarketcap" } ], "sources_count": 91, "sources_truncated": true, "generated_at": "2026-08-17T09:11:37Z" }, { "type": "top_news", "title": "BTC stuck near $63K as US spot ETFs see $390M outflows", "answer_id": "6a829ec8e210dd5a1b8f0570", "question_key": null, "answer": { "tldr": "## TLDR\nUS spot Bitcoin ETFs posted another session of net outflows, keeping BTC range-bound.", "body": "## Deep Dive\nSpot-ETF flow is the near-term driver. A return to net inflows would be the first sign the range is breaking.\n\n## Conclusion\nPrice is waiting on flow, not a new macro catalyst." }, "sources": [ { "url": "https://cryptopotato.com/btc-etf-outflows-august" } ], "sources_count": 27, "sources_truncated": true, "generated_at": "2026-08-17T05:40:24Z" } ], "total_size": 26, "has_more": true }, "status": { "timestamp": "2026-03-05T22:43:48.471Z", "error_code": 0, "error_message": "", "elapsed": 10, "credit_count": 1, "notice": "" } }
json
application/json

Coin Insights Latest

GET
https://pro-api.coinmarketcap.com
/v5/cmc-ai/coins/latest
X-CMC_PRO_API_KEY (header)

Returns the CMC AI questions and answers for a cryptocurrency. Use it to attach explainers to any asset you already display, including why the price moved today, what people are saying, what is on the roadmap, and the latest news. Exactly one of crypto_id, slug, or symbol is required; they are mutually exclusive.

On a Coin Detail Page these insights appear as the blue question pills below the price chart, for example on coinmarketcap.com/currencies/bitcoin/. Some questions are a fixed template for that coin. Others are written for current market conditions and then go away.

  • fixed_question is a stable template. Examples include "What is Bitcoin?", "What could affect BTC's future price?", "What is next on BTC's roadmap?", and "What is the latest update in BTC's codebase?". Two templates depend on the day's move: "Why is BTC's price up today?" (price_up) or "Why is BTC's price down today?" (price_down). Only one of those is shown. A coin never returns both.
  • trending_question is a market-dependent question about that coin with no fixed template, for example a one-off prompt about a protocol incident or a catalyst unique to that asset.
  • top_news is a headline tied to the requested coin. These change as the news cycle changes.

When a requested cryptocurrency is in the coverage set but has no content yet, it is still returned with an empty insights[] array rather than an error. Coins skipped by skip_invalid, and coins returned with an empty insights[], are not charged. Pagination is over cryptocurrencies, not over individual insights. Coverage is the current top 100 by market cap and is not guaranteed per question. Use /v5/cmc-ai/coins/map first if you need to know which coins currently have coverage. Market-wide homepage questions live on /v5/cmc-ai/latest.

Refresh cadence by question:

  • price_up and price_down: about every 1 hour.
  • future_price, sentiment, and latest_news: about every 8 hours.
  • overview, roadmap, and codebase: about every 24 hours.
  • trending_question: about every 24 hours.

Content is fetched from the database. This endpoint does not generate answers on request. Answers are English only.

This endpoint is available on the following API plans:

  • Basic
  • Builder
  • Startup
  • Growth
  • Professional
  • Enterprise

Cache / Update frequency: Responses may be up to 1 minute old. See the cadence list above for how often each question is regenerated.
Plan credit use: 1 call credit per cryptocurrency returned. Skipped coins and empty-insight coins are free. Repeat calls that return the same content for a coin are not charged.
CMC equivalent page: The blue question pills below the chart on Coin Detail Pages, e.g. coinmarketcap.com/currencies/bitcoin/.

Coin Insights Latest › query Parameters

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

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,1027. Mutually exclusive with slug and symbol.

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

Alternatively pass comma-separated cryptocurrency slugs. Example: bitcoin,ethereum. Mutually exclusive with crypto_id and symbol.

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

Alternatively pass comma-separated cryptocurrency symbols. Example: BTC,ETH. Mutually exclusive with crypto_id and slug.

type
​string

Optionally filter by insight type. Comma-separated. Allowed: fixed_question, trending_question, top_news. Example: top_news or fixed_question,trending_question.

question_key
​string

Optionally filter fixed questions by semantic key. Comma-separated. Allowed: price_up, price_down, future_price, sentiment, latest_news, overview, roadmap, codebase. Ignored for non-fixed types.

sources_limit
​integer · min: 0 · max: 100

Max source URLs to return per insight. Default 10, max 100. Pass 0 to return an empty sources[] while still populating sources_count.

Default: 10
skip_invalid
​boolean

When requesting multiple cryptocurrencies, pass true to skip unresolvable identifiers and still return the valid ones. When false (default), any unresolvable identifier fails the whole request with 4001.

Default: false
start
​integer · min: 1

1-based offset of the paginated list to return.

Default: 1
limit
​integer · min: 1 · max: 250

Number of results to return. Use with start to page through the list. Default 100, max 250.

Default: 100

Coin Insights Latest › Headers

X-CMC_PRO_API_KEY
​string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Coin Insights Latest › Responses

Successful

CMC_AI_Coins_Latest_-_Response_Model
​CMC_AI_Coins_Latest_-_Results_object · required

Results of your query returned as an object.

​API_Status_Object

Standardized status object for API calls.

GET/v5/cmc-ai/coins/latest
curl https://pro-api.coinmarketcap.com/v5/cmc-ai/coins/latest \ --header 'X-CMC_PRO_API_KEY: <api-key>'
Example Responses
{ "data": { "coins": [ { "crypto_id": 1, "name": "Bitcoin", "symbol": "BTC", "slug": "bitcoin", "insights": [ { "type": "fixed_question", "title": "Why is BTC's price up today?", "answer_id": "6a82d0abe24562528cd3f6ac", "question_key": "price_up", "answer": { "tldr": "## TLDR\nBitcoin bounced as US spot-ETF outflows slowed and funding rates reset closer to neutral.", "body": "## Deep Dive\nThe move is a relief bounce inside a broader range, not a confirmed trend reversal.\n\n## Conclusion\nHold the range until ETF flows turn sustainably positive." }, "sources": [ { "url": "https://coinmarketcap.com/currencies/bitcoin/" } ], "sources_count": 57, "sources_truncated": true, "generated_at": "2026-08-17T09:14:14Z" }, { "type": "fixed_question", "title": "What could affect BTC's future price?", "answer_id": "6a82d11c9c0e4a1bb7e2c401", "question_key": "future_price", "answer": { "tldr": "## TLDR\nETF flows, dollar strength, and miner distribution remain the main forward-looking drivers for Bitcoin.", "body": "## Deep Dive\nA sustained return of spot-ETF inflows would be the cleanest bullish tell. The opposite keeps BTC range-bound.\n\n## Conclusion\nPosition around flow, not a single print." }, "sources": [ { "url": "https://coinmarketcap.com/currencies/bitcoin/" }, { "url": "https://cryptopotato.com/btc-etf-outflows-august" } ], "sources_count": 34, "sources_truncated": true, "generated_at": "2026-08-17T08:02:11Z" } ] }, { "crypto_id": 1027, "name": "Ethereum", "symbol": "ETH", "slug": "ethereum", "insights": [ { "type": "fixed_question", "title": "Why is ETH's price down today?", "answer_id": "6a82d22f0ab14c33a91de802", "question_key": "price_down", "answer": { "tldr": "## TLDR\nEther lagged Bitcoin as ETH ETF flows stayed soft and L2 activity cooled.", "body": "## Deep Dive\nRelative weakness versus BTC is the story more than a standalone ETH shock.\n\n## Conclusion\nETH/BTC is the pair to watch until ETF flow improves." }, "sources": [ { "url": "https://coinmarketcap.com/currencies/ethereum/" } ], "sources_count": 22, "sources_truncated": true, "generated_at": "2026-08-17T09:10:03Z" } ] } ], "total_size": 2, "has_more": false }, "status": { "timestamp": "2026-03-05T22:43:48.471Z", "error_code": 0, "error_message": "", "elapsed": 10, "credit_count": 1, "notice": "" } }
json
application/json

DerivativesGlobal Metrics