Skip to main content

Overview

Returns detailed market/trading pair information for a specific cryptocurrency across multiple exchanges, including price, volume, and market metadata.

Usage

coinpaprika-cli coin-markets <COIN_ID> [OPTIONS]

Parameters

coin_id
string
required
Coin ID in format symbol-name (e.g., btc-bitcoin)
--quotes
string
default:"USD"
Currency quotes, comma-separated (e.g., USD, BTC, USD,BTC)
--limit
number
default:"50"
Maximum number of markets to return
--output
string
default:"table"
Output format: table or json
--raw
boolean
default:"false"
Show raw JSON response without wrapper metadata

Examples

Get Bitcoin markets with USD quotes

coinpaprika-cli coin-markets btc-bitcoin

Get Ethereum markets with multiple quote currencies

coinpaprika-cli coin-markets eth-ethereum --quotes USD,BTC

Get top 20 markets for Solana

coinpaprika-cli coin-markets sol-solana --limit 20

Get markets in JSON format

coinpaprika-cli coin-markets btc-bitcoin --output json

Example Output

Table Format

┌──────────────┬───────────────────┬────────────┬─────────────┬─────────────┬──────────────┐
│ Exchange     │ Pair              │ Price (USD)│ Volume (24h)│ Trust Score │ Category     │
├──────────────┼───────────────────┼────────────┼─────────────┼─────────────┼──────────────┤
│ Binance      │ BTC/USDT          │ $52,345.67 │ $2.3B       │ High        │ Spot         │
│ Coinbase     │ BTC/USD           │ $52,340.12 │ $1.8B       │ High        │ Spot         │
│ Kraken       │ BTC/EUR           │ €48,234.56 │ $876M       │ High        │ Spot         │
│ OKX          │ BTC/USDT          │ $52,342.89 │ $1.2B       │ High        │ Spot         │
└──────────────┴───────────────────┴────────────┴─────────────┴─────────────┴──────────────┘

JSON Format

[
  {
    "exchange_id": "binance",
    "exchange_name": "Binance",
    "pair": "BTC/USDT",
    "base_currency_id": "btc-bitcoin",
    "base_currency_name": "Bitcoin",
    "quote_currency_id": "usdt-tether",
    "quote_currency_name": "Tether",
    "market_url": "https://www.binance.com/en/trade/BTC_USDT",
    "category": "Spot",
    "fee_type": "Percentage",
    "outlier": false,
    "adjusted_volume_24h_share": 15.23,
    "quotes": {
      "USD": {
        "price": 52345.67,
        "volume_24h": 2300000000.00
      }
    },
    "trust_score": "high",
    "last_updated": "2024-03-03T12:00:00Z"
  },
  {
    "exchange_id": "coinbase-exchange",
    "exchange_name": "Coinbase Exchange",
    "pair": "BTC/USD",
    "base_currency_id": "btc-bitcoin",
    "base_currency_name": "Bitcoin",
    "quote_currency_id": "usd-us-dollars",
    "quote_currency_name": "US Dollars",
    "market_url": "https://pro.coinbase.com/trade/BTC-USD",
    "category": "Spot",
    "fee_type": "Percentage",
    "outlier": false,
    "adjusted_volume_24h_share": 12.45,
    "quotes": {
      "USD": {
        "price": 52340.12,
        "volume_24h": 1800000000.00
      }
    },
    "trust_score": "high",
    "last_updated": "2024-03-03T12:00:00Z"
  }
]

Response Fields

FieldTypeDescription
exchange_idstringUnique exchange identifier
exchange_namestringExchange name
pairstringTrading pair (e.g., BTC/USDT)
base_currency_idstringBase currency coin ID
base_currency_namestringBase currency name
quote_currency_idstringQuote currency coin ID
quote_currency_namestringQuote currency name
market_urlstringDirect URL to market on exchange
categorystringMarket category (Spot, Perpetual, etc.)
fee_typestringFee structure type
outlierbooleanWhether price is an outlier
adjusted_volume_24h_sharenumberMarket’s share of total volume
quotesobjectPrice and volume data per quote currency
trust_scorestringMarket trust score
last_updatedstringLast update timestamp

API Endpoint

GET https://api.coinpaprika.com/v1/coins/{coin_id}/markets?quotes={quotes}

Build docs developers (and LLMs) love