---
title: "List tokens with optional filtering by name, symbol, or type"
method: GET
path: "/{chain_id}/api/v2/tokens/"
tags: ["tokens"]
---

# List tokens with optional filtering by name, symbol, or type

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

Retrieves a paginated list of tokens with optional filtering by name, symbol, or type.

## Path parameters

- `chain_id` string, required

## Query parameters

- `type` union
  - string
  - string
- `q` string, nullable
- `limit` integer, nullable
- `sort` 'fiat_value' | 'holders_count' | 'circulating_market_cap'
- `order` 'asc' | 'desc'
- `items_count` integer
- `contract_address_hash` string, nullable
- `fiat_value` union
  - string
  - string
  - string
- `holders_count` union
  - string
  - string
  - string
- `is_name_null` boolean
- `market_cap` union
  - string
  - string
  - string
- `name` string

## Response `200`

List of tokens matching the filter criteria, with pagination.

- object
  - `items` Token[], required
    - `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

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/blockscout/apis/blockscout-pro-api.md) · [All operations](https://skmtc.net/blockscout/apis/blockscout-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockscout/blockscout-pro-api/revisions/59ac5466233b/schema)