Get list of tags

Get a list of all our tags. Each tag provides insights into the number of coins it encompasses, along with market-specific statistics like volume and market capitalization. The tags can also be used in the coins endpoint as a filter.

https://api.coinranking.com/v2/tags

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of coin (either fiat or crypto), the price of the reference currency is used in all the values that represent a price, e.g. 24hVolume and marketCap. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

Default value: yhjMzLPhuIDl

Example:
...tags?referenceCurrencyUuid=5k-_VTxqtCEI
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

Example:
...tags?timePeriod=1y

Code examples

Response

json
{
  "status": "success",
  "data": {
    "stats": {
      "total": 61
    },
    "tags": [
      {
        "slug": "defi",
        "shortname": "DeFi",
        "name": "DeFi coins",
        "iconUrl": "https://cdn.coinranking.com/mXMAEpdTf/defi.svg",
        "hasContent": true,
        "numberOfCoins": 1118,
        "24hVolume": "5471264386.786922",
        "volumeShare": "7.67",
        "marketCap": "76706768342.49992",
        "marketCapChange": "-3.86",
        "marketCapShare": "2.48",
        "topCurrencySymbol": "LINK",
        "topCurrencyMarketCap": "10163230777.470625",
        "topCurrencyDominance": "13.25",
        "coinrankingUrl": "https://coinranking.com/coins/defi"
      },
      {
        "slug": "stablecoin",
        "shortname": "Stablecoins",
        "name": "Stablecoins",
        "iconUrl": "https://cdn.coinranking.com/JxqrcpBpA/stablecoins.svg",
        "hasContent": true,
        "numberOfCoins": 103,
        "24hVolume": "61379763718.98494",
        "volumeShare": "86.07",
        "marketCap": "213941190832.68878",
        "marketCapChange": "-0.05",
        "marketCapShare": "6.93",
        "topCurrencySymbol": "USDT",
        "topCurrencyMarketCap": "136108713544.9239",
        "topCurrencyDominance": "63.62",
        "coinrankingUrl": "https://coinranking.com/coins/stablecoin"
      }
    ]
  }
}

Response fields

Property Description
status String

Status of the request

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

Total number of tags available.
data.tags Array

List of tag objects.
data.tags[] Object

A tag object. Read more about what a tag is in the introduction.
data.tags[].slug String

Slug identifier for the tag. This is a short url-friendly name, so for example the tag with the name "Layer-2 coins" has layer-2 as slug. These slugs can also be used as a filter in the coins endpoint (Look for the tags query parameter).

data.tags[].shortname String

As the name implies, it is a shorter version of the name. It mostly omits the tokens or coins part of the name, so instead of the "Layer-2 coins" you get just "Layer-2". In contrast to the slug, these short names are not url-friendly perse and cannot be used for filtering.

data.tags[].name String

Full name of the tag. It is the name we use on our categories page.
data.tags[].iconUrl String

URL of the tag's icon. Every tag has it's own icon, and you can find it through this url. The images might change over time.
data.tags[].hasContent Boolean

Indicates if the tag has any coins associated with it. This should be the case in almost all cases, but new categories can be made before there are any coins related to them.

data.tags[].numberOfCoins Number

Number of coins associated with the tag. Should you use the filter on the coins endpoint to get the coins related to a specific tag, numberOfCoins is the amount of coins that you can expect to get back (with pagination, that is).
data.tags[].24hVolume String

The aggregated 24-hour trading volume for all coins that are associated to this tag.
data.tags[].volumeShare String

Share of the total trading volume. Meaning, the percentage the aggregated 24 hour volume (see the previous property) compared to the 24 hour volume of all coins listed on Coinranking.

data.tags[].marketCap String

Market capitalization for coins associated to the tag. In other words, the aggregated market cap for every coin that is related to this tag. Market cap itself is a product of the amount of coins in circulation, multiplied by the value of each of these coins.

data.tags[].marketCapChange String

Percentage change in market capitalization. The previous property (marketCap) represents how much the market cap for all coins with a specific tag is. This value compares the current market cap for a tag to the same one 24 hours ago.

data.tags[].marketCapShare String

Share of the total market capitalization. Meaning, the percentage the aggregated market cap (see the previous property) compared to market cap of all coins listed on Coinranking.

data.tags[].topCurrencySymbol String

Symbol of the top currency within the tag. The top currency being the coin with the highest market cap. A requirement is that this coin has to be a tier 1 coin.. If there is no tier 1 coin available, this value is null.

data.tags[].topCurrencyMarketCap String

Market capitalization of the top currency. See topCurrencySymbol. Can be null
data.tags[].topCurrencyDominance String

How dominant the top coin is compared to all the other coins with this tag, as a percentage. See topCurrencySymbol. Can be null.
data.tags[].coinrankingUrl String

URL to the Coinranking page for the tag.

Error response

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

Error responses

Previous

Tag details

 Next

Real-time (WebSockets)

On this page