{"service":"wallet-value","version":"1.0.0","title":"Wallet value in USD","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.003 USDC per call. Typical response time 5000 ms (p95). Category: Trading.","paid":{"method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-value","scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"3000","amountUsdc":"0.003","payTo":"0x703aA725EBd995B3F32BB5132Effa8B90FCc2165","maxTimeoutSeconds":60},"input":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address (0x...) on Ethereum and Base, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"chains":{"description":"Chains to value (ethereum and base when omitted), e.g. [\"base\"]","minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["ethereum","base"]}}},"required":["address"]},"example":{"address":"0x87DB3C25d1E8E40f8EF240D48a711B0C355CF8Cf","chains":["base"]}},"output":{"schema":{"type":"object","properties":{"address":{"type":"string"},"totalUsd":{"type":"number"},"chains":{"type":"object","properties":{"ethereum":{"type":["number","null"]},"base":{"type":["number","null"]}},"required":["ethereum","base"],"additionalProperties":false},"holdings":{"type":"array","items":{"type":"object","properties":{"chain":{"type":"string","enum":["ethereum","base"]},"symbol":{"type":"string"},"contract":{"type":["string","null"]},"balance":{"type":"string"},"priceUsd":{"type":["number","null"]},"valueUsd":{"type":["number","null"]}},"required":["chain","symbol","contract","balance","priceUsd","valueUsd"],"additionalProperties":false}},"unpriced":{"type":"array","items":{"type":"object","properties":{"chain":{"type":"string","enum":["ethereum","base"]},"symbol":{"type":"string"},"reason":{"type":"string"}},"required":["chain","symbol","reason"],"additionalProperties":false}},"errors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"updatedAt":{"type":"string"},"note":{"type":"string"},"next":{"type":"object","properties":{"service":{"type":"string","description":"Service id of the suggested next paid call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"type":"string","enum":["GET","POST"]},"url":{"type":"string","description":"Paid route of the next call"},"useWhen":{"type":"string","description":"When the next call is the right one"},"sample":{"type":"string","description":"Free fixed sample of the whole family"}},"required":["service","tool","method","url","useWhen","sample"],"additionalProperties":false,"description":"Suggested next paid call in the same family (call it in a loop when the task continues)"}},"required":["address","totalUsd","chains","holdings","unpriced","errors","updatedAt","note"],"additionalProperties":false},"example":{"address":"0x87DB3C25d1E8E40f8EF240D48a711B0C355CF8Cf","totalUsd":8.47,"chains":{"ethereum":null,"base":8.47},"holdings":[{"chain":"base","symbol":"ETH","contract":null,"balance":"0.002360178464231316","priceUsd":2420.0937,"valueUsd":5.71},{"chain":"base","symbol":"USDC","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","balance":"2.756539","priceUsd":1,"valueUsd":2.76}],"unpriced":[],"errors":{},"updatedAt":"2026-10-18T04:14:44.193Z","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."}},"mcp":{"url":"https://x402-gateway.blackwoodstate8.workers.dev/mcp","tool":"blackwood_wallet_value"},"openapi":"https://x402-gateway.blackwoodstate8.workers.dev/openapi.json","status":"https://x402-gateway.blackwoodstate8.workers.dev/status.json"}