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
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: yhjMzLPhuIDlExample:
...tags?referenceCurrencyUuid=5k-_VTxqtCEI
|
timePeriod (optional) String |
Time period where the change and sparkline are based on Default value: 24hAllowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y Example:
...tags?timePeriod=1y
|
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"
}
]
}
}
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 |
data.tags[].topCurrencyMarketCap String |
Market capitalization of the top currency. See topCurrencySymbol. Can be |
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 |
data.tags[].coinrankingUrl String |
URL to the Coinranking page for the tag. |
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}