Skip to main content

​
What is the CoinPaprika CLI?

A command-line tool for querying cryptocurrency market data. Covers the entire CoinPaprika API — tickers, coins, exchanges, OHLCV, search, contracts, tags, and currency conversion. Free tier included, no API key needed to start. Source: github.com/coinpaprika/coinpaprika-cli

​
Install

​
One-line install (macOS, Linux)

curl -sSL https://raw.githubusercontent.com/coinpaprika/coinpaprika-cli/main/install.sh | sh
Terminal output showing coinpaprika-cli install script completing successfully

​
Verify installation

coinpaprika-cli status
You should see a health check response confirming the API is reachable.

​
Quick start wizard

coinpaprika-cli onboard
Walks you through first commands, API key setup (optional), and configuration.

​
Commands

Every CoinPaprika REST API endpoint has a matching CLI command:
CommandWhat it doesExample
globalMarket overview (cap, volume, BTC dominance)coinpaprika-cli global
coinsList all coinscoinpaprika-cli coins --limit 10
coinCoin detailscoinpaprika-cli coin btc-bitcoin
coin-eventsCoin eventscoinpaprika-cli coin-events btc-bitcoin
coin-exchangesExchanges listing a coincoinpaprika-cli coin-exchanges btc-bitcoin
coin-marketsTrading pairs for a coincoinpaprika-cli coin-markets btc-bitcoin
tickersAll tickers (real-time prices)coinpaprika-cli tickers --limit 20
tickerSingle coin tickercoinpaprika-cli ticker btc-bitcoin
ticker-historyHistorical tickers [Starter+]coinpaprika-cli ticker-history btc-bitcoin --start 2024-01-01
ohlcvHistorical OHLCV [Starter+]coinpaprika-cli ohlcv btc-bitcoin --start 2024-01-01
ohlcv-latestLast full day OHLCVcoinpaprika-cli ohlcv-latest btc-bitcoin
ohlcv-todayToday’s OHLCV (partial)coinpaprika-cli ohlcv-today btc-bitcoin
exchangesList exchangescoinpaprika-cli exchanges --limit 10
exchangeExchange detailscoinpaprika-cli exchange binance
exchange-marketsMarkets on an exchangecoinpaprika-cli exchange-markets binance
tagsList tags/categoriescoinpaprika-cli tags
tagTag detailscoinpaprika-cli tag defi
personPerson detailscoinpaprika-cli person vitalik-buterin
searchSearch coins, exchanges, people, tagscoinpaprika-cli search bitcoin
convertCurrency conversioncoinpaprika-cli convert btc-bitcoin usd-us-dollars
platformsList contract platformscoinpaprika-cli platforms
contractsContracts on a platformcoinpaprika-cli contracts eth-ethereum
contract-tickerTicker by contract addresscoinpaprika-cli contract-ticker eth-ethereum 0xdac...
contract-historyContract history [Starter+]coinpaprika-cli contract-history eth-ethereum 0xdac... --start 2024-01-01
key-infoAPI key info [Paid]coinpaprika-cli key-info
mappingsID mappings [Business+]coinpaprika-cli mappings
changelogCoin ID changelog [Starter+]coinpaprika-cli changelog
config showShow configcoinpaprika-cli config show
config set-keySet API keycoinpaprika-cli config set-key <KEY>
config resetDelete configcoinpaprika-cli config reset
shellInteractive REPLcoinpaprika-cli shell
onboardSetup wizardcoinpaprika-cli onboard
statusAPI health checkcoinpaprika-cli status
plansFree tier details and paid overviewcoinpaprika-cli plans
attributionAttribution snippetscoinpaprika-cli attribution

​
Output formats

The CLI outputs tables by default. Switch to JSON for scripting and piping: 
# Table output (default, human-readable)
coinpaprika-cli ticker btc-bitcoin

# JSON with metadata wrapper
coinpaprika-cli --output json ticker btc-bitcoin

# Raw JSON (no _meta wrapper, for piping to jq)
coinpaprika-cli --output json --raw ticker btc-bitcoin
Pipe raw JSON into jq for filtering: 
coinpaprika-cli --output json --raw ticker btc-bitcoin | jq '.quotes.USD.price'

​
Examples

​
Get the Bitcoin price

coinpaprika-cli ticker btc-bitcoin

​
Top 10 coins by market cap

coinpaprika-cli tickers --limit 10

​
Search for a coin

coinpaprika-cli search solana

​
Global market overview

coinpaprika-cli global

​
Historical OHLCV (requires Starter plan or above)

coinpaprika-cli ohlcv btc-bitcoin --start 2025-01-01

​
Convert between currencies

coinpaprika-cli convert btc-bitcoin usd-us-dollars

​
Look up a token by contract address

coinpaprika-cli contract-ticker eth-ethereum 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

​
Interactive REPL

coinpaprika-cli shell
Opens an interactive session where you can run commands without typing coinpaprika-cli each time.

​
API key setup

The free tier works without a key (20,000 calls/month, 2,000 assets). For paid tiers: 
# Interactive setup (recommended)
coinpaprika-cli onboard

# Or set directly
coinpaprika-cli config set-key YOUR_API_KEY

# Or use an environment variable
export COINPAPRIKA_API_KEY=your-key

# Or pass per-command
coinpaprika-cli --api-key your-key ticker btc-bitcoin
Priority: CLI flag > environment variable > config file. Check your key and usage: 
coinpaprika-cli key-info

​
Coin ID format

CoinPaprika coin IDs follow the pattern {symbol}-{name} (lowercase, hyphens for spaces): btc-bitcoin, eth-ethereum, usdt-tether, sol-solana, ada-cardano, doge-dogecoin, avax-avalanche, matic-polygon Use coinpaprika-cli search {query} to find the correct ID for any coin.

​
Use with AI agents

AI agents running in terminals (Claude Code, Aider, etc.) can install and use the CLI as a tool. The one-liner install works in any shell: 
curl -sSL https://raw.githubusercontent.com/coinpaprika/coinpaprika-cli/main/install.sh | sh
Once installed, agents can call coinpaprika-cli directly with --output json --raw for machine-readable output. This is useful when:
  • The agent doesn’t have MCP support
  • You want the agent to script data pipelines
  • You need to pipe output into other tools (jq, scripts)
  • You’re running headless or in CI/CD

​
Troubleshooting

The installer puts the binary in ~/.local/bin. If that’s not in your PATH, add it:
export PATH="$HOME/.local/bin:$PATH"
Add that line to your ~/.bashrc, ~/.zshrc, or ~/.profile to make it permanent.
The installer tries ~/.local/bin first (no sudo needed). You can also set a custom directory:
COINPAPRIKA_INSTALL_DIR=~/bin curl -sSL https://raw.githubusercontent.com/coinpaprika/coinpaprika-cli/main/install.sh | sh
Check the coin ID format. Use coinpaprika-cli search <name> to find the correct ID. Coin IDs are lowercase: btc-bitcoin, not Bitcoin or BTC.
Historical endpoints (OHLCV, ticker history, contract history) require a Starter plan ($99/mo) or above. Run coinpaprika-cli plans to see what’s available on the free tier.

​
What’s next?

REST API Reference

Complete endpoint documentation with interactive playground

MCP Server

Connect Claude Desktop or Cursor to CoinPaprika data

Agent Skills

Install CoinPaprika skills for any AI agent

Python SDK

Official Python client for the CoinPaprika API

​
Need help?

Join Our Discord

Connect with our community for real-time support and discussions

Direct Support

Contact our team for technical assistance and custom integrations

​
FAQs

Not for the free tier. 20,000 calls/month, 2,000 assets, no key required. Paid plans (Starter $99/mo and up) unlock all assets and historical endpoints.
10 requests per second per IP, across all plans. Each CLI command makes one API call.
Yes. AI agents can install it with one command and use --output json --raw for machine-readable output. The CLI covers every REST API endpoint.
Pre-built binaries are available on the GitHub releases page. The install script works on macOS and Linux only.