cryptologo

Rust client for crypto-logo.com — the cryptocurrency logo database with 413 coins in SVG, PNG, WebP, JPEG, and ICO formats. Async API powered by reqwest and serde.

Every logo is available as a scalable SVG vector and pre-generated raster derivatives in 13 standard sizes (16px to 2000px). Logos are served from Cloudflare R2 CDN with immutable cache headers.

Browse logos at crypto-logo.com — API docs

Install

[dependencies]
cryptologo = "0.1"
tokio = { version = "1", features = ["full"] }

Quick Start

use cryptologo::{CryptoLogo, LogoFormat};

#[tokio::main]
async fn main() -> Result<(), cryptologo::Error> {
    let client = CryptoLogo::new();

    // List all 413 coins sorted by market cap
    let coins = client.list_coins().await?;
    for coin in coins.iter().take(3) {
        println!("{} ({}) — rank #{:?}", coin.name, coin.ticker, coin.market_cap_rank);
    }

    // Download Bitcoin SVG logo
    let svg = client.get_logo("bitcoin-btc", LogoFormat::Svg, None).await?;
    std::fs::write("bitcoin.svg", &svg)?;

    // Generate CDN URL for embedding
    let url = client.get_cdn_url("ethereum-eth", LogoFormat::WebP, 128);
    println!("{}", url);
    // https://cdn.crypto-logo.com/logos/ethereum-eth/128x128/transparent.webp

    Ok(())
}

What You Can Do

List Coins

let coins = client.list_coins().await?;
let svg_coins: Vec<_> = coins.iter().filter(|c| c.has_svg).collect();
println!("{} coins have SVG logos", svg_coins.len());

Fetch Logos

use cryptologo::{LogoFormat, LogoOptions};

// SVG vector (no options needed)
let svg = client.get_logo("bitcoin-btc", LogoFormat::Svg, None).await?;

// PNG at 256x256
let opts = LogoOptions { width: Some(256), ..Default::default() };
let png = client.get_logo("bitcoin-btc", LogoFormat::Png, Some(opts)).await?;

// OG image with white background
let og_opts = LogoOptions {
    width: Some(1200), height: Some(630), bg: Some("FFFFFF".into()),
};
let og = client.get_logo("bitcoin-btc", LogoFormat::Png, Some(og_opts)).await?;

CDN URLs

// CDN URL for fast display
let url = client.get_cdn_url("bitcoin-btc", LogoFormat::WebP, 128);
// https://cdn.crypto-logo.com/logos/bitcoin-btc/128x128/transparent.webp

Cryptocurrency Logo Standards

Use Case	Format	Size
Website UI	SVG	Scalable
Exchange listing	PNG	512x512
Social/OG	PNG	1200x630
Favicon	ICO/SVG	32x32

Pre-generated sizes: 16, 32, 48, 64, 96, 120, 128, 200, 256, 400, 512, 1024, 2000.

API Reference

Method	Returns	Description
`CryptoLogo::new()`	`CryptoLogo`	Create client
`list_coins()`	`Result<Vec<Coin>>`	All 413 coins
`get_logo(slug, fmt, opts)`	`Result<Vec<u8>>`	Logo bytes
`get_logo_url(slug, fmt, opts)`	`String`	API URL
`get_cdn_url(slug, fmt, width)`	`String`	CDN URL
`download_logo(slug, fmt, opts, path)`	`Result<()>`	Save to file
`get_asset(path)`	`Result<Vec<u8>>`	Variant/history

Also Available

Platform	Package	Install
PyPI	cryptologo	`pip install cryptologo`
npm	cryptologo	`npm install cryptologo`
Go	cryptologo-go	`go get github.com/dobestan/cryptologo-go`
Ruby	cryptologo	`gem install cryptologo`

Embed Widget

Embed CryptoLogo widgets on any website with cryptologo-embed:

<script src="https://cdn.jsdelivr.net/npm/cryptologo-embed@1/dist/embed.min.js"></script>
<div data-cryptologo="entity" data-slug="example"></div>

Zero dependencies · Shadow DOM · 4 themes (light/dark/sepia/auto) · Widget docs

License

MIT

cryptologo 0.1.2