{"uid":"cap_fTMI7f0oqCnUPb74PgD2B","slug":"base-wallet-portfolio-valuation-live-onchain-c1dba8d8","name":"Base Wallet Portfolio Valuation (Live Onchain)","description":"Self-computed Base onchain toolkit for AI agents: ERC-20 safety scan, manipulation-resistant TWAP price oracle, gas/fee oracle, calldata decoder, token/address/contract intel, wallet approval-risk audit, and batch token triage — all computed live from raw Base chain, no third-party data.","url":"https://x402-data-api.bodhinindustries.workers.dev/portfolio","method":"GET","headers":{},"bodySchema":{"type":"object","required":["wallet"],"properties":{"tokens":{"type":"string","description":"Optional comma-separated extra Base ERC-20 addresses to include beyond the major-token set (up to 10)."},"wallet":{"type":"string","description":"Base wallet address to value (EOA or contract)."}}},"responseSchema":{"type":"object","properties":{"block":{"type":"integer","description":"Base block height"},"wallet":{"type":"string","description":"wallet valued"},"coverage":{"type":"string","description":"what was covered"},"holdings":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string","description":"token address or 'native'"},"priced":{"type":"boolean","description":"was it priced"},"source":{"type":"string","description":"quoter_v2 | stablecoin_ref | no_pool"},"symbol":{"type":"string","description":"symbol"},"balance":{"type":"string","description":"human balance"},"priceUsd":{"type":"number","description":"USD per token (or null)"},"valueUsd":{"type":"number","description":"USD value of this holding"}}}},"totalUsd":{"type":"number","description":"total USD value (priced holdings)"},"computedAt":{"type":"string","description":"ISO-8601 timestamp"},"ethPriceUsd":{"type":"number","description":"self-computed ETH/USD (or null)"},"pricedCount":{"type":"integer","description":"holdings that could be priced"},"holdingsCount":{"type":"integer","description":"holdings with balance > 0"},"thirdPartyDataUsed":{"type":"boolean","description":"always false"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a1X6iwhllschXP4U-I1v-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live USD portfolio valuation for a Base wallet address, pricing each ERC-20 and native ETH holding directly from on-chain data with no third-party price feeds.","exampleAgentPrompt":"What is the current total USD value of my Base wallet 0x4a7d3b6f... across all its ERC-20 tokens and ETH, priced live from on-chain — no third-party data?","exampleUseCases":null,"resultDescription":"A JSON object containing: the Base block height at time of computation, the wallet address, a list of all holdings with balance > 0 (each with token address, symbol, human-readable balance, USD price, USD value, and pricing source), the total USD value of priced holdings, a count of priced vs total holdings, the self-computed ETH/USD price, an ISO-8601 timestamp, and a flag confirming no third-party data was used.","failureModes":["Invalid or malformed wallet address returns an error or empty holdings","Token addresses in the optional 'tokens' param that are not valid ERC-20s on Base may be skipped or return no_pool pricing source","Tokens with no Uniswap pool on Base return priced:false and null priceUsd","Network or RPC errors on the Base chain may cause computation failure","Exceeding 10 extra token addresses in the 'tokens' param may result in truncation or error"],"whenToPreferThis":"Choose this endpoint when you need a live, self-computed USD valuation of a Base wallet with no reliance on third-party price oracles or data providers — ideal for scenarios requiring trustless, manipulation-resistant pricing sourced directly from Base chain state. Prefer this over Etherscan or CoinGecko-backed portfolio APIs when auditability and on-chain provenance of prices matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:00.363Z","isFirstParty":false}