Skip to main content

​
Overview

Retrieve a list of tags (categories) used to classify cryptocurrencies. Tags help organize coins by their use case, technology, or sector (e.g., DeFi, NFT, Layer 1).

​
Usage

coinpaprika-cli tags [OPTIONS]

coinpaprika-cli tag <tag_id>

​
List Tags

​
Options

​
limit
number
default:"50"
Maximum number of tags to return
​
output
string
default:"table"
Output format: table or json
​
raw
boolean
default:"false"
Output raw JSON without metadata wrapper

​
Examples

​
List top 20 tags

coinpaprika-cli tags --limit 20

​
Get all tags as JSON

coinpaprika-cli tags --output json

coinpaprika-cli tags --limit 50

​
Tag Details

​
Arguments

​
tag_id
string
required
The unique identifier for the tag (e.g., defi, nft, layer-1)

​
Options

​
output
string
default:"table"
Output format: table or json
​
raw
boolean
default:"false"
Output raw JSON without metadata wrapper

​
Examples

​
Get DeFi tag details

coinpaprika-cli tag defi

​
Get NFT tag with coin list

coinpaprika-cli tag nft --output json

​
Explore Layer 1 projects

coinpaprika-cli tag layer-1

​
Response (List)

The tags command returns a list of all tags: 
[
  {
    "id": "defi",
    "name": "Decentralized Finance (DeFi)",
    "description": "Decentralized finance refers to financial services using smart contracts...",
    "type": "functional",
    "coin_counter": 450,
    "ico_counter": 25
  },
  {
    "id": "nft",
    "name": "Non-Fungible Token (NFT)",
    "description": "Non-fungible tokens are unique digital assets...",
    "type": "functional",
    "coin_counter": 180,
    "ico_counter": 15
  }
]

​
Response (Detail)

The tag command returns detailed information including a list of coins: 
{
  "id": "defi",
  "name": "Decentralized Finance (DeFi)",
  "description": "Decentralized finance (DeFi) refers to financial services using smart contracts on blockchains, primarily Ethereum. DeFi platforms allow users to lend, borrow, trade, and earn interest without traditional financial intermediaries.",
  "type": "functional",
  "coin_counter": 450,
  "ico_counter": 25,
  "coins": [
    "eth-ethereum",
    "link-chainlink",
    "uni-uniswap",
    "aave-aave",
    "mkr-maker"
  ]
}

​
Response Fields

​
id
string
Unique tag identifier (e.g., defi, nft)
​
name
string
Display name of the tag
​
description
string
Detailed explanation of the tag category
​
type
string
Tag classification type (e.g., functional, technological)
​
coin_counter
number
Number of coins tagged with this category
​
ico_counter
number
Number of ICOs associated with this category
​
coins
array
List of coin IDs tagged with this category (only in detail view)

​
Notes

  • Tags are curated by CoinPaprika to help classify and discover coins
  • Multiple tags can apply to a single coin
  • The coins array is only returned when fetching a specific tag detail
  • All values may be null if data is unavailable
  • Available on free tier

​
Common Tag Examples

  • defi - Decentralized Finance
  • nft - Non-Fungible Tokens
  • layer-1 - Layer 1 blockchains
  • smart-contracts - Smart contract platforms
  • privacy-coins - Privacy-focused cryptocurrencies
  • stablecoins - Price-stable cryptocurrencies
  • exchange-based-tokens - Exchange utility tokens
  • metaverse - Metaverse and virtual world projects
  • coins - List all coins
  • coin - Get coin details
  • search - Search across coins, tags, and more

Build docs developers (and LLMs) love

Get started for freeTalk to us