v1

latestOpenAPI 3.1.1MIT2026-07-1771017.6 KB

Token Lists

Get a single token by symbol or address

Retrieve information about a specific token on a given chain. The token can be identified by either its symbol (e.g., 'USDC.e') or its contract address.

get/asset/{chain_id}/{id}

Path parameters

chain_id4217 | 42431 | 31318 required

idstring required

Example:pathUSD

Token identifier - either the token symbol (e.g., 'pathUSD') or the token contract address (e.g., '0x20c0000000000000000000000000000000000000')

Response

Successful response with token information

chain_idinteger required

Chain ID of the network where token is deployed

addressstring required

Checksummed address of the token contract

decimalsinteger required

Number of decimals for token balance

namestring required

Name of the token

symbolstring required

Symbol of the token

logo_uristring url

URI to the token logo (SVG or PNG, 64x64 recommended)

tagsstring[] required

Array of tag identifiers associated with the token

extensionsExtensionMap

Object containing arbitrary or vendor-specific token metadata

Example response

{
  "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"
    }
  }
}