CoinMarketCap API
★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey23 EndpointsREST
For Agents
Look up authoritative crypto rankings, prices, OHLCV history, exchange data, and global market metrics across thousands of assets through CoinMarketCap's Pro API.
Use for: Get the latest price quote for bitcoin and ethereum in USD, Retrieve a historical USD quote for solana on a specific past date, List the top 100 coins by market cap with current quotes, Pull daily OHLCV candles for a coin over the last 30 days
Not supported: Does not handle order placement, wallet management, or on-chain transactions — use for crypto rankings, quotes, OHLCV, and global metrics only.
Jentic publishes the only available OpenAPI specification for CoinMarketCap API, keeping it validated and agent-ready. CoinMarketCap is the most widely cited cryptocurrency rankings and market cap source — the Pro API exposes 23 endpoints covering listings, quotes (latest and historical), OHLCV candles, market pairs, exchange data, global metrics, trending coins, categories, fiat mappings, and a price conversion tool. Trading platforms, news sites, and analytics tools rely on it for benchmark pricing.
Install Jentic One Beta
Connect the CoinMarketCap API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CoinMarketCap API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with CoinMarketCap API.
Retrieve latest and historical listings of cryptocurrencies ranked by market cap
Pull latest and historical price quotes for one or many coins in any supported quote currency
Fetch OHLCV candles for cryptocurrencies over chosen time intervals
Browse market pairs for a coin to see where it trades and at what volumes
List exchanges and look up per-exchange info, listings, and quotes
Retrieve global market metrics including total market cap and BTC dominance
Surface trending coins, top gainers and losers, and convert amounts between two currencies
Use Cases
Patterns agents use CoinMarketCap API for, with concrete tasks.
★ Authoritative Rankings and Market Cap Display
Render the canonical ranked list of cryptocurrencies by market cap that users recognise from coinmarketcap.com. The /v1/cryptocurrency/listings/latest endpoint returns paginated coins with rank, price, market cap, and 24-hour change. Useful for explorers, exchanges, and market overview pages.
Call GET /v1/cryptocurrency/listings/latest with limit=100 and convert=USD and return the ranked list
OHLCV-Based Charting
Render OHLCV candles for a coin over chosen intervals using the v2 OHLCV endpoints. Supply latest or historical date ranges to power line and candlestick charts in trading dashboards or research tools.
Call GET /v2/cryptocurrency/ohlcv/historical with id, time_start, time_end, and interval=daily and return the candle series
Trending and Discovery Feeds
Power discovery surfaces (newsletter highlights, homepage carousels, alert feeds) using the trending and gainers-losers endpoints. They return short ranked lists CoinMarketCap publishes itself, so the data matches what readers see on the site.
Call GET /v1/cryptocurrency/trending/gainers-losers with time_period=24h and return the top five gainers
AI Market Briefing Agent via Jentic
Build an agent that produces a daily crypto market briefing using CoinMarketCap data through Jentic. The agent expresses an intent (give me a market briefing); Jentic resolves the right combination of listings, global metrics, and trending endpoints, then executes them with stored credentials. Cost-aware for assistants needing authoritative pricing without managing the X-CMC_PRO_API_KEY secret in agent context.
Through Jentic, fetch global metrics, top 10 listings, and top 5 gainers in 24h, then return a brief market summary
Key Endpoints
23 endpoints — jentic publishes the only available openapi specification for coinmarketcap api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/v1/cryptocurrency/listings/latest
List ranked coins by market cap
GET
/v2/cryptocurrency/quotes/latest
Get latest price quotes for one or many coins
GET
/v2/cryptocurrency/ohlcv/historical
Retrieve historical OHLCV candles
GET
/v1/cryptocurrency/market-pairs/latest
List market pairs for a coin
GET
/v1/global-metrics/quotes/latest
Get global crypto market metrics
GET
/v1/cryptocurrency/trending/gainers-losers
Get top gainers and losers
GET
/v1/tools/price-conversion
Convert an amount between two currencies
GET
/v1/cryptocurrency/listings/latest
List ranked coins by market cap
GET
/v2/cryptocurrency/quotes/latest
Get latest price quotes for one or many coins
GET
/v2/cryptocurrency/ohlcv/historical
Retrieve historical OHLCV candles
GET
/v1/cryptocurrency/market-pairs/latest
List market pairs for a coin
GET
/v1/global-metrics/quotes/latest
Get global crypto market metrics
GET
/v1/cryptocurrency/trending/gainers-losers
Get top gainers and losers
GET
/v1/tools/price-conversion
Convert an amount between two currencies
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
CoinMarketCap Pro API keys are stored encrypted in the Jentic vault. Agents receive scoped execution tokens — the X-CMC_PRO_API_KEY header is set server-side at execution and never enters the agent's prompt or logs.
Intent-based discovery
Agents search Jentic by intent (e.g. get top crypto by market cap) and Jentic returns the matching CoinMarketCap operation with its parameter schema, so the agent calls the correct endpoint without browsing docs.
Time to first call
Direct integration: 1-2 days for auth, credit-aware backoff, and pagination across paid endpoints. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using CoinMarketCap API through Jentic.
Why is there no official OpenAPI spec for CoinMarketCap API?
CoinMarketCap publishes interactive Pro API documentation but does not distribute a machine-readable 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 at https://app.jentic.com/sign-up.
What authentication does the CoinMarketCap API use?
The Pro API requires an API key sent in the X-CMC_PRO_API_KEY header. Through Jentic, the key is stored in the encrypted vault and the agent receives a scoped execution token rather than the raw key string.
Can I retrieve historical OHLCV candles with the CoinMarketCap API?
Yes. GET /v2/cryptocurrency/ohlcv/historical accepts an id or symbol along with time_start, time_end, and interval (e.g. daily, weekly), returning OHLCV records suitable for charting and backtesting.
What are the rate limits for the CoinMarketCap API?
CoinMarketCap charges in monthly call credits and per-minute throughput that depend on the plan tier (Basic, Hobbyist, Startup, Standard, Professional, Enterprise). The OpenAPI spec does not declare exact thresholds; check your plan and call /v1/key/info to see the current usage.
How do I convert an amount between two currencies through Jentic?
Install the SDK with pip install jentic, search Jentic for convert cryptocurrency amount, load the schema for GET /v1/tools/price-conversion, and execute with amount, symbol, and convert parameters.
Does the API expose CoinMarketCap categories and tags?
Yes. GET /v1/cryptocurrency/categories returns all category groupings, and GET /v1/cryptocurrency/category returns the coins inside a specific category — useful for thematic dashboards (DeFi, gaming, layer-1 etc.).
GET STARTED