Skip to main content

​
Commands Overview

Ticker commands provide real-time and historical price data:
  • tickers - List tickers for all coins
  • ticker - Get ticker for a specific coin
  • ticker-history - Historical ticker data (paid feature)

​
List Tickers

coinpaprika-cli tickers [OPTIONS]
Get real-time price data for multiple coins.

​
Options

  • --limit <NUMBER> - Maximum number of results (default: 50)
  • --quotes <CURRENCIES> - Currency quotes, comma-separated (default: USD)

​
Examples

coinpaprika-cli tickers --limit 20

​
Get Ticker

coinpaprika-cli ticker <COIN_ID> [OPTIONS]
Get comprehensive real-time price data for a specific coin.

​
Arguments

  • <COIN_ID> - Coin identifier (e.g., btc-bitcoin, eth-ethereum)

​
Options

  • --quotes <CURRENCIES> - Currency quotes, comma-separated (default: USD)

​
Examples

coinpaprika-cli ticker btc-bitcoin

​
Response Fields

Basic information:
  • id, name, symbol, rank
  • circulating_supply - Circulating supply
  • total_supply - Total supply
  • max_supply - Maximum supply
  • beta_value - Beta coefficient
  • first_data_at - First data availability
  • last_updated - Last update timestamp
Quote data (per currency):
  • price - Current price
  • volume_24h - 24-hour trading volume
  • volume_24h_change_24h - Volume change percentage
  • market_cap - Market capitalization
  • market_cap_change_24h - Market cap change percentage
Price changes:
  • percent_change_15m - 15-minute change
  • percent_change_30m - 30-minute change
  • percent_change_1h - 1-hour change
  • percent_change_6h - 6-hour change
  • percent_change_12h - 12-hour change
  • percent_change_24h - 24-hour change
  • percent_change_7d - 7-day change
  • percent_change_30d - 30-day change
  • percent_change_1y - 1-year change
All-time high:
  • ath_price - All-time high price
  • ath_date - ATH date
  • percent_from_price_ath - Distance from ATH

​
Historical Ticker Data

PAID FEATURE: Requires Starter plan or higher. See pricing plans.
coinpaprika-cli ticker-history <COIN_ID> --start <DATE> [OPTIONS]
Get historical ticker data with various time intervals.

​
Arguments

  • <COIN_ID> - Coin identifier

​
Options

  • --start <DATE> - Start date in ISO format (e.g., 2024-01-01) [Required]
  • --end <DATE> - End date in ISO format (optional)
  • --interval <INTERVAL> - Time interval (default: 24h)
  • --limit <NUMBER> - Maximum number of results (default: 50)
  • --quote <CURRENCY> - Quote currency (default: usd)

​
Available Intervals

  • 5m - 5 minutes (paid plans only)
  • 1h - 1 hour
  • 24h - 24 hours (1 day)
  • 7d - 7 days
  • 30d - 30 days

​
Examples

coinpaprika-cli ticker-history btc-bitcoin \
  --start 2024-01-01 \
  --interval 24h \
  --limit 30

​
Response Fields

  • timestamp - Data point timestamp
  • price - Price at timestamp
  • volume_24h - 24-hour volume
  • market_cap - Market cap at timestamp

​
Practical Examples

​
Price Monitoring

#!/bin/bash
# Monitor Bitcoin price every minute
while true; do
  price=$(coinpaprika-cli ticker btc-bitcoin --output json --raw | jq -r '.quotes.USD.price')
  change_24h=$(coinpaprika-cli ticker btc-bitcoin --output json --raw | jq -r '.quotes.USD.percent_change_24h')
  echo "$(date): BTC = \$${price} (${change_24h}% 24h)"
  sleep 60
done

​
Price Comparison

# Compare top 5 coins
coinpaprika-cli tickers --limit 5 --output json --raw | \
  jq '.[] | {name, price: .quotes.USD.price, change_24h: .quotes.USD.percent_change_24h}'

​
Historical Analysis

# Get last month of daily data
coinpaprika-cli ticker-history btc-bitcoin \
  --start $(date -d '30 days ago' +%Y-%m-%d) \
  --interval 24h \
  --limit 30 \
  --output json --raw > btc-history.json

​
Alert on Price Change

#!/bin/bash
# Alert if Bitcoin drops more than 5%
change=$(coinpaprika-cli ticker btc-bitcoin --output json --raw | jq -r '.quotes.USD.percent_change_24h')
if (( $(echo "$change < -5" | bc -l) )); then
  echo "ALERT: Bitcoin down ${change}% in 24h"
fi

​
Supported Quote Currencies

Common quote currencies:
  • USD - US Dollar
  • BTC - Bitcoin
  • ETH - Ethereum
You can specify multiple quotes: 
coinpaprika-cli ticker btc-bitcoin --quotes USD,EUR,BTC,ETH

​
Rate Limits

Free tier:
  • 20,000 calls/month total
  • Updates every ~10 minutes
Paid plans:
  • Higher rate limits
  • Faster updates (5-minute intervals)
  • Historical data access
See plans command for details.

​
API Details

  • List Tickers: /tickers
  • Get Ticker: /tickers/{coin_id}
  • Ticker History: /tickers/{coin_id}/historical (paid)
  • Method: GET
  • Update Frequency: ~10 minutes (free), ~5 minutes (paid)
  • ohlcv - OHLCV candlestick data
  • coins - Coin information
  • global - Market overview

Build docs developers (and LLMs) love

Get started for freeTalk to us