---
title: "List Tokens"
method: GET
path: "/v1/tokens"
tags: ["Tokens"]
---

# List Tokens

`GET /v1/tokens`

Lists or search existing tokens based on the provided filters. Supports querying by chain ID, token address, symbol, and/or name.



**Authentication**: Pass `x-client-id` header for frontend usage from allowlisted origins or `x-secret-key` for backend usage.

## Query parameters

- `limit` integer — Number of tokens to return per page (1-100).
- `page` integer — Page number for pagination, starting from 1.
- `chainId` integer — Limit tokens to a specific chain.
- `tokenAddress` string — Get a specific token by contract address
- `symbol` string — Limit tokens to a specific symbol.
- `name` string — Limit tokens to a specific name.

## Response `200`

Tokens returned successfully.

- object
  - `pagination` object, required
    - `hasMore` boolean — Whether there are more items available
    - `limit` number, nullable — Number of items per page
    - `page` number, nullable — Current page number
    - `totalCount` number, nullable — Total number of items available
  - `tokens` object[], required
    - `chainId` integer, required — The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism).
    - `address` string, required — A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).
    - `decimals` number, required
    - `symbol` string, required
    - `iconUri` string
    - `prices` object, required — Token price in different FIAT currencies.

## Other responses

- `400` — Invalid request parameters.
- `401` — Authentication required. For backend usage, include `x-secret-key` header. For frontend usage, include `x-client-id` + `Authorization: Bearer <jwt>` headers.
- `500` — Internal server error. This may occur due to network connectivity issues, wallet creation failures, or transaction execution failures.

---

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