{"uid":"cap_V10fuhe237wM2cR9YX0sY","slug":"base-token-metadata-fe030bae","name":"Base Token Metadata","description":"Read a Base token name, symbol, decimals and total supply in one call. Handles tokens that return a bytes32 name or symbol instead of a string, which is the case that breaks naive decoders. Fields the contract does not implement come back null and are listed, rather than guessed at. Refuses an address with no contract.","url":"https://api.zfinia.com/x402/v1/base-token-metadata?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9_6qdXq1Vh-KQ7Jwt2GzX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the name, symbol, decimals, and total supply of an ERC-20 token contract on Base in a single call, handling edge cases like bytes32-encoded fields.","exampleAgentPrompt":"Can you look up the token name, symbol, decimals, and total supply for the Base contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"Token display in a DeFi dashboard","prompt":"I'm building a portfolio tracker — can you pull the name, symbol, and decimals for the Base token at 0x4200000000000000000000000000000000000006 so I can label the balance correctly?"},{"title":"Validating a new token before listing","prompt":"Before I add this token to my exchange, can you check what name, symbol, decimals, and total supply the contract at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base actually returns? I want to make sure nothing is null."},{"title":"Identifying an unknown contract","prompt":"Someone sent me tokens at Base address 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 — can you tell me what token it is, including its symbol and total supply?"}],"resultDescription":"Returns an object with token name, symbol, decimals, and total supply as read directly from the contract. Fields the contract does not implement are returned as null with those field names listed explicitly. If no contract exists at the given address, the call is refused with an error.","failureModes":["Address is a wallet or has no deployed contract — returns a refusal error","Contract exists but is non-standard and returns no readable metadata — affected fields come back null","Malformed address (not a valid 0x hex string) — rejected by input schema validation","Network congestion on Base causing timeout","bytes32-encoded name/symbol decoded correctly but other edge cases may yield unexpected strings"],"whenToPreferThis":"Choose this endpoint when you need ERC-20 token metadata from the Base network and want a single call that handles both standard string and bytes32-encoded name/symbol fields without writing custom decoding logic. Prefer it over direct RPC calls when you need graceful null handling for missing fields rather than a revert or decoder crash.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:41:30.885Z","isFirstParty":false,"canonicalSlug":"base-token-metadata-fe030bae"}