Skip to main content
GET
Retrieve logo by cryptocurrency symbol

Basic Usage

Crypto Logo API works through hotlinking logos of different cryptocurrencies directly into your app or website. Simply use an image tag, and the logos will load directly from our global CDN. This approach ensures you always display the most current logo versions without managing logo files yourself. Since our service is designed for hotlinking, please note that caching or storing the logo images locally is not supported. This HTML snippet demonstrates how to retrieve a logo for BTC (Bitcoin):
BTC logo (identification only, no affiliation)

Limitations

Our Free Logo API plan is limited to 64x64px logos and require an attribution link. Upgrade to a paid plan for high resolution logos, increased rate limits and no attribution.

Examples

Let’s say you want to retrieve the logo for Ethereum (ETH). You can do this by using the following URL:
ETH logo (identification only, no affiliation)
If you want to receive a light variant of the monogram fallback when the logo is not available, you can use the fallback parameter in the URL and set it to monogram-light. This is useful for light-themed applications where you want a fallback with a light background.
Request
This will return a light monogram image generated from the first three letters of the cryptocurrency symbol with a light background, perfect for light-themed interfaces.
INV logo
If you want to receive a 404 HTTP response when the logo is not available, you can use the fallback parameter in the URL and set it to 404. This is useful for handling cases where the logo is not found, and you want to handle it in your application.
Request
HTTP Response

Path Parameters

symbol
string
required

The cryptocurrency symbol for which to retrieve the logo. For example, BTC for Bitcoin or ETH for Ethereum. We support over 12,000 cryptocurrencies.

Example:

"BTC"

Query Parameters

token
string
default:YOUR-API-TOKEN
required

Publishable API token for authentication. You can find yours in account settings.

Example:

"<publishable-api-token>"

size
enum<number>

Size of the logo to return. Allowed values are 64, 128, or 256. Default is 64px for free users, 128px for paid users. Set to 256px for high-resolution logos (paid users only).

Available options:
64,
128,
256
fallback
enum<string>
default:monogram

Fallback behavior if the logo is not available. 'monogram': Returns a monogram image from the first letter of the symbol (default). 'monogram-light': Returns a light variant of the monogram with light background. '404': Returns a 404 HTTP error.

Available options:
monogram,
monogram-light,
404

Response

Logo image found and returned as PNG.

The response is of type file.