cryptologo 0.1.2

Rust client for crypto-logo.com — 413 cryptocurrency logos in SVG, PNG, WebP, ICO
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# cryptologo

[![crates.io](https://img.shields.io/crates/v/cryptologo.svg)](https://crates.io/crates/cryptologo)
[![docs.rs](https://docs.rs/cryptologo/badge.svg)](https://docs.rs/cryptologo)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

Rust client for [crypto-logo.com](https://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](https://crypto-logo.com)** — [API docs](https://crypto-logo.com/api/docs/)

## Install

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

## Quick Start

```rust,no_run
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

```rust,no_run
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

```rust,no_run
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

```rust
// 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](https://pypi.org/project/cryptologo/) | `pip install cryptologo` |
| **npm** | [cryptologo](https://www.npmjs.com/package/cryptologo) | `npm install cryptologo` |
| **Go** | [cryptologo-go](https://github.com/dobestan/cryptologo-go) | `go get github.com/dobestan/cryptologo-go` |
| **Ruby** | [cryptologo](https://rubygems.org/gems/cryptologo) | `gem install cryptologo` |

## Embed Widget

Embed [CryptoLogo](https://crypto-logo.com) widgets on any website with [cryptologo-embed](https://widget.crypto-logo.com):

```html
<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](https://widget.crypto-logo.com)

## License

MIT