{"uid":"cap_dHjUOv5x1zvIZ9j_AJ6rG","slug":"hermes-plant-portfolioguard-score-8777821b","name":"Hermes Plant PortfolioGuard Score","description":"Deterministic portfolio risk analysis and quality scoring. Computes riskScore, riskLevel, volatility, sharpe, maxDrawdown, concentrationHHI, diversification, effectiveHoldings plus per-rule findings with fixes and sector/position breakdown. Pure math only from caller holdings and returns. No external data.","url":"https://hermesplant.com/api/agent-services/portfolioguard/score","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"holdings":{"type":"array","items":{"type":"object","required":["symbol","weight"],"properties":{"sector":{"type":"string"},"symbol":{"type":"string"},"weight":{"type":"number"},"returns":{"type":"array","items":{"type":"number"}},"assetClass":{"type":"string"}}},"description":"List of positions with symbol, weight (0-1), optional returns[], sector, assetClass."},"riskFreeRate":{"type":"number","description":"Optional risk-free rate for Sharpe (default 0)."},"periodReturns":{"type":"array","items":{"type":"number"},"description":"Optional time series of portfolio or market period returns (preferred for volatility/sharpe/MDD)."}}},"responseSchema":{"type":"json","example":{"metrics":{"sharpe":0.42,"volatility":0.0071,"maxDrawdown":0.014,"concentrationHHI":0.2375,"effectiveHoldings":4.21,"diversificationScore":76},"findings":[{"fix":null,"why":"Weights should sum to approximately 1.0.","rule":"weights-sum-sanity","evidence":"sum=1","severity":"info"},{"fix":null,"why":"No position exceeds 25%.","rule":"single-position-concentration","evidence":"maxWeight=0.35","severity":"info"}],"breakdown":{"bySector":{"Bonds":{"count":1,"weight":0.35},"Technology":{"count":1,"weight":0.25}},"topPositions":[{"symbol":"BND","weight":0.35},{"symbol":"AAPL","weight":0.25}]},"riskLevel":"medium","riskScore":64}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oM6f_kzmWQzF-3zMYefvm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a portfolio's holdings and weights to produce a risk score, Sharpe ratio, volatility, max drawdown, concentration (HHI), diversification score, and rule-based compliance findings.","exampleAgentPrompt":"Score the risk of my portfolio: AAPL at 25%, BND at 35%, MSFT at 20%, GOOGL at 10%, and CASH at 10% — I want the Sharpe ratio, max drawdown, concentration HHI, diversification score, and any rule violations flagged.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a numeric riskScore (0–100), a riskLevel label (e.g. 'medium'), quantitative metrics (Sharpe ratio, daily volatility, max drawdown, concentration HHI, effective holdings count, diversification score), a list of rule-based findings with severity and reasoning, and a breakdown of holdings by sector and top positions by weight.","failureModes":["Weights do not sum to approximately 1.0 — endpoint flags a sanity warning or returns an error","Missing required fields such as holdings array or weights — returns 400 bad request","Single position weight exceeds threshold — flagged as a finding rather than hard failure","Invalid or unrecognized ticker symbols — may produce partial or degraded analytics","Payment not completed via x402 — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when an AI agent needs deterministic, test-backed portfolio risk quantification including Sharpe, volatility, drawdown, concentration (HHI), and compliance rule checks — all in one call. Prefer it over building custom analytics when you need a metered, pay-per-call quant service with structured findings and sector breakdowns ready for downstream reporting or agent decision-making.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:26.587Z","isFirstParty":false}