{"uid":"cap_pPQuRvAVmuBprdu40x8LU","slug":"x402stock-portfolio-x-ray-23ce327c","name":"x402stock Portfolio X-Ray","description":"Risk x-ray for a whole watchlist or portfolio in one call. Pass `?tickers=AAPL,MSFT,NVDA` (up to 25; optional `?weights=`). Returns per-holding price, sector and cap, plus portfolio concentration (top-weight, Herfindahl, diversification score), sector concentration, market-cap distribution, weighted day performance and risk flags. Replaces dozens of per-holding calls. From x402stock","url":"https://agents.x402stock.xyz/api/v1/portfolio/xray?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"object","required":["source","as_of","holding_count","weighting","sections","summary","holdings","disclaimer"],"properties":{"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"summary":{"type":"object","required":["day_change_percent","sector_concentration","market_cap_distribution","concentration","performance","risk_flags"],"properties":{"risk_flags":{"type":"array","items":{"type":"string"}},"performance":{"type":"object","required":["best","worst"],"properties":{"best":{"anyOf":[{"type":"object","required":["ticker","change_percent"],"properties":{"ticker":{"type":"string"},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"worst":{"anyOf":[{"type":"object","required":["ticker","change_percent"],"properties":{"ticker":{"type":"string"},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"concentration":{"type":"object","required":["top_weight","top3_weight","hhi","diversification_score","label"],"properties":{"hhi":{"type":"number"},"label":{"type":"string"},"top_weight":{"type":"number"},"top3_weight":{"type":"number"},"diversification_score":{"type":"number"}},"additionalProperties":false},"day_change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"sector_concentration":{"type":"object","required":["hhi","label","coverage","top_sectors"],"properties":{"hhi":{"type":"number"},"label":{"type":"string"},"coverage":{"type":"number"},"top_sectors":{"type":"array","items":{"type":"object","required":["sector","weight"],"properties":{"sector":{"type":"string"},"weight":{"type":"number"}},"additionalProperties":false}}},"additionalProperties":false},"market_cap_distribution":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"additionalProperties":false},"holdings":{"type":"array","items":{"type":"object","required":["ticker","name","price","change_percent","market_cap","sector","cap_bucket","weight"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"sector":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticker":{"type":"string"},"weight":{"type":"number"},"cap_bucket":{"type":"string"},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"weighting":{"enum":["equal","custom"],"type":"string"},"disclaimer":{"type":"string"},"holding_count":{"type":"number"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_49F86903ETz6tIL0ap_MV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_XpCL0u2NYpgvuYaXiLmE2","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs an X-ray analysis of a portfolio of US-listed stocks, ETFs, or other securities, returning market, risk, or compositional insights for the provided holdings.","exampleAgentPrompt":"Can you run an x-ray on my portfolio — I hold AAPL, MSFT, SPY, and QQQ — and tell me what sectors I'm exposed to and how concentrated my positions are?","exampleUseCases":[{"title":"Portfolio sector exposure check","prompt":"I have a mix of AAPL, TSLA, XOM, JPM, and SPY in my portfolio — can you x-ray it and tell me what sectors I'm overweight in and whether I'm too concentrated anywhere?"},{"title":"ETF overlap and diversification audit","prompt":"I'm holding VOO, QQQ, and VGT — can you x-ray these together and show me where there's overlap and how diversified I actually am across sectors?"},{"title":"Pre-rebalancing portfolio review","prompt":"Before I rebalance, can you x-ray my current holdings — NVDA, AMD, INTC, SMCI, and AVGO — and give me a breakdown of my sector weights and any concentration risks I should know about?"}],"resultDescription":"Returns a structured analysis of the submitted portfolio including sector allocations, position weights, concentration metrics, and potentially risk or exposure scores derived from current market data for each holding.","failureModes":["Invalid or unrecognized ticker symbols return an error","Malformed input schema returns 400-level error","Payment not completed via x402/USDC results in 402 Payment Required","Empty or missing properties field returns validation error","Delisted or illiquid securities may return incomplete data"],"whenToPreferThis":"Choose this endpoint when you need a holistic, multi-dimensional view of a portfolio rather than data on a single ticker. It is ideal for risk assessment, diversification audits, rebalancing prep, or when an agent needs to synthesize position-level data into portfolio-level insights. Prefer this over single-ticker endpoints when the user has multiple holdings and wants aggregate analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:41:08.843Z","isFirstParty":false,"canonicalSlug":"x402stock-portfolio-x-ray-23ce327c"}