# Get tokens (GET /tokens)

Operation `get_tokens` of the Uniswap API. Base URL: `https://trade-api.gateway.uniswap.org/v1`.

Returns a list of tokens and their associated metadata, formatted in the style of a token list. `sort=tvl` and `sort=volume_24h` return the top `limit` tokens ranked across the requested chains, expanded to one entry per chain instance. `sort=default` (the default) returns the full Uniswap default token list; `limit` and `chainId` are ignored. `sort=bridgeable` returns all tokens with at least one bridgeable chain executable via the Uniswap API. This endpoint never returns `404`: an empty result (e.g. a ranked sort with no data for the requested chain) is a `200` with an empty `tokens` array, and internal data-source failures surface as `500`, or `504` on timeout.

Parameters: 3 query, 1 header · Auth: apiKey · Responses: 200, 400, 401, 429, 500, 504

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `sort` | enum | no |  |
| `limit` | integer | no | Number of ranked tokens to return. Applies only when sort is `tvl` or `volume_24h`. Defaults to 100. |
| `chainId` | enum | no | Filter ranked token results to a specific chain. When omitted, ranked results include all supported chains. Ignored when sort is `default`. |

## Headers

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `x-api-key` | string | yes | Your API key for authentication. |

## Responses

- `200` — Get tokens successful. An empty `tokens` array is a valid result when no tokens match the requested sort and chains.
- `400` — RequestValidationError, Bad Input
- `401` — UnauthorizedError eg. Account is blocked.
- `429` — Ratelimited
- `500` — Unexpected error
- `504` — Request duration limit reached.

Interactive playground: https://developers.uniswap.org/docs/api-reference/get_tokens
All endpoints: https://developers.uniswap.org/docs/api-reference