Skip to main content
GET
Get v3 vault risk detail (Webacy-native)
Returns the full V3 risk decomposition for one vault — composite grade, per-category contributors, the dense criteria taxonomy, coverage disclosure, and the pass-through v2 risk envelope.
Understanding the version numbers. Three independent version axes show up on the V3 surface — they are not the same number:
  • API version v3 — the URL path (/v3/...) and the response schema_version (3.0).
  • framework_version — which criteria taxonomy was used. v1 today (the only supported value).
  • grading_scheme — which letter-grade band table is applied. v2 is the default (the standard 11-band scale); v1 is frozen and deprecated.
So the V3 API uses 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

The chain 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

This endpoint does not return a stale flag or generated_at. To assess freshness, use metadata.last_scored_at on the response, or read the v2 list / grades endpoints, which carry stale.Treat missing, stale, or errored data as unknown — never as safe. See Hard-gating and fail behavior.

Authorizations

x-api-key
string
header
required

Path Parameters

address
string
required

Vault contract address.

Query Parameters

chain
enum<string>
required

Chain identifier. Vault v3 covers 9 chains: eth, arb, base, opt, pol, bsc, avax, gnosis, sol. Any other value returns 400 "Invalid chain". Required.

Available options:
eth,
arb,
base,
opt,
pol,
bsc,
avax,
gnosis,
sol
grading_scheme
enum<string>
default:v2

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.

Available options:
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.

schema_version
string
required
Example:

"3.0"

metadata
object
required

Pass-through v2 vault identity/market metadata.

composite
grading_scheme v2 (standard) · object
required

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+.

categories
object
required
coverage
object
required

How many criteria are live today vs defined by the framework — so what the grade reflects is on the wire, not just in docs.

risk
object
required

Pass-through v2 risk envelope (overallRisk etc.).