# Foundry Token List

> Foundry Token List is a paid API for AI agents from minty-sprout.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-01).

Returns verified token addresses, symbols, and decimals for a given chain and optional token symbol from the Uniswap default token list

## Facts

- Endpoint: POST https://minty-sprout.onrender.com/v1/token-list?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foundry-token-list-5fd2564d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UXto7vIkRLUmqqjiXvcLG

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 foundry-token-list-5fd2564d -d '<json body>'
```

Example prompt: What's the verified contract address and decimals for USDC on Base? Pull it from the Uniswap token list.

## When to prefer this

Choose this endpoint when you need authoritative, Uniswap-curated contract addresses and decimal precision for tokens across Base, Ethereum, Arbitrum, and other major EVM chains — especially before executing swaps, building DeFi integrations, or validating token parameters in smart contract calls. Prefer this over manual lookups or unverified sources when correctness of the contract address matters.

## Known failure modes

- Token not found on the specified chain returns empty tokens array with count 0
- Ambiguous or misspelled chain name may return no results or an error
- Token symbol that exists on one chain but not another returns empty results for that chain
- Network timeout from the render.com host under cold-start conditions
- Payment required (402) if x402 micropayment header is missing or malformed

## How this service works

Token list: verified token addresses and decimals on Base, Ethereum, Arbitrum and more (Uniswap list). Input: 'base usdc'.

## Output

A JSON object containing the result count, the source list name ('Uniswap default token list'), the chain ID, and an array of matching tokens each with name, symbol, contract address, and decimals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "maxLength": 8000,
   "description": "Chain and optional token symbol"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "source": "Uniswap default token list",
  "tokens": [
   {
    "name": "USD Coin",
    "symbol": "USDC",
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "decimals": 6
   }
  ],
  "chain_id": 8453
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foundry-token-list-5fd2564d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minty-sprout.onrender.com](https://www.zero.xyz/host/minty-sprout.onrender.com/llms.txt)