---
title: "Returns information about the given token by its symbol for the given blockchain"
method: GET
path: "/v1/token/{blockchain}/by-symbol/{symbol}"
tags: ["Entity"]
---

# Returns information about the given token by its symbol for the given blockchain

`GET /v1/token/{blockchain}/by-symbol/{symbol}`

## Request

- Base URL: `https://backend.swap.coffee`
- URL: `https://backend.swap.coffee/v1/token/{blockchain}/by-symbol/{symbol}`
- Auth: one of:
  - none
  - API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/swap/apis/swap-coffee-api/docs/v1/token/:blockchain/by-symbol/:symbol/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `blockchain` string, required
- `symbol` string, required

## Response `200`

tokens

- ApiToken[]
  - `address` ApiTokenAddress, required
    - `blockchain` string, required
    - `address` string, required
  - `metadata` ApiTokenMetadata, required
    - `name` string, required
    - `symbol` string, required
    - `decimals` integer, required
    - `image_url` string
    - `listed` boolean, required
    - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required

## Other responses

- `default`: Some error during request processing

---

[API](https://skmtc.dev/swap/apis/swap-coffee-api.md) - [All operations](https://skmtc.dev/swap/apis/swap-coffee-api/llms.txt) - [OpenAPI document](https://skmtc.dev/swap/apis/swap-coffee-api/revisions/88f42fef59b7?raw)