> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rialto.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported Tokens

> Search for tokens and cache Rialto's quote-supported universe.

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:

```http theme={null}
GET /tokens/search?query=<token_address>&limit=1
```

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

Example response:

```json theme={null}
{
  "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:

```http theme={null}
GET /tokens/quote-supported?chain_id=4663
```

```bash theme={null}
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](/developers/partner-supported-tokens) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.