{"uid":"cap_VP0xt_v_FKEg5Q14Gavei","slug":"agenticfi-evm-wallet-token-balances-4b7672cb","name":"AgenticFi EVM Wallet Token Balances","description":"EVM token balances for a wallet - native + ERC-20 with Sim pricing, warnings, pagination, and optional historical prices","url":"https://defi-api.agenticfi.wtf/api/wallet/balances/:address","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","pathParams","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"}}},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","title":"chain (optional)","description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of balances to return, 1-1000 Examples: 100, 500"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)"},"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"},"filters":{"type":"string","title":"filters (optional)","description":"Optional. Filter balances by asset type: 'erc20' or 'native'"},"metadata":{"type":"string","title":"metadata (optional)","description":"Optional. Comma-separated extra metadata fields: 'logo', 'url', 'pools'"},"chain_ids":{"type":"string","title":"chain_ids (optional)","description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default"},"asset_class":{"type":"string","title":"asset_class (optional)","description":"Optional. Asset class filter, e.g. 'stablecoin'"},"historical_prices":{"type":"string","title":"historical_prices (optional)","description":"Optional. Comma-separated hour offsets, up to 3 values, e.g. '720,168,24' Examples: 720,168,24"},"exclude_spam_tokens":{"type":"string","title":"exclude_spam_tokens (optional)","description":"Optional. Set to 'true' to exclude tokens with less than $100 liquidity"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_tP2wYZgGum7Z0dh5QbeUJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native and ERC-20 token balances for an EVM wallet address across multiple chains, with USD pricing, asset warnings, and pagination support","exampleAgentPrompt":"What tokens does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base and Ethereum? Show me both native and ERC-20 balances with current USD prices, up to 100 results.","exampleUseCases":[{"title":"Monitor portfolio value across chains","prompt":"Check all the tokens I'm holding across Ethereum, Arbitrum, and Base right now. Give me the total USD value and list any risky assets with warnings."},{"title":"Audit DeFi wallet stablecoin exposure","prompt":"Show me every stablecoin in my wallet on multiple chains with their current USD prices. I need to know my total stablecoin holdings and any associated risk warnings."},{"title":"Track large holder positions","prompt":"Pull all token balances for wallet 0x1234567890123456789012345678901234567890 across all EVM chains. Include native assets and paginate through the full results with historical price data if available."}],"resultDescription":"A paginated list of token balances (native + ERC-20) held by the wallet, each with token symbol, amount, USD value via Sim pricing, asset class, optional logo/metadata, and any risk warnings. Also includes a next_offset cursor for pagination and optional historical price data.","failureModes":["Invalid or malformed wallet address returns 400 error","Unsupported chain_id or chain name returns 400 or empty result","Wallet with no balances returns empty list","Pagination cursor mismatch or expired offset returns error","Missing required address parameter returns 422 validation error","Payment not included or insufficient returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a comprehensive snapshot of all token holdings (native + ERC-20) for any EVM wallet across multiple chains, especially when you need USD pricing via Sim, asset risk warnings, or historical price data alongside balances. Prefer this over generic blockchain explorers when you need structured, agent-ready output with pagination and metadata in a single pay-per-call request.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:03.251Z","isFirstParty":false}