Xspoonai Official Portfolio Risk Analyzer

---
name: portfolio-risk-analyzer
description: Advanced portfolio risk analysis and monitoring for Web3 assets with liquidation warnings, correlation analysis, and diversification recommendations
version: 1.0.0
author: Sambit Sargam
tags:
  - portfolio
  - risk
  - analysis
  - liquidation
  - correlation
  - diversification
  - defi
  - monitoring
  - alerts
triggers:
  - type: keyword
    keywords:
      - portfolio risk
      - liquidation risk
      - portfolio health
      - risk score
      - concentration risk
      - correlation
      - diversification
      - ltv
      - loan-to-value
      - portfolio exposure
      - risk management
      - position risk
    priority: 95
  - type: pattern
    patterns:
      - "(?i)(analyze|check|assess) .*portfolio .*(risk|health|exposure)"
      - "(?i)(calculate|show|get) .*risk .*(score|rating|level)"
      - "(?i)(what|check) .*liquidation .*(price|risk|danger)"
      - "(?i)(am|is) .*(my|this|the) .*(portfolio|position) .*(safe|at risk|healthy)"
      - "(?i)(how|much) .*(concentration|diversification) .*(risk|exposure)"
      - "(?i)(monitor|alert) .*(portfolio|position|account) .*(risk|health|danger)"
      - "(?i)(ltv|loan.to.value) .*(health|status|ratio)"
    priority: 90
  - type: intent
    intent_category: portfolio_risk_analysis
    priority: 98
parameters:
  - name: address
    type: string
    required: true
    description: Wallet address to analyze for risk
  - name: chain
    type: string
    required: false
    default: ethereum
    description: Blockchain network (ethereum, polygon, arbitrum, optimism, avalanche, base)
  - name: analysis_type
    type: string
    required: false
    default: comprehensive
    description: Type of analysis (comprehensive, concentration, correlation, liquidation, defi_exposure)
  - name: include_defi_positions
    type: boolean
    required: false
    default: true
    description: Include DeFi lending/borrowing positions in analysis
  - name: alert_threshold
    type: number
    required: false
    default: 75
    description: Risk threshold percentage for alerts (0-100)
  - name: include_recommendations
    type: boolean
    required: false
    default: true
    description: Include diversification and rebalancing recommendations
prerequisites:
  env_vars:
    - ETHERSCAN_API_KEY
    - ALCHEMY_API_KEY
    - DEFI_PROTOCOL_API_KEY (optional for lending protocol data)
  skills: []
composable: true
persist_state: true
cache_enabled: true

scripts:
  enabled: true
  working_directory: ./scripts
  definitions:
    - name: portfolio_fetcher
      description: Fetch all ERC20 and NFT holdings from wallet
      type: python
      file: portfolio_fetcher.py
      timeout: 45
      requires_auth: false

    - name: risk_calculator
      description: Calculate comprehensive risk metrics for portfolio
      type: python
      file: risk_calculator.py
      timeout: 60
      requires_auth: false

    - name: correlation_analyzer
      description: Analyze token correlation and concentration risk
      type: python
      file: correlation_analyzer.py
      timeout: 45
      requires_auth: false

    - name: defi_exposure_analyzer
      description: Analyze DeFi lending/borrowing positions and liquidation risk
      type: python
      file: defi_exposure_analyzer.py
      timeout: 45
      requires_auth: false

    - name: liquidation_monitor
      description: Calculate liquidation prices and LTV health
      type: python
      file: liquidation_monitor.py
      timeout: 30
      requires_auth: false

    - name: diversification_recommender
      description: Generate portfolio rebalancing and diversification recommendations
      type: python
      file: diversification_recommender.py
      timeout: 30
      requires_auth: false

capabilities:
  - real-time portfolio valuation
  - concentration risk scoring
  - token correlation analysis
  - liquidation price warnings
  - defi position monitoring
  - ltv health tracking
  - diversification recommendations
  - risk-adjusted allocation suggestions
  - portfolio rebalancing guidance
  - exposure analysis across chains

security_considerations:
  - Read-only operations (no transaction signing)
  - No private key exposure
  - Public blockchain data queries only
  - Rate-limited API calls
  - Optional data caching for performance
  - No wallet balance modification

use_cases:
  - Monitor DeFi position safety in real-time
  - Identify liquidation risks before they occur
  - Reduce concentration risk through data-driven recommendations
  - Optimize portfolio allocation across chains
  - Track correlation between holdings
  - Alert on portfolio health changes

example_queries:
  - "Analyze portfolio risk for address 0x742d35Cc6634C0532925a3b844Bc0e6dB1Eae543 on Ethereum"
  - "Calculate liquidation risk for my Aave position"
  - "Show portfolio concentration and diversification suggestions"
  - "What's my current LTV health and liquidation price on Compound?"
  - "Analyze correlation between my token holdings"
  - "Alert if my portfolio risk score exceeds 75%"
  - "Generate rebalancing recommendations for safer allocation"

integration_points:
  - Etherscan API (token holdings, transfers)
  - Alchemy API (portfolio data, NFT metadata)
  - Aave Subgraph (lending positions)
  - Compound Subgraph (borrowing positions)
  - Curve Finance API (LP positions)
  - Uniswap Subgraph (V2/V3 LP positions)
  - CoinGecko API (token prices, market data)

version_history:
  - version: 1.0.0
    date: 2026-02-07
    changes:
      - Initial release with core portfolio risk analysis
      - Support for 6 major EVM chains
      - DeFi position monitoring
      - Liquidation risk alerts
      - Diversification recommendations