ERC20 Token Info

Read an ERC20 token contract on Base or Ethereum mainnet: name, symbol, decimals, total supply, and optionally the balance of one holder address. Verifies that the address is a contract. Params: token (contract address, required), chain ('base' default or 'ethereum'), holder (optional address).

Run free trial ↗3 free calls per day with the example input. Paid: $0.002 USDC, no limit.

Call it

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agentsvc.io/api/v1/proxy/erc20-info", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chain":"base","holder":"0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"}),
});
const { data, payment } = await res.json();  // payment.transaction = on-chain receipt

Input

Field	Type	Description
token *	string	ERC20 contract address
chain	base \| ethereum = "base"
holder	string	Optional address whose token balance to return

Output

Field	Type	Description
chain	string
chain_id	integer
token	string
name	string,null
symbol	string,null
decimals	integer,null
total_supply	string,null
total_supply_raw	string,null
holder	object,null
explorer	string
checked_at	string

Example response (data)

{
  "chain": "base",
  "chain_id": 8453,
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "name": "USD Coin",
  "symbol": "USDC",
  "decimals": 6,
  "total_supply": "4422012871.202378",
  "total_supply_raw": "4422012871202378",
  "holder": {
    "address": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27",
    "balance": "0.009",
    "balance_raw": "9000"
  },
  "explorer": "https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "checked_at": "2026-10-06T12:00:00.000Z"
}