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

# Company Logos

> Render NGX company logos in your app, and go beyond the default PNG when you need to.

Every company response from the API includes a `logo_url` field. It's a ready-to-use PNG that needs no extra setup. For most apps, that's all you need.

```json theme={null}
{
  "symbol": "DANGCEM",
  "company_name": "Dangote Cement Plc",
  "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/DANGCEM.png"
}
```

**Endpoints that include `logo_url`:**

* [`GET /companies`](/api-reference/companies/list)
* [`GET /companies/{symbol}`](/api-reference/companies/detail)
* [`GET /market/top-trades`](/api-reference/market/top-trades)
* [`GET /market/movers`](/api-reference/market/movers)

```javascript JavaScript theme={null}
const res = await fetch('https://api.ngnmarket.com/v1/companies/DANGCEM', {
  headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
});
const { data } = await res.json();

document.getElementById('logo').src = data.logo_url;
```

## When you need more than the default PNG

`logo_url` always points to a 200×200 PNG on a CDN. If you need a different format or size, or want logos bundled into your own build instead of hotlinking a third-party CDN, use [`ngx-logos`](https://www.npmjs.com/package/ngx-logos) directly.

It's the same community-maintained package that `logo_url` is generated from, and it also ships WebP and favicon-sized ICOs (16/32/48px), which the API doesn't expose.

```bash theme={null}
npm install ngx-logos
```

```javascript JavaScript theme={null}
const { getLogoPath, getLogoUrl, listSymbols } = require('ngx-logos');

getLogoPath('DANGCEM', 'png');   // absolute path on disk, useful in Node/build tools
getLogoUrl('DANGCEM', 'webp');   // CDN URL, any of the three formats
listSymbols();                   // every ticker with a logo available
```

### Bulk-copy logos into your project

The CLI copies whichever formats and symbols you need straight into your app. This is handy for a build step that bundles logos as static assets instead of fetching them at runtime.

```bash theme={null}
# All PNGs into ./public/logos
npx ngx-logos copy

# Specific formats and destination
npx ngx-logos copy --formats=png,webp --dest=./public/logos

# Just the symbols you actually use
npx ngx-logos copy --formats=png --symbols=DANGCEM,GTCO --dest=./assets

# See every available symbol
npx ngx-logos list
```

### Direct CDN URLs, no install needed

If you just want a URL for a specific format the API doesn't return, jsDelivr serves the package directly:

```
https://cdn.jsdelivr.net/npm/ngx-logos/dist/webp/DANGCEM.webp
https://cdn.jsdelivr.net/npm/ngx-logos/dist/ico/GTCO.ico
```

<Note>
  Logos are community-maintained and licensed for use as a convenience resource. Brand assets remain the property of their respective companies. See the [package's license](https://github.com/ngnmarket/ngx-logos/blob/main/LICENSE) for details.
</Note>

<CardGroup cols={2}>
  <Card title="List companies reference" icon="book" href="/api-reference/companies/list">
    See `logo_url` alongside price, market cap, and sector fields
  </Card>

  <Card title="ngx-logos on GitHub" icon="github" href="https://github.com/ngnmarket/ngx-logos">
    Source, CONTRIBUTING guide, and the full list of formats
  </Card>
</CardGroup>