{"uid":"cap_TAjIo4vm1fCBBbfOnKx12","slug":"tracefast-erc-20-token-balance-by-block-a2901b6b","name":"TraceFast ERC-20 Token Balance by Block","description":"TraceFast live Ethereum data: balanceOf(address) for one token at the end of a block, read from contract storage. A token outside the covered set is refused (422), never a fake zero. Path address and token: 0x-prefixed, 40 hex. Query block: integer, state at the end of this block, absent = current. Docs: https://docs.tracefast.xyz/api/address-token-balance.md","url":"https://mpp.tracefast.xyz/api/v1/chains/1/entities/:address/tokens/:token/balance","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"required":["method"],"properties":{"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pI-DE7p1_uQfw3h_R5KOo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the on-chain balance of a specific ERC-20 token for a given Ethereum address, read from contract storage at the end of a specified block.","exampleAgentPrompt":"What's the USDC balance of Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 at block 20000000? Use TraceFast to read it directly from contract storage.","exampleUseCases":[{"title":"Historical portfolio snapshot audit","prompt":"What was the WETH balance of address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 at the end of Ethereum block 19500000? I need the exact on-chain figure from contract storage."},{"title":"Real-time whale wallet monitoring","prompt":"Check the current DAI balance for wallet 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 on Ethereum — I want the live figure straight from the contract."},{"title":"DeFi protocol collateral verification","prompt":"What is the USDC balance held by the Aave v3 pool contract at 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 as of block 20100000? I need to verify the exact on-chain collateral amount."}],"resultDescription":"Returns the token balance (as a numeric value from contract storage) for the specified address and ERC-20 token, reflecting state at the end of the requested block. If no block is specified, returns the current state. If the token is outside the covered set, the API returns a 422 error rather than a fake zero.","failureModes":["422 Unprocessable Entity — token contract is outside the covered set (not a zero balance, a genuine refusal)","Invalid address format — address or token not 0x-prefixed or not 40 hex characters","Block number not yet indexed — querying a very recent block may fail","Payment failure — x402 micropayment not completed, request rejected","Network error or service unavailability on TraceFast infrastructure"],"whenToPreferThis":"Choose this endpoint when you need a single, precise ERC-20 token balance for one address at a specific block, read directly from contract storage with guaranteed accuracy (no fake zeros for unsupported tokens). Prefer it over general portfolio endpoints when you only need one token's balance, or when historical block-level precision is required. It is especially useful in DeFi analytics, audit trails, and agent workflows that need to verify token holdings at a deterministic point in time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:27.809Z","isFirstParty":false}