# booAIP Token Supply Lookup

> booAIP Token Supply Lookup is a paid API for AI agents from booaip.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the total supply and decimals for a given ERC-20 token symbol on-chain

## Facts

- Endpoint: GET https://booaip.vercel.app/api/supply
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/booaip-token-supply-lookup-eae304be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RrVbxGQ7Mzicl97b8oWCl

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 booaip-token-supply-lookup-eae304be
```

Example prompt: What is the total supply and decimals for USDC on-chain? I need the raw totalSupply number and token precision so I can calculate real balances in my DeFi workflow.

## When to prefer this

Use this endpoint when an AI agent needs on-chain ERC-20 token supply data in a pay-per-call model without API key management; ideal for crypto/DeFi agents that need accurate totalSupply and decimals to normalize token amounts, especially when paying with USDC via x402 on Base.

## Known failure modes

- Token symbol not found returns found: false with no supply data
- Invalid or unsupported token symbol yields empty or error response
- Payment failure via x402 USDC on Base prevents API access
- Network or contract lookup timeout returns error
- Unsupported chain or token contract returns not found

## How this service works

ERC-20 token name, symbol, decimals and total supply via on-chain read. Body: { token, chain }.

## Output

Returns a JSON object with: found (boolean indicating if token was located), symbol (the token ticker), decimals (number of decimal places for the token), and totalSupply (raw integer string of the full token supply).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "eth, bnb, base."
  },
  "token": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "found": true,
  "symbol": "USDC",
  "decimals": 6,
  "totalSupply": "1000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/booaip-token-supply-lookup-eae304be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from booaip.vercel.app](https://www.zero.xyz/host/booaip.vercel.app/llms.txt)