# ChainRead Token Info

> ChainRead Token Info is a paid API for AI agents from chainread.genexxis.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Fetches ERC-20 token metadata (name, symbol, decimals, total supply) or detects ERC-721/ERC-1155 token standard for a given contract address on supported EVM chains.

## Facts

- Endpoint: GET https://chainread.genexxis.com/token?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainread-token-info-498a1649
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qcn_gWCM5MXsxXD9DVBVu

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 chainread-token-info-498a1649
```

Example prompt: What's the name, symbol, decimals, and total supply of the contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — and is it ERC-20, ERC-721, or ERC-1155?

## When to prefer this

Use this endpoint when you need to quickly look up ERC-20 token metadata (name, symbol, decimals, total supply) or detect the token standard (ERC-20, ERC-721, ERC-1155) for a contract address on Ethereum, Base, Arbitrum, OP Mainnet, Polygon, or BNB Chain without needing to sign transactions or manage RPC keys. It is ideal for agents that need token context for DeFi calculations, UI display, or contract classification. Prefer this over a raw eth_call endpoint when you want pre-decoded, human-readable token data in one call.

## Known failure modes

- Non-contract address returns isContract: false with empty token fields
- Contract that doesn't implement ERC-20/721/1155 returns unknown standard
- Invalid or malformed contract address returns HTTP 422
- Unsupported chain name returns validation error
- RPC timeout or network failure may return HTTP 5xx
- Contract revert returns HTTP 422 with decoded revert reason

## How this service works

Token metadata for any contract: ERC-20 name, symbol, decimals, total supply (raw and formatted), or ERC-721 / ERC-1155 detection via ERC-165 interfaces.

## Output

Returns a JSON object with the token's name, symbol, decimals, total supply (raw and formatted), detected standard (ERC-20, ERC-721, or ERC-1155), ERC-165 interface detection results, whether the address is a contract, the block number at which data was read, chain name, chain ID, and a timestamp. Big numbers are returned as strings to avoid precision loss.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "ethereum (default), base, arbitrum, optimism, polygon, bsc"
      },
      "address": {
       "type": "string",
       "description": "Token contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-10-25T03:50:00.000Z",
  "name": "USD Coin",
  "chain": "base",
  "symbol": "USDC",
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "chainId": 8453,
  "decimals": 6,
  "standard": "ERC-20",
  "interfaces": {
   "erc165": false
  },
  "isContract": true,
  "blockNumber": "37412345",
  "totalSupply": "4114170396312345",
  "totalSupplyFormatted": "4114170396.312345"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainread-token-info-498a1649/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainread.genexxis.com](https://www.zero.xyz/host/chainread.genexxis.com/llms.txt)