name	coinpaprika-api
description	Access the CoinPaprika API to query cryptocurrency market data including coin prices, tickers, exchanges, historical OHLCV data, and global market statistics. Use this skill when making HTTP requests to api-pro.coinpaprika.com for crypto market information.

CoinPaprika API Skill

Access the CoinPaprika API to query comprehensive cryptocurrency market data across 50,000+ assets and 350+ exchanges.

Examples

"What is the current price of Bitcoin?"
"Show me OHLCV data for Ethereum over the last 30 days"
"List all exchanges trading Solana"
"Look up a token by its contract address on Ethereum"
"Search for a coin called pepe"
"Get global crypto market stats"
"Convert 1 BTC to USD"
"Get all stablecoin coin IDs"

Instructions

Base URL & Authentication

https://api-pro.coinpaprika.com/v1/

Include the API key in every request via the Authorization header:

curl -s -X GET "https://api-pro.coinpaprika.com/v1/{ENDPOINT}" \
  -H "Authorization: api_hogSLfWMtl-pO_7Nfn0o4SSiiVUrUIpVeM" | jq

Endpoints Reference

Key Info

GET /key/info — Returns API key plan name, start date, active status, portal link, monthly usage.

Global Market Data

GET /global — Global market cap, total 24h volume, number of active cryptocurrencies, ATH values.

Coins

Endpoint	Description
`GET /coins`	List all coins. Returns `id`, `name`, `symbol`, `rank`, `is_active`, `type` (coin/token), `is_new`
`GET /coins/{coin_id}`	Detailed coin info (no price data — use `/tickers` for prices)
`GET /coins/{coin_id}/markets`	All trading pairs for a coin
`GET /coins/{coin_id}/exchanges`	Exchanges listing the coin
`GET /coins/{coin_id}/events`	Coin events (updated every 5 min)

Tickers (Price Data)

Endpoint	Description
`GET /tickers`	All active coin tickers (Free plan: max 2000 assets)
`GET /tickers/{coin_id}`	Single coin ticker
`GET /tickers/{coin_id}?quotes=USD,BTC`	With specific quote currencies
`GET /tickers/{coin_id}/historical?start={date}&interval={interval}`	Historical price, volume, market cap

Ticker response fields: id, name, symbol, rank, circulating_supply, total_supply, max_supply, beta_value, first_data_at, last_updated, quotes.{QUOTE}.price, quotes.{QUOTE}.volume_24h, quotes.{QUOTE}.market_cap, quotes.{QUOTE}.percent_change_1h/24h/7d/30d, quotes.{QUOTE}.ath_price, quotes.{QUOTE}.ath_date.

Note: Free plan does not include circulating_supply.

Historical tickers — available intervals by plan:

Interval	Param values	Free	Starter	Pro	Business	Enterprise
Daily	`24h`,`1d`,`7d`,`14d`,`30d`,`90d`,`365d`	1 year	5 years	unlimited	unlimited	unlimited
Hourly	`1h`,`2h`,`3h`,`6h`,`12h`	1 day	30 days	90 days	365 days	unlimited
5-minute	`5m`,`10m`,`15m`,`30m`,`45m`	none	7 days	30 days	365 days	unlimited

OHLCV (Candlestick Data)

Endpoint	Description
`GET /coins/{coin_id}/ohlcv/historical?start={date}&end={date}`	Historical OHLCV
`GET /coins/{coin_id}/ohlcv/latest`	Last full day
`GET /coins/{coin_id}/ohlcv/today`	Current day (partial, changes each request)

OHLCV response fields: time_open, time_close, open, high, low, close, volume, market_cap.

OHLCV time range limits by plan:

Plan	Range	Interval param
Free	24 hours	`24h`
Starter	30 days	`24h`
Pro	90 days	`24h`
Business	365 days	`1h`,`6h`,`12h`,`24h`
Enterprise	Unlimited	`5m`,`15m`,`30m`,`1h`,`6h`,`12h`,`24h`

Exchanges

Endpoint	Description
`GET /exchanges`	List all exchanges (id, name, ranking, activity, volumes)
`GET /exchanges/{exchange_id}`	Exchange details
`GET /exchanges/{exchange_id}/markets`	Exchange markets (base/quote, price, volume, type)

Contracts (Token Lookup)

Endpoint	Description
`GET /contracts`	List all available contract platforms
`GET /contracts/{platform_id}`	All tokens on a platform
`GET /contracts/{platform_id}/{contract_address}`	Ticker data for token by contract
`GET /contracts/{platform_id}/{contract_address}/historical`	Historical ticks by contract

Endpoint	Description
`GET /tags`	List all tags (name, description, type, coin/ico counts)
`GET /tags/{tag_id}`	Tag details
`GET /tags/{tag_id}?additional_fields=coins`	Tag with list of coin IDs
`GET /tags/{tag_id}?additional_fields=coins,icos`	Tag with coins and ICOs

People

GET /people/{person_id} — Person description, social links, team memberships (updated hourly).

Search

GET /search?q={query}&c=currencies,exchanges&limit=10 — Search currencies, exchanges, icos, people, tags.

Price Converter

GET /price-converter?base_currency_id={from}&quote_currency_id={to}&amount={amount}

ID Mappings (Business+ plans)

GET /coins/mappings?coinpaprika={id} — Map IDs between CoinPaprika, CoinMarketCap, CoinGecko, CryptoCompare, ISIN, DTI.

ID Changelog (Starter+ plans)

GET /changelog/ids — Returns coin ID changes (currency_id, old_id, new_id, changed_at).

Common Parameters

Parameter	Description	Example
`quotes`	Quote currencies (comma-separated)	`USD,BTC,ETH`
`start`	Start date (RFC3339 or Unix)	`2024-01-01`
`end`	End date	`2024-12-31`
`interval`	Data interval	`5m`,`1h`,`1d`,`7d`,`30d`
`limit`	Results limit	`100`

Common IDs

Coin IDs: btc-bitcoin, eth-ethereum, usdt-tether, usdc-usd-coin, bnb-binance-coin, sol-solana, xrp-xrp, ada-cardano

Platform IDs (for contracts): eth-ethereum, bnb-binance-coin, matic-polygon, arb-arbitrum, sol-solana, avax-avalanche, op-optimism, base-base

Streaming API (WebSocket)

Endpoint: wss://streaming.coinpaprika.com/ticks (Enterprise plan)

Subscribe:

{"event": "subscribe", "ids": ["btc-bitcoin", "eth-ethereum"], "quotes": ["USD"]}

Message format:

{"id": "btc-bitcoin", "sym": "BTC", "ts": 1676916987, "quotes": {"USD": {"m": 608286188, "p": 50000.123, "v24h": 801851299.55}}}

Fields: p = price, v24h = 24h volume, m = market cap, ts = Unix timestamp.

Supported quotes: USD, BTC, ETH, BNB, MATIC, SOL. Max 5 per subscription. Server pings every 120s.

Deprecated Endpoints (do not use)

GET /ticker → use GET /tickers
GET /ticker/{coin_id} → use GET /tickers/{coin_id}
GET /coins/{coin_id}/twitter → removed

Output Format

Return data in a readable format using tables or bullet points
For price data, always include the quote currency (e.g., "$42,000 USD")
For historical data, summarize trends unless raw output is requested

Rules

All timestamps are UTC; use RFC3339 format: 2024-01-01T00:00:00Z or 2024-01-01
Coin IDs follow pattern: {symbol}-{name} (lowercase, hyphens for spaces)
The /tickers endpoint does NOT include tags — use /tags/{id}?additional_fields=coins for coin IDs by tag
Rate limit: 10 requests/second per IP globally
Enterprise plan: unlimited monthly requests; other plans have monthly caps

r--w/SKILL.md

Select an option

No results found