---
title: "Get ERC20 token balances"
method: GET
path: "/v1/account/tokens"
tags: ["Token Balances"]
---

# Get ERC20 token balances

`GET /v1/account/tokens`

Retrieve all token balances for all ERC20 tokens for a specified address.

By default, it will return all token balances for all ERC20 tokens that the address has ever received.
You can specify a contract address to check the balance of a non-standard contract.

## Query parameters

- `chain_id` string, required — chain network id, see [list of details](/platform/features/api/web3-api)
- `address` string, required — A hex string referencing a wallet address
- `contract_address` string — The address of the token contract, or filter multiple addresses, (max 100), eg:contract_address=0xdac17f958d2ee523a2206206994597c13d831ec7,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
- `limit` integer — The desired page size limit. Less or equal than 100
- `page` integer — The page offset

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- ResponseGetAccountTokens
  - `code` integer
  - `message` string
  - `data` TokenMeta[]
    - `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.
    - `balance` string, required — The balance of the ERC-20 token for a given wallet.
  - `next_page` integer
  - `count` integer

## 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)