API Reference
Crypto Logo API
Crypto Logo API allows you to retrieve logos based on cryptocurrency symbols, providing both high-quality images and fallback options when a logo is not available.
/crypto/{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):
<img src="https://img.BrandSearch.com/crypto/BTC?token=<publishable-api-token>" alt="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
Retrieve logo for Ethereum cryptocurrency
https://img.BrandSearch.com/crypto/ETH?token=<publishable-api-token>Get light monogram fallback for non-existent logo
https://img.BrandSearch.com/crypto/NONEXISTENT?token=<publishable-api-token>&fallback=monogram-lightGet 404 HTTP response for non-existent logo
https://img.BrandSearch.com/crypto/NONEXISTENT?token=<publishable-api-token>&fallback=404Parameters
Path Parameters
| Parameter | Type | Description |
|---|---|---|
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
| Parameter | Type | Description |
|---|---|---|
token | string (required) | Publishable API token for authentication. You can find yours in account settings. |
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). |
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. |
Response
200 - Logo image found and returned as PNG
The response is of type file (image/png).