For Agents
Query 34 endpoints for live and historical crypto coin prices, OHLCV candles, exchange and DEX listings, and global market statistics including BTC dominance.
Get started with Coinranking API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"get crypto coin price and market cap"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Coinranking API API.
List ranked coins and their live prices, market caps, and 24h changes via GET /coins
Pull price history at multiple timeframes via GET /coin/{uuid}/price-history
Retrieve OHLCV candles for technical analysis via GET /coin/{uuid}/ohlcv
Resolve a token by blockchain contract address via GET /blockchain/{uuid}/contract-address/{contractAddress}
GET STARTED
Use for: Get the current price and market cap of Bitcoin, Retrieve 30 days of price history for Ethereum, Find which exchanges list a specific coin, Look up a token by its contract address on Polygon
Not supported: Does not handle order execution, wallet balances, or on-chain transactions — use for read-only crypto market data only.
Jentic publishes the only available OpenAPI document for Coinranking API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Coinranking API, keeping it validated and agent-ready. Coinranking provides real-time and historical cryptocurrency market data covering coins, exchanges, decentralised exchanges, markets, blockchains, and global statistics. The API exposes 34 read-only endpoints including coin price history, OHLCV candles, market-cap and volume history, BTC dominance, exchange and DEX details, and contract-address lookups across blockchains. Authentication is via the x-access-token header against api.coinranking.com/v2.
Track BTC dominance and global market cap history via GET /stats/btc-dominance-history and /stats/market-cap-history
Compare centralised exchanges and DEXs through /exchanges, /dexs, and their per-venue coin and market listings
Surface trending coins via GET /coins/trending
Patterns agents use Coinranking API API for, with concrete tasks.
★ Live Crypto Market Dashboard
Power a market dashboard with ranked coin lists, live prices, and 24h change pulled from /coins along with global stats from /stats. Coinranking returns market cap, volume, change, and rank in a single paginated response so a dashboard can render the top 100 coins without coordinating multiple endpoints. Reference currency is configurable via referenceCurrencyUuid for fiat or stablecoin denomination.
Call GET /coins?limit=100&orderBy=marketCap and GET /stats together, then return a JSON object with top coins and total market cap
Price History Charts
Render price charts for any listed coin by fetching /coin/{uuid}/price-history at the desired timeframe (24h, 7d, 30d, 1y, 5y). Coinranking returns timestamped price points ready for charting libraries with no further transformation. Pair with /coin/{uuid}/ohlcv when candlestick rendering is required.
Fetch GET /coin/Qwsogvtv82FCd/price-history?timePeriod=30d for Bitcoin and return the price array for charting
DEX and Token Discovery
Investigate decentralised-exchange activity by listing DEXs via /dexs and their markets via /dex/{uuid}/markets. Combine with /blockchain/{uuid}/contract-address/{contractAddress} to identify unknown tokens encountered on-chain. This supports research workflows that need to attribute on-chain activity back to named coins and venues.
Call GET /blockchain/ethereum/contract-address/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 to identify the token, then GET /coin/{uuid}/exchanges to list where it trades
Macro Crypto Research
Track macro indicators such as BTC dominance and global market cap over time via /stats/btc-dominance-history and /stats/market-cap-history. Researchers and reporting tools can pull multi-year series in a single call to power newsletters, models, or quarterly reports without scraping public chart sites.
Call GET /stats/btc-dominance-history?timePeriod=1y and return the dominance percentage series
AI Agent Crypto Lookup via Jentic
Give an AI agent live crypto context through Jentic by searching for the operation it needs (price lookup, OHLCV, DEX listings) and executing it with the returned schema. The x-access-token credential is held in the Jentic vault so it is never exposed in agent prompts or logs. Agents can access market data without parsing Coinranking's raw documentation.
Use Jentic to search 'get crypto price history', load the GET /coin/{uuid}/price-history schema, and execute it for uuid=Qwsogvtv82FCd with timePeriod=7d
34 endpoints — jentic publishes the only available openapi specification for coinranking api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/coins
List ranked coins with live prices
/coin/{uuid}/price-history
Get historical price series for a coin
/coin/{uuid}/ohlcv
Get OHLCV candles for a coin
/blockchain/{uuid}/contract-address/{contractAddress}
Resolve token by contract address
/stats/btc-dominance-history
Historical BTC dominance percentage
/exchanges
List centralised exchanges
/coins/trending
List trending coins
/coins
List ranked coins with live prices
/coin/{uuid}/price-history
Get historical price series for a coin
/coin/{uuid}/ohlcv
Get OHLCV candles for a coin
/blockchain/{uuid}/contract-address/{contractAddress}
Resolve token by contract address
/stats/btc-dominance-history
Historical BTC dominance percentage
Three things that make agents converge on Jentic-routed access.
Credential isolation
Coinranking x-access-token keys are stored encrypted in the Jentic vault and injected into the request header at execution. Raw keys never enter the agent context.
Intent-based discovery
Agents search by intent (e.g., 'get crypto price history') and Jentic returns the matching Coinranking operation with its parameter schema so the agent can call the right endpoint without browsing docs.
Time to first call
Direct integration: 1-2 days for auth, pagination, and timeseries shaping. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
CoinGecko API
Generous free tier with social and developer signal alongside prices
Choose CoinGecko when community/developer scores or trending lists matter more than DEX-by-blockchain breakdown
Coinpaprika API
Free crypto market data with monthly call quotas across plans
Choose Coinpaprika when you need person/event data and a free tier without contract-by-blockchain lookups
CoinMarketCap API
Long-established crypto data with stricter free-tier limits
Choose CoinMarketCap when downstream consumers expect the canonical CMC ranking
Binance API
Live order books and trading execution to act on Coinranking signals
Pair with Coinranking when an agent needs both market analytics and the ability to place spot trades
Specific to using Coinranking API API through Jentic.
Why is there no official OpenAPI spec for Coinranking API?
Coinranking does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Coinranking 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 Coinranking API use?
Coinranking expects an API key in the x-access-token header on every request to api.coinranking.com/v2. Through Jentic the key is stored encrypted in the vault and injected at execution so it never appears in agent prompts or logs.
Can I get OHLCV candle data with the Coinranking API?
Yes. GET /coin/{uuid}/ohlcv returns open-high-low-close-volume candles for any listed coin. Combine with /coin/{uuid}/price-history when you only need closing-price series for charting.
What are the rate limits for the Coinranking API?
Rate limits are tier-based and enforced by the x-access-token. The OpenAPI spec does not enumerate exact quotas; consult your Coinranking developer dashboard for your current tier limits. HTTP 429 indicates you have exceeded them.
How do I look up a token by contract address with the Coinranking API through Jentic?
Search Jentic for 'lookup token by contract address', load the GET /blockchain/{uuid}/contract-address/{contractAddress} schema, and execute it with the blockchain uuid (e.g. ethereum) and the token's contract address. Jentic returns the matching coin record without manual auth setup.
Does Coinranking cover decentralised exchanges?
Yes. GET /dexs lists DEXs and GET /dex/{uuid}/markets returns the trading pairs on each. This makes Coinranking suitable for research that needs both centralised exchange and DEX coverage in one feed.
/exchanges
List centralised exchanges
/coins/trending
List trending coins