Get v3 vault risk detail (Webacy-native)
curl --request GET \
--url https://api.webacy.com/v3/vaults/{address} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.webacy.com/v3/vaults/{address}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.webacy.com/v3/vaults/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.webacy.com/v3/vaults/{address}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.webacy.com/v3/vaults/{address}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.webacy.com/v3/vaults/{address}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.webacy.com/v3/vaults/{address}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"schema_version": "3.0",
"metadata": {
"address": "0xD50DA5F859811A91fD1876C9461fD39c23C747Ad",
"chain": "eth",
"name": "MEV Capital Resolv USR",
"symbol": "MC-USR",
"lender_concentration": {
"hhi": 0.18,
"risk_band": "low",
"participant_count": 42,
"top10_share_pct": 55.2,
"top30_share_pct": 78.1,
"top_participants": [
{
"address": "0x1111111111111111111111111111111111111111",
"share_pct": 12.3
}
]
},
"borrower_concentration": {
"hhi": 0.31,
"risk_band": "medium",
"participant_count": 17,
"top10_share_pct": 71.4,
"top30_share_pct": 92,
"top_participants": [
{
"address": "0x2222222222222222222222222222222222222222",
"share_pct": 22.6
}
]
},
"curator_concentration": {
"hhi": 0.29,
"risk_band": "medium",
"market_count": 12,
"top10_share_pct": 61,
"top30_share_pct": 88.4,
"top_markets": [
{
"market_key": "8453-0x9103da5da5c9f9b6e4bda4b2f8f3f0e1d2c3b4a5",
"label": "cbBTC/USDC",
"share_pct": 20.1
}
],
"total_supply_usd": 1234567890,
"vault_count": 8,
"curator": "0x3333333333333333333333333333333333333333"
},
"protocol_dependency_concentration": {
"hhi": 0.42,
"risk_band": "high",
"collateral_count": 7,
"top10_share_pct": 88.1,
"top30_share_pct": 99,
"top_collateral": [
{
"collateral": "eth:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
"collateral_symbol": "WBTC",
"share_pct": 61.2
},
{
"collateral": "eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"collateral_symbol": "WETH",
"share_pct": 22
}
],
"total_supply_usd": 1250000000,
"resolved_supply_usd": 1180000000,
"coverage_pct": 94.4,
"partial": false,
"vault_count": 24,
"protocol": "morpho"
},
"incentives": null,
"deposit_status": {
"status": "open",
"source": "erc4626_max_deposit",
"reason": "cap_headroom_42.1pct",
"capacity_usd": 1250000,
"permission": "permissionless"
},
"fees": {
"apy_after_fees": 0.0419,
"apy_before_fees": 0.0466,
"fee_gap_reason": null,
"fee_treatment": "in_share_price",
"fee_model": {
"performance_bps": 1000,
"management_bps": 0,
"entry_bps": null,
"exit_bps": null,
"source": "morpho_api",
"management_source": "protocol_design",
"method": "fee_model_v1"
}
},
"realized_apr_windows": {
"realized_7d": 0.06079078,
"realized_30d": 0.0626949,
"realized_90d": 0.05970668
},
"apy_consensus": {
"status": "disputed",
"measure": "realized_90d",
"ts_apy": 0.06826576,
"diff_bp": -72
},
"apy_backup_for": null,
"flow_terms": {
"deposit_flow": "async",
"redemption_flow": "async",
"settlement_seconds": 172800,
"lockup_seconds": null,
"source": "lagoon_api"
},
"impairment_state": null,
"yield_risk": {
"as_of": "2026-11-04",
"methodology_version": "yield-risk-v1.0.0",
"days_underwater": 182,
"bad_prints_dropped": 0,
"windows": {
"30d": {
"status": "refused",
"refusal_reason": "insufficient_history",
"start": null,
"end": null,
"observations": 25,
"coverage": null,
"realized_apy": null,
"realized_apy_null_reason": null,
"volatility": null,
"max_drawdown": null,
"days_underwater_max": null,
"negative_days": null,
"gap_days": null,
"tbill_apy": null,
"excess_return": null,
"sharpe": null,
"sortino": null,
"ratio_null_reason": null
},
"90d": {
"status": "ok",
"refusal_reason": null,
"start": "2026-08-06",
"end": "2026-11-04",
"observations": 85,
"coverage": 0.9444,
"realized_apy": -0.00167574,
"realized_apy_null_reason": null,
"volatility": 0.19897299,
"max_drawdown": -0.08252973,
"days_underwater_max": 46,
"negative_days": 2,
"gap_days": 0,
"tbill_apy": 0.039575,
"excess_return": -0.04125036,
"sharpe": -0.2073,
"sortino": -0.239,
"ratio_null_reason": null
},
"180d": {
"status": "ok",
"refusal_reason": null,
"start": "2026-05-08",
"end": "2026-11-04",
"observations": 175,
"coverage": 0.9722,
"realized_apy": 0.00109994,
"realized_apy_null_reason": null,
"volatility": 0.13825246,
"max_drawdown": -0.08252973,
"days_underwater_max": 46,
"negative_days": 2,
"gap_days": 0,
"tbill_apy": 0.037414,
"excess_return": -0.03631429,
"sharpe": -0.2627,
"sortino": -0.3019,
"ratio_null_reason": null
},
"365d": {
"status": "ok",
"refusal_reason": null,
"start": "2025-11-04",
"end": "2026-11-04",
"observations": 360,
"coverage": 0.9863,
"realized_apy": 0.00852387,
"realized_apy_null_reason": null,
"volatility": 0.10610133,
"max_drawdown": -0.11623574,
"days_underwater_max": 182,
"negative_days": 4,
"gap_days": 0,
"tbill_apy": 0.040193,
"excess_return": -0.03166863,
"sharpe": -0.2985,
"sortino": -0.3408,
"ratio_null_reason": null
}
}
},
"strategy_class": "crypto_backed_lending",
"strategy_class_source": "collateral_allocations",
"strategy_class_note": "0% of supply lent against collateral is RWA collateral",
"strategy_rwa_collateral_pct": 0,
"lending_methodology_applies": true,
"lending_methodology_note": null,
"under_review": {
"active": false,
"reasons": [],
"since": null
}
},
"composite": {
"grading_scheme": "v1",
"grade": "F",
"stars": 1,
"score": 98.5,
"contributors": {
"smart_contract": {
"score": 0,
"weight": 0.2,
"weighted_contribution": 0
},
"operational_governance": {
"score": 0,
"weight": 0.2,
"weighted_contribution": 0
},
"asset_collateral": {
"score": 10,
"weight": 0.15,
"weighted_contribution": 1.5
},
"market_liquidity": {
"score": 35,
"weight": 0.2,
"weighted_contribution": 7
},
"counterparty": {
"score": 0,
"weight": 0.1,
"weighted_contribution": 0
},
"hack_exploit_history": {
"score": 0,
"weight": 0.15,
"weighted_contribution": 0
},
"chain_infrastructure": {
"score": 0,
"weight": 0,
"weighted_contribution": 0
}
},
"upstream_risk": 98.5,
"clamped_by_upstream": true,
"score_source": "upstream",
"drivers_complete": false,
"drivers": [
{
"category": "market_liquidity",
"category_name": "Market & liquidity",
"score": 35,
"weight": 0.2,
"weighted_contribution": 7,
"criteria": [
{
"key": "large_holder_concentration",
"name": "Large-holder concentration bounded",
"status": "warn",
"evidence": {
"hci_10": 0.34
}
}
]
}
]
},
"categories": {
"smart_contract": {
"score": 0,
"criteria": {
"contract_verified": {
"name": "Contract verified on explorer",
"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": {
"name": "Large-holder concentration bounded",
"status": "warn",
"data_quality": {
"confidence": 0.95,
"last_observed_at": "2026-06-02T09:49:36Z",
"source": "rwa-grade-pipeline"
},
"evidence": {
"hci_10": 0.34
}
}
}
}
},
"coverage": {
"framework_version": "v1",
"total_criteria": 42,
"live_criteria": 28,
"per_category": {
"smart_contract": {
"live": 6,
"total": 8
}
}
},
"risk": {
"overallRisk": 98.5
}
}{
"x402Version": 1,
"error": "payment required"
}{
"message": "Payment service temporarily unavailable"
}Vault Risk V3
Get risk data for a single vault
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.
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>'import requests
url = "https://api.webacy.com/v3/vaults/{address}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.webacy.com/v3/vaults/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.webacy.com/v3/vaults/{address}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.webacy.com/v3/vaults/{address}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.webacy.com/v3/vaults/{address}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.webacy.com/v3/vaults/{address}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"schema_version": "3.0",
"metadata": {
"address": "0xD50DA5F859811A91fD1876C9461fD39c23C747Ad",
"chain": "eth",
"name": "MEV Capital Resolv USR",
"symbol": "MC-USR",
"lender_concentration": {
"hhi": 0.18,
"risk_band": "low",
"participant_count": 42,
"top10_share_pct": 55.2,
"top30_share_pct": 78.1,
"top_participants": [
{
"address": "0x1111111111111111111111111111111111111111",
"share_pct": 12.3
}
]
},
"borrower_concentration": {
"hhi": 0.31,
"risk_band": "medium",
"participant_count": 17,
"top10_share_pct": 71.4,
"top30_share_pct": 92,
"top_participants": [
{
"address": "0x2222222222222222222222222222222222222222",
"share_pct": 22.6
}
]
},
"curator_concentration": {
"hhi": 0.29,
"risk_band": "medium",
"market_count": 12,
"top10_share_pct": 61,
"top30_share_pct": 88.4,
"top_markets": [
{
"market_key": "8453-0x9103da5da5c9f9b6e4bda4b2f8f3f0e1d2c3b4a5",
"label": "cbBTC/USDC",
"share_pct": 20.1
}
],
"total_supply_usd": 1234567890,
"vault_count": 8,
"curator": "0x3333333333333333333333333333333333333333"
},
"protocol_dependency_concentration": {
"hhi": 0.42,
"risk_band": "high",
"collateral_count": 7,
"top10_share_pct": 88.1,
"top30_share_pct": 99,
"top_collateral": [
{
"collateral": "eth:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
"collateral_symbol": "WBTC",
"share_pct": 61.2
},
{
"collateral": "eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"collateral_symbol": "WETH",
"share_pct": 22
}
],
"total_supply_usd": 1250000000,
"resolved_supply_usd": 1180000000,
"coverage_pct": 94.4,
"partial": false,
"vault_count": 24,
"protocol": "morpho"
},
"incentives": null,
"deposit_status": {
"status": "open",
"source": "erc4626_max_deposit",
"reason": "cap_headroom_42.1pct",
"capacity_usd": 1250000,
"permission": "permissionless"
},
"fees": {
"apy_after_fees": 0.0419,
"apy_before_fees": 0.0466,
"fee_gap_reason": null,
"fee_treatment": "in_share_price",
"fee_model": {
"performance_bps": 1000,
"management_bps": 0,
"entry_bps": null,
"exit_bps": null,
"source": "morpho_api",
"management_source": "protocol_design",
"method": "fee_model_v1"
}
},
"realized_apr_windows": {
"realized_7d": 0.06079078,
"realized_30d": 0.0626949,
"realized_90d": 0.05970668
},
"apy_consensus": {
"status": "disputed",
"measure": "realized_90d",
"ts_apy": 0.06826576,
"diff_bp": -72
},
"apy_backup_for": null,
"flow_terms": {
"deposit_flow": "async",
"redemption_flow": "async",
"settlement_seconds": 172800,
"lockup_seconds": null,
"source": "lagoon_api"
},
"impairment_state": null,
"yield_risk": {
"as_of": "2026-11-04",
"methodology_version": "yield-risk-v1.0.0",
"days_underwater": 182,
"bad_prints_dropped": 0,
"windows": {
"30d": {
"status": "refused",
"refusal_reason": "insufficient_history",
"start": null,
"end": null,
"observations": 25,
"coverage": null,
"realized_apy": null,
"realized_apy_null_reason": null,
"volatility": null,
"max_drawdown": null,
"days_underwater_max": null,
"negative_days": null,
"gap_days": null,
"tbill_apy": null,
"excess_return": null,
"sharpe": null,
"sortino": null,
"ratio_null_reason": null
},
"90d": {
"status": "ok",
"refusal_reason": null,
"start": "2026-08-06",
"end": "2026-11-04",
"observations": 85,
"coverage": 0.9444,
"realized_apy": -0.00167574,
"realized_apy_null_reason": null,
"volatility": 0.19897299,
"max_drawdown": -0.08252973,
"days_underwater_max": 46,
"negative_days": 2,
"gap_days": 0,
"tbill_apy": 0.039575,
"excess_return": -0.04125036,
"sharpe": -0.2073,
"sortino": -0.239,
"ratio_null_reason": null
},
"180d": {
"status": "ok",
"refusal_reason": null,
"start": "2026-05-08",
"end": "2026-11-04",
"observations": 175,
"coverage": 0.9722,
"realized_apy": 0.00109994,
"realized_apy_null_reason": null,
"volatility": 0.13825246,
"max_drawdown": -0.08252973,
"days_underwater_max": 46,
"negative_days": 2,
"gap_days": 0,
"tbill_apy": 0.037414,
"excess_return": -0.03631429,
"sharpe": -0.2627,
"sortino": -0.3019,
"ratio_null_reason": null
},
"365d": {
"status": "ok",
"refusal_reason": null,
"start": "2025-11-04",
"end": "2026-11-04",
"observations": 360,
"coverage": 0.9863,
"realized_apy": 0.00852387,
"realized_apy_null_reason": null,
"volatility": 0.10610133,
"max_drawdown": -0.11623574,
"days_underwater_max": 182,
"negative_days": 4,
"gap_days": 0,
"tbill_apy": 0.040193,
"excess_return": -0.03166863,
"sharpe": -0.2985,
"sortino": -0.3408,
"ratio_null_reason": null
}
}
},
"strategy_class": "crypto_backed_lending",
"strategy_class_source": "collateral_allocations",
"strategy_class_note": "0% of supply lent against collateral is RWA collateral",
"strategy_rwa_collateral_pct": 0,
"lending_methodology_applies": true,
"lending_methodology_note": null,
"under_review": {
"active": false,
"reasons": [],
"since": null
}
},
"composite": {
"grading_scheme": "v1",
"grade": "F",
"stars": 1,
"score": 98.5,
"contributors": {
"smart_contract": {
"score": 0,
"weight": 0.2,
"weighted_contribution": 0
},
"operational_governance": {
"score": 0,
"weight": 0.2,
"weighted_contribution": 0
},
"asset_collateral": {
"score": 10,
"weight": 0.15,
"weighted_contribution": 1.5
},
"market_liquidity": {
"score": 35,
"weight": 0.2,
"weighted_contribution": 7
},
"counterparty": {
"score": 0,
"weight": 0.1,
"weighted_contribution": 0
},
"hack_exploit_history": {
"score": 0,
"weight": 0.15,
"weighted_contribution": 0
},
"chain_infrastructure": {
"score": 0,
"weight": 0,
"weighted_contribution": 0
}
},
"upstream_risk": 98.5,
"clamped_by_upstream": true,
"score_source": "upstream",
"drivers_complete": false,
"drivers": [
{
"category": "market_liquidity",
"category_name": "Market & liquidity",
"score": 35,
"weight": 0.2,
"weighted_contribution": 7,
"criteria": [
{
"key": "large_holder_concentration",
"name": "Large-holder concentration bounded",
"status": "warn",
"evidence": {
"hci_10": 0.34
}
}
]
}
]
},
"categories": {
"smart_contract": {
"score": 0,
"criteria": {
"contract_verified": {
"name": "Contract verified on explorer",
"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": {
"name": "Large-holder concentration bounded",
"status": "warn",
"data_quality": {
"confidence": 0.95,
"last_observed_at": "2026-06-02T09:49:36Z",
"source": "rwa-grade-pipeline"
},
"evidence": {
"hci_10": 0.34
}
}
}
}
},
"coverage": {
"framework_version": "v1",
"total_criteria": 42,
"live_criteria": 28,
"per_category": {
"smart_contract": {
"live": 6,
"total": 8
}
}
},
"risk": {
"overallRisk": 98.5
}
}{
"x402Version": 1,
"error": "payment required"
}{
"message": "Payment service temporarily unavailable"
}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 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
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
Path Parameters
Vault contract address.
Query Parameters
Chain identifier (e.g. eth, base, pol). Required.
Available options:
eth, base, bsc, pol, opt, arb, avax, sol, stellar, hedera, tron, sui, sei, btc, gnosis Grading scheme to pin (default v1). Unknown values return 400 with the supported list.
Available options:
v1 Response
Webacy-native v3 vault detail.
Webacy-native v3 vault detail. 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.
Example:
"3.0"
Pass-through v2 vault identity/market metadata.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
How many criteria are live today vs defined by the framework — so what the grade reflects is on the wire, not just in docs. live / total describe the framework; on the RWA / stablecoin detail response measured_criteria / per_category[*].measured add the per-asset count of criteria that produced a measurement (assessed: true), excluding unverified ones.
Show child attributes
Show child attributes
Pass-through v2 risk envelope (overallRisk etc.).