API ID mappings

The API ID Mappings endpoint allows you to map IDs from other cryptocurrency API providers to Coinpaprika API IDs. This is especially useful when you have provider-specific IDs and want to interact with the Coinpaprika API using its own standardized IDs. In addition to Coinpaprika’s and other providers internal ID system, this endpoint also supports mapping ISIN(International Securities Identification Number) and DTI (Digital Token Identifier) IDs.

Use Cases:

Map your existing provider IDs (including ISIN and DTI) to Coinpaprika IDs
Retrieve other provider IDs (and ISIN, DTI) corresponding to a given Coinpaprika ID
Easily integrate and standardize data across different platforms with varying ID systems

This flexibility enables seamless integration across different crypto data sources and allows you to work with a variety of ID formats within the Coinpaprika ecosystem.

Available mapping providers

Coinpaprika
Coinmarketcap
Coingecko
Cryptocompare
ISIN
DTI

Available on the following API plans:

Business
Enterprise

Examples:

Use a single query parameter to get mappings for a specific Coinpaprika, Coinmarketcap, Coingecko, Cryptocompare, ISIN, or DTI ID. The response will include all available mappings for the specified ID.

# Get mappings for a specific Coinpaprika ID
curl --request GET \
    --url 'https://api-pro.coinpaprika.com/v1/coins/mappings?coinpaprika=btc-bitcoin' \
    --header 'Authorization: <your-api-key>'
  
# Get mappings for a specific Coinmarketcap ID
curl --request GET \
    --url 'https://api-pro.coinpaprika.com/v1/coins/mappings?coinmarketcap=1' \
    --header 'Authorization: <your-api-key>'\
  
# Get mappings for a specific Coingecko ID
curl --request GET \
    --url 'https://api-pro.coinpaprika.com/v1/coins/mappings?coingecko=bitcoin' \
    --header 'Authorization: <your-api-key>'
  
# Get mappings for a specific Cryptocompare ID
curl --request GET \
    --url 'https://api-pro.coinpaprika.com/v1/coins/mappings?cryptocompare=1' \
    --header 'Authorization: <your-api-key>'
  
# Get mappings for a specific ISIN ID
curl --request GET \
    --url 'https://api-pro.coinpaprika.com/v1/coins/mappings?isin=XTV15WLZJMF0' \
    --header 'Authorization: <your-api-key>'
               
# Get mappings for a specific DTI ID
curl --request GET \
    --url 'https://api-pro.coinpaprika.com/v1/coins/mappings?dti=V15WLZJMF' \
    --header 'Authorization: <your-api-key>'

Update interval: Every 1 minute.

GET

coins

mappings

CLI

curl --request GET \
--url 'https://api-pro.coinpaprika.com/v1/coins/mappings?coinpaprika=btc-bitcoin' \
--header 'Authorization: <your-api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.coinpaprika.com/v1/coins/mappings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinpaprika.com/v1/coins/mappings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.coinpaprika.com/v1/coins/mappings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.coinpaprika.com/v1/coins/mappings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "coinpaprika": "btc-bitcoin",
    "coinmarketcap": "1",
    "coingecko": "bitcoin",
    "cryptocompare": "1",
    "isin": "XTV15WLZJMF0",
    "dti": "V15WLZJMF",
    "updated_at": "2024-12-12T13:13:28Z"
  }
]

{
  "error": "you have reached maximum request limit"
}

Authorizations

Authorization

string

header

required

Query Parameters

coinpaprika

string

Coinpaprika API ID of a coin you want to map to the other provider API IDs

coinmarketcap

string

Coinmarketcap API ID of a coin you want to map to the other provider API IDs

coingecko

string

Coingecko API ID of a coin you want to map to the other provider API IDs

cryptocompare

string

Cryptocompare API ID of a coin you want to map to the other provider API IDs

isin

string

ISIN ID of a coin you want to map to the other provider API IDs

dti

string

Digital Token Identifier of a coin you want to map to the other provider API IDs

Response

successful operation

coinpaprika

string

ID of coin on coinpaprika.com

Example:

"btc-bitcoin"

coinmarketcap

string

ID of coin on coinmarketcap.com

Example:

"1"

coingecko

string

ID of coin on coingecko.com

Example:

"bitcoin"

cryptocompare

string

ID of coin on cryptocompare.com

Example:

"1"

isin

string

ISIN (International Securities Identification Number) of the coin

Example:

"XTV15WLZJMF0"

dti

string

Digital Token Identifier of the coin

Example:

"V15WLZJMF"

updated_at

string

Date of the last update of the mappings. RFC3999 (ISO-8601) format

Example:

"2024-12-12T13:13:28Z"

CLI

curl --request GET \
--url 'https://api-pro.coinpaprika.com/v1/coins/mappings?coinpaprika=btc-bitcoin' \
--header 'Authorization: <your-api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.coinpaprika.com/v1/coins/mappings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinpaprika.com/v1/coins/mappings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.coinpaprika.com/v1/coins/mappings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.coinpaprika.com/v1/coins/mappings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "coinpaprika": "btc-bitcoin",
    "coinmarketcap": "1",
    "coingecko": "bitcoin",
    "cryptocompare": "1",
    "isin": "XTV15WLZJMF0",
    "dti": "V15WLZJMF",
    "updated_at": "2024-12-12T13:13:28Z"
  }
]

{
  "error": "you have reached maximum request limit"
}

Getting Started

Key

Global

Coins

People

Tags

Tickers

Exchanges

Contracts

Changelog

Tools

API ID mappings

Authorizations

Query Parameters

Response