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.

Rate limits

The rate limits for the metadata 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 metadata of all coins

professional This endpoint requires the professional 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
https://api.coinranking.com/v2/metadata/coins

Code examples

Response

HTTP/1.1 200 OK
[
  {
    "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"
      }
    ],
    "color": "#22a079",
    "listedAt": 1420761600,
    "tags": [
      "stablecoin"
    ],
    "maxSupply": null,
    "issuanceBlockchains": [
      {
        "name": "Avalanche",
        "reference": "0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7 "
      },
      {
        "name": "Ethereum",
        "reference": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    ]
  }
]

Response fields

NameTypeDescription
_Object[]

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

_.tagsString[]

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