{"uid":"cap_xXhyKwikEk8PmdVBAWzEk","slug":"erc20-token-metadata-lookup-b24e5cd9","name":"ERC20 Token Metadata Lookup","description":"ERC20 token metadata by contract address and chain: name, symbol, decimals, logo, total supply and verified-contract flag, from an indexed source behind an API key. Data agents cannot self-derive. token metadata, erc20 info, token name symbol decimals, contract metadata, token logo Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/token/metadata","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":{"chain":{"type":"string","description":"ethereum, base, arbitrum, polygon, bsc, optimism (default ethereum)"},"address":{"type":"string","description":"token contract 0x..."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_okKk1vN3RN79oYP_sXsCt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns name, symbol, decimals, logo, total supply, and verified-contract status for any ERC20 token by contract address and chain ID from an indexed source.","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the ERC20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet (chain 1)?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the token's human-readable name, ticker symbol, decimal precision, logo image URL, total supply (raw and/or formatted), and a boolean flag indicating whether the contract is verified — all sourced from an indexed off-chain data store.","failureModes":["Invalid or malformed contract address returns a 4xx error","Contract address not found or not an ERC20 token returns empty or error response","Unsupported chain ID returns an error indicating the chain is not indexed","Missing API key or invalid authentication returns 401 unauthorized","Rate limit exceeded returns 429 too many requests"],"whenToPreferThis":"Use this endpoint when you need rich, pre-indexed ERC20 token metadata — including logo and verified status — that cannot be efficiently self-derived from raw on-chain calls. Prefer this over direct RPC calls when you need logo URLs, verification flags, or want a single fast call instead of multiple eth_call requests. Best suited for agents enriching token data in DeFi dashboards, portfolio trackers, or risk analysis pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:55:55.901Z","isFirstParty":false}