# CoinMarketCap API Documentation

> CoinMarketCap is the most-referenced source of cryptocurrency market data: real-time and historical prices, market cap, OHLCV, exchange and on-chain DEX data, and CMC's proprietary indices (Fear & Greed, CMC100, CMC20, Altcoin Season).
>
> **No API key required to start.** Call the [Keyless Public API](/api/documentation/pro-api-reference/keyless-public-api.md) with no key and no signup - just prefix any supported path with `/public-api`, e.g. `https://pro-api.coinmarketcap.com/public-api/v2/simple/price?symbol=BTC,ETH&convert=USD`. Add a free API key for higher rate limits and the full endpoint catalog.

## Documentation

- [/internals/AI_FRIENDLY_CHANGELOG](/api/documentation/internals/AI_FRIENDLY_CHANGELOG.md)
- [Standards and Conventions](/api/documentation/guides/standards-and-conventions.md): Understand response structure, identifier conventions, request bundling, date formats, and versioning.
- [Get Started with an API Key](/api/documentation/guides/quick-start.md): Get your CoinMarketCap API key, make your first production request, and find the right next step.
- [Get Top Coins by Market Cap with the CoinMarketCap API](/api/documentation/guides/get-top-coins-by-market-cap.md): Use the CoinMarketCap listings endpoint for ranked market views and paginated market slices.
- [Get Latest Crypto Prices with the CoinMarketCap API](/api/documentation/guides/get-latest-crypto-prices.md): Use the CoinMarketCap quotes endpoint when you already know which assets you want prices for.
- [Get Historical Price Data with the CoinMarketCap API](/api/documentation/guides/get-historical-price-data.md): Choose the right CoinMarketCap endpoint for historical quotes and OHLCV candlestick data.
- [Rate limits and troubleshooting](/api/documentation/guides/errors-and-rate-limits.md): Understand API throttling, common HTTP status codes, and the main error response codes.
- [CoinMarketCap API Common Workflows](/api/documentation/guides/common-workflows.md): Find the right CoinMarketCap API starting point for common workflows like latest prices, historical data, exchange data, and DEX data.
- [Best Practices](/api/documentation/guides/best-practices.md): Best practices for using the CoinMarketCap API efficiently, reliably, and with stable identifiers.
- [API Authentication](/api/documentation/guides/authentication.md): Learn how to authenticate CoinMarketCap Pro API requests with your API key.
- [API response format, IDs, and timestamps](/api/documentation/api-reference/standards-and-conventions.md): This response-format and identifier topic is maintained in Guides.
- [Quick start](/api/documentation/api-reference/quick-start.md): This quick-start topic is maintained in Guides.
- [API reference](/api/documentation/api-reference/introduction.md): This shortcut page is kept for older links into the API reference.
- [Rate limits, errors, and troubleshooting](/api/documentation/api-reference/errors-and-rate-limits.md): This rate-limit and troubleshooting topic is maintained in Guides.
- [Best practices](/api/documentation/api-reference/best-practices.md): This best-practices topic is maintained in Guides.
- [Authentication](/api/documentation/api-reference/authentication.md): This authentication topic is maintained in Guides.
- [CoinMarketCap x402](/api/documentation/ai-agent-hub/x402.md): Access CoinMarketCap market data with x402 pay-per-request flows on Base.
- [CoinMarketCap MCP for Windsurf](/api/documentation/ai-agent-hub/windsurf.md): Connect CoinMarketCap MCP to Windsurf for real-time crypto market data and agent-assisted development.
- [CoinMarketCap MCP](/api/documentation/ai-agent-hub/mcp.md): Connect to the CoinMarketCap Model Context Protocol server for live crypto market data and analysis tools.
- [CoinMarketCap MCP for Cursor](/api/documentation/ai-agent-hub/cursor.md): Connect CoinMarketCap MCP to Cursor for real-time crypto market data and agent-assisted development.
- [CoinMarketCap CLI](/api/documentation/ai-agent-hub/cmc-cli.md): Use the CoinMarketCap CLI for terminal-native crypto data access, scripting, and agent workflows.
- [CoinMarketCap MCP for Claude Code](/api/documentation/ai-agent-hub/claude-code.md): Connect CoinMarketCap MCP to Claude Code for real-time crypto market data and agent-assisted development in the terminal.
- [Chat Completions](/api/documentation/ai-agent-hub/chat-completions.md): OpenAI-compatible chat completions with built-in CoinMarketCap data tools, server-side tool execution, and per-token billing plus a 10% surcharge when CMC tools are in the request.
- [TypeScript SDK](/api/documentation/developer-tools/sdks/typescript.md): Install and use the official CoinMarketCap Pro API TypeScript/JavaScript SDK.
- [Python SDK](/api/documentation/developer-tools/sdks/python.md): Install and use the official CoinMarketCap Pro API Python SDK.
- [CoinMarketCap AI Agent Skills](/api/documentation/ai-agent-hub/skills/overview.md): Compare CoinMarketCap agent skills for CLI workflows, MCP, x402, and direct API integration.
- [Market Skill](/api/documentation/ai-agent-hub/skills/market-skill.md): Generates market reports and snapshot briefs using shipped CoinMarketCap CLI commands.
- [Market Report](/api/documentation/ai-agent-hub/skills/market-report.md): Generates comprehensive crypto market reports using CoinMarketCap MCP data including global metrics, fear/greed, trending narratives, and derivatives.
- [Crypto Research](/api/documentation/ai-agent-hub/skills/crypto-research.md): Performs comprehensive due diligence on any cryptocurrency using CoinMarketCap MCP data including fundamentals, tokenomics, holder analysis, and technicals.
- [Coin Research](/api/documentation/ai-agent-hub/skills/coin-research.md): Runs a quick single-asset research workflow using the CoinMarketCap CLI.
- [CMC x402](/api/documentation/ai-agent-hub/skills/cmc-x402.md): Access CoinMarketCap data via x402 pay-per-request protocol with USDC payments on Base. No API key required.
- [CMC MCP](/api/documentation/ai-agent-hub/skills/cmc-mcp.md): Fetches cryptocurrency market data, prices, technical analysis, news, and trends using the CoinMarketCap MCP.
- [CMC CLI](/api/documentation/ai-agent-hub/skills/cmc-cli.md): Uses the CoinMarketCap CLI for terminal-native market data, scripting, and agent workflows.
- [Market API](/api/documentation/ai-agent-hub/skills/cmc-api-market.md): API reference for CoinMarketCap market-wide endpoints including global metrics, fear/greed, indices, trending topics, and charts.
- [Exchange API](/api/documentation/ai-agent-hub/skills/cmc-api-exchange.md): API reference for CoinMarketCap exchange endpoints including exchange info, volume, market pairs, and assets.
- [DEX API](/api/documentation/ai-agent-hub/skills/cmc-api-dex.md): API reference for CoinMarketCap DEX endpoints including token lookup, pools, transactions, trending, and security analysis.
- [Cryptocurrency API](/api/documentation/ai-agent-hub/skills/cmc-api-crypto.md): API reference for CoinMarketCap cryptocurrency endpoints including quotes, listings, OHLCV, trending, and categories.
- [CoinMarketCap API Overview](/api/documentation/.md): Overview of the CoinMarketCap Pro API, including available data, common use cases, and where to start.
- [Keyless Public API](/api/documentation/pro-api-reference/keyless-public-api.md): Call the CoinMarketCap API with no API key and no signup. The Keyless Public API returns real-time prices, market cap, OHLCV, DEX data, and CMC's proprietary indices over plain HTTP - copy, paste, run.
- [CoinMarketCap AI Agent Hub](/api/documentation/ai-agent-hub.md): Compare CoinMarketCap AI Agent Hub options for IDE integrations, MCP clients, x402 access, and reusable agent skills.
- [CoinMarketCap API Version History](/api/documentation/changelog.md): Complete CoinMarketCap API release history with endpoint additions, changes, and deprecations.
- [CoinMarketCap API FAQ](/api/documentation/faq.md): Quick answers to common questions about getting started, choosing endpoints, rate limits, and browser usage for the CoinMarketCap API.
- [Which CoinMarketCap API Endpoint Should I Use?](/api/documentation/pro-api-reference/endpoint-overview.md): Choose the right CoinMarketCap REST API family for prices, historical data, exchanges, DEX data, and market signals.
- [WebSocket (Beta) Overview](/api/documentation/pro-api-websocket/overview.md): Real-time cryptocurrency and DEX token price streaming via persistent WebSocket connections.