---
title: "List token balances for an address with pagination and type filtering"
method: GET
path: "/{chain_id}/api/v2/addresses/{address_hash_param}/tokens"
tags: ["addresses"]
---

# List token balances for an address with pagination and type filtering

`GET /{chain_id}/api/v2/addresses/{address_hash_param}/tokens`

Retrieves token balances for a specific address with pagination and filtering by token type. Useful for displaying large token portfolios.

## Path parameters

- `address_hash_param` string, required
- `chain_id` string, required

## Query parameters

- `type` union
  - string
  - string
- `items_count` integer
- `fiat_value` union
  - string
  - string
  - string
- `id` integer
- `value` union
  - string
  - string
  - string

## Response `200`

Token balances for the specified address with pagination.

- object
  - `items` TokenBalance[], required
    - `token_instance` NFTInstance
      - `is_unique` boolean, required
      - `id` string, required
      - `holder_address_hash` string
      - `image_url` string
      - `animation_url` string
      - `external_app_url` string
      - `metadata` object
      - `owner` AddressParam, required
        - `hash` string, required
        - `implementation_name` string, required
        - `name` string, required
        - `ens_domain_name` string
        - `metadata` object
        - `is_contract` boolean, required
        - `private_tags` AddressTag[], required
          - `address_hash` string, required
          - `display_name` string, required
          - `label` string, required
        - `watchlist_names` WatchlistName[], required
          - `display_name` string, required
          - `label` string, required
        - `public_tags` AddressTag[], required
          - `address_hash` string, required
          - `display_name` string, required
          - `label` string, required
        - `is_verified` boolean, required
      - `token` TokenInfo, required
        - `circulating_market_cap` string, required
        - `icon_url` string, required
        - `name` string, required
        - `decimals` string, required
        - `symbol` string, required
        - `address_hash` string
        - `type` string, required
        - `holders_count` string
        - `exchange_rate` string, required
        - `total_supply` string, required
    - `value` string, required
    - `token_id` string, required
    - `token` Token, required — Token struct
      - `address_hash` string, required
      - `bridge_type` 'omni' | 'amb', nullable — Type of bridge used for this bridged token
      - `circulating_market_cap` string, nullable, required
      - `circulating_supply` string, nullable, required
      - `decimals` string, nullable, required
      - `exchange_rate` string, nullable, required
      - `foreign_address` string, nullable
      - `holders_count` string, nullable, required
      - `icon_url` string, uri, nullable, required
      - `name` string, nullable, required
      - `origin_chain_id` string, nullable
      - `reputation` 'ok' | 'scam', nullable, required — Reputation of the token
      - `symbol` string, nullable, required
      - `total_supply` string, nullable, required
      - `type` 'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984', required
      - `volume_24h` string, nullable, required
  - `next_page_params` object, nullable, required

## Other responses

- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/blockscout/apis/blockscout-pro-api.md) · [All operations](https://skmtc.dev/blockscout/apis/blockscout-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockscout/apis/blockscout-pro-api/revisions/59ac5466233b?raw)