Why Vault Risk Screening Matters
Compliance
Automated listing verdicts help you meet due diligence requirements for DeFi integrations
Risk Management
Catch governance risks, liquidity traps, and code vulnerabilities before your users deposit
User Protection
Surface vault health data so users can make informed decisions about their capital
- 7 risk categories, 41 tags — Covers structure, governance, liquidity, code quality, asset risk, performance, and protocol risk
- Listing verdicts —
safe_to_list,caution,review_required,do_not_list— actionable decisions, not just numbers - Sub-500ms responses — Screen vaults in real-time without blocking your UI
- 6 EVM chains — ETH, ARB, BASE, OPT, POL, BSC from a single API
Prerequisites
Before implementing vault screening, ensure you have:- A Webacy API key (sign up here)
- Basic familiarity with REST APIs or the Webacy SDK
- Your vault listing or portfolio management flow identified for integration points
Screen a Vault Before Listing
Before surfacing a vault to users, check its risk rating and listing verdict.| Field | Description | Action |
|---|---|---|
riskScore | 0-100 composite rating | Set your threshold (e.g., >50 = review) |
tier | low / medium / high / critical | Quick categorization |
listingVerdict | safe_to_list / caution / review_required / do_not_list | Direct listing decision |
withdrawalRisk | null / constrained / delayed / illiquid / locked / blocked | User exit condition |
risk.issues[] | Array of risk tags with severity | Understand what’s driving the rating |
Listing Verdict Decision Logic
| Verdict | Action |
|---|---|
safe_to_list | Auto-approve for listing |
caution | List with a risk warning badge |
review_required | Queue for manual review before listing |
do_not_list | Block from listing — has blocking risk tags or rating >= 75 |
Monitor High-Risk Vaults
Once vaults are listed, monitor them continuously for changes.| Filter | Example | Use Case |
|---|---|---|
tier=critical | Only critical vaults | Alert pipeline |
attentionNeeded=true | Vaults with state changes | Daily monitoring |
riskFlags=vault-redemption-closed | Specific risk condition | Targeted alerts |
chain=eth&minTvl=1000000 | Chain + TVL threshold | Portfolio-relevant vaults |
Build a Vault Risk Dashboard
Fetch a paginated list of vaults with risk data for a dashboard view.Complete Integration Workflow
Here’s how vault screening fits into a typical platform.Vault Listing Flow
Implementation Example
Full TypeScript Implementation
Full TypeScript Implementation
API Quick Reference
| Endpoint | Use Case | Response Time |
|---|---|---|
GET /vaults | List all vaults with risk data | ~300ms |
GET /vaults/{address}?chain={chain} | Full vault risk detail | ~500ms |
Next Steps
Vault Risk API
Full endpoint reference with all query parameters
Rating Methodology
How vault risk ratings are computed — sub-ratings, penalties, and floors
Stablecoin Depeg Monitoring
Monitor the stablecoins that underlie your vaults
Risk Tags Reference
Complete list of all risk tags and what they mean
