# Cryptocurrency Logos

> Logos for 20,000+ cryptocurrencies including Bitcoin, Ethereum, Solana, and tokens across 50+ chains. Powered by CoinGecko data.

## How It Works

1. **Symbol or address lookup** — `img.loadlogo.com/crypto/{symbol}` for tokens by symbol, or `img.loadlogo.com/crypto/{chainId}/{address}` for on-chain tokens.
2. **CoinGecko search** — Resolves symbols to token metadata and logo URLs via CoinGecko's API.
3. **Logo caching** — Fetched logos are stored in R2 for edge-cached delivery.
4. **Metadata endpoint** — `api.loadlogo.com/crypto/{symbol}` returns JSON with symbol, name, and logo URL.

## Benefits

- 20,000+ tokens supported via CoinGecko
- Major tokens: BTC, ETH, SOL, ADA, DOGE, XRP, DOT, AVAX, MATIC, LINK
- On-chain token lookup by chain ID + contract address
- Blockchain chain logos via `/blockchain/{id}`
- Edge-cached for instant delivery
- Smart conflict resolution for duplicate symbols

## Code Example

```html
<!-- Crypto logos by symbol -->
<img src="https://img.loadlogo.com/crypto/btc" alt="Bitcoin" />
<img src="https://img.loadlogo.com/crypto/eth" alt="Ethereum" />
<img src="https://img.loadlogo.com/crypto/sol" alt="Solana" />

<!-- On-chain token by address -->
<img src="https://img.loadlogo.com/crypto/8453/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" alt="USDC on Base" />

<!-- Blockchain chain logo -->
<img src="https://img.loadlogo.com/blockchain/8453" alt="Base" />
```

## Related

- [Stock Ticker Logos](/features/stock-tickers.md)
- [Portfolio Trackers Use Case](/use-cases/portfolio-trackers.md)
- [Full API Reference](/docs.md)