{"uid":"cap_kg14O1bRzRQyV2SHvhYri","slug":"x402-quantitative-risk-snapshot-cdd77acb","name":"X402 Quantitative Risk Snapshot","description":"Pay-per-request data tools for AI agents.","url":"https://x402.feld-feder.at/v1/quant/risk-snapshot","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","title":"PriceSeriesRequest","required":["closes"],"properties":{"closes":{"type":"array","items":{"type":"number","maximum":1000000000000,"exclusiveMinimum":0},"title":"Closes","maxItems":2000,"minItems":3}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"ResponseEnvelope[QuantRiskSnapshotResult]","required":["data"],"properties":{"ok":{"type":"boolean","const":true,"title":"Ok","default":true},"data":{"type":"object","title":"QuantRiskSnapshotResult","required":["observations","total_return_pct","annualized_volatility_pct","downside_deviation_pct","max_drawdown_pct","risk_score","risk_label","disclaimer"],"properties":{"disclaimer":{"type":"string","title":"Disclaimer"},"risk_label":{"enum":["low","moderate","high","very_high"],"type":"string","title":"Risk Label"},"risk_score":{"type":"number","title":"Risk Score"},"observations":{"type":"integer","title":"Observations"},"max_drawdown_pct":{"type":"number","title":"Max Drawdown Pct"},"total_return_pct":{"type":"number","title":"Total Return Pct"},"downside_deviation_pct":{"type":"number","title":"Downside Deviation Pct"},"annualized_volatility_pct":{"type":"number","title":"Annualized Volatility Pct"}}},"cache":{"anyOf":[{"type":"object","title":"CacheInfo","required":["hit"],"properties":{"hit":{"type":"boolean","title":"Hit"},"age_seconds":{"type":"integer","title":"Age Seconds","default":0,"minimum":0}}},{"type":"null"}],"default":null},"source":{"anyOf":[{"type":"object","title":"SourceInfo","required":["requested_url","final_url","retrieved_at"],"properties":{"final_url":{"type":"string","title":"Final Url"},"status_code":{"anyOf":[{"type":"integer","maximum":599,"minimum":100},{"type":"null"}],"title":"Status Code","default":null},"content_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Hash","default":null},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","default":null},"retrieved_at":{"type":"string","title":"Retrieved At","format":"date-time"},"requested_url":{"type":"string","title":"Requested Url"},"redirect_count":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Redirect Count","default":null}}},{"type":"null"}],"default":null},"_payment":{"anyOf":[{"type":"object","title":"PaymentInfo","required":["amount_usdc","network"],"properties":{"network":{"type":"string","title":"Network"},"amount_usdc":{"anyOf":[{"type":"number","minimum":0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Amount Usdc"},"transaction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction","default":null}}},{"type":"null"}],"default":null},"warnings":{"type":"array","items":{"type":"object","title":"WarningInfo","required":["code","message"],"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"}}},"title":"Warnings"},"provenance":{"type":"array","items":{"type":"string"},"title":"Provenance"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"disclaimer":"Deterministic research output only; not financial advice or an order signal.","risk_label":"moderate","risk_score":30.574257,"observations":5,"max_drawdown_pct":1.980198,"total_return_pct":4,"downside_deviation_pct":0,"annualized_volatility_pct":40}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_kvHcO4f7IBCYYRwiAVjSl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a pay-per-request quantitative risk assessment for a financial instrument or portfolio, including risk label, risk score, drawdown, volatility, and return metrics.","exampleAgentPrompt":"Run a quantitative risk snapshot on my portfolio returns data — I need the risk label, risk score, max drawdown, annualized volatility, and total return so I can see where it falls on the risk spectrum.","exampleUseCases":[{"title":"Portfolio risk check before rebalancing","prompt":"Before I rebalance, can you compute a risk snapshot for my current portfolio's recent price history? I need the risk score, risk label, max drawdown, and annualized volatility so I know if I'm over-exposed."},{"title":"Backtested strategy risk evaluation","prompt":"I've got a series of returns from my backtested trading strategy — can you run a quantitative risk assessment and tell me the risk label, score, downside deviation, and max drawdown percentage?"},{"title":"Comparing risk of two assets","prompt":"Can you pull a risk snapshot for this ETF's recent price data? I want the risk score, volatility, and drawdown figures so I can compare it against another position I'm considering."}],"resultDescription":"Returns a JSON object with a risk_label (e.g. 'moderate'), a numerical risk_score, max_drawdown_pct, total_return_pct, downside_deviation_pct, annualized_volatility_pct, and the number of observations used. Includes a disclaimer that output is deterministic research only, not financial advice.","failureModes":["Missing or malformed input price/returns data returns an error","Insufficient observations may produce unreliable or zero volatility metrics","Payment failure via x402 protocol results in 402 response and no data returned","Invalid request body format returns a parsing or validation error"],"whenToPreferThis":"Choose this endpoint when you need a fast, affordable ($0.01 USDC), deterministic quantitative risk profile — including drawdown, volatility, risk score, and a categorical risk label — computed from provided financial data. It is well-suited for AI agents that need lightweight, pay-per-request risk analytics without subscribing to a full financial data platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:35:44.079Z","isFirstParty":false}