logostream API

The logostream API serves stock logos, country flags, and cryptocurrency icons. It supports caching, fallbacks, and flexible size/variant options.

API Key Required

To use the logostream API, you need a personal API key.

How to request your API key:

Send an email to sales@logostream.dev with the following information:

Intended use case (e.g., Trading App, Fintech Platform, Banking App)
Domain(s) that will use the API

Base URL

https://api.logostream.dev/

Response Format

Direct image file (SVG, PNG, JPG, WebP, GIF)

Category	Description
`cryptos`	Cryptocurrency icons
`country`	Country flags
`stocks`	Stock logos (via ISIN, Symbol, WKN)
`banks`	Bank logos (via BIC, BLZ)
`forex`	Forex currency icons (via currency code)

Endpoints & Parameters

GET

/stocks/:idType/:identifier

Path Parameters

idType

Options: isin, symbol, wkn, crypto

identifier

e.g., US0378331005 (ISIN) or AAPL (symbol)

Query Parameters

keyRequired

Your personal API key (contact sales@logostream.dev to obtain one)

variant

Options: xs (small icons), logo (full wordmark logo), icon (default icon), transparent (icon with a transparent background)

format

Options: svg, png, jpg, webp, gif

size

Optional, e.g., 100x100 for resize

Example

GET /stocks/symbol/AAPL?key=YOUR_API_KEY&variant=logo&format=svg

Response

The API returns the image file directly. The Content-Type header reflects the file type (image/svg+xml, image/png, etc.).

Response Codes

200

The logo image

400

Invalid category or missing parameters

404

Logo not found

500

Internal error (e.g., Supabase or Worker issue)

Code Examples

import http.client

conn = http.client.HTTPSConnection("api.logostream.dev")
conn.request("GET", "/stocks/isin/US89X4X18105")

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

API Integration Examples