> ## Documentation Index
> Fetch the complete documentation index at: https://docs.logokit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## 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`:

```html theme={null}
<img src="https://img.logokit.com/ticker/AAPL?token=<publishable-api-token>" alt="AAPL logo (identification only, no affiliation)" />
```

<Frame>
  <img src="https://mintcdn.com/usefulcollective/4lAPrWb_Bqt_x98x/images/apple.png?fit=max&auto=format&n=4lAPrWb_Bqt_x98x&q=85&s=d88da131061a45bfebbd1ab441177d18" width="128" height="128" data-path="images/apple.png" />
</Frame>

<Note>
  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.
</Note>

## 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`

### 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`

<Note>
  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.
</Note>

## Limitations

<Info>
  Our Free Logo API plan is limited to 64x64px logos and require an [attribution](/attribution) link. [Upgrade ](https://logokit.com/pricing) to a paid plan for high resolution logos, increased rate limits and no attribution.
</Info>

## Examples

<AccordionGroup>
  <Accordion title="Retrieve logo for Nvidia stock ticker">
    To retrieve the logo for the NASDAQ's ticker `NVDA`, you can
    use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/NVDA?token=<publishable-api-token>" alt="NVDA logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img src="https://mintcdn.com/usefulcollective/4lAPrWb_Bqt_x98x/images/nvda.png?fit=max&auto=format&n=4lAPrWb_Bqt_x98x&q=85&s=5757a73045cbf771f36221928db5e026" alt="NVDA logo (identification only, no affiliation)" width="128" height="128" data-path="images/nvda.png" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for Vanguard Total Stock Market Index Fund ETF using its ISIN">
    For the Vanguard Total Stock Market Index Fund ETF using its ISIN `US9229087690`, you can use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/US9229087690?token=<publishable-api-token>" alt="Vanguard Total Stock Market Index Fund ETF logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img src="https://mintcdn.com/usefulcollective/4lAPrWb_Bqt_x98x/images/vti.png?fit=max&auto=format&n=4lAPrWb_Bqt_x98x&q=85&s=28ce21d69c74190ae25737322eb2357f" alt="Vanguard Total Stock Market Index Fund ETF logo (identification only, no affiliation)" width="128" height="128" data-path="images/vti.png" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for Vanguard FTSE All-World UCITS ETF using its ticker">
    When you need the logo for the Vanguard FTSE All-World UCITS ETF using its ticker `VWRL` traded on the London Stock Exchange, you can use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/VWRL:LN?token=<publishable-api-token>" alt="Vanguard FTSE All-World UCITS ETF logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img src="https://mintcdn.com/usefulcollective/4lAPrWb_Bqt_x98x/images/vti.png?fit=max&auto=format&n=4lAPrWb_Bqt_x98x&q=85&s=28ce21d69c74190ae25737322eb2357f" alt="Vanguard Total Stock Market Index Fund ETF logo (identification only, no affiliation)" width="128" height="128" data-path="images/vti.png" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for USD currency for positions and spot rates">
    To get the logo for the USD currency, use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/USD:CUR?token=<publishable-api-token>" alt="USD" />
    ```

    <Frame>
      <img src="https://mintcdn.com/usefulcollective/4lAPrWb_Bqt_x98x/images/USD.png?fit=max&auto=format&n=4lAPrWb_Bqt_x98x&q=85&s=f3d24556e1f4b0b8b630e907d1d50649" alt="USD" width="128" height="128" data-path="images/USD.png" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for USD to EUR FX rate">
    Here's how to retrieve the logo for the USD to EUR FX rate using the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/USDEUR:CUR?token=<publishable-api-token>" alt="USD to EUR FX rate" />
    ```

    <Frame>
      <img src="https://mintcdn.com/usefulcollective/4lAPrWb_Bqt_x98x/images/USDEUR.png?fit=max&auto=format&n=4lAPrWb_Bqt_x98x&q=85&s=3313eedd060ed6aaf16e930a163f36b0" alt="USD to EUR FX rate" width="128" height="128" data-path="images/USDEUR.png" />
    </Frame>
  </Accordion>

  <Accordion title="Get light monogram fallback for non-existent logo">
    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.

    ```md Request theme={null}
    https://img.logokit.com/ticker/INVALID?fallback=monogram-light&token=<publishable-api-token>
    ```

    This will return a light monogram image generated from the first three letters of the ticker symbol with a light background, perfect for light-themed interfaces.

    <Frame>
      <img src="https://mintcdn.com/usefulcollective/4lAPrWb_Bqt_x98x/images/INV.png?fit=max&auto=format&n=4lAPrWb_Bqt_x98x&q=85&s=25f1865541e5cc6a459d38b86581db9f" alt="INV logo" width="256" height="256" data-path="images/INV.png" />
    </Frame>
  </Accordion>

  <Accordion title="Get 404 HTTP response for non-existent 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.

    ```md Request theme={null}
    https://img.logokit.com/ticker/INVALID?fallback=404&token=<publishable-api-token>
    ```

    ```bash HTTP Response theme={null}
      404 Not Found
    ```
  </Accordion>
</AccordionGroup>

## Parameters


## OpenAPI

````yaml GET /ticker/{symbol}
openapi: 3.0.3
info:
  title: LogoKit Logo API
  version: 1.0.0
  description: >-
    The LogoKit Logo API allows you to retrieve company logos by domain,
    providing high-quality PNG images via hotlinking. Supports fallback options
    and attribution for free users.
servers: []
security: []
tags:
  - name: Logo API
    description: Operations for retrieving company logos by domain
  - name: Stock Logo API
    description: Operations for retrieving logos by stock ticker symbols
  - name: Crypto Logo API
    description: Operations for retrieving logos by cryptocurrency symbols
  - name: Brand API
    description: Operations for retrieving comprehensive brand information
externalDocs:
  description: LogoKit Documentation
  url: https://docs.logokit.com
paths:
  /ticker/{symbol}:
    get:
      tags:
        - Stock Logo API
      summary: Retrieve logo by stock ticker symbol
      description: >-
        Returns the logo for the specified stock ticker as a PNG image. Free
        users: 64x64px. Paid users: 128x128px. Caching or local storage of
        images is not supported.
      operationId: getLogoTicker
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
            example: AAPL
          description: >-
            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.
        - name: token
          in: query
          required: true
          schema:
            type: string
            example: <publishable-api-token>
            default: YOUR-API-TOKEN
          description: >-
            Publishable API token for authentication. You can find yours in
            [account settings](https://logokit.com/account/api-tokens).
        - name: size
          in: query
          required: false
          schema:
            type: number
            enum:
              - 64
              - 128
              - 256
            default: null
          description: >-
            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).
        - name: fallback
          in: query
          required: false
          schema:
            type: string
            enum:
              - monogram
              - monogram-light
              - '404'
            default: monogram
          example: monogram
          description: >-
            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.
      responses:
        '200':
          description: Logo image found and returned as PNG.
          content:
            image/png:
              schema:
                type: string
                format: binary
        '401':
          description: Invalid or missing API token.
        '404':
          description: Logo not found (only if `fallback=404` is used).
        '429':
          description: Rate limit exceeded.
      servers:
        - url: https://img.logokit.com
          description: Image API server

````