{"uid":"cap_un7WnVcnXzOWrLiJlMe2u","slug":"agent-data-tools-wallet-portfolio-7a4308e8","name":"Agent Data Tools – Wallet Portfolio","description":"USD value of a wallet on Base, Ethereum, Arbitrum or Optimism: native ETH plus major tokens (USDC and WETH everywhere, the common Base tokens on Base) and up to 20 tokens you add, each priced from its deepest Uniswap v3 pool, read live from the chain. Returns holdings, total and anything that could not be priced. Not a full token inventory. Use to check what a wallet is worth before trading, lending or paying.","url":"https://agent-data-tools.revmesh2074.workers.dev/wallet/portfolio?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","eth","arb","op"],"type":"string","description":"Network: base (default), eth, arb or op"},"tokens":{"type":"string","description":"Optional extra comma-separated 0x token addresses (up to 20)"},"address":{"type":"string","description":"0x wallet address"}}},"responseSchema":{"type":"object","properties":{"note":{"type":"string"},"block":{"type":"number"},"chain":{"type":"string"},"ethUsd":{"type":"number"},"method":{"type":"string"},"address":{"type":"string"},"chainId":{"type":"number"},"holdings":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"symbol":{"type":"string"},"balance":{"type":"string"},"priceUsd":{"type":"number"},"quotedIn":{"type":"string"},"valueUsd":{"type":"number"}}}},"totalUsd":{"type":"number"},"unpriced":{"type":"array","items":{}},"tokensChecked":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USD","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_unILRezmH5I0jPdYa-7yy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token holdings and USD values for a given wallet address on Base, Ethereum, Arbitrum, or Optimism, priced via Uniswap v3 spot prices.","exampleAgentPrompt":"What's the current portfolio value and token breakdown for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — including any USDC and ETH holdings?","exampleUseCases":[{"title":"Check DeFi wallet value before trade","prompt":"What's the total USD value and full token breakdown for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum right now? I want to see each token's balance and price."},{"title":"Monitor a watched address on Arbitrum","prompt":"Can you pull the current portfolio for address 0xAbCd1234...5678 on Arbitrum and tell me what tokens it holds and how much each is worth in USD?"},{"title":"Verify portfolio before OFAC screening","prompt":"Look up the wallet holdings for 0x1234abcd...ef on Base — I need the list of tokens, their balances and USD values so I can review the account."}],"resultDescription":"A JSON object containing the wallet address, chain name and ID, current block number, ETH/USD rate, an array of holdings (each with token address, symbol, balance, USD price, quote source, and USD value), the total portfolio USD value, a list of unpriced tokens, and the count of tokens checked.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain value returns a validation error","Token not traded on Uniswap v3 against USDC or WETH appears in 'unpriced' array","Network or RPC timeout may result in a failed call (not charged)","More than 20 extra tokens passed in the 'tokens' param may be rejected"],"whenToPreferThis":"Use this endpoint when you need a real-time USD valuation of a wallet's on-chain token holdings across Base, Ethereum, Arbitrum, or Optimism, priced at live Uniswap v3 spot rates, without needing an API key or account. Prefer this over centralized portfolio APIs when you need decentralized, on-chain accuracy and pay-per-call pricing with no subscription commitment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:30:12.385Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-wallet-portfolio-7a4308e8"}