USD-valued portfolio for a wallet on Base, priced from Chainlink on-chain oracles.
Reads the wallet's native ETH plus major ERC-20 balances, reads each asset's Chainlink USD aggregator directly on-chain, and returns holdings with per-asset prices and dollar values, sorted largest first, stamped with the block height.
Prices come from Chainlink contracts rather than a price API, so there is no vendor key, no rate limit, and no third-party terms attached to the result.
Covered assets: ETH (native), WETH, USDC, cbBTC. Zero-balance assets are listed in "emptyAssets" rather than cluttering holdings.
When to use: valuing a wallet, treasury reporting, checking what an address actually holds in dollar terms.
When NOT to use: you need an exhaustive scan of every token a wallet has ever received (this checks a curated major-asset set, not an indexer), LP or staked positions, NFTs, or chains other than Base.
Args:
- address (string, required): the wallet address to value.
Returns structuredContent:
{
"address": "0x...", "chain": "base", "chainId": 8453, "blockNumber": 49976942,
"holdings": [
{ "symbol": "ETH", "kind": "native", "address": null,
"raw": "1500000000000000000", "balance": "1.5",
"priceUsd": 3120.44, "valueUsd": 4680.66 }
],
"totalValueUsd": 4680.66,
"emptyAssets": ["cbBTC"],
"priceSource": "Chainlink on-chain price feeds (Base)"
}
If every balance read fails the call errors and is not billed; a genuinely empty wallet returns an
empty holdings list with totalValueUsd 0.