Skip to content
LogoLogo

Tempo Token List Registry

A Uniswap Token Lists-compatible API for token metadata and icons on Tempo.

As an example, here's Tempo Testnet's tokenlist, fetched from tokenlist.tempo.xyz/list/42431:

    Endpoints

    EndpointDescription
    /list/{chain_id}Token list for a chain
    /asset/{chain_id}/{id}Get a single token by symbol or address​
    /icon/{chain_id}Chain icon (SVG)
    /icon/{chain_id}/{address}Token icon (SVG)

    Adding a New Token

    1. Fork tempoxyz/tempo-apps

    2. Add token to data/<chain_id>/tokenlist.json in apps/tokenlist:

      {
  "name": "piUSD",
  "symbol": "PiUSD",
  "decimals": 6,
  "chainId": 42431,
  "address": "0x..."
}

    3. Add icon to data/<chain_id>/icons/<address>.svg (lowercase address) in apps/tokenlist

    4. Submit PR with as much information as you think is helpful for review.

    Icon Requirements

    • Format: SVG
    • Address filename must be lowercase (e.g., 0xabcd...1234.svg)
    • Recommended: square aspect ratio, minimal whitespace 1Code has comments. Press enter to view.

    Full OpenAPI Spec →