{"uid":"cap_xMgvQn8su0nn-xADGuACn","slug":"2s-io-crypto-token-metadata-3cf24410","name":"2s.io Crypto Token Metadata","description":"Live on-chain token metadata for an ERC-20 or ERC-721 contract (Base, Ethereum, Polygon, Arbitrum, Optimism; keyless). Returns name, symbol, decimals, detected standard, and total supply (raw + formatted). The authoritative read straight from the contract — complements crypto.token-price and crypto.contract (ABI/source).","url":"https://2s.io/api/crypto/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","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","polygon","arbitrum","optimism"],"type":"string","description":"Default base."},"address":{"type":"string","description":"Token contract address."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0036","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.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F6q3ve4QQWZWoRBKWmUIt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live on-chain metadata for an ERC-20 or ERC-721 token contract across Base, Ethereum, Polygon, Arbitrum, and Optimism — returning name, symbol, decimals, detected standard, and total supply.","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":null,"resultDescription":"Returns the token's on-chain name, symbol, number of decimals, detected token standard (ERC-20 or ERC-721), and total supply in both raw integer form and human-readable formatted form — read directly from the contract.","failureModes":["Invalid or non-existent contract address returns an error or empty metadata","Contract address exists but is not an ERC-20 or ERC-721 (e.g. proxy, multisig) — standard may be undetectable","Unsupported chain value returns validation error","Network congestion or RPC issues may cause delayed or failed on-chain reads","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need authoritative, live on-chain token metadata (name, symbol, decimals, total supply, token standard) directly from the contract — not from a centralized index that may be stale. Ideal for verifying token details before a swap, enriching a portfolio view, or confirming ERC standard. Complements price endpoints (which give market data) and ABI/source endpoints (which give contract code).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:59:42.649Z","isFirstParty":false}