API Reference
Stock Logo API
Stock Logo API allows you to retrieve logos based on a stock exchange ticker, providing both high-quality images and fallback options when a logo is not available.
/ticker/{symbol}Basic Usage
Stock Logo API works through hotlinking stock ticker logos 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 snippet demonstrates how to retrieve a logo for stock ticker AAPL:
<img src="https://img.BrandSearch.com/ticker/AAPL?token=<publishable-api-token>" alt="AAPL logo (identification only, no affiliation)" />By default, only the most popular exchanges are enabled on a new account. If you require access to additional exchanges, please contact us to enable them for you.
Supported Ticker Formats
The API supports a wide range of ticker formats across different exchanges and identification schemes. If no exchange or composite code is specified, US is assumed. For example, all
of the following identifiers can be used to retrieve the logo for specified companies:
Apple Inc
- Standard Exchange Tickers:
AAPL/AAPL:US - Example Exchange-Specific Tickers:
APC.DE,APC.F,APC:GR,AAPL34.SA,AAPL34:BZ - Identification Numbers:
- CUSIP:
037833100 - SEDOL:
2046251 - ISIN:
US0378331005 - WKN:
865985
- CUSIP:
Roche Holding AG (voting, non-voting, ADR)
- Standard Exchange Tickers:
RO:SW,ROG:SW,RHHBY/RHHBY:US - Example Exchange-Specific Tickers:
ROGN:MM,RHO6.F - Identification Numbers:
- CUSIP:
S71103881,S71089189,771195104 - SEDOL:
7110388,7108918,BYZHCK7 - ISIN:
CH0012032113,CH0012032048,US7711951043 - WKN:
851311,855167,891106
- CUSIP:
We continuously expand our coverage of global exchanges and ticker formats. If you need support for specific exchanges or identification schemes not currently available, please reach out to us.
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 Nvidia stock ticker
https://img.BrandSearch.com/ticker/NVDA?token=<publishable-api-token>Retrieve logo for Vanguard Total Stock Market Index Fund ETF using its ISIN
https://img.BrandSearch.com/ticker/US9229087690?token=<publishable-api-token>Retrieve logo for USD currency for positions and spot rates
https://img.BrandSearch.com/ticker/USD?token=<publishable-api-token>Parameters
Path Parameters
| Parameter | Type | Description |
|---|---|---|
symbol | string (required) | The stock ticker symbol for which to retrieve the logo. For example, AAPL. We support all major stock exchanges worldwide, including NYSE, NASDAQ, TSE, LSE, SZSE, Euronext,
Deutsche Boerse and more. Example: "AAPL" |
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).