Get coin fiat prices

Growth This endpoint requires the growth plan or higher. Free, Basic and Startup plans can use preview access.

The coin fiat prices endpoint provides the price of a coin in all available fiat currencies, including USD, EUR, GBP, and more. These fiat currencies act as reference currencies in our system, forming the basis for conversions. To learn more about how reference currencies work, see our reference currencies endpoint.

https://api.coinranking.com/v2/coin/:uuid/fiat-prices

Preview access

Free, Basic and Startup plans can test this endpoint with five successful requests per account per UTC day. Use the documented endpoint URL with your existing API key. Preview access is applied automatically. The allowance resets at 00:00 UTC.

All API keys, resource IDs, query parameters and pagination requests share this endpoint's allowance for your account. Failed requests do not consume the preview allowance. Successful previews also count toward your normal API usage, and your plan's result, historical-window and rate limits still apply. See endpoint previews for limits, response headers and quota errors.

Path parameters

Parameter	Description
uuid `String`	UUID of the coin you need the price.

Code examples

curl 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/fiat-prices' \
  -H 'x-access-token: your-api-key' \
  -G

const options = {
  headers: {
    'x-access-token': 'your-api-key',
  },
};

fetch('https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/fiat-prices', options)
  .then((response) => response.json())
  .then((result) => console.log(result));

<?php

  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/fiat-prices",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

import requests

headers = {
  'x-access-token': 'your-api-key'
}

response = requests.request("GET", "https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/fiat-prices", headers=headers)

print(response.text)

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "prices": [
      {
        "referenceCurrencyUuid": "cYkSLiOlL7Qw",
        "referenceCurrencySymbol": "CNY",
        "referenceCurrencyName": "Chinese Yuan",
        "referenceCurrencyIconUrl": "https://cdn.coinranking.com/__Q5DN_tH/cn.svg",
        "price": "637459.34229400648858905809"
      },
      {
        "referenceCurrencyUuid": "yhjMzLPhuIDl",
        "referenceCurrencySymbol": "USD",
        "referenceCurrencyName": "US Dollar",
        "referenceCurrencyIconUrl": "https://cdn.coinranking.com/FNwFOF8tV/us.svg",
        "price": "87336.01084405759"
      },
      {
        "referenceCurrencyUuid": "UinC7PrlC4hF",
        "referenceCurrencySymbol": "KRW",
        "referenceCurrencyName": "South Korean Won",
        "referenceCurrencyIconUrl": "https://cdn.coinranking.com/b-ARx3e2S/kr.svg",
        "price": "123876504.59582840166794170873"
      },
      {
        "referenceCurrencyUuid": "Ef8u4mwlnsSx",
        "referenceCurrencySymbol": "SGD",
        "referenceCurrencyName": "Singapore Dollar",
        "referenceCurrencyIconUrl": "https://cdn.coinranking.com/c1PE935ks/sg.svg",
        "price": "114475.23953379426512176243"
      }
    ]
  }
}

Response fields

Property	Description
status `String`	Status of the request Allowed values: success
data `Object`
data.prices `Object[]`	List of coin prices in fiat currencies
data.prices.referenceCurrencyUuid `String`	UUID of the reference currency
data.prices.referenceCurrencySymbol `String`	Symbol of the reference currency
data.prices.referenceCurrencyName `String`	Name of the reference currency
data.prices.referenceCurrencyIconUrl `String`	Location of the reference currency icon
data.prices.price `String`	Coin price in the reference currency

Error response

HTTP/1.1 404 Not Found
{
  "status": "fail",
  "type": "COIN_NOT_FOUND",
  "message": "Coin not found"
}

Error responses

Error	Description
PRICE_NOT_FOUND `Object`	No price could be calculated for this request. Try another UUID
COIN_NOT_FOUND `Object`	The coin could not be found. Try another UUID

Error	Description
VALIDATION_ERROR `Object`	The request could not be validated. The response should provide more details.