Supported Tokens

Rialto provides two token-discovery endpoints for integrators:

Endpoint	Use it for
`GET /tokens/search`	Look up a specific token address on demand.
`GET /tokens/quote-supported`	Download the full quote-supported universe as a gzip-compressed snapshot.

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.
category	crypto, stock, or etf.
liquid	Whether the token currently has an enabled route.
can_buy	Whether the router can currently buy the token from an anchor.
can_sell	Whether the router can currently sell the token into an anchor.
liquidity_usd	Known aggregate liquidity, when available.

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'

Example response:

{
  "chain_id": 4663,
  "tokens": [
    {
      "name": "Wrapped Ether",
      "symbol": "WETH",
      "address": "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
      "decimals": 18,
      "source": "whitelist",
      "type": "non_stable",
      "category": "crypto",
      "liquid": true,
      "can_buy": true,
      "can_sell": true,
      "liquidity_usd": "<current_liquidity>"
    }
  ]
}

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/quote-supported?chain_id=4663

curl --compressed \
  'https://rialto-trade-api.rialto.xyz/tokens/quote-supported?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 either endpoint. Symbols such as WETH or USDG are not accepted because symbols are not unique.

Get started

Quote API

propAMM Integration

Supported Tokens

Token fields

Search for one token

Full supported-token universe

Using tokens in quotes

​Token fields

​Search for one token

​Full supported-token universe

​Using tokens in quotes

Token fields

Search for one token

Full supported-token universe

Using tokens in quotes