# Token Info

> Token Info is a paid API for AI agents from chain.tollkit.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns metadata for a specific ERC-20 or SPL token (name, symbol, decimals, total supply) on Base, Ethereum, or Solana

## Facts

- Endpoint: POST https://chain.tollkit.dev/chain/token?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-info-8619456c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HsQG4xcGBMQZ56eXLodCO

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 token-info-8619456c -d '<json body>'
```

Example prompt: Can you look up the token info for the contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know the name, symbol, decimals, and total supply?

## When to prefer this

Use this endpoint when you need on-chain token metadata — name, symbol, decimals, total supply — for a known contract address on Base, Ethereum, or Solana. Prefer it over generic blockchain explorers when you need structured JSON output suitable for agent pipelines. It's especially useful before executing trades, displaying token info in UIs, or enriching wallet data with human-readable token names.

## Known failure modes

- Invalid contract address format returns a validation error
- Token address not found on the specified chain returns an empty or error response
- Wrong chain specified for a valid address (e.g. Base address queried on Ethereum) may return no data
- Network or RPC timeout causes a service error
- Malformed address (not 0x hex or valid base58) rejected by pattern validation

## How this service works

Wallet balances, tokens, transactions and prices on Base, Ethereum and Solana. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://data.tollkit.dev/openapi.json.

## Output

A JSON object containing the token's name, symbol, contract address, chain, decimals, total supply (human-readable and raw), a link to the block explorer, and the timestamp the data was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "solana"
   ],
   "type": "string",
   "default": "base",
   "description": "Which chain to read: \"base\" (default), \"ethereum\" or \"solana\"."
  },
  "token": {
   "type": "string",
   "pattern": "^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$",
   "description": "ERC-20 contract, or SPL mint on Solana."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "chain": "base",
  "symbol": "USDC",
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "decimals": 6,
  "checked_at": "2026-10-04T07:45:36.715Z",
  "explorer_url": "https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "total_supply": "4370466599.027823",
  "total_supply_raw": "4370466599027823"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-info-8619456c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.tollkit.dev](https://www.zero.xyz/host/chain.tollkit.dev/llms.txt)