{"uid":"cap_LOblfrkh9VuJtCZxl0qJ2","slug":"base-wallet-portfolio-balances-api-0185cfae","name":"Base Wallet Portfolio Balances API","description":"Base wallet portfolio in one call: native + major ERC-20 balances with USD values and total. Onchain USDC pay-per-call.","url":"https://build-4c941cab041172e9439ece2f.emblem.build/pub/tasks/x402-onchain/api/portfolio","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3alWu5TAMfla4rDc_dF_k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches native ETH and major ERC-20 token balances with USD values and a total portfolio value for a given Base wallet address in a single call.","exampleAgentPrompt":"Can you pull up the full portfolio for Base wallet 0x1234...abcd — I want to see the native ETH balance, all major ERC-20 tokens, their USD values, and the total portfolio worth?","exampleUseCases":[{"title":"DeFi portfolio tracker for a user","prompt":"What's the total value of my Base wallet 0xAbC123...? Show me the ETH balance and all the ERC-20 tokens with their USD prices."},{"title":"Multi-wallet net worth dashboard","prompt":"I manage a few wallets — can you grab the native and ERC-20 balances with USD values for 0xDead...Beef so I can add it to my net worth tracker?"},{"title":"Pre-trade balance check for an agent","prompt":"Before I make a swap, check what tokens and how much ETH are in my Base wallet 0x9F...77 and give me the total USD value of the portfolio."}],"resultDescription":"Returns a breakdown of the wallet's native ETH balance and balances of major ERC-20 tokens on Base, each with their current USD price and value, plus a grand total portfolio value in USD — all in a single structured response.","failureModes":["Invalid or malformed wallet address returns an error","Unrecognized or non-Base address may return empty balances","Network or RPC timeout may cause a temporary failure","Payment not processed (x402 USDC payment failure) results in 402 error","Token price data unavailable may cause missing USD values for some assets"],"whenToPreferThis":"Choose this endpoint when you need a one-shot aggregated view of a wallet's native ETH and major ERC-20 holdings with USD valuations on the Base network, rather than querying individual token contracts or price feeds separately. Ideal for portfolio dashboards, pre-trade checks, or agent-driven net worth calculations on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:37.628Z","isFirstParty":false}