{"uid":"cap_pnCCQVdibSxChxZgdsMkg","slug":"wallet-portfolio-value-0b3ecd20","name":"Wallet Portfolio Value","description":"Wallet balances, tokens, transactions and prices on Base, Ethereum and Solana. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://data.tollkit.dev/openapi.json.","url":"https://chain.tollkit.dev/chain/portfolio?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum","solana"],"type":"string","default":"base","description":"Which chain to read: \"base\" (default), \"ethereum\" or \"solana\"."},"tokens":{"type":"array","items":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$"},"maxItems":20,"description":"Extra token contracts or SPL mints to include."},"address":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$","description":"Wallet address."}}},"responseSchema":{"type":"json","example":{"note":"Covers the native coin, USDC/USDT and any tokens you list in `tokens`. Prices are read from on-chain pools at this moment.","chain":"base","address":"0xBbfCE2D320dE6aB328Ba93A771c531ebFC9cE704","holdings":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":2.222,"symbol":"USDC","warning":null,"price_usd":1,"value_usd":2.22,"pool_depth_usd":null}],"checked_at":"2026-10-04T07:45:41.538Z","explorer_url":"https://basescan.org/address/0xBbfCE2D320dE6aB328Ba93A771c531ebFC9cE704","total_value_usd":2.22,"unpriced_holdings":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.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_TUR_mpIX0y69PYRMz9HDz","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 total portfolio value and token holdings (native coin, USDC, USDT, and specified tokens) for a wallet address on Base, Ethereum, or Solana with real-time USD prices from on-chain pools.","exampleAgentPrompt":"What is the total USD value of my wallet 0xBbfCE2D320dE6aB328Ba93A771c531ebFC9cE704 on Base, including USDC and the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"DeFi portfolio net worth check","prompt":"Can you tell me the total USD value of everything held in this Ethereum wallet: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? Include USDC and USDT."},{"title":"Solana wallet token audit","prompt":"Give me a full breakdown of all tokens and their USD values in the Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM right now."},{"title":"Automated portfolio monitoring alert","prompt":"Check the current portfolio value on Base for wallet 0x1234567890abcdef1234567890abcdef12345678 and also include the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to know the total USD worth and each holding's value."}],"resultDescription":"Returns a JSON object with the chain name, wallet address, a list of holdings (each with asset contract, symbol, amount, USD price sourced from on-chain pools, USD value, and any warnings), total portfolio USD value, count of unpriced holdings, timestamp of the check, and a block explorer URL for the wallet.","failureModes":["Invalid wallet address format returns a validation error","Unsupported chain value outside base/ethereum/solana is rejected","Token contract address not found on the specified chain may appear as unpriced holding","Insufficient x402 payment (0.008 USDC) results in payment-required error","On-chain pool data unavailable for exotic tokens results in null price and warning flag","Rate limiting or node unavailability may cause transient 5xx errors"],"whenToPreferThis":"Use this endpoint when you need a comprehensive USD-denominated snapshot of all assets in a single wallet across Base, Ethereum, or Solana — especially when you want both native coin and ERC-20/SPL token values aggregated into a total. Prefer this over a simple balance check when you need portfolio-level value aggregation with real-time on-chain prices. The ability to include up to 20 extra token contracts makes it ideal for DeFi power users tracking custom tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:38:23.803Z","isFirstParty":false,"canonicalSlug":"wallet-portfolio-value-0b3ecd20"}