# RelAI Token List API (v4)

> RelAI Token List API (v4) is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-08).

Returns a curated list of tokens available on a specified blockchain network, accessed via USDC micropayment.

## Facts

- Endpoint: POST https://api.relai.fi/relay/1772442473781/v4/%7Bchain%7D/tokenList
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-relai-fi-a1583d8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CJPM8OOj7INZPsK4YgeCV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-relai-fi-a1583d8f -d '<json body>'
```

Example prompt: Can you pull the curated token list for the Polygon chain from RelAI's v4 API so I can see which tokens are supported there?

## When to prefer this

Choose this endpoint when you need a pre-curated, trusted list of tokens for a specific blockchain and want to avoid maintaining your own token registry. Ideal for DeFi applications, swap interfaces, or wallet UIs that need reliable token metadata per chain. Prefer over raw on-chain queries when speed and curation quality matter more than exhaustiveness.

## Known failure modes

- Invalid or unsupported chain identifier returns an error or empty list
- Payment failure (insufficient USDC balance) results in 402 Payment Required
- Network timeout for unknown chain IDs
- Malformed chain parameter in URL path returns 400 Bad Request
- Chain not yet indexed returns empty token array

## How this service works

Fetch a curated list of tokens for a specified blockchain (v4); access requires payment in USDC per the API's payment schema.

## Output

A structured list of tokens available on the specified blockchain, including token names, symbols, contract addresses, decimals, and any additional metadata curated by RelAI. Each call costs $0.01 USDC via the x402 payment protocol.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-relai-fi-a1583d8f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)