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
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:
BasicBuilderStartupGrowthProfessional- 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.
query Parameters
crypto_id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,1027. Mutually exclusive with slug and symbol.
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass comma-separated cryptocurrency slugs. Example: bitcoin,ethereum. Mutually exclusive with crypto_id and symbol.
symbol^[0-9A-Za-z$@\-,]+(?…Alternatively pass comma-separated cryptocurrency symbols. Example: BTC,ETH. Mutually exclusive with crypto_id and slug.
sortField used to sort the list. One of cmc_rank, crypto_id, name. Default cmc_rank.
start1-based offset of the paginated list to return.
limitNumber of results to return. Use with start to page through the list. Default 100, max 250.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
CMC AI Map › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Market Feed Latest
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_questionis 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_questionis 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_newsis 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:
BasicBuilderStartupGrowthProfessional- 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.
query Parameters
typeOptionally filter by insight type. Comma-separated. Allowed: fixed_question, trending_question, top_news. Example: top_news or fixed_question,trending_question.
sources_limitMax source URLs to return per insight. Default 10, max 100. Pass 0 to return an empty sources[] while still populating sources_count.
start1-based offset of the paginated list to return.
limitNumber of results to return. Use with start to page through the list. Default 100, max 250.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Market Feed Latest › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Coin Insights Latest
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_questionis 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_questionis 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_newsis 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_upandprice_down: about every 1 hour.future_price,sentiment, andlatest_news: about every 8 hours.overview,roadmap, andcodebase: 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:
BasicBuilderStartupGrowthProfessional- 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/.
query Parameters
crypto_id^\d+(?:,\d+)*$One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,1027. Mutually exclusive with slug and symbol.
slug^[0-9a-z-]+(?:,[0-9a…Alternatively pass comma-separated cryptocurrency slugs. Example: bitcoin,ethereum. Mutually exclusive with crypto_id and symbol.
symbol^[0-9A-Za-z$@\-,]+(?…Alternatively pass comma-separated cryptocurrency symbols. Example: BTC,ETH. Mutually exclusive with crypto_id and slug.
typeOptionally filter by insight type. Comma-separated. Allowed: fixed_question, trending_question, top_news. Example: top_news or fixed_question,trending_question.
question_keyOptionally 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_limitMax source URLs to return per insight. Default 10, max 100. Pass 0 to return an empty sources[] while still populating sources_count.
skip_invalidWhen 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.
start1-based offset of the paginated list to return.
limitNumber of results to return. Use with start to page through the list. Default 100, max 250.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Coin Insights Latest › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.