Supported Tokens

Rialto provides three token-discovery endpoints for integrators:

Endpoint	Use it for
`GET /tokens`	Read the whitelisted token list using the `all` or `strict` scope.
`GET /tokens/search`	Look up a specific token address on demand.
`GET /tokens/supported-tokens`	Download the full supported-token universe as a gzip-compressed snapshot.

Whitelisted tokens

GET /tokens

Auth: public. The endpoint supports the all and strict scopes. Use the scope configured for your integration.

curl -sS 'https://rialto-trade-api.rialto.xyz/tokens?scope=strict'

Example response:

{
  "chain_id": 4663,
  "tokens": [
    {
      "name": "ETH",
      "symbol": "ETH",
      "address": "<native_eth_sentinel>",
      "decimals": 18,
      "source": "constant",
      "type": "non_stable"
    },
    {
      "name": "Wrapped Ether",
      "symbol": "WETH",
      "address": "<sell_token_address>",
      "decimals": 18,
      "source": "whitelist",
      "type": "non_stable"
    }
  ]
}

Token fields

Field	Description
name	Token display name.
symbol	Token symbol.
address	Token contract address.
decimals	Token decimals.
source	How the token entered the supported set.
type	stable or non_stable.

Search for one token

Use the search endpoint when you need to check a specific token without loading the full supported-token universe:

GET /tokens/search?query=<token_address>&limit=1

curl -sS \
  'https://rialto-trade-api.rialto.xyz/tokens/search?query=<token_address>&limit=1'

Cache search results by chain and lowercase token address. This makes the lookup an on-demand operation on the first request for an address, rather than an API call before every quote.

Result	Recommended cache duration
Supported token	5 to 15 minutes
Unsupported token	30 to 60 minutes

Refresh the cached result after an unexpected quote rejection, even if its normal cache duration has not elapsed.

Full supported-token universe

Use the full snapshot when a shared service wants to maintain a local set of all supported addresses:

GET /tokens/supported-tokens?chain_id=4663

curl --compressed \
  'https://rialto-trade-api.rialto.xyz/tokens/supported-tokens?chain_id=4663'

The response is gzip-compressed. Keep one shared cache per chain instead of downloading and parsing the full universe for every request or worker. See Complete Supported Tokens Universe for snapshot refresh and caching guidance.

Using tokens in quotes

GET /quote accepts canonical 0x-prefixed token addresses only. Pass the address returned by a token endpoint. Symbols such as WETH or USDG are not accepted because symbols are not unique.

Get started

Swap API

propAMM Integration

Supported Tokens

Whitelisted tokens

Token fields

Search for one token

Full supported-token universe

Using tokens in quotes

​Whitelisted tokens

​Token fields

​Search for one token

​Full supported-token universe

​Using tokens in quotes

Whitelisted tokens

Token fields

Search for one token

Full supported-token universe

Using tokens in quotes