# BRAINIAC Token Metadata API

> BRAINIAC Token Metadata API is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-11).

Fetches on-chain metadata for a specific ERC-20 or other token contract at a given block number on a blockchain network

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/chain-data/token/metadata?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-token-metadata-api-a83b43e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mk6PFaZP2qGqoF78TiGmr

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 brainiac-token-metadata-api-a83b43e2 -d '<json body>'
```

Example prompt: Can you look up the on-chain metadata — name, symbol, decimals — for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 at block number 19000000?

## When to prefer this

Use this endpoint when you need quick, cheap, pay-per-call access to ERC-20 or other token contract metadata without setting up an account or API key. It is ideal for agents that occasionally need token details on demand and want to pay micro-amounts per query. Prefer this over free RPC calls when you need a managed, reliable response without managing your own node infrastructure, and over larger data providers when cost per call matters and you do not need bulk data.

## Known failure modes

- Invalid token address format returns a validation error
- Token address is not a recognized contract or has no metadata — empty or null response
- Block number exceeds chain head or is out of range
- Payment not received or insufficient USDC — 402 Payment Required response
- Network or RPC timeout causing delayed or missing response

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing on-chain metadata for the specified token contract, including fields such as token name, symbol, decimals, and potentially other contract-level metadata. The data reflects the state at the specified block number, or at the latest block if none is provided.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "blockNumber": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0
  },
  "tokenAddress": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "symbol": "USDC",
  "chainId": 8453,
  "sources": [
   {
    "url": "https://mainnet.base.org",
    "source": "Base JSON-RPC",
    "status": "OK",
    "retrievedAt": "2026-11-07T12:08:59.919Z"
   }
  ],
  "decimals": 6,
  "blockNumber": "latest",
  "limitations": [
   "Metadata depends on the token contract implementing standard ERC-20 methods.",
   "Name and symbol decoding supports standard ABI-encoded strings; non-standard encodings may return null.",
   "Not all tokens implement all metadata methods."
  ],
  "retrievedAt": "2026-11-07T12:08:59.919Z",
  "totalSupply": "0x000000000000000000000000000000000000000000000000000f2dbd16d0a3f2",
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "totalSupplyDecimal": "4272414805500914"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-token-metadata-api-a83b43e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
