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 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.
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
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"
}
]
}
]
Name | Type | Description |
---|---|---|
_ | 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 |