Get tokens

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.

Authorization

x-api-keystringrequiredheader

Playground key

You're using a shared playground keyCreate a free account and get your own API keys from the dashboard.

Get your keys

Query Parameters

sortenumdefault:default

defaulttvlvolume_24hbridgeable

limitintegerdefault:100

Number of ranked tokens to return. Applies only when sort is tvl or volume_24h. Defaults to 100.

chainIdenum

1105613013714319632448018684217432646635042845310143421614222043114570735914481457777777713018453211155111

Filter ranked token results to a specific chain. When omitted, ranked results include all supported chains. Ignored when sort is default.

Response

Get tokens successful. An empty tokens array is a valid result when no tokens match the requested sort and chains.

requestIdstringrequired

A unique ID for the request.

tokensobject[]required

GET/tokens

Request

curl --request GET \
  --url 'https://trade-api.gateway.uniswap.org/v1/tokens' \
  --header 'x-api-key: <api-key>'

Response

200

{  "requestId": "<string>",  "tokens": [    {      "name": "<string>",      "address": "<string>",      "chainId": "<number>",      "symbol": "<string>",      "decimals": "<number>",      "logoURI": "<string>",      "extensions": {        "bridgeInfo": {},        "safetyInfo": {          "safetyLevel": "<string>",          "safetyDescription": "<string>",          "buyFee": "<number>",          "sellFee": "<number>"        }      }    }  ]}