---
title: "Get brand data by crypto symbol"
method: GET
path: "/v2/brands/crypto/{symbol}"
tags: ["brands"]
---

# Get brand data by crypto symbol

`GET /v2/brands/crypto/{symbol}`

Get brand data using a crypto symbol

## Path parameters

- `symbol` string, required

## Query parameters

- `allowNsfw` boolean

## Response `200`

Successful request.

- BrandResponse
  - `id` string — Unique identifier for the brand
  - `name` string, nullable — Brand name
  - `domain` string — Brand website URL
  - `claimed` boolean — Set to true if the owner of the brand claimed its brand profile on [Brandfetch](https://brandfetch.com)
  - `description` string, nullable — Brand description
  - `longDescription` string, nullable — Brand long description
  - `links` object[] — Social media links of the brand
    - `name` 'twitter' | 'facebook' | 'instagram' | 'github' | 'youtube' | 'linkedin' | 'crunchbase' — Name of the social media platform
    - `url` string — URL of the social media profile
  - `logos` object[] — Logos, symbols & icons of the brand
    - `theme` 'dark' | 'light' | 'null', nullable — See logo theme. Possible values: - **dark**: A dark logo should be displayed on a light background (e.g. #ffffff) - **light**: A light logo should be displayed on a dark background (e.g. #000000)
    - `formats` Format[] — A list of format objects containing files in different formats
      - `src` string — File source
      - `format` 'svg' | 'webp' | 'png' | 'jpeg' — File format
      - `height` integer, nullable — File height in pixels
      - `width` integer, nullable — File width in pixels
      - `size` integer — File size in bytes
      - `background` 'transparent', nullable — Indicates if the file has a transparent background
    - `tags` object[] — A list of string attached to the logo. For example, if the logo icon is "photographic" rather than a logomark. Possible values: - **photographic**: The asset image is photographic in nature. For example, if this tag is present on an icon or Logo asset, it means the image has photographic qualities and is likely not a typical brand logotype or logomark graphic. - **portrait**: The asset image is a portrait or portrait-like. This is often the case when a sole proprietorship or small brand uses a self portrait as their logo or icon.
    - `type` 'icon' | 'logo' | 'symbol' | 'other' — See logo type. Possible values: - **icon**: The icon that is used on social profiles (e.g. [Tesla's social icon](https://cdn.brandfetch.io/tesla.com/icon)) - **logo**: The horizontal logo, seen on large surfaces (e.g. [Tesla's logo](https://asset.brandfetch.io/id2S-kXbuK/idAJ5NMLPG.svg)) - **symbol**: The universal mark that abstractly represents the brand (e.g. [Tesla's T symbol](https://asset.brandfetch.io/id2S-kXbuK/idM-t614MT.svg)) - **other**: Other is used to refer to any type of logo that is not the primary one. (e.g. Amazon Kindle Logo)
  - `colors` object[] — Accent, dark, light & palette colors of the brand
    - `hex` string — Color HEX code
    - `type` 'accent' | 'dark' | 'light' | 'brand' — Type of the color. Possible values: - **accent**: The main color that represents the brand (used to draw attention e.g. call to action button) - **dark**: The darker color of the brand (used for surfaces or backgrounds) - **light**: The lighter color of the brand (used for surfaces or backgrounds) - **brand**: The full-color scheme of the brand (used to create color palettes users can pick from)
    - `brightness` number, float — Color brightness. Calculated based on the standard formula 0.2126*R + 0.7152*G + 0.0722*B
  - `fonts` object[] — Title & body fonts of the brand
    - `name` string, nullable — Font family
    - `type` 'title' | 'body' — Font type
    - `origin` 'google' | 'custom' | 'system' — See font origin. Possible values: - **google**: The font that's hosted on Google Font - **custom**: The font that has been uploaded by the brand itself - **system**: The font that's already installed on the user's operating system (see example)
    - `originId` string, nullable — Font origin ID
    - `weights` object[]
  - `images` object[] — Banner, picture & other images of the brand
    - `formats` Format[] — Available formats of the image
      - `src` string — File source
      - `format` 'svg' | 'webp' | 'png' | 'jpeg' — File format
      - `height` integer, nullable — File height in pixels
      - `width` integer, nullable — File width in pixels
      - `size` integer — File size in bytes
      - `background` 'transparent', nullable — Indicates if the file has a transparent background
    - `tags` object[] — Tags associated with the image
    - `type` 'banner' | 'other' | 'picture' — Image type. `picture` entries are photography published on the brand's own site and carry `pictureMetadata`.
    - `pictureMetadata` object — Present on `picture` entries only. Lets you choose between a brand's pictures without fetching the files first.
      - `score` number — How representative of the brand we consider this picture
      - `rank` integer — Position of this picture among the brand's pictures, by descending score
      - `naturalWidth` integer — Intrinsic width of the image in pixels
      - `naturalHeight` integer — Intrinsic height of the image in pixels
      - `alt` string — Alt text published with the image on the brand's site
      - `sourceUrl` string — URL of the image on the brand's own site. A `picture` can arrive with an empty `formats` array, in which case this is how you reach the image.
      - `imageCategory` string, nullable — Category we classified the image into
      - `categoryConfidence` number, nullable — Confidence in the assigned `imageCategory`
  - `qualityScore` number — Score between 0-1 which indicates the quality of the data for the given brand. Useful when you don't want to show lower quality brands to your users. Lower 3rd is poor quality, middle 3rd is OK quality, upper 3rd is high quality. Lower scores indicate that a brand is less likely to be "real". For example, where google.com will score high, my-random-blog.com will score between 0.3-0.4. The score factors in things like data-recency, whether the brand has been claimed, if it has been manually verified by our team, the brand's domain ranking on the web, as well as other factors. Don't rely on a fixed score for any given brand. The way we calculate this score may change over time as we add new factors, or tweak the weights of existing ones such that a score for a given brand may change. However, they will remain aligned such that scores divide quality into thirds: low, medium, high.
  - `company` object — The company object returns firmographic data related to the brand
    - `employees` 1 | 2 | 11 | 51 | 201 | 501 | 1001 | 5001 | 10001, nullable — 1 employee, 2-10 employees, 11-50 employees, 51-200 employees, 201-500 employees, 501-1,000 employees, 1,001-5,000 employees, 5,001-10,000 employees, 10,001+ employees
    - `financialIdentifiers` object, nullable — Object holding financial identifiers
      - `isin` string[] — List of ISIN codes
      - `ticker` string[] — List of Stock or ETF ticker
    - `foundedYear` integer, nullable — The year the brand was founded
    - `industries` Industry[] — An array of industry categories, sorted by descending confidence. See the full list of industries [here](https://docs.google.com/spreadsheets/d/1N44nMfVtPCFM4ebTcmRlqbyxjFtDAGVuqd0mh0dcOU0/edit?usp=sharing)
      - `id` string — Unique identifier for the industry
      - `score` number, float — Score between 0-1 about the confidence in the industry
      - `slug` string — URL friendly identifier
      - `name` string — Name of the industry
      - `emoji` string — An emoji for the industry
      - `parent` IndustryParent[], nullable — If the object is a sub-category, the parent industry
        - `id` string — Unique identifier for the industry
        - `slug` string — URL friendly identifier
        - `name` string — Name of the industry
        - `emoji` string — An emoji for the industry
    - `kind` 'EDUCATIONAL' | 'GOVERNMENT_AGENCY' | 'NON_PROFIT' | 'PARTNERSHIP' | 'PRIVATELY_HELD' | 'PUBLIC_COMPANY' | 'SELF_EMPLOYED' | 'SELF_OWNED', nullable — Organizational Structure
    - `location` Location — Company's headquarter information
      - `city` string, nullable — Headquarter city
      - `country` string, nullable — Headquarter country
      - `countryCode` string, nullable — Headquarter country code (ISO 3166-1 alpha-2)
      - `region` string, nullable — Headquarter region
      - `state` string, nullable — Headquarter state
      - `subregion` string, nullable — Headquarter subregion
  - `isNsfw` boolean — true when the brand is for adult content, e.g. is not safe for work
  - `urn` string — Uniform Resource Name for the brand

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — <Not Found> or <Invalid Crypto Symbol>
- `429` — API key quota exceeded

## Changes

- **2026-08-20** `09c15db0f2cd` — 1 warning, 1 info
  - added the new `picture` enum value to the `images/items/type` response property for the response status `200`
  - added the optional property `images/items/pictureMetadata` to the response with the `200` status

[Change history](https://skmtc.dev/brandfetch/apis/brandfetch-api/changes/v2/brands/crypto/:symbol/get.md)

---

[API](https://skmtc.dev/brandfetch/apis/brandfetch-api.md) · [All operations](https://skmtc.dev/brandfetch/apis/brandfetch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandfetch/brandfetch-api/revisions/09c15db0f2cd/schema)