{"uid":"cap_s5sMg4I1GhocnhYgaEM94","slug":"financial-data-x402-erc-20-token-balance-lookup-ba39297f","name":"Financial Data x402 — ERC-20 Token Balance Lookup","description":"Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.","url":"https://x402financialdata.com/token-balance/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":"raw_balance is in the token's smallest unit -- this endpoint doesn't return the token's decimals, so divide by 10**decimals yourself for a human-readable amount (most ERC-20s use 18, but not all).","chain":"eth","address":"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae","raw_balance":"125500000","token_contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__XDfubPqCv10VYYU77Gr7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the raw on-chain token balance of a given wallet address for an ERC-20 token contract on a specified chain, paid per-call via x402/USDC.","exampleAgentPrompt":"What is the raw on-chain ERC-20 token balance for wallet address 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae on Ethereum — I need the raw balance in the token's smallest unit so I can divide by decimals myself.","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Look up the raw token balance for wallet 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae on Ethereum for the USDC contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 — I want the smallest-unit number so I can calculate the human-readable amount."},{"title":"Verify airdrop eligibility by balance","prompt":"Can you check whether wallet 0xABCDEF1234567890abcdef1234567890abcdef12 actually holds any tokens for contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Ethereum before I whitelist them for the airdrop?"},{"title":"Monitor whale wallet token holdings","prompt":"Fetch the current on-chain token balance for the whale wallet 0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503 on Ethereum for contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 — I want the raw balance in base units."}],"resultDescription":"Returns a JSON object containing: the blockchain chain identifier (e.g. 'eth'), the queried wallet address, the token contract address, and the raw_balance as a string in the token's smallest unit (e.g. wei for 18-decimal ERC-20s). Does not return the token's decimals; the caller must divide by 10^decimals (commonly 10^18) to get a human-readable amount.","failureModes":["Invalid or malformed wallet address returns an error response","Unknown or unsupported chain identifier may return empty or error","Payment failure via x402 (insufficient USDC) blocks the request","Token contract not deployed on the specified chain may return zero or error","Rate limiting or network issues on the underlying RPC node","Address with no token holdings returns raw_balance of '0'"],"whenToPreferThis":"Choose this endpoint when you need a quick, keyless, pay-per-call ERC-20 token balance lookup for an arbitrary wallet address without signing up for an API subscription. It is ideal for agents that need occasional on-chain balance checks at low cost ($0.01 USDC), support USDC micropayments via the x402 protocol, and want to avoid managing API credentials. Prefer it over free RPC calls when you want a reliable, hosted solution, or over subscription-based providers when call volume is low or unpredictable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:52:16.314Z","isFirstParty":false}