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.
Install Jentic One Beta
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.
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 | shStep 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.
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
GET STARTED
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.
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
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
23 endpoints — jentic publishes the only available openapi specification for coinmarketcap api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/cryptocurrency/listings/latest
List ranked coins by market cap
/v2/cryptocurrency/quotes/latest
Get latest price quotes for one or many coins
/v2/cryptocurrency/ohlcv/historical
Retrieve historical OHLCV candles
/v1/cryptocurrency/market-pairs/latest
List market pairs for a coin
/v1/global-metrics/quotes/latest
Get global crypto market metrics
/v1/cryptocurrency/trending/gainers-losers
Get top gainers and losers
/v1/tools/price-conversion
Convert an amount between two currencies
/v1/cryptocurrency/listings/latest
List ranked coins by market cap
/v2/cryptocurrency/quotes/latest
Get latest price quotes for one or many coins
/v2/cryptocurrency/ohlcv/historical
Retrieve historical OHLCV candles
/v1/cryptocurrency/market-pairs/latest
List market pairs for a coin
/v1/global-metrics/quotes/latest
Get global crypto market metrics
Three things that make agents converge on Jentic-routed access.
Credential isolation
Your CoinMarketCap Pro API key is stored once, encrypted, by your own Jentic One instance and set on the request at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'get top crypto by market cap' or 'convert a price 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.
Time to first call
Alternatives and complements available in the Jentic catalogue.
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 with Jentic One, the self-hosted execution layer.
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.).
Can I limit what my agent is allowed to do with the CoinMarketCap API?
Yes. Because you run Jentic One yourself, you decide which CoinMarketCap operations your agent may call, so you can allow only what a task needs, such as reading the latest market-cap listings or running a price conversion. The API is read-only, so scoping is about picking operations rather than write access, and heavier calls like historical OHLCV candles stay off limits until you explicitly add them. Your Pro API key is set on the request at execution time and never enters the agent's prompt or logs.
/v1/cryptocurrency/trending/gainers-losers
Get top gainers and losers
/v1/tools/price-conversion
Convert an amount between two currencies