Get Protocol Risk Clusters
Retrieve behavioral risk clusters for a specific protocol, categorized by zScore ranges and detailed risk summaries
Analyze protocol user behavior through risk clustering and detailed behavioral summaries.
Primary Uses:
Risk assessment and user segmentation
Protocol behavior analysis
Lending risk evaluation
User classification and targeting
Score Ranges:
0-200: High risk wallets (new wallets, potential bots)
200-400: Medium risk wallets (moderate activity)
400-600: Good reputation wallets (active DeFi users)
600-800: High reputation wallets (power users)
800-1000: Excellent reputation wallets (whales, veterans)
Returns: Risk clusters with behavioral summaries and score ranges
Retrieves behavioral risk clusters for a specific protocol with detailed risk summaries.
Authorizations
Query parameters
protocol_namestringRequiredExample:
Name of the protocol to get risk clusters for.
aaveHeader parameters
x-api-keystringRequiredDefault:
API key for authentication
cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93Responses
200
Risk clusters with behavioral analysis for the protocol
application/json
get
GET /zpass/api/zscore/categories HTTP/1.1
Host: api.myzscore.ai
x-api-key: cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93
Accept: */*
200
Risk clusters with behavioral analysis for the protocol
[
{
"protocol_name": "aave",
"lower_bound": 0,
"upper_bound": 150,
"summary": "High Risk. This cluster exhibits high-risk behavior with a low range (100-250), indicating significant speculation. The high deposit mix volatility (0.129) relative to borrow volatility (0.034) suggests erratic supply management. Frequent borrowing (median 0.46 days between borrows) coupled with a relatively long average time to first repayment (8.93 days) points to potentially unsustainable leverage strategies. This profile presents a substantial lending risk."
},
{
"protocol_name": "aave",
"lower_bound": 150,
"upper_bound": 250,
"summary": "High Risk. This cluster exhibits a high liquidation count mean of 20.57, a relatively high borrow-to-deposit ratio of 0.71, and frequent activity (deposit count mean: 189.4, borrow count mean: 135, repay count mean: 96). Despite the slightly below-average borrow-to-deposit ratio, the extremely high liquidation count and low range indicate a high-risk appetite and aggressive leverage style, contradicting what would be expected for a cluster in this range."
},
{
"protocol_name": "aave",
"lower_bound": 250,
"upper_bound": 350,
"summary": "High Risk. This cluster exhibits a high liquidation count mean of 36.0 and a low borrow-to-deposit ratio of 0.22, with a high deposit count (6094), moderate borrow count (1363), and low repay count (353). Despite the relatively low borrow-to-deposit ratio, the extremely high liquidation count overrides any other signal, indicating a high-risk appetite and potentially aggressive leverage style, despite showing little preference for volatile assets."
},
{
"protocol_name": "aave",
"lower_bound": 350,
"upper_bound": 450,
"summary": "Medium Risk. While the relatively low borrow mix volatility (3.48%) suggests some conservatism, the higher deposit mix volatility (12.87%) and short average time to first repay (7.3 days) indicate potentially frequent, short-term borrowing strategies. The infrequent borrowing (median 298 days) and modest borrowing/repaying activity (1.6/0.8) also adds to risk perception. Reported liquidation rate(s): 48%, 87%."
},
{
"protocol_name": "aave",
"lower_bound": 450,
"upper_bound": 550,
"summary": "Medium Risk. While the relatively low volatility in borrow and deposit mixes suggests some degree of conservative behavior, the high average deposit and borrow counts, coupled with a relatively short median time between borrows, indicate moderately frequent activity. The quick average time to first repay suggests a focus on short-term borrowing strategies."
},
{
"protocol_name": "aave",
"lower_bound": 550,
"upper_bound": 650,
"summary": "Medium Risk. While the relatively low volatility in borrowing and deposit mixes suggests conservative behavior, the significantly higher deposit count compared to borrow and repay counts warrants further investigation. The short median time between borrows and rapid average time to first repay indicates frequent, potentially short-term borrowing activity. This necessitates careful monitoring for potential increased risk."
},
{
"protocol_name": "aave",
"lower_bound": 650,
"upper_bound": 750,
"summary": "Medium Risk. This cluster exhibits a moderate risk profile. While the range (700-750) suggests a relatively low-risk group, the significantly higher borrow count (4214.56) compared to repay count (1396.33) indicates potentially imbalanced leverage. The short median time between borrows (0.59) further points to active trading or borrowing behavior. However, no liquidations observed to date."
},
{
"protocol_name": "aave",
"lower_bound": 750,
"upper_bound": 850,
"summary": "Low Risk. This cluster exhibits low-risk borrowing and repayment behavior, with a balanced ratio between borrowing and repayment counts (5586 vs 4964) and minimal volatility in deposit and borrow mixes. The short median time between borrows (0.058) and rapid average time to first repayment (0.072) suggest frequent, well-managed activity. The high range value (800-850) further supports the low-risk assessment."
},
{
"protocol_name": "aave",
"lower_bound": 850,
"upper_bound": 1000,
"summary": "Low Risk. This cluster exhibits low-risk borrowing and repayment behavior, with a balanced ratio between borrowing and repayment counts (5586 vs 4964) and minimal volatility in deposit and borrow mixes. The short median time between borrows (0.058) and rapid average time to first repayment (0.072) suggest frequent, well-managed activity. The high range value (800-850) further supports the low-risk assessment."
}
]