# Agent Data Tools: Base Token Info

> Agent Data Tools: Base Token Info is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns on-chain metadata for an ERC-20 token contract on the Base network, including name, symbol, decimals, and total supply.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/base/token-info?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-base-token-info-56268f06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DoGThuJvfg1n-3TpaHUWq

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 agent-data-tools-base-token-info-56268f06
```

Example prompt: What's the name, symbol, decimals, and total supply of the ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?

## When to prefer this

Use this endpoint when you need authoritative on-chain metadata for a specific ERC-20 token contract on the Base network, especially name, symbol, decimals, or total supply. Prefer this over price endpoints when you need contract-level facts rather than market data, and over wallet endpoints when you are inspecting the token contract itself rather than a holder's balance.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty result
- Contract address not deployed on Base returns not-found error
- Malformed 0x address (wrong length or checksum) may return a validation error
- Network congestion or RPC unavailability may cause timeouts
- Token with non-standard ERC-20 interface may return incomplete metadata

## How this service works

Look up the name, symbol, decimals and total supply of an ERC-20 token contract on Base, live from the contract. Use to identify an unknown token address or to format raw amounts; for a holder's balance use base_token_balance. Input is a ticker (USDC, WETH…) or the token's 0x contract address; an address that is not an ERC-20 contract returns 422, uncharged.

## Output

Returns a JSON object with the token's human-readable name, ticker symbol, chain name (e.g. 'Base'), chain ID (e.g. 8453), contract address, number of decimals, formatted total supply string, and raw total supply integer string as it appears on-chain.

## 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": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "examples": [
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       ],
       "description": "Token: a ticker such as USDC or WETH, or the 0x ERC-20 contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string"
      },
      "chain": {
       "type": "string"
      },
      "token": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "chainId": {
       "type": "number"
      },
      "decimals": {
       "type": "number"
      },
      "totalSupply": {
       "type": "string"
      },
      "totalSupplyRaw": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "chain": "Base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "chainId": 8453,
  "decimals": 6,
  "totalSupply": "1000000000.0",
  "totalSupplyRaw": "1000000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-base-token-info-56268f06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)