{"uid":"cap_b6vzjjA-9vZvGk17rhE1K","slug":"agenticfi-wallet-token-balances-74d3d3e1","name":"AgenticFi 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/%7Baddress%7D","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_JR2Q4z02t1u85_vohthM6","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":"Fetches all token balances (native and ERC-20) for a given wallet address across one or more EVM chains","exampleAgentPrompt":"What tokens and balances does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base and Ethereum — show me both native and ERC-20 assets, include logos, and limit the results to 100.","exampleUseCases":null,"resultDescription":"Returns a paginated list of token balances for the wallet, each entry including token symbol, contract address, chain, balance amount, and optionally logo URLs, pool data, and historical price information. Includes a next_offset cursor for pagination.","failureModes":["Invalid or malformed wallet address returns a 400 error","Unsupported chain_ids value returns an error or empty result","Payment not received (x402) returns 402 Payment Required","Address with no on-chain activity returns empty balance list","Pagination cursor (offset) is expired or invalid, returning an error","Rate limit or upstream data provider outage returns 5xx"],"whenToPreferThis":"Use this endpoint when you need a comprehensive multi-token, multi-chain balance snapshot for a specific EVM wallet address. Prefer it over single-chain block explorers when you need cross-chain aggregation, ERC-20 enumeration with metadata, or stablecoin/asset-class filtering in a single pay-per-call DeFi-native API.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:47:24.719Z","isFirstParty":false}