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

​
Overview

Retrieve a changelog of coin ID modifications, including renames, mergers, and deprecated IDs. Essential for maintaining data integrity in applications that store coin IDs.

​
Usage

coinpaprika-cli changelog [options]

​
Options

​
--limit
number
default:"50"
Maximum number of changelog entries to return (default: 50)
​
--page
number
default:"1"
Page number for pagination (default: 1)
​
--output
string
default:"table"
Output format: table or json
​
--raw
boolean
default:"false"
JSON output without _meta wrapper (for scripts/piping)

​
Examples

​
Get recent ID changes

coinpaprika-cli changelog --limit 20

​
Paginate through changelog

# First 50 entries
coinpaprika-cli changelog --page 1

# Next 50 entries
coinpaprika-cli changelog --page 2

​
JSON output for monitoring

coinpaprika-cli changelog --output json --raw --limit 100 > changelog.json

​
Check for specific coin changes

coinpaprika-cli changelog --output json --raw --limit 1000 | \
  jq '.[] | select(.old_id == "btc-bitcoin" or .new_id == "btc-bitcoin")'

​
Response Structure

The response contains an array of changelog entries:
​
old_id
string
Previous coin ID (before the change)
​
new_id
string
New coin ID (after the change)
​
change_type
string
Type of change (e.g., “rename”, “merge”, “deprecate”)
​
timestamp
string
ISO 8601 timestamp when the change occurred
​
reason
string
Description or reason for the change

​
API Endpoint

GET https://api-pro.coinpaprika.com/v1/changelog/ids
Query Parameters:
  • limit — Maximum number of results (default: 50)
  • page — Page number (default: 1)
Headers: 
Authorization: <your-api-key>

​
Use Cases

Data Migration

Update stored coin IDs when they change

Integration Monitoring

Monitor for breaking changes in coin IDs

Historical Analysis

Track coin lifecycle and rebranding events

Error Prevention

Avoid 404 errors from outdated coin IDs

​
Pagination

The changelog is paginated with 50 entries per page by default: 
# Get total entries from first request
total=$(coinpaprika-cli changelog --page 1 --output json | jq '.total')

# Calculate total pages
pages=$(( (total + 49) / 50 ))

# Fetch all pages
for page in $(seq 1 $pages); do
  coinpaprika-cli changelog --page $page --output json >> all_changes.json
done

​
Plan Requirements

Available on:
  • Starter plan and higher
Not available on:
  • Free tier (no API key)

mappings

Get ID mappings across platforms (Business+)

coins

List all current coins

​
Notes

  • Check the changelog regularly if you store coin IDs in your database
  • Old IDs may redirect to new ones temporarily, but updates are recommended
  • Some changes represent coin rebrands or chain migrations
  • The changelog includes both active and deprecated coins

Build docs developers (and LLMs) love

Get started for freeTalk to us