{"uid":"cap_yyWiUSbM02rTPdYJYq_Zg","slug":"base-onchain-tools-token-metadata-lookup-48b904c3","name":"Base Onchain Tools – Token Metadata Lookup","description":"Eleven read-only endpoints answering questions about Base mainnet that are tedious to assemble from raw RPC: what an unverified contract is actually able to do, whether a token transfer will revert and for what reason, what an arbitrary token is worth, and whether an address is safe to pay. Priced $0.001-$0.04 per call in USDC over x402. No account, no API key, no signup, no minimum, no rate limit to negotiate — the payTo address in the 402 response is the whole integration. Failed calls are not billed. The payment middleware cancels settlement on any 4xx or 5xx, so a malformed parameter or an upstream outage costs nothing. Answers are read live from Base mainnet at request time, with failover across five independent RPC providers. A batch that comes back incomplete is treated as a failure rather than returned with the missing entries as zeros, because a confident wrong answer costs a caller more than an error does. Scope is deliberately narrow: Base mainnet only, reads only, no keys held, nothing stored between requests.","url":"https://base-onchain-tools.dolerite.workers.dev/v1/base/token?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":["address"],"properties":{"address":{"type":"string","description":"ERC-20 contract address on Base mainnet"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","symbol":"USDC","decimals":6}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GPqNOXb6XX8aCxzWuKgQU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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, and decimals for any ERC-20 token contract on Base mainnet.","exampleAgentPrompt":"What's the name, symbol, and decimals for the ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base mainnet?","exampleUseCases":[{"title":"Identify unknown token in wallet","prompt":"I see a token at address 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 in my Base wallet — can you tell me what it is, its symbol, and how many decimals it uses?"},{"title":"Display token info in DeFi dashboard","prompt":"Before showing the swap summary, look up the token name and symbol for the contract 0x4200000000000000000000000000000000000006 on Base so I can label it properly."},{"title":"Validate token address before integration","prompt":"I'm about to integrate this Base token contract — 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — can you confirm its name, symbol, and decimal places so I know I have the right one?"}],"resultDescription":"A JSON object with three fields: name (human-readable token name, e.g. 'USD Coin'), symbol (ticker symbol, e.g. 'USDC'), and decimals (integer precision, e.g. 6). Data is read live from Base mainnet at request time using failover across five independent RPC providers. If any field cannot be resolved, the call fails entirely rather than returning partial or zero-filled data.","failureModes":["Invalid or non-ERC-20 contract address returns a 4xx error (not billed)","Contract exists but does not implement standard ERC-20 metadata interface — call fails","RPC provider outage across all five failover providers causes 5xx (not billed)","Malformed address string (wrong length, non-hex) triggers input validation error","Token deployed on a network other than Base mainnet will not be found"],"whenToPreferThis":"Choose this endpoint when you need fast, reliable ERC-20 token metadata (name, symbol, decimals) for a known contract address on Base mainnet without setting up RPC infrastructure, API keys, or accounts. It is ideal for agents enriching transaction data, labeling tokens in UIs, or validating contract addresses before integrating them. It is not appropriate for Ethereum mainnet, other L2s, or write operations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:33:52.756Z","isFirstParty":false,"canonicalSlug":"base-onchain-tools-token-metadata-lookup-48b904c3"}