{"uid":"cap_oTNbOvTJgjq-iPEKVJGGi","slug":"erc-20-token-metadata-lookup-base-chain-2aa8f8a2","name":"ERC-20 Token Metadata Lookup (Base Chain)","description":"ERC-20 metadata on Base: name, symbol, decimals, totalSupply (raw + formatted) for any token contract.","url":"https://x402-data-api.sigrunner.workers.dev/chain/erc20-meta?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","properties":{"token":{"type":"string","description":"0x-prefixed ERC-20 contract address on Base"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["token","name","symbol","decimals","total_supply_raw","total_supply","chain"],"properties":{"name":{"type":"string"},"chain":{"type":"string"},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"},"total_supply":{"type":"integer"},"total_supply_raw":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","chain":"base","token":"0x833589fCd6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","decimals":6,"total_supply":3500000000,"total_supply_raw":"3500000000000000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_liY6SkaPg9VJ33Qir30Uc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns name, symbol, decimals, and total supply (raw and formatted) for any ERC-20 token contract on the Base blockchain.","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the ERC-20 token at contract address 0x833589fCd6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"Pre-trade token identity verification","prompt":"Before I swap, can you look up the name, symbol, and decimals for the token at 0x833589fCd6eDb6E08f4c7C32D4f71b54bdA02913 on Base so I know exactly what I'm trading?"},{"title":"Display token info in a DeFi dashboard","prompt":"I'm building a dashboard — fetch the full metadata for the Base ERC-20 at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb including its name, symbol, decimals, and total supply."},{"title":"Validate unknown token contract details","prompt":"Someone sent me tokens at address 0x4200000000000000000000000000000000000006 on Base — can you tell me what this token actually is, its symbol, and how many total tokens exist?"}],"resultDescription":"A JSON object containing the token's contract address, human-readable name, ticker symbol, decimal precision, raw total supply (as a string to preserve precision), formatted total supply (as a number), and the chain identifier ('base').","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty response","Address not deployed on Base (e.g. Ethereum mainnet address) returns no data","Malformed 0x address format causes a bad request error","Payment failure (insufficient USDC or x402 handshake failure) blocks the request","Rate limiting or worker timeout for heavily loaded contracts"],"whenToPreferThis":"Use this endpoint when an agent needs on-chain ERC-20 metadata — name, symbol, decimals, or total supply — for a Base chain token without setting up a full RPC node or blockchain SDK. It is especially useful in pre-trade checks, token display UIs, or enrichment pipelines where basic token facts are needed cheaply ($0.01 USDC per call) with no API key required. Prefer this over full blockchain RPC calls when only metadata is needed and low operational overhead is a priority.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:43:25.006Z","isFirstParty":false,"canonicalSlug":"erc-20-token-metadata-lookup-base-chain-2aa8f8a2"}