crypto-market-search

Purpose

Search, discover, and analyze cryptocurrency market data across 12,000+ coins and 350+ exchanges using CoinPaprika MCP tools.

Available Tools

Tool	Use case
search(q, categories, limit)	Find coins by name, symbol, or keyword
resolveId(type, query)	Resolve fuzzy names to canonical coin IDs
getTickersById(coinId, quotes)	Price, market cap, volume for one coin
getTickers(limit, quotes)	Top coins by market cap
getGlobal()	Total market cap, BTC dominance, 24h volume
getCoinById(coinId)	Coin description, links, team, tags
getCoinExchanges(coinId)	Which exchanges list this coin
getCoinMarkets(coinId, quotes)	Trading pairs for a coin
getCoinOHLCVHistorical(coinId, start)	Historical candlestick data
getCoinOHLCVLatest(coinId)	Last full day OHLCV
getCoinOHLCVToday(coinId)	Today's partial OHLCV
getExchanges(limit, quotes)	List exchanges
getExchangeByID(exchangeId)	Exchange details
getPlatforms()	List contract platforms
getTickerByContract(platformId, contractAddress)	Price lookup by contract address
getTagById(tagId, additionalFields)	Get coins by category (use additionalFields: "coins")
getTags()	List all categories/tags
priceConverter(baseCurrencyId, quoteCurrencyId, amount)	Convert between currencies
status()	API health check

Coin ID Format

Pattern: {symbol}-{name} (lowercase, hyphens). Examples: btc-bitcoin, eth-ethereum, sol-solana.

If unsure of the ID, call search(q: "user query") or resolveId(type: "coin", query: "user query") first.

Workflows

Search for a coin:

1. search(q: "pepe", categories: "currencies", limit: 5)
2. Pick the correct result, use its id field for further queries

Get coin price and details:

1. getTickersById(coinId: "btc-bitcoin", quotes: "USD,BTC")
2. Key fields: quotes.USD.price, quotes.USD.market_cap, quotes.USD.volume_24h, quotes.USD.percent_change_24h

Top coins by market cap:

1. getTickers(limit: 10, quotes: "USD")
2. Results are sorted by rank

Market overview:

1. getGlobal() for total market cap, BTC dominance, volume
2. getTickers(limit: 10) for top movers

Look up token by contract address:

1. getTickerByContract(platformId: "eth-ethereum", contractAddress: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48")
2. Platform IDs: eth-ethereum, bnb-binance-coin, matic-polygon, sol-solana, arb-arbitrum, avax-avalanche, op-optimism, base-base

Find coins by category:

1. getTagById(tagId: "stablecoin", additionalFields: "coins") returns array of coin IDs
2. Common tags: stablecoin, defi, nft, layer-1, layer-2, meme-token

Historical OHLCV:

1. getCoinOHLCVHistorical(coinId: "btc-bitcoin", start: "2025-01-01", interval: "24h", limit: 30)
2. Intervals: 5m, 15m, 30m, 1h, 6h, 12h, 24h

Output Guidelines

• Use compact numbers: 1.2B, 450M, 12.3K
• Show multiple timeframes: 1h, 24h, 7d, 30d changes
• Include market cap rank for context
• Note distance from ATH when significant
• Distinguish circulating vs total vs max supply
• Never provide investment advice
• Always cite which MCP tools provided the data

Error Handling

• Coin not found → use search to find similar names
• Invalid coin ID → must be symbol-name format (lowercase, hyphens)
• Rate limited → wait briefly, suggest caching results

Rate Limits

• Free tier: 20,000 calls/month (no API key needed)
• Pro tier: higher limits via api-pro.coinpaprika.com
• Global: 10 requests/second