Skip to main content
The Stablecoin Stress Test API dynamically calculates risk scores for major stablecoins based on real-time (or simulated) data and customizable risk factor weights. Use this API to monitor stablecoin stability, detect emerging risks, and fine-tune assessment models based on your own risk preferences.

​
Risk Factors

Each stablecoin risk score is calculated from the following factors:
FactorDescription
Peg DeviationMagnitude and frequency of price drifting from $1.00
Volume VolatilityVariance in trading volume over time
Liquidity ChangeTVL shifts across key pools and chains
Collateral QualityRisk level of the assets backing the stablecoin
Sentiment AnalysisSocial/media signals about stability or risk events
Each factor can be individually weighted, and total weighting must equal 100%.

​
Endpoints

​
GET /stress-test/scores

  • Returns the current risk scores for all tracked stablecoins.

​
Example Response:

[
  {
    "name": "USDC",
    "price": 1.00,
    "risk_level": "Moderate",
    "risk_score": 10.7,
    "collateral_summary": "100% short-term U.S. Treasuries"
  },
  {
    "name": "DAI",
    "price": 1.00,
    "risk_level": "Low",
    "risk_score": 9.6,
    "collateral_summary": "Multi-collateral: ETH, USDC, others"
  }
]

​
GET /stress-test/weights

  • Returns the current weighting setup for each risk factor.

​
Example Response:

{
  "peg_deviation": 25,
  "volume_volatility": 20,
  "supply_changes": 15,
  "liquidity_change": 20,
  "collateral_quality": 15,
  "sentiment_analysis": 5
}

​
POST /stress-test/weights

  • Allows updating the custom risk factor weights. (Admin access required.)
Payload Example: 
{
  "peg_deviation": 30,
  "volume_volatility": 15,
  "supply_changes": 15,
  "liquidity_change": 25,
  "collateral_quality": 10,
  "sentiment_analysis": 5
}

​
Notes

Risk Score Ranges:
  • 0–10 → Low Risk
  • 10–20 → Moderate Risk
  • 20+ → High Risk
Price Source:
  • Prices are fetched from on-chain oracles and major exchanges.
Collateral Data:
  • Updated periodically based on issuer disclosures and third-party audits.
Refresh Interval:
  • Risk scores are recalculated hourly or on major data events.