Get Vault Risk Detail (V3)
Returns the v3 Webacy-native vault decomposition: composite grade + per-category contributors, the dense categories criteria map, coverage disclosure, plus pass-through v2 metadata and risk. POLARITY: scores are 0–100, higher = worse (A+ = 0, F = 100). composite.score is floored from below by upstream_risk.
CU cost: 1 CU per request (v3-vault-detail).
risk envelope.
- API version
v3— the URL path (/v3/...) and the responseschema_version(3.0). framework_version— which criteria taxonomy was used.v1today (the only supported value).grading_scheme— which letter-grade band table is applied.v2is the default (the standard 11-band scale);v1is frozen and deprecated.
framework_version=v1 and grading_scheme=v2 by default. Seeing v1 on framework_version does not mean you’re on an older API.Supported chains
Thechain query parameter is required. Vault v3 covers 9 chains: eth, arb, base, opt, pol, bsc, avax, gnosis, sol.
Chains outside this list return 400 "Invalid chain", even if accepted by a shared parameter enum.
Assessing freshness
Authorizations
Path Parameters
Vault contract address.
Query Parameters
Chain identifier. Vault v3 covers 9 chains: eth, arb, base, opt, pol, bsc, avax, gnosis, sol. Any other value returns 400 "Invalid chain". Required.
eth, arb, base, opt, pol, bsc, avax, gnosis, sol Grading scheme to pin (default v2, the standard 11-band risk scale — lower risk = better grade). Pin v1 for the frozen legacy scale (it uses an E band and has no C+). Unknown values return 400 with the supported list.
v1, v2 Response
Webacy-native v3 vault detail.
Webacy-native v3 vault detail (RFC-019). metadata and risk are pass-through from the v2 vault response; composite/categories/coverage are the v3 additions. The three category-keyed maps are dense across all 7 WebacyCategory keys.
"3.0"
Pass-through v2 vault identity/market metadata.
Headline grade block. POLARITY (load-bearing): score is 0–100, HIGHER = WORSE (A+ = 0, F = 100) — same direction as the v2 risk.score on the same response. score = max(Σ contributors·weight, upstream_risk): floored from below by the upstream pipeline risk.
The letter set in grade depends on grading_scheme: v2 (default, standard 11-band scale) emits C+ and never E; v1 (frozen legacy scale) emits E and never C+.
- grading_scheme v2 (standard)
- grading_scheme v1 (legacy)
How many criteria are live today vs defined by the framework — so what the grade reflects is on the wire, not just in docs.
Pass-through v2 risk envelope (overallRisk etc.).
