{"uid":"cap_DoGThuJvfg1n-3TpaHUWq","slug":"agent-data-tools-base-token-info-56268f06","name":"Agent Data Tools: Base Token Info","description":"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.","url":"https://agent-data-tools.revmesh2074.workers.dev/base/token-info?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","chain":"Base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","chainId":8453,"decimals":6,"totalSupply":"1000000000.0","totalSupplyRaw":"1000000000000000"}},"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_LczTfFa3MxvVrr-cI7P9m","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 on-chain metadata for an ERC-20 token contract on the Base network, including name, symbol, decimals, and total supply.","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"Identify unknown Base token contract","prompt":"I received a token airdrop to my wallet — the contract is 0x4200000000000000000000000000000000000006 on Base. Can you tell me the token name, symbol, and how many decimals it uses?"},{"title":"Verify token supply before DeFi integration","prompt":"Before we integrate this token into our protocol, can you pull the total supply and decimal count for the ERC-20 at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base?"},{"title":"Enrich token metadata for portfolio dashboard","prompt":"I'm building a portfolio tracker — can you look up the full on-chain metadata for the token at 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 on Base, including name, symbol, chain ID, and total supply?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:43:59.201Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-base-token-info-56268f06"}