Skip to main content

Overview

Search across all CoinPaprika data including cryptocurrencies, exchanges, ICOs, people, and tags. This is the quickest way to find specific entities when you don’t know their exact ID.

Usage

coinpaprika-cli search <query> [OPTIONS]

Arguments

query
string
required
Search term (e.g., coin name, symbol, exchange name, person name)

Options

categories
string
Comma-separated list of categories to search. Options:
  • currencies - Cryptocurrencies
  • exchanges - Exchange platforms
  • icos - Initial Coin Offerings
  • people - Industry figures
  • tags - Category tags
If not specified, searches all categories
limit
number
default:"10"
Maximum number of results per category
modifier
string
Search modifier. Use symbol_search to search by ticker symbol only
output
string
default:"table"
Output format: table or json
raw
boolean
default:"false"
Output raw JSON without metadata wrapper

Examples

Search for Bitcoin

coinpaprika-cli search bitcoin

Search for Ethereum in specific categories

coinpaprika-cli search ethereum --categories currencies,exchanges --limit 5

Search by symbol only

coinpaprika-cli search BTC --modifier symbol_search

Search for an exchange

coinpaprika-cli search binance --categories exchanges

Search for a person

coinpaprika-cli search vitalik --categories people

Search for DeFi projects

coinpaprika-cli search defi --categories currencies,tags --limit 20

Get comprehensive search results as JSON

coinpaprika-cli search "layer 2" --output json

Response

The command returns results grouped by category:
{
  "currencies": [
    {
      "id": "btc-bitcoin",
      "name": "Bitcoin",
      "symbol": "BTC",
      "rank": 1,
      "is_active": true,
      "type": "coin"
    },
    {
      "id": "bch-bitcoin-cash",
      "name": "Bitcoin Cash",
      "symbol": "BCH",
      "rank": 25,
      "is_active": true,
      "type": "coin"
    }
  ],
  "exchanges": [
    {
      "id": "bitcoin-com",
      "name": "Bitcoin.com Exchange"
    }
  ],
  "icos": [],
  "people": [],
  "tags": [
    {
      "id": "bitcoin-fork",
      "name": "Bitcoin Fork",
      "coin_counter": 15,
      "ico_counter": 2
    }
  ]
}

Response Fields

Currency Results

id
string
Unique coin identifier (use this for other commands)
name
string
Full name of the cryptocurrency
symbol
string
Trading symbol/ticker
rank
number
Market cap rank
is_active
boolean
Whether the coin is currently active
type
string
Type: coin or token

Exchange Results

id
string
Unique exchange identifier
name
string
Exchange name

People Results

id
string
Unique person identifier
name
string
Person’s full name
teams_count
number
Number of projects associated with this person

Tag Results

id
string
Unique tag identifier
name
string
Tag display name
coin_counter
number
Number of coins in this category
ico_counter
number
Number of ICOs in this category

Notes

  • Search is case-insensitive
  • Results are ranked by relevance
  • Use --categories to narrow your search and improve performance
  • The symbol_search modifier is useful when you know the exact ticker
  • Empty arrays are returned for categories with no matches
  • Available on free tier

Search Tips

  1. Find coin ID: Use search to discover the exact coin ID for other commands
    coinpaprika-cli search cardano
    # Returns: ada-cardano
    # Then use: coinpaprika-cli coin ada-cardano
    
  2. Symbol search: When searching by ticker, use the modifier
    coinpaprika-cli search ETH --modifier symbol_search
    
  3. Category filtering: Limit search to specific categories for faster results
    coinpaprika-cli search binance --categories exchanges
    
  4. Fuzzy matching: Search works with partial names
    coinpaprika-cli search "bit" --limit 5
    
  • coin - Get details about a specific coin
  • exchange - Get exchange information
  • person - Get person details
  • tags - Browse all tags

Build docs developers (and LLMs) love