{"uid":"cap_Hylp0KruS6GVhO_8cPhAw","slug":"xerxes-erc-20-balanceof-4d437f6e","name":"Xerxes ERC-20 balanceOf","description":"Returns the ERC-20 token balance of a given address for a specified token contract. Provide token (ERC-20 contract address) and address (holder address). Query: token (ERC-20 contract, 0x + 40 hex), address (holder, 0x + 40 hex).","url":"https://ari001.tailb4ac3a.ts.net/v1/ventures/ethereum_contract_abi_service/erc20_balanceof?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["token","address"],"properties":{"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"ERC-20 contract, 0x + 40 hex"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"holder, 0x + 40 hex"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean"},"chain":{"type":"string"},"error":{"type":"string","description":"present when ok is false"},"method":{"type":"string"},"result":{"type":"string","description":"the uint256 as a decimal string"},"service":{"type":"string"}}}}}}},"responseSchema":null,"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_LYaxHx7D07DdCpVYVSwpn","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 ERC-20 token balance of a specific wallet address for a given token contract on Ethereum mainnet","exampleAgentPrompt":"What's the current USDC balance of the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"How many USDT tokens does the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold? The USDT contract is 0xdAC17F958D2ee523a2206206994597C13D831ec7."},{"title":"Gating access by token holdings","prompt":"Check if the address 0xAbCd1234AbCd1234AbCd1234AbCd1234AbCd1234 holds any of our governance token at contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 — we need to know if they qualify for premium access."},{"title":"Monitoring whale wallet token exposure","prompt":"Tell me the current balance of WETH tokens (contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) held by the address 0x8315177aB297bA92A06054cE80a67Ed4DBd7ed3a so I can track their position."}],"resultDescription":"A JSON object with 'ok' (boolean success flag), 'result' (the token balance as a uint256 decimal string), 'chain' (the blockchain network), 'service' (service identifier), and on failure an 'error' string describing what went wrong.","failureModes":["Invalid ERC-20 contract address format returns a 400 or error response","Invalid holder address format returns error","Non-ERC-20 contract address (e.g. EOA or non-standard contract) may return zero or error","Network issues with Ethereum node cause timeouts","Contract address that does not implement balanceOf returns an error","Payment not included or insufficient (x402) results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to look up the on-chain ERC-20 token balance for a specific wallet address on Ethereum mainnet. Prefer this over general blockchain explorers when you need a programmatic, machine-readable decimal balance for agent workflows, DeFi logic, access gating, or portfolio tracking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T01:23:24.779Z","isFirstParty":false,"canonicalSlug":"xerxes-erc-20-balanceof-4d437f6e"}