/api/v1/tickers/logos/domain/{symbol}Get the website domain for a stock ticker.
Get the website domain for a stock ticker. Returns a Google S2 favicon URL (128px) derived from the company website. Useful for displaying company logos without maintaining a logo database.
Why use this
Common use case
Single-ticker logo/domain lookup — returns the company website domain plus a Google S2 favicon URL at 128×128 resolution. Useful for: portfolio-table row icons, watchlist company-logo chips, news-feed thumbnail placeholders. The 1-token cost makes this safe to call on every row. For batch lookup (e.g. all 50 tickers in a portfolio view) prefer GET /api/v1/tickers/logos/domains — one call returns the full map. Domain mapping is sourced from FinRadar's hand-curated top-3000 list with Yahoo Finance fallback for the long tail.
Parameters
| Name | In | Required | Default | Allowed | Description | Example |
|---|---|---|---|---|---|---|
| symbol | path | required | — | — | Stock ticker (canonical hyphen form). Server normalizes case + dot/slash variants. Multi-class issuers preserve their share-class suffix (`BRK-A` and `BRK-B` both map to `berkshirehathaway.com`). Returns 404 for unknown symbols. | AAPL |
Response schema
| Field | Type | Nullable | Description |
|---|---|---|---|
| symbol | string | no | Ticker echoed back in canonical hyphen form. |
| domain | string | yes | Company website domain (e.g. `apple.com`, `microsoft.com`, `nvidia.com`). Sourced from FinRadar's curated ticker→domain mapping (~7,500 entries) — primary mapping is hand-curated for the top-3000 tickers; fallback uses Yahoo Finance company-website field. Null for issuers without a discoverable corporate website (rare; mostly small-cap shell companies or pre-IPO ADRs). |
| logo | string | yes | Google S2 favicon URL at 128×128 resolution (`https://www.google.com/s2/favicons?domain={domain}&sz=128`). Free unauthenticated CDN; no rate limits for client-side `<img>` rendering. Null when `domain` is null. For higher-resolution / brand-asset logos use external services (Clearbit, etc.) — Google S2 caps at 128px. |
| cached | boolean | no | Boolean: `true` when the response came from FinRadar's 24h server-side cache (most calls), `false` on the rare cache-miss path (refresh ~5-10ms slower). |
Sample response
- "symbol": "AAPL"
- "domain": "apple.com"
- "logo": "https://www.google.com/s2/favicons?domain=apple.com&sz=128"
- "cached": true
Errors
| Status | Label | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid query, body, or path parameter. |
| 401 | Unauthorized | Missing or invalid Authorization header / api_Token. |
| 402 | Payment Required | Insufficient token balance for this call. Top up |
| 429 | Too Many Requests | Rate limit exceeded for your tier (see /pricing for tier limits). Tier limits |
| 500 | Server Error | Unexpected server-side failure. Retry with backoff; report if persistent. |
Code samples
curl "https://api.finradar.ai/api/v1/tickers/logos/domain/{symbol}?api_Token=YOUR_API_KEY" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"Generate an API key in /account/credentials to run live queries (literal YOUR_API_KEY placeholder shown until then).