canonical: https://jentic.com/apis/pro.coinmarketcap.com/coinmarketcap # Pro Coinmarketcap CoinMarketCap API Jentic publishes the only available OpenAPI specification for CoinMarketCap API, keeping it validated and agent-ready. The CoinMarketCap API provides real-time and historical cryptocurrency market data across 25 endpoints, covering price quotes, market capitalizations, OHLCV candlestick data, exchange volumes, trending coins, and global market metrics. It supports over 10,000 cryptocurrencies and 500 exchanges, making it one of the most comprehensive sources of digital asset pricing data available programmatically. ## For AI agents Retrieve real-time cryptocurrency prices, historical OHLCV data, exchange volumes, and global market metrics for over 10,000 digital assets and 500 exchanges. ## Scope Does not handle trading, wallet management, or portfolio tracking - use for market data retrieval only. ## Capabilities - Retrieve real-time price quotes and market capitalizations for thousands of cryptocurrencies - Access historical OHLCV candlestick data for technical analysis across configurable time intervals - Track trending cryptocurrencies including top gainers, losers, and most-visited coins - Query exchange-level data including trading volumes and available market pairs - Monitor global cryptocurrency market metrics such as total market cap and BTC dominance - Convert between cryptocurrency and fiat currency values using live exchange rates - Browse and filter cryptocurrency categories with aggregate market statistics ## Use cases ### Portfolio Price Monitoring Track real-time prices and 24-hour changes for a portfolio of cryptocurrency holdings. The CoinMarketCap API returns latest quotes for up to 100 cryptocurrencies in a single request, with data including price, volume, market cap, and percent changes across 1h, 24h, 7d, and 30d windows. Agents can poll this endpoint on a schedule to detect significant price movements and trigger alerts. Example prompt: Retrieve the latest USD quotes for BTC, ETH, and SOL using the /v2/cryptocurrency/quotes/latest endpoint and flag any coin with a 24-hour change exceeding 5 percent ### Technical Analysis Data Feed Access historical OHLCV (open, high, low, close, volume) candlestick data for any listed cryptocurrency across daily, hourly, or minute intervals. The CoinMarketCap API provides up to 10,000 data points per request with configurable time periods, enabling backtesting of trading strategies and generation of technical indicators without maintaining a separate data pipeline. Example prompt: Fetch daily OHLCV data for Ethereum from /v2/cryptocurrency/ohlcv/historical for the last 90 days and calculate the 20-day moving average ### Exchange Volume Comparison Compare trading volumes and available market pairs across cryptocurrency exchanges. The API covers over 500 exchanges with normalized volume data, spot and derivatives breakdowns, and exchange-level metadata. This enables agents to identify the most liquid venues for a given trading pair or assess exchange reliability based on reported volumes. Example prompt: Query /v1/exchange/listings/latest to rank the top 10 exchanges by 24-hour adjusted volume and return the exchange name and volume for each ### AI Agent Cryptocurrency Research Enable AI agents to answer natural-language questions about cryptocurrency markets by searching for and executing CoinMarketCap API operations through Jentic. Agents can resolve coin identifiers, fetch current pricing, pull category breakdowns, and access trending data without hardcoding API paths or managing authentication directly. Example prompt: Search Jentic for 'get cryptocurrency market data', load the operation schema for latest quotes, and execute a request to retrieve the current price and market cap for the top 5 coins by market cap ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | /v2/cryptocurrency/quotes/latest | Get latest price quotes for one or more cryptocurrencies | | GET | /v1/cryptocurrency/listings/latest | List all cryptocurrencies ranked by market cap | | GET | /v2/cryptocurrency/ohlcv/historical | Get historical OHLCV candlestick data | | GET | /v1/cryptocurrency/trending/latest | Get trending cryptocurrencies | | GET | /v1/exchange/listings/latest | List exchanges ranked by volume | | GET | /v1/global-metrics/quotes/latest | Get global crypto market metrics | | GET | /v1/tools/price-conversion | Convert between crypto and fiat currencies | | GET | /v1/cryptocurrency/map | Map CoinMarketCap IDs to cryptocurrency symbols | ## Key resources - **Cryptocurrency** — Price quotes, listings, OHLCV data, trending coins, and category browsing for digital assets - **Exchange** — Exchange listings, volume data, and market pair information across 500+ exchanges - **Global Metrics** — Aggregate market statistics including total market cap and BTC dominance - **Tools** — Utility operations like fiat currency mapping and price conversion ## Why Jentic - **Setup:** Wiring the CoinMarketCap API by hand means setting the X-CMC_PRO_API_KEY header, pointing calls at pro-api.coinmarketcap.com, and tracking which v1 and v2 paths serve which market data yourself. Through Jentic you install once, import CoinMarketCap from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** CoinMarketCap's market data endpoints take their targets as query parameters rather than an id in the URL path, so scope the agent by operations: limit it to the reads it needs, such as latest quotes and listings. You choose the operations it may call, so it stays within read-only market data. - **Credential handling:** Your CoinMarketCap API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get the latest cryptocurrency price' or 'convert between currencies', and Jentic returns the matching CoinMarketCap operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **CoinGecko API** — Free-tier crypto market data with broader DeFi protocol coverage but lower rate limits - **Blockchain.com API** — On-chain blockchain data including transaction details and wallet balances - **Binance API** — Exchange-specific market data with trading execution for the highest-volume crypto exchange ## FAQ ### Why is there no official OpenAPI spec for CoinMarketCap API? CoinMarketCap does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call CoinMarketCap API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the CoinMarketCap API use? The CoinMarketCap API uses an API key passed in the X-CMC_PRO_API_KEY header with every request. Through Jentic, this key is stored encrypted in the credential vault and injected automatically - agents never handle the raw key directly. ### Can I get historical OHLCV data for any cryptocurrency with this API? Yes. The /v2/cryptocurrency/ohlcv/historical endpoint returns open, high, low, close, and volume data for any listed cryptocurrency. You can specify daily or hourly intervals and request up to 10,000 data points per call, covering years of historical price action. ### What are the rate limits for the CoinMarketCap API? Rate limits depend on your subscription tier. The free Basic plan allows 333 calls per day and 10,000 per month. Paid plans (Hobbyist, Startup, Standard, Professional, Enterprise) progressively increase limits up to unlimited calls. Each response includes rate limit headers showing your remaining credits. ### How do I retrieve the latest Bitcoin price through Jentic? Search Jentic for 'get cryptocurrency price quote', load the returned operation schema for /v2/cryptocurrency/quotes/latest, then execute with the parameter symbol set to BTC and convert set to USD. Jentic handles authentication and returns the structured price response. Install with pip install jentic. ### Does the CoinMarketCap API cover exchange-level data? Yes. The API includes endpoints for exchange listings (/v1/exchange/listings/latest), exchange quotes (/v1/exchange/quotes/latest), and market pairs per exchange (/v1/exchange/market-pairs/latest). These cover over 500 exchanges with normalized 24-hour trading volumes. ### Can I access trending and category data for cryptocurrencies? Yes. The /v1/cryptocurrency/trending/latest endpoint returns currently trending coins, /v1/cryptocurrency/trending/gainers-losers provides top movers, and /v1/cryptocurrency/categories lists all tracked categories with aggregate market caps. These are useful for market screening and discovery workflows. ### Can I limit what my agent is allowed to do with the CoinMarketCap API? Yes. Because you run Jentic One yourself, your own rules decide which CoinMarketCap operations and credentials the agent may use. The CoinMarketCap endpoints take their targets as query parameters rather than an id in the URL path, so you scope the agent by operation, allowing only the reads it needs such as latest quotes at /v2/cryptocurrency/quotes/latest and listings at /v1/cryptocurrency/listings/latest. By choosing which operations it may call, you keep the agent confined to read-only market data and block anything you have not permitted.