omni_dollar_cost_averaging_dca
Calculate recurring crypto investments and projected portfolio value, profit, and purchase count to reduce timing risk compared with lump-sum investing.
Instructions
Crypto Dollar-Cost Averaging (DCA) Accumulation Calculator. Simulate historical and projected recurring cryptocurrency investments (weekly/monthly DCA) versus lump-sum investing to reduce timing risk. Discipline: CRYPTO. Governing mathematical model / formula: Average Acquisition Cost = Total Capital Invested / Total Accumulated Tokens.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_portfolio_value_usd (Projected Terminal Value), total_capital_invested (Total Principal Invested), net_profit_earned (Net Unrealized Profit), total_purchases_count (Number of Recurring Orders) using recurring_investment_usd (Recurring Contribution Amount ($)), purchase_frequency (Purchase Frequency (1 = Weekly, 2 = Bi-Weekly, 3 = Monthly)), dca_duration_months (Investment Horizon (Months) in months), projected_annual_growth_pct (Projected Annual Asset CAGR (%) 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.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Crypto Dollar-Cost Averaging (DCA) Accumulation Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
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): "dollar-cost-averaging-dca"
category (string): "crypto"
name (string): "Crypto Dollar-Cost Averaging (DCA) Accumulation Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_portfolio_value_usd (Projected Terminal Value): Formatted display string (e.g. '$38,420.00')
metrics.total_capital_invested (Total Principal Invested): Formatted display string (e.g. '$26,000.00')
metrics.net_profit_earned (Net Unrealized Profit): Formatted display string (e.g. '+$12,420.00 (+47.8%)')
metrics.total_purchases_count (Number of Recurring Orders): Formatted display string (e.g. '104 Automatic Buys')
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_dollar_cost_averaging_dca"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| purchase_frequency | No | Purchase Frequency (1 = Weekly, 2 = Bi-Weekly, 3 = Monthly). 1: Weekly (52x/yr), 2: Bi-Weekly (26x/yr), 3: Monthly (12x/yr). Default: 1. Min: 1. Max: 3. | |
| dca_duration_months | No | Investment Horizon (Months) (months). Total duration of systematic DCA program. Default: 24. Min: 6. Max: 120. | |
| recurring_investment_usd | No | Recurring Contribution Amount ($). Periodic purchase amount. Default: 250. Min: 10. Max: 10000. | |
| projected_annual_growth_pct | No | Projected Annual Asset CAGR (%) (%). Expected compound annual capital appreciation. Default: 35. Min: -20. Max: 200. |