{"uid":"cap_tLSZSeZeyWW9tUm1zH-Db","slug":"erc-20-token-metadata-lookup-68705d7e","name":"ERC-20 Token Metadata Lookup","description":"41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.","url":"https://x402-micro-pay.com/api/skills/erc20-meta?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum"],"type":"string","default":"base"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract address"},"holder":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional holder for balanceOf"},"request_id":{"type":"string","pattern":"^[A-Za-z0-9._:-]+$","maxLength":64,"minLength":1,"description":"Optional idempotency key. Echoed back; a credit-pack redemption with the same request_id and body is charged once."}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"name":"USD Coin","block":22000000,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","chain_id":8453,"decimals":6,"is_contract":true,"total_supply":"1000000000000000","holder_balance":null,"total_supply_fmt":"1000000000","holder_balance_fmt":null},"next":["token_price","token_risk"],"skill":"erc20_meta","charged":true,"service":"erc20_meta","sources":[{"url":"https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"base eth_call/multicall3","block":22000000,"fetched_at":"2026-10-24T14:00:00Z"}],"summary":"USDC decimals=6 supply=…","version":"1.0.0","warnings":[],"confidence":0.95,"data_as_of":"2026-10-24T14:00:00Z","generated_at":"2026-10-24T14:00:00Z"}},"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_AXaOoPdYDL1r1Sjr13QSU","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":"Fetches on-chain metadata for an ERC-20 token contract (name, symbol, decimals, total supply, and optional holder balance) on Base or Ethereum.","exampleAgentPrompt":"What are the name, symbol, decimals, and total supply of the ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"Token identity check before DeFi interaction","prompt":"Before I swap, can you confirm what token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 is on Base — its full name, symbol, and how many decimals it uses?"},{"title":"Portfolio balance lookup for a wallet","prompt":"Check how many tokens the wallet 0xAbCd1234...5678 holds for the ERC-20 contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, and tell me the formatted balance."},{"title":"Due diligence on a new token listing","prompt":"I'm researching a token at 0x1234abcd...on Ethereum — can you pull its on-chain metadata like name, symbol, total supply, and confirm it's actually a deployed contract?"}],"resultDescription":"Returns a JSON object with token name, symbol, decimals, total supply (raw and formatted), holder balance if requested (raw and formatted), chain ID, block number at which data was fetched, whether the address is a contract, data freshness timestamps, confidence score, source attribution (e.g. Basescan), and suggested next skills to call (e.g. token_price, token_risk).","failureModes":["Invalid contract address format (must be 0x-prefixed 40-hex-char) returns validation error","Address is an EOA (externally owned account), not an ERC-20 contract — is_contract=false, token fields may be null","Unsupported chain value other than 'base' or 'ethereum' returns schema validation error","No payment sent — server returns HTTP 402 requiring USDC payment on Base via x402","Network RPC timeout or block reorg causes stale or missing block data","Holder address provided but has zero balance — holder_balance returns 0 not null"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain ERC-20 metadata (name, symbol, decimals, supply) directly from the blockchain rather than from a centralized token registry or price feed. Ideal for validating unknown contract addresses, enriching token data pipelines, or checking a wallet's token balance — especially when no API key or account setup is acceptable and pay-per-call USDC billing via x402 on Base is preferred.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T06:51:30.329Z","isFirstParty":false,"canonicalSlug":"erc-20-token-metadata-lookup-68705d7e"}