{"uid":"cap_wwb9A1euCXYImS85H0v3f","slug":"erc20-token-balance-for-one-holder-9917d044","name":"ERC20 Token Balance for One Holder","description":"ERC20 token balance for one holder — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/erc20-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string"},"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"erc20-balance","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.003,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7Az29gpOOJpndBo_8zaM9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ERC20 token balance of a specific wallet address for a given token contract on a supported EVM chain","exampleAgentPrompt":"What's the USDC balance for wallet 0xAbC1234567890abcdef1234567890abcdef1234 on Base — the USDC contract is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"DeFi portfolio tracker balance check","prompt":"What's the USDT balance for wallet 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe on Ethereum — the USDT contract address is 0xdAC17F958D2ee523a2206206994597C13D831ec7?"},{"title":"Verify token holdings before allowlisting","prompt":"Check whether wallet 0x1234567890abcdef1234567890abcdef12345678 holds any governance tokens on Arbitrum — the token contract is 0x912CE59144191C1204E64559FE8253a0e49E6548."},{"title":"Monitor whale wallet on Polygon","prompt":"What's the current MATIC token balance for address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Polygon using token contract 0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0?"}],"resultDescription":"Returns a JSON object with ok status, balance details, and a payment receipt including transaction hash, USD amount charged, and a unique receipt ID, along with an ISO8601 timestamp of when the data was generated.","failureModes":["Invalid owner or contract address format (must match 0x[40 hex chars] pattern)","Unsupported chain name outside the allowed enum values","Token contract does not exist on the specified chain","Network or RPC node connectivity issues causing delayed or failed response","Insufficient payment causing 402 rejection before data is returned"],"whenToPreferThis":"Use this endpoint when you need a fast, on-demand ERC20 token balance lookup for a single wallet-contract pair on any of 10 major EVM-compatible chains (Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Gnosis, Linea, Scroll). Prefer it over raw RPC calls or broader portfolio APIs when you want a simple pay-per-call model with no API key setup, especially in agent workflows that need to verify token holdings, check DeFi positions, or audit wallet state programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:37.526Z","isFirstParty":false,"canonicalSlug":"erc20-token-balance-for-one-holder-9917d044"}