{"uid":"cap_vgHZj4HAL1KSZOBPFyrH9","slug":"openverbs-chain-erc-20-token-metadata-23830a3c","name":"OpenVerbs Chain — ERC-20 Token Metadata","description":"Live ERC-20 metadata read directly from the contract: name, symbol, decimals and total supply (raw + decimal-formatted). Handles both string and legacy bytes32 name/symbol encodings. Returns `isToken:false` for EOAs or non-token contracts. Reads live on-chain data with automatic endpoint fallback.","url":"https://chain.openverbs.com/v1/token","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"chain":{"enum":["ethereum","base","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain to query. One of: ethereum, base, arbitrum, optimism, polygon. Default \"ethereum\"."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract address."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"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_8fp_XgP_UwvBWoKlXN6Sm","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":"Reads live ERC-20 token metadata (name, symbol, decimals, total supply) directly from a contract on EVM chains, handling both string and legacy bytes32 encodings.","exampleAgentPrompt":"Can you look up the on-chain metadata for the ERC-20 token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need its name, symbol, decimals, and total supply?","exampleUseCases":[{"title":"Verify unknown token contract identity","prompt":"I found this contract address 0x514910771AF9Ca656af840dff83E8264EcF986CA on Ethereum — can you tell me what token it is, its symbol, how many decimals it uses, and what the total supply is?"},{"title":"Check token supply on Base","prompt":"What is the total supply of the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, and is it actually an ERC-20 token?"},{"title":"DeFi app token info lookup on Arbitrum","prompt":"Pull the name, symbol, and decimals for the ERC-20 contract 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 on Arbitrum so I can configure it in my app."}],"resultDescription":"Returns a JSON object with the token's name, symbol, decimals, raw total supply, decimal-formatted total supply, and an isToken boolean. If the address is an EOA or non-token contract, isToken is false and token fields are absent or null. Data is read live from the chain at call time.","failureModes":["Invalid or malformed contract address (not 0x + 40 hex chars) returns a validation error","Non-token contract or EOA returns isToken:false with no token metadata","Unsupported chain value returns an enum validation error","Contracts with non-standard or missing name/symbol/decimals may return partial data","RPC endpoint unavailability triggers automatic fallback; persistent outage returns an error","Rate limiting or payment failure returns a 402 or 429 response"],"whenToPreferThis":"Use this endpoint when you need authoritative, live on-chain ERC-20 metadata directly from the contract — not from a third-party indexer or cached database. It is the right choice when you need to verify token identity, check decimals for balance formatting, or confirm whether an address is actually an ERC-20 token. Prefer it over price APIs (which do not return contract-level metadata) and over wallet APIs (which focus on balances, not token definitions). Its support for bytes32 legacy encodings makes it robust for older tokens that would fail with naive ABI calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:22.636Z","isFirstParty":false}