Crypto Metadata API
Description, links, logo, colour, supply, all-time high, tags and contract addresses for 2.3M+ coins from one endpoint, on every plan. Logos as SVG, PNG or WebP at any size.
30 days free, then $199 a month. Card required, cancel any time.
Free · https://api.coinranking.com/v2/coin/:uuid · bulk and contract lookup on Professional
# Everything about one coin: description, links, logo, supply, tags, contracts
curl 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd' \
-H 'x-access-token: YOUR_KEY'Everything a Coin Page Needs, from Seven Endpoints
What a coin is, where to read more, what it looks like, how much exists and where it lives on-chain.
- GET/coin/:uuid
Description, links, logo, colour, supply, all-time high, market and exchange counts, tags, contract addresses, listing date, CoinGecko and CoinMarketCap IDs.
- GET/tags
Coins, exchanges, markets, fiat, categories, commodities, indices and stocks by name, symbol or contract address.
- GET/assets
Resolve any token address on a supported blockchain to its coin, with every contract address the coin has.
The locked and reserved addresses subtracted from total supply to reach circulating supply.
- GET/bulk/coins
The entire coin set with metadata as gzip JSON. Refreshed every ten minutes, 25 requests a day.
Logos in the Format and Size Your Client Renders
Change the extension of any iconUrl for PNG or WebP and add ?size= for exact dimensions. No image pipeline.
| URL | Use it for | |
|---|---|---|
| SVG | …/bitcoin_btc.svg | Web pages and any client that renders SVG. Scales perfectly, smallest at small sizes. |
| PNG | …/bitcoin_btc.png?size=28x28 | Email, legacy clients, image tooling. Broadest compatibility. |
| WebP | …/bitcoin_btc.webp?size=56x56 | Native mobile apps and modern browsers. Typically 30–60% smaller than PNG. |
| Retina | srcset … 1x, … ?size=56x56 2x | Request only the sizes you display; smaller sizes are cheaper and faster. |
What Developers Build on Metadata
A price is a number; metadata makes the row recognisable.
Coin Pages
Description, links, supply, ATH and logo from one call, with the brand colour for the chart line.
Wallet Token Lookup
Paste a contract address, get the coin. Works through search on any plan and the blockchain endpoint on Professional.
Category Screens
Tags with their market cap and volume, and /coins filtered by tag for the list beneath.
In-House Mirrors
Bulk export the whole set hourly, then keep the majors live from the socket.
Metadata by Plan
Coin details, tags, search and logos are on every plan, including Free. Contract-address lookup, supply modifiers and the bulk export need the Professional plan.
| Free · $0 | Startup · $49/mo | Professional · $199/mo | |
|---|---|---|---|
| Price | $0 | $49 | $199 |
| Coin details, tags, search, assets, logos | Included | Included | Included |
| UUID by contract address | — | — | Included |
| Supply modifiers | — | — | Included |
| Bulk coins export | — | — | 25 requests a day |
| Free trial | — | 30 days | 30 days |
30-day free trial on Professional. Compare every plan.
Metadata Questions
Coinranking API's coin details endpoint returns a coin's name, symbol, description, brand colour, logo URL, website, social and repository links, circulating, total and max supply, all-time high with its timestamp, number of markets and exchanges, tags, contract addresses per blockchain, listing date, and its CoinGecko and CoinMarketCap IDs. It is on every plan. See coin details.
Yes. Every coin, exchange, market, fiat currency and category in Coinranking API carries an iconUrl pointing to an SVG on Coinranking's CDN. Replace .svg with .png or .webp for a raster version, and append ?size=WIDTHxHEIGHT for exact pixel dimensions; the CDN converts on demand and caches at the edge. See the icons docs.
Call GET /blockchain/:blockchain/:address on Coinranking API with the blockchain name and the token's address, case-insensitive, and it returns the coin's UUID, name, symbol and every contract address the coin has across chains. The endpoint is Professional. On any plan, GET /search-suggestions?query= also accepts a full contract address and returns matching coins.
Yes. Coinranking bulk coins endpoint streams the entire coin set with full metadata as gzip-compressed JSON in one request, refreshed every ten minutes and limited to 25 requests a day. It is a Professional endpoint, built for teams that mirror the dataset in-house and use the regular or streaming endpoints for live prices.
Tags are Coinranking's categories: DeFi, stablecoins, meme coins, layer-1, staking, large cap, small cap and more. GET /tags lists every tag with its coin count, market cap and volume, each coin carries its tags, and /coins?tags[]= filters the coin list by category. Tags are on every plan. See tags.
Yes. Coin details carry circulating, total and max supply with a confirmed flag and timestamp on every plan. The Professional supply modifiers endpoint lists the locked and reserved addresses subtracted from total supply to reach circulating supply, and supply history tracks the figures over time.
More of Coinranking API
Same key, same base URL.
Get the Coin Metadata
Descriptions, logos, links and supply on a free key today. Contract lookup and the bulk export are free for 30 days on Professional.
30 days free, then $199 a month. Card required, cancel any time.