Reference currencies

The price of a coin is shown in a reference currency. Currencies include, but are not limited to, coins. In contrast to coins, currencies also includes Fiat currencies like US Dollar, EURO, YEN and more. Furthermore, currencies also comprehends denominators as Satoshi and Wei (these are the atomic units for respectively Bitcoin and Ethereum, or - perhaps overly simplified - one could compare them with what the cent is to the Dollar.) Additionally, currencies include assets like Gold and Silver, which can also be used as reference currencies.

You can find the UUID of any fiat currency with our Search function for UUIDs.

Get list of reference currencies

Get a list of reference currencies, which can be used as reference for coins. The response includes all the essentials for this use-case, such as the symbol (e.g. USD) and - if available - the sign (e.g. $).

https://api.coinranking.com/v2/reference-currencies

Query parameters

Parameter Description
limit (optional) Number

Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 20
Size range: 0-5000

Example:
...reference-currencies?limit=10
offset (optional) Number

Offset. Used for pagination

Default value: 0

Example:
...reference-currencies?offset=50
types (optional) Array

A currency is one of four types: coin (e.g. Bitcoin, Ethereum, etc.), fiat (US Dollar, Euro, Yen, etc.), denominator (e.g. Satoshi) or asset (e.g. Gold, Silver, etc.). Filter the response by providing one or more types.

Allowed values:
coin fiat denominator asset

Example:
...reference-currencies?types[]=coin&types[]=fiat
search (optional) String

Filter the results by searching for currency names or symbols.

Example:
...reference-currencies?search=EUR
cursor (optional) String

Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information.

Example:
...reference-currencies?cursor=eyJ0IjoxLC...

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 3
    },
    "currencies": [
      {
        "uuid": "Qwsogvtv82FCd",
        "type": "coin",
        "symbol": "BTC",
        "name": "Bitcoin",
        "iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
        "sign": "₿"
      },
      {
        "uuid": "razxDUgYGNAdQ",
        "type": "coin",
        "symbol": "ETH",
        "name": "Ethereum",
        "iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
        "sign": "Ξ"
      },
      {
        "uuid": "yhjMzLPhuIDl",
        "type": "fiat",
        "symbol": "USD",
        "name": "US Dollar",
        "iconUrl": "https://cdn.coinranking.com/kz6a7w6vF/usd.svg",
        "sign": "$"
      }
    ]
  },
  "pagination": {
    "limit": 20,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "nextCursor": "eyJ0IjoxLCJyIjpudWxsLCJ1IjoieWhqTXpMUGh1SURsIiwibyI6bnVsbCwiZCI6bnVsbH0",
    "previousCursor": null
  }
}

Response fields

PropertyDescription
status String

Status of the request

Allowed values:
success
data Object
data.stats Object
data.stats.total Number

Total number of coins

data.currencies Object[]

List of reference currencies

data.currencies.uuid String

UUID of the reference currency

data.currencies.type String

The type of the currency can be either 'coin' (BTC, ETH, etc.), 'fiat' (USD, EUR, etc.), 'denominator' (Satoshi, Wei, etc.) or 'asset' (Gold, Silver, etc.)

data.currencies.symbol String

Currency symbol

data.currencies.name String

Name of the currency

data.currencies.iconUrl String

Location of the icon

data.currencies.sign String

Some currencies have a symbol, like $ for USD and ₿ for BTC

pagination Object

Pagination information. See Pagination for more details.

pagination.limit Number

The number of results per page

pagination.hasNextPage Boolean

Whether there are more results available after the current page

pagination.hasPreviousPage Boolean

Whether there are results available before the current page

pagination.nextCursor String/null

Cursor to use for the next page, or null if there are no more results

pagination.previousCursor String/null

Cursor to use for the previous page, or null if on the first page

Error response

json
HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "VALIDATION_ERROR",
  "message": "limit must be at least 1 and most 100"
}

Error responses

Previous

Market details

 Next

Introduction

On this page