{"uid":"cap_fERMXxbGzr56iTwWb_q2s","slug":"xx402-base-wallet-portfolio-exposure-api-50721d5a","name":"xx402 Base Wallet Portfolio Exposure API","description":"Paid Base token, wallet, DeFi, chain-read, x402 buyer/seller discovery, and specialized Bitcoin 15-minute Up/Down prediction-market data packets for autonomous agents and risk tools.","url":"https://x402.xx402.icu/api/base-wallet-portfolio-exposure?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"keys":["summary","portfolio_exposure_decision","portfolio_snapshot","positions","priority_queue","best_next_products","risk_breakdown","wallet_safety","review_queue","avoid_queue","bucket_counts","source_status","sources"],"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Yxmhl-UZR9OYoKXWggz0G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked portfolio exposure snapshot, risk breakdown, and wallet safety analysis for a given Base/EVM wallet address across core Base ERC20 tokens.","exampleAgentPrompt":"Check the portfolio exposure and risk breakdown for Base wallet 0xba76c7ECa175f67cFcE475c09498f840176bf497, looking at up to 6 token positions including USDC, WETH, and USDbC, with USD price hints included.","exampleUseCases":[{"title":"DeFi Risk Check Before Trade","prompt":"Before I make any moves, can you analyze the portfolio exposure and risk breakdown for my Base wallet 0xba76c7ECa175f67cFcE475c09498f840176bf497? Show me up to 8 token positions with price hints so I know where I'm most exposed."},{"title":"Wallet Safety Audit for Agent Fleet","prompt":"Run a wallet safety and exposure analysis on Base address 0xba76c7ECa175f67cFcE475c09498f840176bf497 using the last 2000 blocks as context, and give me the review queue and avoid queue so I know which tokens to flag."},{"title":"Portfolio Snapshot for Risk Dashboard","prompt":"I need a ranked portfolio snapshot for Base wallet 0xba76c7ECa175f67cFcE475c09498f840176bf497 — include zero-balance token rows as well, look at up to 6 exposure rows, and attach USD price hints for sizing."}],"resultDescription":"Returns a JSON object with keys including summary, portfolio_exposure_decision, portfolio_snapshot, positions (ranked token balances with optional USD price hints), priority_queue, best_next_products, risk_breakdown, wallet_safety score, review_queue (tokens to watch), avoid_queue (tokens to avoid), bucket_counts, source_status, and sources used.","failureModes":["Invalid wallet address format (not a valid 0x EVM address) returns validation error","Token address list exceeds allowed maximum or contains invalid addresses","Block window out of allowed range (100–5000) causes parameter rejection","Rate limiting or payment failure via x402 protocol results in 402 Payment Required","Upstream Base chain data source unavailable causes partial or failed response","No token balances found for the wallet on the specified tokens returns empty positions array"],"whenToPreferThis":"Choose this endpoint when you need a fast, ranked portfolio exposure and risk assessment for a specific Base/EVM wallet, especially when you want pre-scored risk buckets, wallet safety context, and token-level exposure ranking in a single call. Prefer it over generic on-chain data tools when you need DeFi risk framing (review/avoid queues, priority queue) rather than raw balances, and when you are operating on the Base chain specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:39:34.961Z","isFirstParty":false,"canonicalSlug":"xx402-base-wallet-portfolio-exposure-api-50721d5a"}