Metadata

Metadata is the static part of our data, i.e. the data that does not automatically change. 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 than 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

PropertyDescription
_ Object[]

The response is a list of objects of all our coins

_.uuid String

UUID of a coin; a unique identifier

_.updatedAt Number

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

_.symbol String

Symbol of a coin

_.name String

Name of a coin

_.iconUrl String

URL to the icon of a coin

_.links Object[]

List of links, like social media pages

_.links.name String

Name of the link

_.links.url String

Url to the specific link

_.links.type String

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.
_.color String

of the coin in hexadecimal format

_.listedAt Number

Timestamp of when the coin was listed on coinranking

_.tags String[]

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

_.issuanceBlockchains Object[]

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.name String

The name of the blockchain

_.issuanceBlockchains.reference String

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

On this page