CoinMarketCap API for AI Agents: six access paths connect agents to live crypto data, starting with the free no-key Keyless Public API, plus MCP, x402 pay-per-call, CMC CLI, Skills, and REST.

Connect AI agents to live CoinMarketCap crypto data through six access paths: the free Keyless Public API, MCP, x402 pay-per-call, CMC CLI, Skills, and REST. Start with no key and no signup.

Last updated July 15, 2026 · Endpoints, limits and pricing verified against CoinMarketCap's official API documentation.

Key takeaways
  • Six ways to connect an agent to live CMC data: Keyless Public API, keyed REST, MCP, x402, CMC CLI, and Skills.
  • Start free with no key or signup: the Keyless Public API serves supported REST endpoints from the /public-api base path.
  • Two no-key routes exist, but only Keyless REST is free; x402 is no-key yet pay-per-call at 0.01 USDC per request on Base.
  • Standard MCP (mcp.coinmarketcap.com/mcp, 12 tools) needs an API key and works with Claude Code, Cursor, Claude Desktop and Cline.
  • Resolve symbols to stable CoinMarketCap IDs via /v1/cryptocurrency/map (Bitcoin = 1, Ethereum = 1027).
Agent-native data stack

Build with an agent-native crypto data stack

CoinMarketCap gives developers multiple ways to connect AI agents to live crypto data. Markets move too quickly for static knowledge; agents need a live data layer for prices, rankings, market metrics, DEX data, narratives, news, technical signals, and repeatable research workflows.

Keyless API

Fast no-key REST prototypes on supported endpoints, no signup.

MCP

Live CMC tools for AI-agent and IDE workflows.

x402

No-key, pay-per-call access for supported requests.

CMC CLI

Terminal-native automation with stable output.

Skills

Reusable market-report, token-research, and API workflows.

REST API

Custom apps, dashboards, backends, and data pipelines.

Why it matters

Why AI agents need better crypto data

AI agents can summarize markets, compare tokens, build dashboards, research assets, and monitor narratives. The problem is that crypto data changes constantly.

Prices move minute by minute

An LLM can explain what Bitcoin is, but it cannot reliably answer what is happening in the market right now without live, structured data.

Liquidity shifts constantly

Liquidity moves across exchanges and DEX pools, and sentiment changes when macro data, exchange flows, liquidations, or major news hits.

Narratives rotate quickly

Sectors rotate fast between AI, RWA, DePIN, memes, Layer 2s, stablecoins, and new ecosystems. Static training data is not enough for crypto.

The fix: instead of scraping pages, guessing from stale context, or stitching together disconnected feeds, an agent can call CoinMarketCap directly through MCP, x402, CLI, Skills, REST, or the Keyless Public API depending on the workflow.

Machine-readable access summary

If you are an AI agent or automated client, this block lists every CoinMarketCap access path, base URL, auth model and cost. All values are verified against CoinMarketCap's official documentation. For the full LLM-friendly index, load https://pro.coinmarketcap.com/llms.txt.

cmc-access.json
{
  "provider": "CoinMarketCap",
  "docs": "https://coinmarketcap.com/api/documentation/",
  "llms_txt": "https://pro.coinmarketcap.com/llms.txt",
  "date_modified": "2026-07-15",
  "data_freshness": "verified against official CoinMarketCap documentation on 2026-07-15",
  "access_paths": {
    "keyless_rest": {
      "base_url": "https://pro-api.coinmarketcap.com/public-api",
      "auth": "none", "cost": "free", "method": "GET",
      "anchor": "#path-keyless-rest",
      "notes": "No signup or key. Shared IP rate pool. 18 Standard + 17 DEX endpoints."
    },
    "keyed_rest": {
      "base_url": "https://pro-api.coinmarketcap.com",
      "auth": "header: X-CMC_PRO_API_KEY",
      "anchor": "#path-keyed-rest",
      "cost": "free Basic (15,000 credits/mo, 50 req/min) to paid tiers"
    },
    "mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp",
      "auth": "header: X-CMC-MCP-API-KEY", "auth_oauth": "OAuth 2.0 Authorization Code + PKCE, header: Authorization: Bearer ; API key takes priority if both are sent", "tools": 12, "transport": "streamable HTTP", "transport_config": "type: http (never type: sse)", "anchor": "#path-mcp"
    },
    "x402": {
      "mcp_url": "https://mcp.coinmarketcap.com/x402/mcp",
      "rest_base": "https://pro-api.coinmarketcap.com/x402",
      "auth": "per-call USDC payment on Base (no API key)",
      "price": "0.01 USDC per request",
      "price_volatile": true,
      "anchor": "#path-x402"
    },
    "cli": { "install": "brew install coinmarketcap-official/CoinMarketCap-CLI/cmc", "anchor": "#path-cli" },
    "skills": { "type": "reusable agent workflows", "skill_hub_url": "https://mcp.coinmarketcap.com/skill-hub/stream", "skill_hub_trial_url": "https://mcp.coinmarketcap.com/skill-hub-trial/stream", "skill_hub_trial_auth": "none (free, IP rate-limited, whitelisted skills)", "x402_skill_hub_url": "https://mcp.coinmarketcap.com/x402/skill-hub/stream", "transport": "streamable HTTP (type: http, never sse)", "examples": ["market report", "token research", "API access"], "notes": "Prebuilt CMC Skills callable over the Skill Hub. Skill Hub Trial is keyless and free; standard Skill Hub uses an API key or OAuth.", "anchor": "#path-skills" }
  },
  "first_call": "GET https://pro-api.coinmarketcap.com/public-api/v1/simple/price?ids=1,1027&convert=USD",
  "id_notes": "Resolve symbols to CoinMarketCap IDs via /v1/cryptocurrency/map (1=BTC, 1027=ETH)."
}

Choose an access path

Different AI-agent workflows need different access paths, and CoinMarketCap supports more than one. The Keyless Public API is the fastest way in: no account, no key, no cost. Add a key or per-call payment only when a workflow needs more.

Path Auth and cost Best for
Keyless REST No key, free, GET only First calls and prototypes with no account setup
Keyed REST API key; free Basic to paid tiers Custom apps and backends needing direct endpoint control
MCP API key; 12 tools Tool use inside Claude Code, Cursor, Claude Desktop, Cline and other MCP clients
x402 No key; 0.01 USDC per call on Base Pay-per-request agent access without a subscription
CMC CLI API key or env var Terminal-native automation with stable output
Skills Runs on the paths above Reusable market-report, token-research and API workflows

Tool and endpoint coverage differs by access path. Use the linked MCP, x402, CLI, Skills, REST, and Keyless docs for current availability and setup details.

Canonical machine index for LLMs and agents: https://pro.coinmarketcap.com/llms.txt

Quickstart

Connect an agent to CoinMarketCap

Copy/paste starters to test the main CoinMarketCap AI-agent access paths. Start with the keyless call, then add a key, MCP, or x402 as the workflow grows. The response shape is identical across keyless and keyed, so nothing needs a rewrite.

These are quick starts, not complete implementation guides. Use the linked spoke pages for production setup, authentication, payment handling, retries, schemas, and client-specific configuration.

1. Keyless REST quick test

Start here. The Keyless Public API is the fastest no-key, no-signup way to pull live data into an agent or prototype: copy, paste, run. Prefix any supported endpoint with /public-api. This requests current USD prices for Bitcoin (1) and Ethereum (1027).

Terminal · keyless
curl "https://pro-api.coinmarketcap.com/public-api/v1/simple/price?ids=1,1027&convert=USD"

2. Optional Python keyless test

A small no-key Python example with no external packages. Keep the full helper, backoff, quote parsing, and CSV export in the dedicated Keyless API Python guide.

keyless.py
import json, urllib.request

url = "https://pro-api.coinmarketcap.com/public-api/v1/simple/price?ids=1,1027&convert=USD"
with urllib.request.urlopen(url) as r:
    data = json.load(r)
print(data)

3. Standard CoinMarketCap MCP

Use standard MCP when your MCP-compatible client should access CoinMarketCap through an API-key-based workflow: recurring agent workflows, IDE integrations, and internal research assistants. The same config works across Claude Code, Cursor, Claude Desktop, Cline and other MCP clients. Configure the server as type "http" (Streamable HTTP), never type "sse". Standard MCP also supports OAuth 2.0 (Authorization Code with PKCE) using an Authorization: Bearer token; if a request carries both a key and a token, the API key takes priority.

mcp.json
{
  "mcpServers": {
    "cmc-mcp": {
      "type": "http",
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": { "X-CMC-MCP-API-KEY": "YOUR_API_KEY" }
    }
  }
}

4. CoinMarketCap x402 MCP

Use x402 MCP when your client supports x402 payment handling and you want no-key, pay-per-call access. This route does not use a CoinMarketCap API key.

mcp.json · x402
{
  "mcpServers": {
    "cmc-x402": { "type": "http", "url": "https://mcp.coinmarketcap.com/x402/mcp" }
  }
}

5. CMC CLI quickstart

Use CMC CLI when the workflow belongs in a terminal, automation script, or agent run that benefits from stable command output. Use explicit CoinMarketCap IDs when determinism matters, Bitcoin is ID 1.

Terminal
brew install coinmarketcap-official/CoinMarketCap-CLI/cmc
cmc auth
cmc price --id 1 -o json
Copy/paste prompts

Ready-made agent prompts

Use these prompts inside an agent that already has access to CoinMarketCap MCP, x402, CLI, Skills, REST, or Keyless Public API documentation.

Agent instruction prompt
You are a crypto market-data agent using CoinMarketCap as your primary live data source.

Use CoinMarketCap tools when the user asks for crypto prices, market cap, volume, global market metrics, market sentiment, technical analysis, trending narratives, recent news, macro-event context, DEX data, or token research.

Choose the access path based on the workflow:
- Use MCP when you are operating inside an MCP-compatible agent or IDE.
- Use x402 when no API key should be managed and pay-per-call access is appropriate.
- Use CMC CLI for terminal-native automation and repeatable command workflows.
- Use Skills for repeatable market reports, token research, CLI, MCP, x402, and API integration guidance.
- Use REST API when application code needs direct endpoint control.
- Use Keyless Public API for supported no-key REST prototypes.

When symbols may collide, prefer CoinMarketCap IDs, slugs, or ranked canonical assets. Do not assume ticker symbols are unique.
Crypto research agent prompt
Use live CoinMarketCap data to research the requested crypto asset.

Return:
1. Asset identity and CoinMarketCap ID or slug
2. Latest price, market cap, volume, and 24-hour change
3. Recent momentum and technical context where available
4. Market context from global metrics, Fear & Greed, Altcoin Season, or narratives where relevant
5. Recent news or catalysts where available
6. DEX, liquidity, holder, or security context where supported
7. Key risks, uncertainty, and data gaps
8. A concise summary suitable for a market-research brief

Use CoinMarketCap tools or documentation rather than stale model knowledge when live data is needed.
Market report agent prompt
Create a crypto market report using live CoinMarketCap data.

Include:
1. Market overview
2. BTC and ETH anchors
3. Total crypto market cap and 24-hour volume
4. Top movers or notable market changes
5. Market sentiment (Fear & Greed, Altcoin Season)
6. Trending narratives and notable news

Use live CoinMarketCap data rather than stale model knowledge.
Access-path selection prompt
Before answering, choose the right CoinMarketCap access path:

- MCP: agent or IDE tool use
- x402 MCP: no-key, pay-per-call agent access
- CMC CLI: terminal-native workflow
- Skills: repeatable agent workflow
- REST API: backend, app, dashboard, database, or scheduled job
- Keyless Public API: supported no-key REST prototype

Explain the chosen path briefly, then complete the task.
x402

Pay-per-call access, no subscription

x402 swaps the API key and monthly plan for per-request payment. There is no key to manage because the payment itself authenticates the call: an x402-aware client signs a small USDC payment on Base for each supported request and gets the data back. Good for agents and prototypes with occasional or unpredictable usage; it is not free.

When to use x402

  • Experiments and hackathons
  • Occasional agent calls and episodic research
  • No-API-key MCP workflows (pay-per-call)
  • Lightweight AI-agent prototypes
  • Agent workflows that prefer per-call payment

x402 MCP setup

Point any MCP client with an x402-aware transport at the x402 MCP server. No API-key header; the client signs a USDC payment per call.

mcp.json · x402 (pay-per-call)
{
  "mcpServers": {
    "cmc-x402": {
      "url": "https://mcp.coinmarketcap.com/x402/mcp"
    }
  }
}

x402 MCP vs standard MCP

Standard MCP
Recurring agent workflows
CoinMarketCap MCP API key
x402 MCP
No API key, pay-per-call
USDC payment through x402

How a call resolves

  • First request returns HTTP 402 with payment details (USDC on Base)
  • The x402 client signs a USDC authorization and retries
  • Server verifies and returns the data; payment settles only on success
  • Current price: $0.01 USDC per supported request, subject to change

x402 is no-API-key, not free. It replaces API-key authentication with payment for supported requests. x402 is not part of the MCP standard, so standard agents such as Claude Code, Cursor, Claude Desktop and Cline do not handle the 402 payment flow automatically; the x402 endpoints are for clients that implement x402 or for programmatic use. For production workloads with predictable scale, broader endpoint access, and account-managed usage, a standard CoinMarketCap API plan may be the better fit.

MCP

Live crypto data for AI tools

MCP lets AI agents discover and call CoinMarketCap tools inside compatible clients and IDEs, a strong fit for Claude and Claude Code, Cursor, Claude Desktop, Cline / Roo Code, ChatGPT-compatible MCP workflows where available, and other MCP-compatible environments.

A tool layer, not raw endpoints

The agent does not need to manually construct every REST endpoint. It discovers the available tools and calls the one that matches the user's request.

Latest crypto quotes Crypto search Crypto metadata Technical analysis Market cap On-chain-style metrics Global crypto metrics Derivatives metrics Trending narratives Macro events Latest crypto news Semantic search

Read the MCP documentation →

Claude Code

Register the hosted server with one command for terminal-based crypto intelligence inside an agentic coding workflow. Then verify: What tools do you have available?

Terminal
claude mcp add cmc-mcp \
  --transport http \
  --url https://mcp.coinmarketcap.com/mcp \
  --header "X-CMC-MCP-API-KEY: your-api-key"
Cursor / Claude Desktop / other MCP clients

Add the hosted server to your mcp.json. The same config works across Cursor, Claude Desktop, Cline, and any client that supports hosted MCP servers with custom headers. Set type "http", never "sse".

mcp.json
{
  "mcpServers": {
    "cmc-mcp": {
      "type": "http",
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": { "X-CMC-MCP-API-KEY": "your-api-key" }
    }
  }
}
ChatGPT-compatible

Use CoinMarketCap MCP in ChatGPT-compatible MCP workflows where supported. Exact setup depends on the client; use the standard endpoint and header only when your workflow supports hosted MCP servers and custom headers.

CLI & Skills

Terminal automation and pre-built workflows

CMC CLI: terminal-native automation

A shell-native way to work with CoinMarketCap data: repeatable commands, stable output, JSON, tables, CSV export, dry-run previews, and deterministic terminal behavior.

  • Quick price checks and scripted market scans
  • Terminal-based market reports and CSV exports
  • Agent-driven terminal workflows and repeatable commands

Skills: pre-built crypto workflows

Reusable workflows built on top of CoinMarketCap data access. Instead of asking an agent to invent a process each time, a Skill gives it a workflow pattern: what to do first, what data to fetch, and which mistakes to avoid. Skills are served over the Skill Hub at mcp.coinmarketcap.com/skill-hub/stream (API key or OAuth), with a keyless, free Skill Hub Trial at mcp.coinmarketcap.com/skill-hub-trial/stream (IP rate-limited, whitelisted skills).

  • Market reports, coin research, and DEX analysis
  • MCP, x402, CLI, and REST API integration workflows
  • Due-diligence and daily or weekly recaps

For agents in developer terminals, CLI can be easier than writing custom REST code for every first test. For production services, REST may still be better because application code usually needs stronger control over retries, storage, transformations, and response handling.

What agents can build with CoinMarketCap

CoinMarketCap data can support a wide range of agent workflows.

AI market analyst

Generate daily or weekly market reports using live prices, global metrics, movers, trending narratives, news, derivatives context, and macro-event awareness.

Token research agent

Research a token by combining identity resolution, price data, market cap, volume, metadata, holder context, technical indicators, market pairs, and recent news.

Crypto morning brief

A structured brief covering BTC, ETH, top movers, Fear & Greed, Altcoin Season, trending narratives, and major upcoming catalysts.

Portfolio-monitoring assistant

Monitor assets in a watchlist or portfolio, explain major price moves, and surface changes in market context.

DEX liquidity & risk monitor

Track token activity, liquidity, pair data, pools, holder distribution, and token security where available using DEX and on-chain surfaces.

Narrative tracker

Track sectors such as AI, RWA, DePIN, memes, Layer 2s, stablecoins, and new ecosystems against market performance, trending data, and news.

Market regime dashboard

Identify whether the market looks risk-on or risk-off using live prices, global metrics, Fear & Greed, Altcoin Season, derivatives context, and breadth.

Trading dashboard

Live prices, volume, market cap, market pairs, technical indicators, and market-wide metrics. Use REST when the backend needs storage and scheduled updates.

Why CoinMarketCap

A market-intelligence layer, not just prices

Generic crypto APIs can provide price data. CoinMarketCap gives agents a broader crypto market-intelligence layer: live prices and listings, market-wide context (global metrics, the Fear and Greed Index, Altcoin Season, CMC indices, derivatives), DEX and on-chain data, and agent-native access through MCP, x402, CLI and Skills, so an agent can ground on live data across a whole workflow rather than a single lookup.

Live prices and market data

Latest quotes, listings, market cap, volume, exchange context, global metrics, and historical context where available by endpoint and plan.

Market-wide context

Global metrics, Fear & Greed, Altcoin Season, CMC indices, derivatives data, trending topics, news, and macro-event context.

DEX and on-chain intelligence

DEX tokens, pairs, platforms, liquidity, pools, holders, transactions, security analysis, and OHLCV data where supported.

Agent-native access paths

Connect agents through MCP, pay per request through x402, automate terminal workflows through CMC CLI, and reuse Skills, not only a REST API.

Reusable workflows

Skills help agents produce consistent outputs, market reports, token research, CLI, MCP, x402, and API integration, instead of improvising each time.

Developer trust signals

Public API docs, AI Agent Hub, MCP, x402, CLI, and Skills docs, setup guides, pricing, status, changelog, and methodology resources.

Start free

Keyless REST across your AI tools

There is one genuinely free, no-key path: the Keyless Public API over REST at /public-api, no account, no key, no payment. Any agent, script or IDE assistant that can make an HTTP request can use it. Standard MCP uses an API key; the no-API-key x402 MCP route is pay-per-call. Response shapes are identical across all three, so there is nothing to rewrite as you move between them.

Keyless REST (free, no key)

The genuinely keyless path. Prefix any supported endpoint with /public-api: no account, no key, no headers, no payment. Same JSON envelope as the keyed Pro API.

Terminal · keyless
curl "https://pro-api.coinmarketcap.com/public-api/v1/simple/price?ids=1,1027&convert=USD"

Same shape, add a key later

For higher limits or the full Pro and DEX catalog, drop the /public-api prefix and add your key as the X-CMC_PRO_API_KEY header. The response is identical.

Terminal · keyed
curl "https://pro-api.coinmarketcap.com/v1/simple/price?ids=1,1027&convert=USD" \
  -H "X-CMC_PRO_API_KEY: YOUR_KEY"

Three access models, one hub. Keyless REST is free (no key, no pay). Standard MCP and the keyed REST/CLI setups use a free or paid API key for higher limits, the full Pro and DEX catalog, and account-managed usage. The no-API-key x402 MCP route is pay-per-call in USDC. Response shapes are identical, so there is nothing to rewrite as you move between them.

Comparison

CoinMarketCap vs generic crypto APIs for agents

Generic crypto APIs usually start with price data. That is useful, but AI agents need more than a price feed.

Generic crypto API CoinMarketCap for AI agents
Price data Prices plus rankings, market cap, volume, global metrics, and history
Endpoint-only integration MCP, x402, CLI, Skills, REST, and Keyless Public API
Basic asset lookup CoinMarketCap IDs, metadata, search, token pages, and market context
Limited market context Fear & Greed, Altcoin Season, CMC indices, derivatives, narratives, news, and macro-event context
Custom workflows built from scratch Reusable Skills for market reports, token research, CLI, MCP, x402, and API integration
One access model Multiple access paths for agents, scripts, apps, and backends

The stronger point is not that every developer must use the same path; it is that CoinMarketCap gives AI-agent builders more ways to connect the right workflow to the right data surface.

Production readiness

Developer trust and resources

AI-agent builders need data sources, docs, setup paths, and production signals. Use these CoinMarketCap resources when moving from prototype to production.

Where public uptime, latency, or benchmark data is unavailable, performance claims stay tied to public status, docs, endpoint behavior, and plan-specific limits.

FAQ

Frequently asked questions

What builders ask most before connecting an agent to CoinMarketCap.

What is the CoinMarketCap API for AI agents?

It is a developer stack for connecting AI agents, LLM apps, coding assistants, and automated research workflows to live CoinMarketCap crypto data. Builders can use MCP, x402, CMC CLI, Skills, REST, or the Keyless Public API depending on the workflow.

Does CoinMarketCap support MCP?

Yes. CoinMarketCap provides an MCP server for AI-agent workflows. Standard CoinMarketCap MCP uses an API key and lets compatible clients discover and call CoinMarketCap data tools.

Can I use CoinMarketCap data without an API key?

Yes, through specific no-key access paths. The Keyless Public API supports selected REST endpoints without an API key. x402 supports pay-per-request access without managing a CoinMarketCap API key or subscription for the supported x402 flow.

What is x402 pay-per-call access?

x402 is a pay-per-request access model. Instead of a traditional API key or subscription for the supported x402 flow, the client pays per request with USDC on Base and receives data after payment handling.

What can I build with CoinMarketCap MCP?

AI market analysts, token research agents, crypto copilots, market-monitoring assistants, narrative trackers, technical-analysis workflows, and research tools that need live CMC data inside an MCP-compatible client.

Does CoinMarketCap work with Claude Code, Cursor, Claude Desktop and Cline?

Yes. CoinMarketCap provides setup documentation for Claude Code, Cursor, Claude Desktop, and Cline. These guides show how to connect CoinMarketCap MCP so the assistant can access live crypto prices, market data, technical analysis, and related tools.

What are CoinMarketCap Skills?

Reusable workflows for AI agents. They help agents run repeatable processes such as market reports, token research, CLI workflows, MCP workflows, x402 workflows, and REST API integration tasks.

How is CoinMarketCap different from a regular crypto API?

A regular crypto API usually focuses on endpoint access or price data. CoinMarketCap gives builders multiple access paths plus market context: MCP, x402, CLI, Skills, REST, Keyless Public API, prices, rankings, global metrics, DEX data, sentiment, narratives, news, technical indicators, and market-regime tools.

Is CoinMarketCap suitable for crypto research agents?

Yes. It suits research agents that need live quotes, metadata, market context, technical analysis, holder or metrics context where available, news, narratives, and repeatable research workflows through Skills.

Can I use CoinMarketCap data in commercial AI applications?

Commercial use depends on the access path, plan, usage rights, and endpoint coverage. Use the CoinMarketCap API pricing page, documentation, and terms for the current commercial-use requirements before launch.

Should I use MCP or REST for an AI trading dashboard?

Use MCP when an AI assistant should answer natural-language questions and call tools. Use REST when your dashboard backend needs direct endpoint control, storage, scheduled polling, transformations, and predictable application logic.

Is x402 the same as the Keyless Public API?

No. The Keyless Public API is a no-key REST path for selected public endpoints. x402 is a pay-per-request access path that uses payment instead of API-key authentication for supported requests.

Build AI agents with live CoinMarketCap data

Start with the free Keyless Public API, add a key for higher limits, or connect agents through MCP, x402, CLI and Skills.