v1

latestOpenAPI 3.1.1MIT2026-07-1771017.6 KB

Token Lists

Get token list for a chain

Retrieve the complete token list for a specific blockchain network

get/list/{chain_id}

Path parameters

chain_id4217 | 42431 | 31318 required

Response

Successful response with token list

schemastring url

JSON Schema reference

namestring required

Name of the token list

timestampstring date-time

Timestamp of this list version

logo_uristring url

URI for the logo of the token list

keywordsstring[] required

Keywords associated with the token list

tagsTagsMap

Mapping of tag identifiers to their definitions

token_mapTokenMap

Mapping of 'chainId_tokenAddress' to token objects

Example response

{
  "schema": "https://esm.sh/gh/uniswap/token-lists/src/tokenlist.schema.json",
  "name": "Tempo Testnet",
  "logo_uri": "https://esm.sh/gh/tempoxyz/tokenlist/data/42431/icon.svg",
  "tokens": [
    {
      "chain_id": 1,
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "decimals": 18,
      "name": "Bridged USDC",
      "symbol": "USDC.e",
      "logo_uri": "https://esm.sh/gh/tempoxyz/tokenlist/data/42431/icons/usdc.svg",
      "extensions": {
        "chain": "tempo",
        "label": "PathUSD",
        "coingeckoId": "pathusd",
        "bridgeInfo": {
          "sourceChainId": 1,
          "sourceAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
        }
      }
    }
  ]
}