---
title: "Get token metadata"
method: GET
path: "/v1/token/metadata"
tags: ["Token Metadata"]
---

# Get token metadata

`GET /v1/token/metadata`

Get the metadata of a specified token.

## Query parameters

- `chain_id` string, required — chain network id, see [list of details](/platform/features/api/web3-api)
- `contract_address` string, required — The address of the token contract

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- ResponseGetTokenMetadata
  - `code` integer
  - `message` string
  - `data` TokenMetaBase
    - `contract_address` string, required — ERC-20 contract address.
    - `decimals` integer, required — The number of decimals the token uses.
    - `name` string, required — The name of the ERC-20 token.
    - `symbol` string, required — The symbol of the ERC-20 token.
    - `total_supply` string — The total supply of the ERC-20 token.
    - `logos` TokenMetaLogo[] — List of logo images for the ERC-20 token.
      - `uri` string, required — URI for the logo image.
      - `width` integer, required — The logo image's approximate width in pixels.
      - `height` integer, required — The logo image's approximate height in pixels.
    - `urls` TokenMetaURL[] — List of urls for the ERC-20 token.
      - `name` string, required — The name of the link.
      - `url` string, required — The URL of the link.
    - `current_usd_price` number — The current price of the ERC-20 token in USD.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/chainbase/apis/data-cloud-task-api.md) · [All operations](https://skmtc.dev/chainbase/apis/data-cloud-task-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainbase/data-cloud-task-api/revisions/4013781aa422/schema)