API Documentation

Metadata

Metadata is the static part of our data, i.e. the data that does not automatically changes. This includes data such as names, symbols and identifiers, but not volatile data such as prices or ranks. These endpoints are meant for when you need to quickly fetch all our data, for instance when bootstrapping your own new application and start out with a fresh set of data. No query parameters to fine-tune the set of results are supported, nor is CORS. It is meant to get all the data once, all at once. The rate limits for these endpoints are more limited then other endpoints, check the response headers for more information about your limits. The limits might change in the future.

Get coins metadata

pro This endpoint requires the pro plan or higher

One request to fetch static data of all coins currently available on coinranking. This includes data such as names and symbols of a coin, but not volatile data such as prices or ranks. You need the regular coin endpoints for volatile data.

GET /metadata/coins

Examples

Response

HTTP/1.1 200 OK
[
  {
    "uuid": "Qwsogvtv82FCd",
    "updatedAt": 1662624162,
    "symbol": "BTC",
    "name": "Bitcoin",
    "iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
    "links": [
      {
        "name": "bitcoin.org",
        "type": "website",
        "url": "https://bitcoin.org"
      },
      {
        "name": "bitcoinmagazine.com",
        "url": "https://bitcoinmagazine.com/",
        "type": "website"
      },
      {
        "name": "bitcointalk.org",
        "url": "https://bitcointalk.org/",
        "type": "bitcointalk"
      },
      {
        "name": "blockchain.com",
        "url": "https://www.blockchain.com/explorer",
        "type": "explorer"
      },
      {
        "name": "bitcoin/bitcoin",
        "url": "https://github.com/bitcoin/bitcoin",
        "type": "github"
      },
      {
        "name": "r/bitcoin",
        "url": "https://www.reddit.com/r/bitcoin/",
        "type": "reddit"
      },
      {
        "name": "Bitcoin_Magazine",
        "url": "https://t.me/Bitcoin_Magazine",
        "type": "telegram"
      },
      {
        "name": "bitcoin",
        "url": "https://t.me/bitcoin",
        "type": "telegram"
      },
      {
        "name": "Bitcoin Whitepaper",
        "url": "https://bitcoin.org/bitcoin.pdf",
        "type": "whitepaper"
      }
    ],
    "color": "#f7931A",
    "listedAt": 1330214400,
    "tags": [
      "layer-1"
    ],
    "issuanceBlockchains": null
  },
  {
    "uuid": "razxDUgYGNAdQ",
    "updatedAt": 1654153459,
    "symbol": "ETH",
    "name": "Ethereum",
    "iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
    "links": [
      {
        "name": "www.ethereum.org",
        "type": "website",
        "url": "https://www.ethereum.org"
      },
      {
        "name": "etherscan.io",
        "url": "https://etherscan.io/",
        "type": "website"
      },
      {
        "name": "bitcointalk.org",
        "url": "https://bitcointalk.org/index.php?topic=428589.0",
        "type": "bitcointalk"
      },
      {
        "name": "ethereumproject",
        "url": "https://facebook.com/ethereumproject",
        "type": "facebook"
      },
      {
        "name": "ethereum",
        "url": "https://github.com/ethereum",
        "type": "github"
      },
      {
        "name": "ethereum",
        "url": "https://www.reddit.com/r/ethereum/",
        "type": "reddit"
      },
      {
        "name": "ethtrader",
        "url": "https://www.reddit.com/r/ethtrader/",
        "type": "reddit"
      },
      {
        "name": "ethereum",
        "url": "https://twitter.com/ethereum",
        "type": "twitter"
      },
      {
        "name": "YouTube",
        "url": "https://www.youtube.com/channel/UCNOfzGXD_C9YMYmnefmPH0g",
        "type": "youtube"
      }
    ],
    "color": "#3C3C3D",
    "listedAt": 1438905600,
    "tags": [
      "layer-1",
      "staking"
    ],
    "issuanceBlockchains": null
  },
  {
    "uuid": "HIVsRcGKkPFtW",
    "updatedAt": 1646638240,
    "symbol": "USDT",
    "name": "Tether USD",
    "iconUrl": "https://cdn.coinranking.com/mgHqwlCLj/usdt.svg",
    "links": [
      {
        "name": "tether.to",
        "url": "https://tether.to/",
        "type": "website"
      },
      {
        "name": "Facebook",
        "url": "https://www.facebook.com/tether.to",
        "type": "facebook"
      },
      {
        "name": "www.linkedin.com",
        "url": "https://www.linkedin.com/company/tether",
        "type": "linkedin"
      },
      {
        "name": "r/tether",
        "url": "https://www.reddit.com/r/tether/",
        "type": "reddit"
      },
      {
        "name": "tether_to",
        "url": "https://twitter.com/tether_to",
        "type": "twitter"
      }
    ],
    "color": "#22a079",
    "listedAt": 1420761600,
    "tags": [
      "stablecoin"
    ],
    "maxSupply": null,
    "issuanceBlockchains": [
      {
        "name": "Algorand",
        "reference": "312769"
      },
      {
        "name": "Avalanche",
        "reference": "0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7 "
      },
      {
        "name": "Bitcoin Cash",
        "reference": "9fc89d6b7d5be2eac0b3787c5b8236bca5de641b5bafafc8f450727b63615c11"
      },
      {
        "name": "EOS",
        "reference": "USDT-eos-tethertether"
      },
      {
        "name": "Ethereum",
        "reference": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      },
      {
        "name": "Liquid Network",
        "reference": "ce091c998b83c78bb71a632313ba3760f1763d9cfcffae02258ffa9865a37bd2"
      },
      {
        "name": "Omni Layer",
        "reference": "31"
      },
      {
        "name": "Solana",
        "reference": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB"
      },
      {
        "name": "Tron TRC20",
        "reference": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
      }
    ]
  }
]

Response fields

NameTypeDescription
ArrayObject[]

The response is a list of objects of all our coins

uuidString

UUID of a coin; a unique identifier

updatedAtNumber

Timestamp of the last change made to the coin's static data

symbolString

Symbol of a coin

nameString

Name of a coin

iconUrlString

URL to the icon of a coin

linksObject[]

List of links, like social media pages

links.nameString

Name of the link

links.urlString

Url to the specific link

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.
ColorString

of the coin in hexadecimal format

listedAtNumber

Timestamp of when the coin was listed on coinranking

tagsObject[]

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

issuanceBlockchainsObject[]

List of issuance blockchains. This is our name for blockchains where the coin is issued on, which in some cases means multiple blockchains. For example Tether is issued on nine different blockchains.

issuanceBlockchains.nameString

The name of the blockchain

issuanceBlockchains.referenceString

The reference, such as a smart contract address, of a coin on the blockchain