{"slug":"x402-gateway-blackwoodstate8-workers-dev-v1-wallet-value-84dda6","title":"Use when you need a wallet portfolio value in USD, a wallet net worth or token b","host":"x402-gateway.blackwoodstate8.workers.dev","method":"POST","resource":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-value","category":"market","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 m","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1238,"reported_calls_30d":3,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"address":"0x87DB3C25d1E8E40f8EF240D48a711B0C355CF8Cf","chains":["base"]},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"Wallet address (0x...) on Ethereum and Base, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"chains":{"description":"Chains to value (ethereum and base when omitted), e.g. [\"base\"]","items":{"enum":["ethereum","base"],"type":"string"},"maxItems":2,"minItems":1,"type":"array"}},"required":["address"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"address":{"type":"string"},"chains":{"additionalProperties":false,"properties":{"base":{"type":["number","null"]},"ethereum":{"type":["number","null"]}},"required":["ethereum","base"],"type":"object"},"errors":{"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"type":"object"},"holdings":{"items":{"additionalProperties":false,"properties":{"balance":{"type":"string"},"chain":{"enum":["ethereum","base"],"type":"string"},"contract":{"type":["string","null"]},"priceUsd":{"type":["number","null"]},"symbol":{"type":"string"},"valueUsd":{"type":["number","null"]}},"required":["chain","symbol","contract","balance","priceUsd","valueUsd"],"type":"object"},"type":"array"},"next":{"additionalProperties":false,"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","properties":{"method":{"enum":["GET","POST"],"type":"string"},"sample":{"description":"Free fixed sample of the whole family","type":"string"},"service":{"description":"Service id of the suggested next paid call","type":"string"},"tool":{"description":"MCP tool name of the same call","type":"string"},"url":{"description":"Paid route of the next call","type":"string"},"useWhen":{"description":"When the next call is the right one","type":"string"}},"required":["service","tool","method","url","useWhen","sample"],"type":"object"},"note":{"type":"string"},"totalUsd":{"type":"number"},"unpriced":{"items":{"additionalProperties":false,"properties":{"chain":{"enum":["ethereum","base"],"type":"string"},"reason":{"type":"string"},"symbol":{"type":"string"}},"required":["chain","symbol","reason"],"type":"object"},"type":"array"},"updatedAt":{"type":"string"}},"required":["address","totalUsd","chains","holdings","unpriced","errors","updatedAt","note"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":1238,"error":null}],"description_full":"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.","last_updated":"2026-10-18T15:25:10.599Z","schemes":["exact","upto"]}