{"endpoint":"/api/defi/il-simulate","method":"POST","service_trust":"https://defi-shield-hazel.vercel.app/api/trust-signal","free_check":{"endpoint":"https://defi-shield-hazel.vercel.app/api/free/token-check","method":"POST","price":"FREE","note":"Try before you buy — free basic token safety check with risk math."},"also_available_on":{"virtuals_acp":{"agent":"Authensor","agent_id":18805,"offerings":["pre_trade_safety","token_deep_scan","wallet_report","batch_seal"],"marketplace":"https://app.virtuals.io/acp/scan/agents","note":"Same service, accessible to 18,000+ autonomous agents on Virtuals Protocol."},"mcp_server":{"package":"devsecure-mcp","install":"npx devsecure-mcp","tools":67,"note":"Install as MCP server in Claude, Cursor, or any MCP-compatible client for direct tool access."},"bazaar":"https://defi-shield-hazel.vercel.app/.well-known/x402","agent_card":"https://defi-shield-hazel.vercel.app/.well-known/agent-card.json"},"powered_by":"DeFi Shield by Authensor","price":"$1.00","description":"Run a Monte Carlo simulation (200 scenarios) with correlated GBM price paths to estimate impermanent loss for a liquidity pool position. Returns IL distribution, time series for charting, net PnL with fee income, max drawdown, and breakeven APY.","llm_usage_prompt":"Call this endpoint BEFORE providing liquidity to an AMM pool to understand the impermanent loss risk. Provide both token prices, investment amount, time horizon (days), volatility estimates, and the correlation between tokens. Optionally include fee_apy to model pool fee income against IL. Returns IL distribution across percentiles (p5/p10/p25/p50/p75/p90/p95), max drawdown, daily time series (p25/p50/p75 for charting), net PnL with accumulated fees, hold-vs-LP value comparison, the breakeven APY needed to offset IL, and a 0-100 risk score. Use this to determine if a pool's advertised APY actually compensates for IL risk, or if simply holding the tokens would be more profitable. Costs $1.00 per call.","params":{"token_a_price":{"type":"number","required":true,"description":"Current price of token A in USD"},"token_b_price":{"type":"number","required":true,"description":"Current price of token B in USD"},"investment_usd":{"type":"number","required":true,"description":"Total investment amount in USD"},"days":{"type":"number","required":false,"description":"Simulation time horizon in days (default: 30)"},"volatility_a":{"type":"number","required":false,"description":"Annualized volatility of token A as decimal (default: 0.8)"},"volatility_b":{"type":"number","required":false,"description":"Annualized volatility of token B as decimal (default: 0.05)"},"correlation":{"type":"number","required":false,"description":"Price correlation between token A and B, range -1 to 1 (default: 0.5). Use ~0.7 for ETH/BTC, ~0 for MEME/USDC, ~0.9 for correlated L1s."},"fee_apy":{"type":"number","required":false,"description":"Annualized APY earned from pool fees as decimal, e.g. 0.25 for 25% (default: 0). When provided, net PnL accounts for accumulated fee income against IL."}},"exampleRequest":{"token_a_price":3200,"token_b_price":1,"investment_usd":10000,"days":30,"correlation":0,"fee_apy":0.15}}