omni_algorithmic_lending_apy
Calculate supply and borrow APYs, utilization, and kink status for Aave/Compound-style lending pools from deposit, borrow, kink, and reserve inputs.
Instructions
Algorithmic Lending Supply & Borrow APY (Aave / Compound Model). Calculate interest rate curves, utilization rate 'kink' point, and supply/borrow APYs for algorithmic money markets (Aave v3 / Compound v3). Discipline: CRYPTO. Governing mathematical model / formula: Borrow APY = Base Rate + (Utilization / Optimal) · Slope₁ | If U > U_opt: + Slope₂ · ([U - U_opt] / [1 - U_opt]).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of borrow_apy_rate (Current Variable Borrow APY), supply_apy_rate (Current Passive Supply APY), pool_utilization_ratio (Pool Utilization Rate (U)), kink_status (Interest Rate Regime) using total_deposited_pool_usd (Total Pool Supplied Deposits ($)), total_borrowed_pool_usd (Total Active Borrows ($)), optimal_utilization_kink_pct (Optimal Utilization Kink Point (%) in %), reserve_factor_pct (Protocol Reserve Factor (%) in %). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
SIBLING ROUTING: Use this dedicated specialist tool for 'Algorithmic Lending Supply & Borrow APY (Aave / Compound Model)' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "algorithmic-lending-apy"
category (string): "crypto"
name (string): "Algorithmic Lending Supply & Borrow APY (Aave / Compound Model)"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.borrow_apy_rate (Current Variable Borrow APY): Formatted display string (e.g. '5.63%')
metrics.supply_apy_rate (Current Passive Supply APY): Formatted display string (e.g. '3.59%')
metrics.pool_utilization_ratio (Pool Utilization Rate (U)): Formatted display string (e.g. '75.0%')
metrics.kink_status (Interest Rate Regime): Formatted display string (e.g. 'Below Kink (Stable Interest Curve)')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_algorithmic_lending_apy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reserve_factor_pct | No | Protocol Reserve Factor (%) (%). Portion of borrow interest retained by protocol treasury. Default: 15. Min: 5. Max: 30. | |
| total_borrowed_pool_usd | No | Total Active Borrows ($). Total loans currently drawn from the pool. Default: 7500000. Min: 10000. Max: 450000000. | |
| total_deposited_pool_usd | No | Total Pool Supplied Deposits ($). Total collateral liquidity supplied by depositors. Default: 10000000. Min: 100000. Max: 500000000. | |
| optimal_utilization_kink_pct | No | Optimal Utilization Kink Point (%) (%). Kink inflection threshold (typically 80% or 90%). Default: 80. Min: 50. Max: 95. |