Crypto Metadata API
Description, links, logo, colour, supply, all-time high, tags and contract addresses for 2.4M+ coins from one endpoint, on every plan. Logos as SVG, PNG or WebP at any size.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.
Free · https://api.coinranking.com/v2/coin/:uuid · bulk on Professional; contract lookup on Growth
# 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.
Endpoints marked Growth have production access on Growth and higher. Free, Basic and Startup can make five successful preview requests per eligible endpoint, per account, each UTC day. Normal usage and plan limits apply. How previews work.
- 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 Growth, with previews on lower plans.
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 lookup and supply modifiers have production access on Growth, with previews on lower plans. Bulk export requires Professional and has no preview.
| Free | Basic | Startup | Growth | Professional | |
|---|---|---|---|---|---|
| Monthly price | $0 | $24 | $49 | $99 | $199 |
| Monthly credits | 10,000 | 500,000 | 1,000,000 | 2,000,000 | 5,000,000 |
| REST rate limit | 5 / second | 1,000 / minute | 2,000 / minute | 4,000 / minute | 6,000 / minute |
| API keys | 1 | 1 | 2 | 5 | Unlimited |
| Historical window, where supported | 1 year | 5 years | All time (from 2010) | All time (from 2010) | All time (from 2010) |
| Maximum results per response | 100 | 5,000 | 5,000 | 5,000 | 5,000 |
Endpoint-specific limits may be lower. Preview allowances are shared across every API key on your account. Every paid plan offers a 30-day free trial. Compare all features.
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. Production access starts on Growth, with daily previews on Free, Basic and Startup. 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 Growth 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. Try contract lookup through daily previews, or start a 30-day paid-plan trial. Bulk export starts on Professional.
10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.