Skip to main content
Paid Feature — Requires Business plan or higherView pricing · Set API key

​
Overview

Retrieve comprehensive mappings between CoinPaprika coin IDs and identifiers from other major crypto data platforms (CoinMarketCap, CoinGecko, Messari, etc.).

​
Usage

coinpaprika-cli mappings

​
Options

​
--output
string
default:"table"
Output format: table or json
​
--raw
boolean
default:"false"
JSON output without _meta wrapper (for scripts/piping)

​
Examples

​
Get all mappings

coinpaprika-cli mappings

​
JSON output for data integration

coinpaprika-cli mappings --output json --raw > mappings.json

​
Find CoinGecko ID for Bitcoin

coinpaprika-cli mappings --output json --raw | \
  jq '.[] | select(.coinpaprika_id == "btc-bitcoin") | .coingecko_id'

​
Convert between platform IDs

# Get mapping for a specific coin
coinpaprika-cli mappings --output json --raw | \
  jq '.[] | select(.coinmarketcap_id == "1")'

​
Response Structure

The response is an array of mapping objects, where each object contains:
​
coinpaprika_id
string
CoinPaprika coin ID (e.g., btc-bitcoin)
​
coingecko_id
string
CoinGecko coin ID (e.g., bitcoin)
​
coinmarketcap_id
string
CoinMarketCap coin ID (numeric, e.g., 1 for Bitcoin)
​
messari_id
string
Messari asset slug
​
livecoinwatch_id
string
LiveCoinWatch identifier
Available mapping fields may vary depending on data availability for each coin

​
API Endpoint

GET https://api-pro.coinpaprika.com/v1/coins/mappings
Headers: 
Authorization: <your-api-key>

​
Use Cases

Data Integration

Sync data between multiple crypto data providers

Multi-Source Validation

Cross-reference data from different platforms

Platform Migration

Migrate from one data provider to CoinPaprika

ID Translation

Translate coin IDs in existing datasets

​
Plan Requirements

Business plan or higher requiredThis endpoint is not available on:
  • Free tier
  • Starter plan
Upgrade to Business plan

changelog

Track coin ID changes over time

key-info

Check your API key and plan

​
Notes

  • Mappings are updated regularly as new coins are added
  • Not all coins have mappings to all platforms
  • Contact support to request missing mappings
  • Data is returned as a large JSON array (several MB)

Build docs developers (and LLMs) love

Get started for freeTalk to us