{"uid":"cap_Vmi1EBTGBxQJxZsuzv4mK","slug":"chainverdict-base-portfolio-balances-18633604","name":"ChainVerdict Base Portfolio Balances","description":"Native ETH and ERC-20 token balances for a Base address in one call, read live from chain at a stated block height.","url":"https://chainverdict.xyz/v1/data/portfolio/%3Aaddr?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["addr"],"properties":{"addr":{"type":"string","description":"Base address to read balances for"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DqDHKQCQjMiJu3x_IHK8T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","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 all ERC-20 token balances for a given Base address in a single call, read live from the blockchain at a specified block height.","exampleAgentPrompt":"What are the current ETH and ERC-20 token balances for the Base address 0x1234...abcd? I want a full portfolio snapshot read live from chain.","exampleUseCases":[{"title":"Pre-payment wallet verification","prompt":"Before I send USDC to 0xAbCd...1234, can you pull their live Base portfolio so I can see what tokens they hold and confirm the address looks active?"},{"title":"DeFi portfolio snapshot for reporting","prompt":"Give me a full snapshot of all ETH and ERC-20 balances on Base for 0xDeFi...5678 right now — I need the complete holdings for my portfolio report."},{"title":"Agent treasury monitoring","prompt":"Check the current on-chain ETH and token balances for our treasury wallet 0xTrea...9999 on Base so I know what funds are available to deploy."}],"resultDescription":"Returns the native ETH balance plus all ERC-20 token balances held by the specified Base address, read live from the blockchain at a stated block height. Includes token symbols, amounts with decimals applied, and the block at which the snapshot was taken.","failureModes":["Invalid or malformed Base address returns a 4xx error","Address with no holdings may return zero balances for all assets","Unpaid request returns HTTP 402 with x402 payment requirements","Network congestion or RPC issues may cause timeouts or stale reads","Very new addresses not yet indexed may return empty results"],"whenToPreferThis":"Use this endpoint when you need a single-call, live on-chain portfolio view combining both native ETH and all ERC-20 token balances for a Base address. Prefer it over separate per-token balance calls when you want a comprehensive holdings snapshot without multiple round trips. Ideal for pre-payment checks, treasury monitoring, or DeFi portfolio analysis on the Base network.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:43:51.273Z","isFirstParty":false,"canonicalSlug":"chainverdict-base-portfolio-balances-18633604"}