{"uid":"cap_hQd2uRLlOvFXPAQ_wMftN","slug":"wallet-portfolio-usd-value-ethereum-base-d86c61e0","name":"Wallet Portfolio USD Value (Ethereum & Base)","description":"Use when you need a wallet portfolio value in USD, a wallet net worth or token balances with USD value for a 0x address. Do not use for solana wallets, transaction history, NFTs, DeFi positions or long-tail tokens. Returns JSON with a wallet's USD value on Ethereum and Base in one call: native and major-token balances priced on-chain from Uniswap v3 pools on Base, per-chain totals and the tokens left unpriced for 0.005 USDC per call. Typical response time 5000 ms (p95). Category: Trading.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-value?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["address"],"properties":{"chains":{"type":"array","items":{"enum":["ethereum","base"],"type":"string"},"maxItems":2,"minItems":1,"description":"Chains to value (ethereum and base when omitted), e.g. [\"base\"]"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address (0x...) on Ethereum and Base, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","totalUsd","chains","holdings","unpriced","errors","updatedAt","note"],"properties":{"next":{"type":"object","required":["service","tool","method","url","useWhen","sample"],"properties":{"url":{"type":"string","description":"Paid route of the next call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"enum":["GET","POST"],"type":"string"},"sample":{"type":"string","description":"Free fixed sample of the whole family"},"service":{"type":"string","description":"Service id of the suggested next paid call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"note":{"type":"string"},"chains":{"type":"object","required":["ethereum","base"],"properties":{"base":{"type":["number","null"]},"ethereum":{"type":["number","null"]}},"additionalProperties":false},"errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"address":{"type":"string"},"holdings":{"type":"array","items":{"type":"object","required":["chain","symbol","contract","balance","priceUsd","valueUsd"],"properties":{"chain":{"enum":["ethereum","base"],"type":"string"},"symbol":{"type":"string"},"balance":{"type":"string"},"contract":{"type":["string","null"]},"priceUsd":{"type":["number","null"]},"valueUsd":{"type":["number","null"]}},"additionalProperties":false}},"totalUsd":{"type":"number"},"unpriced":{"type":"array","items":{"type":"object","required":["chain","symbol","reason"],"properties":{"chain":{"enum":["ethereum","base"],"type":"string"},"reason":{"type":"string"},"symbol":{"type":"string"}},"additionalProperties":false}},"updatedAt":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"note":"USD values use the on-chain price of the same asset on Base: its deepest Uniswap v3 pool against USDC or WETH (USDC counts as 1 USD). Ethereum tokens are priced through their Base counterpart (same issuer or canonical bridge); tokens without one, or without a liquid pool, are listed in unpriced and left out of the totals. Balances cover the native coin and a fixed list of major tokens; values are rounded to cents.","chains":{"base":8.47,"ethereum":null},"errors":{},"address":"0x87DB3C25d1E8E40f8EF240D48a711B0C355CF8Cf","holdings":[{"chain":"base","symbol":"ETH","balance":"0.002360178464231316","contract":null,"priceUsd":2420.0937,"valueUsd":5.71},{"chain":"base","symbol":"USDC","balance":"2.756539","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","priceUsd":1,"valueUsd":2.76}],"totalUsd":8.47,"unpriced":[],"updatedAt":"2026-10-18T04:14:44.193Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_B2gUAaYL-2B3H_0pd1X_q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the total USD value, native and major-token balances, and per-chain totals for a 0x wallet address on Ethereum and Base, priced via Uniswap v3 pools.","exampleAgentPrompt":"What's the total USD value of the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on both Ethereum and Base — I want to know the net worth broken down by chain and which tokens are held.","exampleUseCases":[{"title":"Personal portfolio net worth check","prompt":"What's my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 worth in USD right now across Ethereum and Base? Break it down by chain for me."},{"title":"Due diligence on a counterparty wallet","prompt":"Before we proceed, can you look up what 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B holds across Ethereum and Base and give me the total USD value?"},{"title":"Base-only wallet valuation","prompt":"What's the USD value of the wallet 0x1234567890abcdef1234567890abcdef12345678 on Base only — just Base, not Ethereum?"}],"resultDescription":"Returns a JSON object with the wallet's total USD value, per-chain USD totals (Ethereum and Base), native and major ERC-20 token balances with individual USD prices sourced from Uniswap v3 on-chain pools, a list of tokens that could not be priced, any per-chain errors, a timestamp, and an optional suggested next call.","failureModes":["Invalid 0x address format returns validation error","Solana or non-EVM addresses are not supported","Long-tail or obscure tokens are returned in the unpriced list rather than valued","RPC or on-chain data unavailability may cause per-chain errors","High latency (~5 s p95) may cause timeouts in low-timeout agent pipelines","NFTs, DeFi positions, and staked assets are not included in the valuation"],"whenToPreferThis":"Use this endpoint when you need a quick, single-call USD net worth or token balance snapshot for a 0x wallet address on Ethereum and/or Base. It is ideal for major EVM tokens priced on-chain via Uniswap v3. Prefer alternatives for Solana wallets, NFT valuations, DeFi position breakdowns, transaction history, or long-tail token pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:35:20.616Z","isFirstParty":false,"canonicalSlug":"wallet-portfolio-usd-value-ethereum-base-d86c61e0"}