{"uid":"cap_Ql1infDQMiZ5KiHZGrzZc","slug":"tokeninfo-erc-20-token-metadata-lookup-559b9377","name":"Tokeninfo – ERC-20 Token Metadata Lookup","description":"Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.","url":"https://stablecrypto.dev/api/etherscan/token/tokeninfo","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chainid":{"type":"number","description":"EVM chain ID (1=Ethereum, 137=Polygon, 8453=Base, etc.)"},"contractaddress":{"type":"string","description":"Token contract address"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CNYrza0ess_781_8YLBGg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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, decimals, and holder count for a token contract on any EVM-compatible chain","exampleAgentPrompt":"What's the name, symbol, and number of holders for the token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet (chain ID 1)?","exampleUseCases":null,"resultDescription":"Returns structured token metadata including the human-readable token name (e.g. 'USD Coin'), ticker symbol (e.g. 'USDC'), decimal precision (e.g. 6), and the total number of on-chain holders for the specified contract.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Unsupported chain ID returns an error","Contract address is not an ERC-20 token (e.g. NFT or EOA) may return incomplete data","Network or Etherscan API timeout causes a 5xx or timeout error","Malformed request missing required fields returns a 400 validation error"],"whenToPreferThis":"Use this endpoint when you need quick, structured token metadata (name, symbol, decimals, holder count) for a known contract address on any EVM chain, especially when you already have the contract address and just need to resolve human-readable details or holder statistics. Prefer this over a generic RPC call when you want holder count specifically, which is not available via standard JSON-RPC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:20.034Z","isFirstParty":false}