{"uid":"cap__C3pjcVlEIMZPqEMX3ftZ","slug":"base-erc-20-token-metadata-lookup-4627b363","name":"Base ERC-20 Token Metadata Lookup","description":"Call when an agent needs ERC-20 name, symbol, decimals, and totalSupply for one Base token. Send token (example Circle USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Read-only eth_call on eip155:8453. Not a contract, or no ERC-20 methods, errors. No spend. Send JSON {\"token\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/base-erc20-meta first.","url":"https://agentshelf.syntexa.ch/v1/base-erc20-meta?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"ERC-20 contract on Base mainnet (eip155:8453). Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (Circle USDC). EIP-55 or all one case. Returns name, symbol, decimals, and total supply. Read-only."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5SpliYf0a3FTJS5Sz7Umx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the name, symbol, decimals, and total supply of any ERC-20 token contract on Base mainnet via a read-only eth_call.","exampleAgentPrompt":"What are the name, symbol, decimals, and total supply of the ERC-20 token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base mainnet?","exampleUseCases":[{"title":"Identify unknown token in wallet","prompt":"I see a token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 in my Base wallet — can you tell me its name, symbol, and how many decimals it uses?"},{"title":"Validate token before DeFi interaction","prompt":"Before I add liquidity, can you look up the ERC-20 metadata for the contract 0x4200000000000000000000000000000000000006 on Base so I can confirm it's the right token with the right decimals?"},{"title":"Fetch total supply for market analysis","prompt":"What is the total supply of the ERC-20 token deployed at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base mainnet?"}],"resultDescription":"Returns a JSON object with the token's name (string), symbol (string), decimals (integer), and totalSupply (large integer or string), read directly from the ERC-20 contract on Base mainnet. Errors if the address is not a contract or does not implement ERC-20 methods.","failureModes":["Address is not a deployed contract on Base — returns an error","Contract exists but does not implement ERC-20 interface methods — returns an error","Malformed or invalid Ethereum address format — request rejected","Token on a different chain (not Base eip155:8453) — returns incorrect or no data","Payment not sent — requires exact $0.003 USDC on Base before production endpoint responds"],"whenToPreferThis":"Use this endpoint when you need fast, cheap, read-only ERC-20 metadata (name, symbol, decimals, totalSupply) for a single token on Base mainnet and don't want to run your own RPC node. Ideal for agents enriching token data, validating contracts, or labeling wallet balances. Not suitable for tokens on other EVM chains, batch lookups of many tokens, or writing/transacting on-chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:48:14.680Z","isFirstParty":false,"canonicalSlug":"base-erc-20-token-metadata-lookup-4627b363"}