Skip to main content
GET
/
v3
/
vaults
/
{address}
Get v3 vault risk detail (Webacy-native)
curl --request GET \
  --url https://api.webacy.com/v3/vaults/{address} \
  --header 'x-api-key: <api-key>'
{
  "schema_version": "3.0",
  "metadata": {
    "address": "0xD50DA5F859811A91fD1876C9461fD39c23C747Ad",
    "chain": "eth",
    "name": "MEV Capital Resolv USR",
    "symbol": "MC-USR"
  },
  "composite": {
    "grading_scheme": "v2",
    "grade": "F",
    "stars": 1,
    "score": 98.5,
    "contributors": {
      "smart_contract": {
        "score": 0,
        "weight": 0.2
      },
      "operational_governance": {
        "score": 0,
        "weight": 0.2
      },
      "asset_collateral": {
        "score": 10,
        "weight": 0.15
      },
      "market_liquidity": {
        "score": 35,
        "weight": 0.2
      },
      "counterparty": {
        "score": 0,
        "weight": 0.1
      },
      "hack_exploit_history": {
        "score": 0,
        "weight": 0.15
      },
      "chain_infrastructure": {
        "score": 0,
        "weight": 0
      }
    },
    "upstream_risk": 98.5,
    "clamped_by_upstream": true
  },
  "categories": {
    "smart_contract": {
      "score": 0,
      "criteria": {
        "contract_verified": {
          "status": "pass",
          "data_quality": {
            "confidence": 0.95,
            "last_observed_at": "2026-06-02T09:49:36Z",
            "source": "rwa-grade-pipeline"
          }
        }
      }
    },
    "market_liquidity": {
      "score": 35,
      "criteria": {
        "large_holder_concentration": {
          "status": "warn",
          "data_quality": {
            "confidence": 0.95,
            "last_observed_at": "2026-06-02T09:49:36Z",
            "source": "rwa-grade-pipeline"
          }
        }
      }
    }
  },
  "coverage": {
    "framework_version": "v1",
    "total_criteria": 42,
    "live_criteria": 28,
    "per_category": {
      "smart_contract": {
        "live": 6,
        "total": 8
      }
    }
  },
  "risk": {
    "overallRisk": 98.5
  }
}
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 (/api/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.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
address
string
required

Vault contract address.

Query Parameters

​
chain
enum<string>
required

Chain identifier (e.g. eth, base, pol). Required.

Available options:
eth,
base,
bsc,
pol,
opt,
arb,
avax,
sol,
stellar,
hedera,
tron,
sui,
ton,
sei,
btc,
gnosis
​
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.).