API Documentation

Free, public API for cryptocurrency logo images. No API key required. All responses include CORS headers for browser usage.

OpenAPI Schema Swagger UI

Logo Image

GET /api/logo/{slug}.{format}

Returns a pre-generated logo derivative. If a requested size/format/background is not pre-generated, the API returns 404.

Path Parameters

Parameter	Type	Description
slug	string	Coin identifier (e.g., `bitcoin-btc`, `ethereum-eth`)
format	string	Output format: `png`, `svg`, `webp`, `jpeg`, `ico`

Query Parameters

Parameter	Type	Default	Description
w	integer	—	Output width in pixels (must match a pre-generated size)
h	integer	—	Output height in pixels (must match a pre-generated size)
bg	string	transparent	Background hex color without # (only supported for specific presets)
size	integer	—	ICO size shorthand (sets both w and h)

Pre-generated Sizes

16 32 48 64 96 120 128 200 256 400 512 1024 2000

Square derivatives are pre-generated only for the sizes above (transparent background).

ICO is pre-generated only for: 16, 32, 48, 64, 128, 256.

OG preset(s): 1200x630 with background FFFFFF (PNG only).

Examples

GET /api/logo/bitcoin-btc.png?w=128&h=128
GET /api/logo/ethereum-eth.svg
GET /api/logo/solana-sol.webp?w=256&h=256
GET /api/logo/cardano-ada.jpeg?w=512&h=512
GET /api/logo/cardano-ada.ico?size=32
GET /api/logo/bitcoin-btc.png?w=1200&h=630&bg=FFFFFF

Response Headers

Header	Value
Cache-Control	`public, max-age=31536000, immutable`
Access-Control-Allow-Origin	`*`
Content-Type	`image/png`, `image/svg+xml`, `image/webp`, `image/jpeg`, or `image/x-icon`

Try It

Coin Slug

Format

Size

Background

/api/logo/bitcoin-btc.png?w=128

Coins List

GET /api/coins.json

Returns a JSON array of all active coins with metadata for building search interfaces.

Response Format

[
  {
    "name": "Bitcoin",
    "ticker": "BTC",
    "slug": "bitcoin-btc",
    "has_png": true,
    "has_svg": true,
    "search_terms": ["비트코인", "ビットコイン", "比特币"]
  },
  ...
]

Response Headers

Header	Value
Cache-Control	`public, max-age=3600`
Content-Type	`application/json`

Asset Files

GET /api/asset/{file_path}

Serves logo variant and history files from the assets directory. Used for alternate logo designs and historical versions.

Usage Guidelines

No API key or authentication required
All images are cached with immutable headers (1 year)
Free for commercial and non-commercial use
Please cache responses on your end when possible
For bulk downloads, consider cloning our assets directly

Available Coins

410+ cryptocurrency logos available. Browse all coins on the homepage or use the /api/coins.json endpoint to get the full list programmatically.