Get ticker for a specific coin

Returns price data of a single cryptocurrency on coinpaprika.com:

identity (id, name, symbol)
ranking (rank)
supplies (circulating_supply, total_supply, max_supply)
beta coefficient (beta_value)
price data in a given currency (price, volumes, market cap, price changes, ath)

price is a volume-weighted average across the markets we track, not a single exchange’s quote. See the price calculation methodology for how markets are selected, how outliers are removed, and how supply, market cap and ath are derived.

Available on the following API plans:

Free - there is no circulating supply field in the Free plan. If you need this field, use another API plan.
Starter
Pro
Business
Enterprise

Update interval:

60 seconds for Starter, Pro, Business, Enterprise plans
On average 5 minutes for Free

GET

tickers

{coin_id}

CLI

curl --request GET \
--url 'https://api.coinpaprika.com/v1/tickers/btc-bitcoin'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinpaprika.com/v1/tickers/{coin_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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/tickers/{coin_id}"

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

	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/tickers/{coin_id}")

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

request = Net::HTTP::Get.new(url)

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

{
  "id": "btc-bitcoin",
  "name": "Bitcoin",
  "symbol": "BTC",
  "rank": 1,
  "circulating_supply": 17007062,
  "total_supply": 17007062,
  "max_supply": 21000000,
  "beta_value": 0.735327,
  "first_data_at": "2010-11-14T07:20:41Z",
  "last_updated": "2018-11-14T07:20:41Z",
  "quotes": {
    "BTC": {
      "price": 1,
      "volume_24h": 1414951.9739396,
      "volume_24h_change_24h": -4.03,
      "market_cap": 17646575,
      "market_cap_change_24h": 0.01,
      "percent_change_15m": 0,
      "percent_change_30m": 0,
      "percent_change_1h": 0,
      "percent_change_6h": 0,
      "percent_change_12h": 0,
      "percent_change_24h": 0,
      "percent_change_7d": 0,
      "percent_change_30d": 0,
      "percent_change_1y": 0,
      "ath_price": null,
      "ath_date": null,
      "percent_from_price_ath": null
    },
    "USD": {
      "price": 5162.15941296,
      "volume_24h": 7304207651.1585,
      "volume_24h_change_24h": -2.5,
      "market_cap": 91094433242,
      "market_cap_change_24h": 1.6,
      "percent_change_15m": 0,
      "percent_change_30m": 0,
      "percent_change_1h": 0,
      "percent_change_6h": 0,
      "percent_change_12h": -0.09,
      "percent_change_24h": 1.59,
      "percent_change_7d": 0.28,
      "percent_change_30d": 27.39,
      "percent_change_1y": -37.99,
      "ath_price": 20089,
      "ath_date": "2017-12-17T12:19:00Z",
      "percent_from_price_ath": -74.3
    }
  }
}

{
  "error": "id not found"
}

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

Path Parameters

coin_id

string

required

Example:

"btc-bitcoin"

Query Parameters

quotes

string

default:USD

Comma separated list of quotes to return. Up to 3 quotes at once. Currently allowed values: BTC, ETH, USD, EUR, PLN, KRW, GBP, CAD, JPY, RUB, TRY, NZD, AUD, CHF, UAH, HKD, SGD, NGN, PHP, MXN, BRL, THB, CLP, CNY, CZK, DKK, HUF, IDR, ILS, INR, MYR, NOK, PKR, SEK, TWD, ZAR, VND, BOB, COP, PEN, ARS, ISK

Example:

"USD,BTC"

Response

successful operation

Tick response. Missing values are returned as empty string

string

Example:

"btc-bitcoin"

name

string

Example:

"Bitcoin"

symbol

string

Example:

"BTC"

rank

number

Example:

1

circulating_supply

number

Example:

17007062

total_supply

number

Example:

17007062

max_supply

number

Example:

21000000

beta_value

number

Example:

0.735327

first_data_at

string

Example:

"2010-11-14T07:20:41Z"

last_updated

string

Example:

"2018-11-14T07:20:41Z"

quotes

object

Show child attributes

Example:

{
  "BTC": {
    "price": 1,
    "volume_24h": 1414951.9739396,
    "volume_24h_change_24h": -4.03,
    "market_cap": 17646575,
    "market_cap_change_24h": 0.01,
    "percent_change_15m": 0,
    "percent_change_30m": 0,
    "percent_change_1h": 0,
    "percent_change_6h": 0,
    "percent_change_12h": 0,
    "percent_change_24h": 0,
    "percent_change_7d": 0,
    "percent_change_30d": 0,
    "percent_change_1y": 0,
    "ath_price": null,
    "ath_date": null,
    "percent_from_price_ath": null
  },
  "USD": {
    "price": 5162.15941296,
    "volume_24h": 7304207651.1585,
    "volume_24h_change_24h": -2.5,
    "market_cap": 91094433242,
    "market_cap_change_24h": 1.6,
    "percent_change_15m": 0,
    "percent_change_30m": 0,
    "percent_change_1h": 0,
    "percent_change_6h": 0,
    "percent_change_12h": -0.09,
    "percent_change_24h": 1.59,
    "percent_change_7d": 0.28,
    "percent_change_30d": 27.39,
    "percent_change_1y": -37.99,
    "ath_price": 20089,
    "ath_date": "2017-12-17T12:19:00Z",
    "percent_from_price_ath": -74.3
  }
}

CLI

curl --request GET \
--url 'https://api.coinpaprika.com/v1/tickers/btc-bitcoin'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinpaprika.com/v1/tickers/{coin_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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/tickers/{coin_id}"

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

	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/tickers/{coin_id}")

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

request = Net::HTTP::Get.new(url)

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

{
  "id": "btc-bitcoin",
  "name": "Bitcoin",
  "symbol": "BTC",
  "rank": 1,
  "circulating_supply": 17007062,
  "total_supply": 17007062,
  "max_supply": 21000000,
  "beta_value": 0.735327,
  "first_data_at": "2010-11-14T07:20:41Z",
  "last_updated": "2018-11-14T07:20:41Z",
  "quotes": {
    "BTC": {
      "price": 1,
      "volume_24h": 1414951.9739396,
      "volume_24h_change_24h": -4.03,
      "market_cap": 17646575,
      "market_cap_change_24h": 0.01,
      "percent_change_15m": 0,
      "percent_change_30m": 0,
      "percent_change_1h": 0,
      "percent_change_6h": 0,
      "percent_change_12h": 0,
      "percent_change_24h": 0,
      "percent_change_7d": 0,
      "percent_change_30d": 0,
      "percent_change_1y": 0,
      "ath_price": null,
      "ath_date": null,
      "percent_from_price_ath": null
    },
    "USD": {
      "price": 5162.15941296,
      "volume_24h": 7304207651.1585,
      "volume_24h_change_24h": -2.5,
      "market_cap": 91094433242,
      "market_cap_change_24h": 1.6,
      "percent_change_15m": 0,
      "percent_change_30m": 0,
      "percent_change_1h": 0,
      "percent_change_6h": 0,
      "percent_change_12h": -0.09,
      "percent_change_24h": 1.59,
      "percent_change_7d": 0.28,
      "percent_change_30d": 27.39,
      "percent_change_1y": -37.99,
      "ath_price": 20089,
      "ath_date": "2017-12-17T12:19:00Z",
      "percent_from_price_ath": -74.3
    }
  }
}

{
  "error": "id not found"
}

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

Getting Started

Key

Global

Coins

People

Tags

Tickers

Exchanges

Contracts

Changelog

Tools

Get ticker for a specific coin

Path Parameters

Query Parameters

Response