Prometheus API Reference

# Request
{
    "message": "Should I move funds from Balanced to Growth vault?",
    "wallet_address": "GBXYZ...",
    "conversation_id": "conv_123"  # optional, for message history
}

# Response
{
    "response": "Based on current market conditions, I'd recommend staying in the Balanced Vault. Here's why:\n\n1. Growth Vault APY has dropped from 13.5% to 11.2% this week\n2. Two of Growth's underlying protocols (Kamino, Aave) show elevated risk metrics\n3. Your Balanced Vault is performing well at 9.5% APY with lower volatility\n\nI'd reconsider this move if Growth APY recovers above 13% with stable risk metrics.",
    "actions": [],
    "confidence": 0.78,
    "sources": ["defillama", "vault_analytics"]
}

# Response
{
    "insights": [
        {
            "type": "optimization",
            "title": "Idle USDC detected",
            "message": "You have 2,500 USDC idle in your wallet. Depositing into the Balanced Vault would earn ~$237/year at current rates.",
            "action": {
                "type": "deposit",
                "vault": "balanced",
                "amount": 2500
            },
            "priority": "medium"
        },
        {
            "type": "market_alert",
            "title": "XLM momentum strong",
            "message": "XLM is up 15% this week with DEX volumes increasing 40%. Consider allocating 10-15% to XLM automated yield.",
            "priority": "low"
        }
    ],
    "weekly_summary": "DeFi markets stable. No security incidents in Nester's integrated protocols. Your portfolio is performing 2.3% above benchmark.",
    "generated_at": "2026-03-22T10:00:00Z"
}

# Response
{
    "risk_score": 6.5,        # 1-10 scale
    "diversification": 4,     # 1-10 (higher = more diversified)
    "concentration_risk": "XLM at 45% (recommended max: 30%)",
    "volatility_30d": 12.5,   # portfolio volatility %
    "recommendations": [
        "Reduce XLM exposure from 45% to 30%",
        "Move idle USDC to Balanced Vault",
        "Consider adding ETH for diversification"
    ]
}