Coins

Coins are all the cryptocurrencies listed with us, like Bitcoin, Ethereum, Dogecoin, and thousands more. Do you miss a particular coin you’d like to see in the API? Submit it via our listing form and we’ll add it within two working days.

Get list of coins

Get a list of coins. On Coinranking, we use this endpoint on our home page.

Be aware that by default the list includes coins with tier 1, 2 and 3. This results in little-known coins with large market caps ranking on top. If you only want to show 'quality coins', then you should filter on tier 1.

Coins are by default ordered by their rank, which - somewhat simplified - means that they are ordered on market cap. The response not only returns a list of coins, but also statistics regarding the requested list, such as the volume in the last 24 hours. If you need all our coins at once, check out our metadata endpoint.

GET /coins
https://api.coinranking.com/v2/coins

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

UUID of reference currency, in which all the prices are calculated. This includes the price, the change and the sparkline. Defaults to US Dollar

Default value: yhjMzLPhuIDl
timePeriod (optional)String

By setting the timePeriod the change percentage and sparkline in the response will be calculated accordingly

Default value: 24h
Allowed values:
1h 3h 12h 24h 7d 30d 3m 1y 3y 5y
symbols (optional)Array

Symbols to filter the list on. Do note that symbols are not unique. Should you need a specific coin, then you should use the uuids filter.

contractAddresses (optional)Array

contract Addresses to filter the list on. These are the addresses currencies get on their respective blockchains. Smart Contract Addresses are a common name for addresses on blockchains, but some chains might call them AssetID, Token Address or something else. We use the term Contract Address to cover all these cases. Note that tokens might be issued on several blockchains, so the same token might have several addresses.

blockchains (optional)Array

Blockchains to filter the list on. With this filter you can for example fetch only coins that are minted on the Ethereum blockchain. You can filter on multiple blockchains at once.

uuids (optional)Array

UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins.

tiers (optional)Array

We separate coins into three tiers. With this parameter you can filter coins on the tiers you need. Read more about out our tiers in our methodology

Allowed values:
1 2 3
tags (optional)Array

Tags to filter the list on.

Allowed values:
defi stablecoin nft dex exchange staking dao meme privacy metaverse gaming wrapped layer-1 layer-2 fan-token football-club web3 social
orderBy (optional)String

Index to order by. All sortings excluding listedAt still take our different tiers of coins into account, read more about it in our methodology.

Default value: marketCap
Allowed values:
price marketCap 24hVolume change listedAt
search (optional)String

Filter the results by searching for coin names or symbols.

scopeId (optional)String

A scope can be used to make a subset of the coin list. To be used in combination with scopeLimit. The scopeId defines a subset, while the scopeLimit defines the size of the subset. Subsequently, any orderBy and orderDirection you choose is applied on the subset. This can be used if you want to sort a subset of coins, while the set itself is ordered by market cap or volume. We use it to make our 'Best Performers' list on Coinranking, where we show the coins that increased the most out of the top 200 highest ranked coins.

Default value: marketCap
Allowed values:
marketCap 24hVolume
scopeLimit (optional)Number

The scopeLimit defines the size of a scoped subset of coins. To be used in combination with scopeId. For more explanation, see scopeId.

Default value: 100
orderDirection (optional)String

Applies direction to the orderBy query, which can be in ascending or descending order.

Default value: desc
Allowed values:
desc asc
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: 50
Size range: 0-5000
offset (optional)Number

Offset. Used for pagination.

Default value: 0
minVolume (optional)Number

Filter the results by a minimum 24h volume.

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 3,
      "totalCoins": 10000,
      "totalMarkets": 35000,
      "totalExchanges": 300,
      "totalMarketCap": "239393904304",
      "total24hVolume": "503104376.06373006"
    },
    "coins": [
      {
        "uuid": "Qwsogvtv82FCd",
        "symbol": "BTC",
        "name": "Bitcoin",
        "color": "#f7931A",
        "iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
        "marketCap": "159393904304",
        "price": "9370.9993109108",
        "listedAt": 1483228800,
        "change": "-0.52",
        "rank": 1,
        "sparkline": [
          "9515.0454185372",
          "9540.1812284677",
          "9554.2212643043",
          "9593.571539283",
        ...
        ],
        "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc",
        "24hVolume": "6818750000"
        "btcPrice": "1",
        "contractAddresses": []
      },
      {
        "uuid": "HIVsRcGKkPFtW",
        "symbol": "USDT",
        "name": "Tether USD",
        "color": "#22a079",
        "iconUrl": "https://cdn.coinranking.com/mgHqwlCLj/usdt.svg",
        "marketCap": "96683907099",
        "price": "1.0001610860600088",
        "listedAt": 1420761600,
        "tier": 1,
        "change": "0.12",
        "rank": 3,
        "sparkline": [
          "0.9989504570557836",
          "0.9983877836406384",
          "0.9980832967019606",
          "0.9991024864845068",
          ...
        ],
        "lowVolume": false,
        "coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tetherusd-usdt",
        "24hVolume": "129352463266",
        "btcPrice": "0.000020055313576108",
        "contractAddresses": [
          "avalanche-c-chain/0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7 ",
          "tron/TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
          "solana/Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
          "eos/USDT-eos-tethertether",
          "omni/31",
          "bitcoin-cash/9fc89d6b7d5be2eac0b3787c5b8236bca5de641b5bafafc8f450727b63615c11",
          "liquid/ce091c998b83c78bb71a632313ba3760f1763d9cfcffae02258ffa9865a37bd2",
          "ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7",
          "algorand/312769"
        ]
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject

A series of statistics regarding the requested list. Note that the stats its scope includes coins outside the limit. E.g. the response of a query with a limit of 50 coins returns 50 coins (obviously), while the stats depicts the amount of coins available, 24 hour volume, etc. without this limit, which may be a much higher number

data.stats.totalNumber

Total number of coins within the query

data.stats.totalCoinsNumber

Total number of coins without the filters

data.stats.totalMarketsNumber

Total number of markets without the filters

data.stats.totalExchangesNumber

Total number of exchanges without the filters

data.stats.totalMarketCapString

The market capital of coins without the filters

data.stats.total24hVolumeString

The volume over the last 24 hours of coins without the filters

data.coinsObject[]

List of coins

data.coins.uuidString

UUID of the coin

data.coins.symbolString

Currency symbol

data.coins.nameString

Name of the coin

data.coins.colorString

Main HEX color of the coin

data.coins.iconUrlString

Location of the icon

data.coins.24hVolumeString

24h trade volume

data.coins.marketCapString

Market capitalization. Price times circulating supply

data.coins.priceString

Price of the coin

data.coins.btcPriceString

Price of the coin expressed in Bitcoin

data.coins.listedAtNumber/null

Epoch timestamp of when we started listing the coin.

data.coins.changeString

Percentage of change over the given time period

data.coins.rankNumber

The position in the ranks

data.coins.sparklineString

Array of prices based on the time period parameter, useful for a sparkline

data.coins.coinrankingUrlString

Where to find the coin on coinranking.com

data.coins.contractAddressesObject[]

List of contract addresses for this coin. The format is blockchain/contractAddress. A single coin can be minted on multiple blockchains. For example, Tether (USDT) is available on Ethereum (ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7), Bitcoin Cash (bitcoin-cash/9fc89d6b7d5be2eac0b3787c5b8236bca5de641b5bafafc8f450727b63615c11) and seven other blockchains.

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}

Error responses

Get coin details

Find information about a specific coin. On Coinranking we use this endpoint on our coin detail page.

GET /coin/:uuid
https://api.coinranking.com/v2/coin/:uuid

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request. UUIDs of coins can be found using the Get coins endpoint or by checking the URL on coinranking.com, e.g. https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc is the URL for Bitcoin, and the part before the + (Qwsogvtv82FCd) is the UUID.

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar

Default value: yhjMzLPhuIDl
timePeriod (optional)String

Time period where the change and sparkline are based on

Default value: 24h
Allowed values:
1h 3h 12h 24h 7d 30d 3m 1y 3y 5y

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "coin": {
      "uuid": "Qwsogvtv82FCd",
      "symbol": "BTC",
      "name": "Bitcoin",
      "description": "Bitcoin is the first decentralized digital currency.",
      "color": "#f7931A",
      "iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
      "websiteUrl": "https://bitcoin.org",
      "links": [
        {
          "name": "Bitcoin",
          "url": "https://www.reddit.com/r/Bitcoin/",
          "type": "reddit"
        }
      ],
      "supply": {
        "confirmed": true,
        "supplyAt": 1640757180,
        "circulating": "17009275",
        "total": "17009275",
        "max": "21000000"
      },
      "24hVolume": "6818750000",
      "marketCap": "159393904304",
      "fullyDilutedMarketCap": "196790985529",
      "price": "9370.9993109108",
      "btcPrice": "1",
      "priceAt": 1640757180,
      "change": "-0.52",
      "rank": 1,
      "numberOfMarkets": 9800,
      "numberOfExchanges": 190,
      "sparkline": [
        "9515.0454185372",
        "9540.1812284677",
        "9554.2212643043",
        "9593.571539283",
        "9592.8596962985",
        "9562.5310295967",
        "9556.7860427046",
        "9388.823394515",
        "9335.3004209165",
        "9329.4331700521",
        "9370.9993109108"
      ],
      "allTimeHigh": {
        "price": "19500.471361532",
        "timestamp": 1513555200
      },
      "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc",
      "lowVolume": false,
      "listedAt": 1483228800,
      "notices": [
        {
          "type": "MESSAGE",
          "value": "Lorem ipsum dolor sit amet"
        }
      ],
      "contractAddresses": [],
      "tags": [
        "staking",
        "layer-1"
       ]
    }
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.coinObject
data.coin.uuidString

UUID of the coin

data.coin.symbolString

Currency symbol

data.coin.nameString

Name of the coin

data.coin.descriptionString

Small description of the coin

data.coin.colorString

Main HEX color of the coin

data.coin.iconUrlString
data.coin.websiteUrlString

URL of the primary website

data.coin.linksObject[]

List of links, like social media pages

data.coin.links.nameString

Name of the link

data.coin.links.urlString

Url to the specific link

data.coin.links.typeString

The type of link

Allowed values:
website bitcointalk explorer discord facebook github instagram line-messenger linkedin medium qq quora reddit sina-weibo telegram tiktok twitter vkontakte wechat whitepaper youtube etc.
data.coin.supplyObject
data.coin.supply.confirmedBoolean

Coins without a confirmed supply are ranked below coins with a confirmed supply. Read about our methodology.

data.coin.supply.supplyAtNumber/null

Epoch timestamp of when the supply was synchronized. If the supply was never synchronized or the supply is manually updated the API will return null.

data.coin.supply.totalString

Number of coins that are in existence

data.coin.supply.circulatingString

Number of coins that are circulating in the public market

data.coin.supply.maxString

Maximum amount the coin's supply can ever be.

data.coin.marketCapString

Market capitalization. Price times circulating supply

data.coin.fullyDilutedMarketCapString

Market capitalization. Price times circulating supply Full Market capitalization. Fully diluted market cap is a coin's price multiplied by its max supply. Or total supply if the max supply is not known. It shows what the market cap could be if all coins were in circulation, with the current price.

data.coin.priceString

Price of the coin

data.coin.btcPriceString

Price of the coin expressed in Bitcoin

data.coin.priceAtNumber/null

Epoch timestamp of when the price was calculated.

data.coin.24hVolumeString

24h trade volume

data.coin.changeString

Percentage of change over the given time period

data.coin.rankNumber

The position in the ranks

data.coin.numberOfMarketsNumber

The number of markets that contain the this coin

data.coin.numberOfExchangesNumber

The number of exchanges that trade this coin

data.coin.sparklineString

Array of prices based on the time period parameter, useful for a sparkline

data.coin.allTimeHighObject
data.coin.allTimeHigh.priceString

The highest price that the coin has reached

data.coin.allTimeHigh.timestampNumber

An Epoch timestamp in seconds when the coin reached its highest price.

data.coin.coinrankingUrlString

Where to find the coin on coinranking.com

data.coin.lowVolumeBoolean

If the coin is not much traded on listed exchanges it is marked as having a low volume. The threshold is currently set at the equivalent of 500.000 US Dollar in 24 hours

data.coin.listedAtNumber/null

Epoch timestamp of when we started listing the coin.

data.coin.noticesObject[]

List of notices, which signal some important information about the coin. The notices are in JSON format, and in most cases consist of a "type" property with an important keyword such as "WARNING", and a more human readable message in a "value" property.

data.coin.contractAddressesObject[]

List of contract addresses for this coin. The format is blockchain/contractAddress. A single coin can be minted on multiple blockchains. For example, Tether (USDT) is available on Ethereum (ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7), Bitcoin Cash (bitcoin-cash/9fc89d6b7d5be2eac0b3787c5b8236bca5de641b5bafafc8f450727b63615c11) and seven other blockchains.

data.coin.tagsObject[]

List of tags, like "Staking" or "Meme"

Error response

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

Error responses

Get coin price

The price endpoint allows users to query the price history of a cryptocurrency based on a specified epoch timestamp (in seconds). The system will find the nearest available price point to the provided timestamp, selecting from data aggregated by minute, hour, or day. The granularity of the returned data depends on how far back in time the requested timestamp is.

GET /coin/:uuid/price
https://api.coinranking.com/v2/coin/:uuid/price

Path parameters

NameTypeDescription
uuidString

UUID of the coin you need the price.

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

UUID of reference currency. This is the currency the price is shown in, which defaults to US Dollar

Default value: yhjMzLPhuIDl
timestamp (optional)Number

The timestamp parameter accepts an epoch timestamp in seconds. This timestamp is used to find the nearest available price point, selecting the data's granularity based on the age of the request:

  • Minute-level data for timestamps within the last 24 hours.
  • Hourly data for timestamps older than 24 hours but less than 30 days.
  • Daily data for timestamps older than 30 days.

If no timestamp is provided, this endpoint will default to the latest price.

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "price": "7305.985182338483",
    "timestamp": 1586305740
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.priceString

The price of the requested coin at the requested time

data.timestampNumber

An Epoch timestamp in seconds when the coin had the given price. Might differ from the provided timestamp in the request, because it is stripped down to the day, hour or minute.

Error response

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

Error responses

Get coin price history

Coinranking keeps track of prices on all listed assets. The history endpoint lists prices and their timestamp for the requested time period, useful for making a chart.

On Coinranking, we use this endpoint for the main price chart on our coin detail page.

GET /coin/:uuid/history
https://api.coinranking.com/v2/coin/:uuid/history

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request

Query parameters

NameTypeDescription
timePeriod (optional)String

Timeperiod where the change and history are based on

Default value: 24h
Allowed values:
1h 3h 12h 24h 7d 30d 3m 1y 3y 5y
referenceCurrencyUuid (optional)String

UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar

Default value: yhjMzLPhuIDl

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "change": "12",
    "history": [
      {
        "price": "41905.99687434882803047615",
        "timestamp": 1641897900
      },
      {
        "price": "41937.93174219252237197408",
        "timestamp": 1641897600
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.changeString

Percentage of change over the given time frame

data.historyObject[]

List of prices

data.history.priceString

Price of the coin

data.history.timestampNumber

An Epoch timestamp in seconds when the coin had the given price.

Error response

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

Error responses

Get coin OHLC

professional This endpoint requires the professional plan or higher

Get OHLC (Open High Low Close) data for the coin throughout time.

GET /coin/:uuid/ohlc
https://api.coinranking.com/v2/coin/:uuid/ohlc

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request the OHLC data for.

Query parameters

NameTypeDescription
interval (optional)String

The interval determines the time period over which each OHLC item is determined.

Default value: day
Allowed values:
minute 5minutes hour 8hours day week month
limit (optional)Number

Limit. Limit the amount of time periods for which the OHLC data is retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. 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: 50
Size range: 0-5000
referenceCurrencyUuid (optional)String

UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar.

Default value: yhjMzLPhuIDl

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "ohlc": [
      {
        "startingAt": 1641427200,
        "open": "43639.170052896734",
        "high": "43830.15844443845",
        "low": "42679.105282492994",
        "close": "43253.82606224523",
        "avg": "43194.86335084649"
      },
      {
        "startingAt": 1641340800,
        "open": "45997.97595190101",
        "high": "47050.58243007133",
        "low": "42923.375181467185",
        "close": "43639.198327313374",
        "avg": "46022.85506904964"
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.ohlcObject[]

List of OHLC items

data.ohlc.startingAtNumber

An Epoch timestamp in seconds marking the start of the time period on which the OHLC values are based.

data.ohlc.openString/null

Opening price of the coin for the time period

data.ohlc.highString/null

Highest price of the coin during the time period

data.ohlc.lowString/null

Lowest price of the coin during the time period

data.ohlc.closeString/null

Closing price of the coin for the time period

data.ohlc.avgString/null

Average price of the coin over the time period

Error response

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

Error responses

Get coin exchange listings

professional This endpoint requires the professional plan or higher

Get a list of exchanges where a specific coin can be traded. On Coinranking, we use this endpoint on our coin exchange listings page.

GET /coin/:uuid/exchanges
https://api.coinranking.com/v2/coin/:uuid/exchanges

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request exchanges for

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar

Default value: yhjMzLPhuIDl
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: 50
Size range: 0-5000
offset (optional)Number

Offset. Used for pagination

Default value: 0
orderBy (optional)String

Index to order by. Default is 24h volume.

Default value: 24hVolume
Allowed values:
24hVolume price
orderDirection (optional)String

Order in ascending or descending order

Default value: desc
Allowed values:
desc asc
search (optional)String

Value to search for within results, i.e. exchange names

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "stats": {
    "24hVolume": "27739840257.811882",
    "total": 278
  },
  "exchanges": [
    {
      "coinrankingUrl": "https://coinranking.com/exchange/Z7wAB_T0o+coinsbit",
      "rank": 1,
      "uuid": "Z7wAB_T0o",
      "verified": false,
      "recommended": false,
      "numberOfMarkets": 22,
      "name": "Coinsbit",
      "iconUrl": "https://cdn.coinranking.com/Xx7PRnP31/coinsbit.svg",
      "24hVolume": "2092377039.0491314",
      "price": "6954.329554998793",
      "btcPrice": "1"
    },
    {
      "coinrankingUrl": "https://coinranking.com/exchange/8JlYgQMK+bkex",
      "rank": 2,
      "uuid": "8JlYgQMK",
      "verified": false,
      "recommended": false,
      "numberOfMarkets": 14,
      "name": "BKEX",
      "iconUrl": "https://cdn.coinranking.com/uNp-AXDRf/BKEX.svg",
      "24hVolume": "1793966025.8889403",
      "price": "6952.4065930949655",
      "btcPrice": "1"
    }
  ]
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject
data.stats.24hVolumeString

Total 24h volume of exchanges in the reference currency

data.stats.totalNumber

Total number of exchanges

data.exchangesObject
data.exchanges.coinrankingUrlNumber

The url to the page on Coinranking for this exchange

data.exchanges.uuidString

UUID of the exchange

data.exchanges.nameString

Name of the exchange

data.exchanges.iconUrlString

Location of the icon

data.exchanges.verifiedBoolean

DEPRECATED Exchanges that are verified to not participate in harmful practices such as wash trading are marked as verified.

data.exchanges.recommendedBoolean

Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges

data.exchanges.numberOfMarketsNumber

Number of markets of the exchange paired with Coinranking

data.exchanges.rankNumber

Rank of the exchange based on volume, taking into account exchange and currency filters

data.exchanges.24hVolumeString

Total volume in 24 hours

data.exchanges.priceString

Price of the chosen coin on this exchange

data.exchanges.btcPriceString

Price of the chosen coin expressed in Bitcoin

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency not available"
}

Error responses

Get coin market listings

professional This endpoint requires the professional plan or higher

Get markets on different exchanges that trade a specific coin. On Coinranking, we use this endpoint on our coin market listings page.

GET /coin/:uuid/markets
https://api.coinranking.com/v2/coin/:uuid/markets

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request markets for

Query parameters

NameTypeDescription
referenceCurrencyUuid (optional)String

UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar

Default value: yhjMzLPhuIDl
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: 50
Size range: 0-5000
offset (optional)Number

Offset. Used for pagination

Default value: 0
orderBy (optional)String

Index to sort on. Default is 24h volume.

Default value: 24hVolume
Allowed values:
24hVolume price
orderDirection (optional)String

Order in ascending or descending order

Default value: desc
Allowed values:
desc asc
search (optional)String

Value to search for within results, e.g. exchange names, currency names, or currency symbols

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "24hVolume": "2795922.586905519",
      "total": 3
    },
    "markets": [
      {
        "uuid": "xk9M2LuHuID5",
        "active": 1,
        "base": {
          "uuid": "Qwsogvtv82FCd",
          "symbol": "BTC"
        },
        "quote": {
          "uuid": "yhjMzLPhuIDl",
          "symbol": "USD"
        },
        "exchange": {
          "uuid": "-zdvbieRdZ",
          "name": "Binance",
          "iconUrl": "https://cdn.coinranking.com/d6w2Hj3z0/BitMEX.svg"
        },
        "24hVolume": "771875964.9750752",
        "price": "3842.9444791178726",
        "btcPrice": "1",
        "rank": 1,
        "marketShare": "30.48",
        "recommended": true,
        "filters": []
      },
      {
        "uuid": "bn7nTLHHuIq2",
        "active": 1,
        "base": {
          "uuid": "Qwsogvtv82FCd",
          "symbol": "BTC"
        },
        "quote": {
          "uuid": "HIVsRcGKkPFtW",
          "symbol": "USDT"
        },
        "exchange": {
          "uuid": "qn5ZJmPFP",
          "name": "Coinbase Pro",
          "iconUrl": "https://cdn.coinranking.com/Ama6htyHL/coinbase.svg"
        },
        "24hVolume": "311344830.86823833",
        "price": "3869.146354559396",
        "btcPrice": "1",
        "rank": 2,
        "marketShare": "12.35",
        "recommended": true,
        "filters": []
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject
data.stats.24hVolumeString

Total 24h volume of exchanges in the reference currency

data.stats.totalNumber

Total number of exchanges

data.marketsObject[]
data.markets.uuidString

UUID of the market

data.markets.activeNumber

If the market is enabled or not

data.markets.baseString

The coin on the left side of the pair, which price is calculated in units of the quote

data.markets.base.uuidString

UUID of the baseCurrency of the market

data.markets.base.symbolString

Symbol of the baseCurrency of the market

data.markets.quoteString

The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USD 10.000 means 1 BTC is traded for 10.000 USD.

data.markets.quote.symbolString

Symbol of the quoteCurrency of the market

data.markets.quote.uuidString

UUID of the quoteCurrency of the market

data.markets.exchangeString

Exchange this market belongs to

data.markets.exchange.nameString

Name of the exchange

data.markets.exchange.uuidString

UUID of the exchange

data.markets.exchange.iconUrlString

Location of the icon

data.markets.24hVolumeString

24h volume of the latest ticker in the reference currency

data.markets.priceString

Price of the latest ticker in reference currency

data.markets.btcPriceString

Price of the latest ticker expressed in Bitcoin

data.markets.rankNumber

Rank of the market based on volume, taking into account exchange and currency filters

data.markets.marketShareString

Percentage of the total market volume reprented by this market, taking into account exchange and currency filters

data.markets.recommendedBoolean

Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges

data.markets.filtersString[]

An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins.

Allowed values:
PREV_FACTOR EXTERNAL_ZSCORE GEO OUTSIDE_TOP_20

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency not available"
}

Error responses

Get coin blockchains

professional This endpoint requires the professional plan or higher

Get the blockchains on which the coin is issued. Most of the time this is only one blockchain, but some coins are issued on multiple blockchains. We call the relation of a coin to a blockchain the issuance blockchain.

GET /coin/:uuid/issuance-blockchains
https://api.coinranking.com/v2/coin/:uuid/issuance-blockchains

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request the blockchains for

Query parameters

NameTypeDescription
limit (optional)Number

Limit. Used for pagination

Default value: 50
Size range: 0-100
offset (optional)Number

Offset. Used for pagination

Default value: 0

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
 {
   "status": "success",
   "data": {
     "total": 1,
     "issuanceBlockchains": [
       {
         "name": "Ethereum",
         "referenceName": "Ethereum contract address",
         "reference": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0"
         "blockExplorerUrl": "https://etherscan.io/token/0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0"
       }
     ]
   }
 }

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.totalNumber

Total number of issuance blockchains for the coin.

data.issuanceBlockchainsObject[]
data.issuanceBlockchains.nameString

Name of the blockchain.

data.issuanceBlockchains.referenceNameString/null

Blockchain specific coin reference name. For instance, 'Ethereum contract address' for a coin's reference on the Ethereum blockchain.

data.issuanceBlockchains.referenceString/null

Reference address of the coin on the blockchain. Null means it is the blockchain's native coin. For example this is the smart contract address of a coin if it is issued on the Ethereum blockchain and the asset code if the coin is issued on the Stellar blockchain.

data.issuanceBlockchains.blockExplorerUrlString/null

The supplies are fetched from third parties, called block explorers. The url links to the website of the block explorer, and if possible to the specific token.

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "VALIDATION_ERROR",
  "messages": [
    "Limit can only be between 1 and 100."
  ]
}

Error responses

Get coin supply modifiers

professional This endpoint requires the professional plan or higher

Get the supply modifiers of a coin. These modifiers are the balances that are subtracted from the total supply in order to get the circulating supply. The balances we use as modifiers are from addresses that are considered not to be in circulation, such as addresses that hold burned or premined coins.

GET /coin/:uuid/modifiers
https://api.coinranking.com/v2/coin/:uuid/modifiers

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request the modifiers for

Query parameters

NameTypeDescription
limit (optional)Number

Limit. Used for pagination

Default value: 50
Size range: 0-100
offset (optional)Number

Offset. Used for pagination

Default value: 0
orderBy (optional)String

Order of the modifiers can be either when they were added (createdAt) or by amount

Default value: createdAt
Allowed values:
amount createdAt
orderDirection (optional)String

Applies direction to the orderBy query, which can be in ascending or descending order.

Default value: desc
Allowed values:
desc asc

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "total": 3,
    "modifiers": [
      {
        "blockchainName": "Neo",
        "blockExplorerUrl": "https://neotracker.io/address/Ae2d6qj91YL3LVUMkza7WQsaTYjzjHm4z1",
        "name": "Foundation",
        "reference": "Ae2d6qj91YL3LVUMkza7WQsaTYjzjHm4z1",
        "syncedAt": 1593436560,
        "amount": "14146080"
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.totalNumber

Total number of modifiers for the coin's supply.

data.modifiersObject
data.modifiers.blockchainNameString

Name of the blockchain to which this modifier applies.

data.modifiers.blockExplorerUrlString

URL to block explorer.

data.modifiers.nameString

Name we have given the modifier.

data.modifiers.referenceString

Address of the modifier.

data.modifiers.syncedAtNumber/null

Epoch timestamp in seconds when the amount has last been synced.

data.modifiers.amountString/null

Balance on the address retrieved at the syncedAt time.

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "VALIDATION_ERROR",
  "messages": [
    "Limit can only be between 1 and 100."
  ]
}

Error responses

Get coin market cap history

professional This endpoint requires the professional plan or higher

With the coin market-caps endpoint you can check out a coin's historical market

GET /coin/:uuid/market-caps
https://api.coinranking.com/v2/coin/:uuid/market-caps

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request the Market cap data for.

Query parameters

NameTypeDescription
interval (optional)String

The interval determines the time period over which each market cap item is determined.

Default value: day
Allowed values:
hour day week month
limit (optional)Number

Limit. Limit the amount of time periods for which the marketCaps are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. 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: 50
Size range: 0-5000

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "history": [
      {
        "timestamp": 1698220800,
        "marketCap": "663355719491"
      },
      {
        "timestamp": 1698217200,
        "marketCap": "662740429329"
      },
      {
        "timestamp": 1698213600,
        "marketCap": "666715637188"
      },
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.historyObject[]

List of market cap items

data.history.timestampNumber

An Epoch timestamp in seconds

data.history.marketCapString/null

the market cap in US Dollars

Error response

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

Error responses

Get coin rank history

professional This endpoint requires the professional plan or higher

With the coin ranks endpoint you can check out how a coin was ranked throughout its existence

GET /coin/:uuid/ranks
https://api.coinranking.com/v2/coin/:uuid/ranks

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request the rank data for.

Query parameters

NameTypeDescription
interval (optional)String

The interval determines the time period over which each rank item is determined.

Default value: day
Allowed values:
hour day week month
limit (optional)Number

Limit. Limit the amount of time periods for which the ranks are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. 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: 50
Size range: 0-5000

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "history": [
      {
        "startingAt": 1698310800,
        "tier": "1",
        "marketCapRank": "1",
        "fullyDilutedMarketCapRank": "1",
        "volumeRank": "2",
        "priceRank": "2"
      },
      {
        "startingAt": 1698307200,
        "tier": "1",
        "marketCapRank": "1",
        "fullyDilutedMarketCapRank": "1",
        "volumeRank": "2",
        "priceRank": "2"
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.historyObject[]

List of rank items

data.history.startingAtNumber

An Epoch timestamp in seconds marking the start of the time period on which the rank values are based.

data.history.tierString/null

Tier of the coin. We have three distinct tiers.

data.history.marketCapRankString/null

The rank of the coin based on market cap. This is the rank we use on our website by default. time period

data.history.fullyDilutedMarketCapRankString/null

The rank of the coin based on fully diluted market cap. Fully diluted market cap is a coin's price multiplied by its max supply. Or total supply if the max supply is not known.

data.history.volumeRankString/null

Market cap based on its trading volume in the past 24 hours.

data.history.priceRankString/null

The rank of the coin based on how much US Dollars just one unit of the coin is worth. This metric greatly favors coins with a low supply.

Error response

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

Error responses

Get coin supply history

professional This endpoint requires the professional plan or higher

With the coin supplies endpoint you can check out a coin's historical amount of supplies

GET /coin/:uuid/supplies
https://api.coinranking.com/v2/coin/:uuid/supplies

Path parameters

NameTypeDescription
uuidString

UUID of the coin you want to request the supply data for.

Query parameters

NameTypeDescription
interval (optional)String

The interval determines the time period over which each supply item is determined.

Default value: day
Allowed values:
hour day week month
limit (optional)Number

Limit. Limit the amount of time periods for which the supplies are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. 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: 50
Size range: 0-5000

Code examples

Parameters examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "history": [
      {
        "timestamp": 1698624000,
        "circulating": "19527731",
        "total": "19527731"
      },
      {
        "timestamp": 1698537600,
        "circulating": "19526875",
        "total": "19526875"
      },
      {
        "timestamp": 1698451200,
        "circulating": "19525868",
        "total": "19525868"
      }
    ]
  }
}

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.historyObject[]

List of supply items

data.history.timestampNumber

An Epoch timestamp in seconds

data.history.circulatingString/null

the circulating supply in US Dollars

data.history.totalString/null

the total supply in US Dollars

Error response

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

Error responses