{"uid":"cap_WrhOis5Fy_1loMfUBifnW","slug":"postandshare-erc-20-token-balance-lookup-e5054c09","name":"Postandshare ERC-20 Token Balance Lookup","description":"x402 pay-per-call data endpoints for AI agents: multi-chain reads (Base, Ethereum, Arbitrum, Polygon) and Nigerian reference data. Format/reference validation only — no personal data, no identity-database lookup.","url":"https://api.postandshare.net/v1/chain/token?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","description":"0x-prefixed ERC-20 contract address"},"holder":{"type":"string","description":"0x-prefixed wallet address"},"network":{"enum":["base","ethereum","arbitrum","polygon"],"type":"string","description":"Chain to read (default base)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-1XwlDunVNAoDFcWukyW8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ERC-20 token balance for a given wallet address and contract on Base, Ethereum, Arbitrum, or Polygon","exampleAgentPrompt":"What's the USDC balance (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) held by wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Check how many tokens the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds of the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need the raw balance."},{"title":"Base chain token holding verification","prompt":"Look up the token balance for contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 held by address 0x1234567890abcdef1234567890abcdef12345678 on Base."},{"title":"Arbitrum DeFi agent balance read","prompt":"Tell me how many tokens wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 has of the token at contract 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 on Arbitrum."}],"resultDescription":"Returns the on-chain ERC-20 token balance for the specified wallet address and token contract on the requested network. Typically includes the raw balance amount and possibly formatted decimals.","failureModes":["Invalid or malformed 0x-prefixed address returns an error","Unsupported network value returns a validation error","Token contract address that is not a valid ERC-20 contract may return zero or an error","Network congestion or RPC issues may cause timeouts","Missing required token or holder parameter returns 400-level error"],"whenToPreferThis":"Choose this endpoint when you need a pay-per-call, no-infrastructure ERC-20 token balance read across Base, Ethereum, Arbitrum, or Polygon without managing your own RPC node. Ideal for AI agents that need occasional on-chain reads without committing to a full blockchain data provider subscription. At $0.001 USDC per call via x402, it suits low-frequency or on-demand balance checks in agentic workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:40:31.229Z","isFirstParty":false,"canonicalSlug":"postandshare-erc-20-token-balance-lookup-e5054c09"}