canonical: https://jentic.com/apis/coinpaprika.com/coinpaprika

# Coinpaprika API

Jentic publishes the only available OpenAPI specification for Coinpaprika API, keeping it validated and agent-ready. Coinpaprika delivers cryptocurrency market data covering coin prices, volumes, market caps, all-time highs, supply figures, and historical OHLCV across thousands of digital assets, exchanges, and contract platforms. The API exposes 30 endpoints spanning tickers, coin detail records, exchange listings, smart-contract address lookups, tag taxonomies, person profiles, and a price converter. Free-tier access requires no credentials while paid plans authenticate via the Authorization header against api-pro.coinpaprika.com.

## For AI agents

Look up live and historical cryptocurrency prices, market capitalisations, exchange listings, and OHLCV candles for thousands of coins via 30 read-only endpoints.

## Scope

Does not handle order execution, wallet management, or on-chain transactions - use for read-only crypto market data lookups only.

## Capabilities

- Retrieve live ticker prices, 24h volume, and market cap for any listed coin via `/tickers/{coin_id}`
- Pull historical OHLCV candles at intervals from 5 minutes to daily via `/coins/{coin_id}/ohlcv/historical`
- Look up token metadata by smart-contract address using `/contracts/{platform_id}/{contract_address}`
- Convert prices between any two coins or fiat currencies through /price-converter
- Fetch exchange profiles, supported markets, and trading pairs via `/exchanges/{exchange_id}/markets`
- Search coins, exchanges, tags, and people by free-text query through /search
- Track upcoming and historical coin events such as forks, airdrops, and conferences via `/coins/{coin_id}/events`

## Use cases

### Crypto Portfolio Valuation

Value a portfolio of cryptocurrency holdings by pulling current prices and 24h changes from /tickers for every coin on the user's watchlist. Coinpaprika returns prices, market caps, and volumes for thousands of assets so a portfolio dashboard can refresh totals on demand without paying for an enterprise data feed. The free tier covers 20,000 calls per month, enough for hourly refreshes of a 25-coin portfolio.

Example prompt: Call GET /tickers with a list of coin IDs (btc-bitcoin, eth-ethereum, sol-solana) and sum the price * holdings for each to return total portfolio USD value

### Historical Backtesting Data

Backtest trading strategies against years of OHLCV history pulled from `/coins/{coin_id}/ohlcv/historical.` Coinpaprika supports intervals from 5 minutes to daily candles, enabling intraday and swing-trading research. A strategy researcher can pull a year of hourly Bitcoin candles in a single paginated request flow and feed them into pandas or a vectorised backtester.

Example prompt: Fetch GET `/coins/btc-bitcoin/ohlcv/historical` with start=2025-01-01 and interval=1h, then return the closing price series as a CSV

### Token Discovery by Contract Address

Resolve unknown tokens encountered on-chain by looking them up via `/contracts/{platform_id}/{contract_address}.` Coinpaprika maintains contract mappings across major chains so an agent investigating a wallet's holdings can convert raw addresses into named coins with prices and metadata. This bypasses the need to maintain a private contract-to-symbol registry.

Example prompt: Call GET `/contracts/eth-ethereum/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48` to identify the token at that address and return its symbol and current price

### Exchange Market Intelligence

Map where a specific coin trades and at what volume by pulling exchange profiles from /exchanges and per-coin exchange lists from `/coins/{coin_id}/exchanges.` A research agent can rank exchanges by liquidity for a target token before recommending where to route an order. Coinpaprika tracks hundreds of exchanges and their trading pairs.

Example prompt: Get all exchanges listing sol-solana via GET `/coins/sol-solana/exchanges` and return the top 5 ranked by reported 24h USD volume

### AI Agent Crypto Research

Embed live crypto market context into an AI agent via Jentic by issuing a single search query for the operation an agent needs (price lookup, OHLCV pull, contract resolution). Jentic returns the matching Coinpaprika operation with its parameter schema so the agent can call it directly without browsing docs. Credentials for paid tiers are isolated in your Jentic One instance and never enter the agent's prompt.

Example prompt: Use Jentic to search 'get current cryptocurrency price', load the matching Coinpaprika `/tickers/{coin_id}` schema, and execute it for coin_id=btc-bitcoin

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/tickers/{coin_id}` | Get live ticker for a specific coin |
| GET | `/coins/{coin_id}/ohlcv/historical` | Retrieve historical OHLCV candles |
| GET | `/contracts/{platform_id}/{contract_address}` | Resolve a token by contract address |
| GET | `/exchanges/{exchange_id}/markets` | List markets on a specific exchange |
| GET | `/price-converter` | Convert amounts between two coins or fiat |
| GET | `/search` | Search coins, exchanges, tags, and people |
| GET | `/global` | Get global crypto market overview |

## Key resources

- **Tickers** — Live and historical price, volume, and market cap data for all listed coins
- **Coins** — Coin metadata, supply, links, events, and exchange listings
- **OHLCV** — Open-high-low-close-volume candles at 5m, 15m, 30m, 1h, 6h, 12h, and daily intervals
- **Exchanges** — Exchange profiles and the markets each exchange operates
- **Contracts** — Smart-contract platforms and address-to-ticker mappings
- **Search** — Free-text search across coins, exchanges, tags, and people

## Why Jentic

- **Setup:** Wiring Coinpaprika by hand means handling its Authorization header for paid tiers against the api.coinpaprika.com host, distinguishing free-tier calls that need no key, and managing pagination across its ticker and OHLCV endpoints yourself. Through Jentic you install once, import Coinpaprika from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Coinpaprika serves read-only market data, so you scope by choosing the operations the agent may call: limit it to what it needs, such as reading a ticker or converting a price, and other calls like historical OHLCV pulls are not included unless you add them.
- **Credential handling:** Your Coinpaprika API key is stored once, encrypted, by your own Jentic One instance and injected into the Authorization header at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get the current cryptocurrency price' or 'convert between two coins', and Jentic returns the matching Coinpaprika operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **CoinGecko API** — Broader free crypto data feed with social and developer metrics in addition to prices
- **CoinMarketCap API** — Commercial crypto market data with stricter free-tier limits but deeper historical archives
- **Binance API** — Live order books and trade execution to pair with Coinpaprika's market context
- **CoinAPI** — Tick-level crypto market data across hundreds of exchanges

## FAQ

### Why is there no official OpenAPI spec for Coinpaprika API?

Coinpaprika does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Coinpaprika 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 Coinpaprika API use?

Coinpaprika uses an API key passed in the Authorization header. The free tier on api.coinpaprika.com accepts unauthenticated requests, while Starter, Pro, Business, and Enterprise tiers require a key sent against api-pro.coinpaprika.com. Through Jentic the key is stored in the encrypted vault and injected at execution time so it never appears in agent prompts.

### Can I get historical OHLCV data with the Coinpaprika API?

Yes. GET `/coins/{coin_id}/ohlcv/historical` returns historical candles at 5m, 15m, 30m, 1h, 6h, 12h, and daily intervals. The 5-minute interval was added in version 1.7.10. Pass start and end timestamps and the desired interval as query parameters.

### What are the rate limits for the Coinpaprika API?

Limits are enforced as monthly call quotas: 20,000 on Free, 200,000 on Starter, 500,000 on Pro, 3,000,000 on Business, and unlimited on Enterprise. HTTP 429 is returned when the quota is exhausted.

### How do I look up a token by contract address with the Coinpaprika API through Jentic?

Search Jentic for 'lookup token by contract address', load the schema for GET `/contracts/{platform_id}/{contract_address}`, and execute it with platform_id (e.g. eth-ethereum) and the address. Jentic returns the matching ticker payload without any manual auth setup.

### Is the Coinpaprika API free?

The Free plan covers 20,000 calls per month with access to most endpoints and requires no API key. Paid plans (Starter, Pro, Business, Enterprise) unlock higher quotas and the api-pro endpoint via the Authorization header.

### Can I limit what my agent is allowed to do with the Coinpaprika API?

Yes. Because you run Jentic One yourself, your own rules decide which Coinpaprika operations the agent may call, so you can allow only what a task needs, such as reading a ticker with GET `/tickers/{coin_id}` or converting a price with GET /price-converter. Operations you do not grant, like historical candle pulls through GET `/coins/{coin_id}/ohlcv/historical` or contract lookups via GET `/contracts/{platform_id}/{contract_address}`, stay unavailable to the agent until you add them. Since Coinpaprika serves read-only market data, this scoping controls exactly which reads the agent can perform.