{"uid":"cap_d75x9EF5pjH3HI2slJGkb","slug":"onchain-toolkit-erc-20-token-metadata-reader-3b351c59","name":"Onchain Toolkit – ERC-20 Token Metadata Reader","description":"ERC-20 name, symbol, decimals and total supply read from the contract itself, and confirmation the address has code on that chain.","url":"https://onchain-toolkit.bowling-anthony.workers.dev/token","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"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"symbol":"USDC","decimals":6,"looksLikeErc20":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gO0fPoPkiaN1oxBvS6XLa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads ERC-20 token name, symbol, decimals, and total supply directly from a smart contract, and verifies the address contains deployed code on the specified chain.","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the ERC-20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet?","exampleUseCases":[{"title":"Token metadata lookup for DeFi dashboard","prompt":"Can you pull the full token info — name, symbol, decimals, and total supply — for the contract 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum so I can display it in my dashboard?"},{"title":"Verify a suspicious token contract","prompt":"I received a token at address 0xdeadbeef00000000000000000000000000000001 on Polygon — can you check if there's actually a contract deployed there and what its name and symbol are?"},{"title":"Onboard a new ERC-20 for a wallet app","prompt":"We're adding support for a new token. Can you look up the name, symbol, and decimals for the contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum mainnet so we can configure it correctly?"}],"resultDescription":"Returns the ERC-20 token's on-chain name, symbol, decimals, and total supply as read directly from the contract, plus a boolean confirming whether contract bytecode exists at the given address on the specified chain.","failureModes":["Address has no deployed contract code — returns code-present: false and no token fields","Address is a non-ERC-20 contract that doesn't implement the standard interface — may return partial or null fields","Invalid or malformed contract address — likely a 400 or error response","Unsupported chain ID — endpoint may not support all EVM chains","Rate limit or payment failure — 402 or 429 response"],"whenToPreferThis":"Use this endpoint when you need authoritative, on-chain ERC-20 token metadata (name, symbol, decimals, total supply) read directly from the contract rather than from a third-party token list or database. Ideal when you need to verify a token is genuinely deployed and conforms to ERC-20, or when working with obscure or newly deployed tokens not yet indexed by aggregators.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:21.548Z","isFirstParty":false}