{
  "tool_id": "retirement_savings",
  "slug": "retirement-calculator",
  "path": "/retirement-calculator/",
  "mode": "url_api",
  "api_usage": "GET https://aifinhub.io/api/retirement-calculator/?<params>",
  "sample_input": {
    "tool": "retirement_savings",
    "current_age": 33,
    "retirement_age": 60,
    "current_savings": 120000,
    "annual_contribution": 18000,
    "annual_return_percent": 7,
    "annual_inflation_percent": 2.5,
    "desired_annual_spending": 65000,
    "social_security_annual": 18000,
    "withdrawal_rate_percent": 4
  },
  "input_schema": {
    "type": "object",
    "properties": {
      "tool": {
        "type": "string"
      },
      "current_age": {
        "type": "integer"
      },
      "retirement_age": {
        "type": "integer"
      },
      "current_savings": {
        "type": "integer"
      },
      "annual_contribution": {
        "type": "integer"
      },
      "annual_return_percent": {
        "type": "integer"
      },
      "annual_inflation_percent": {
        "type": "number"
      },
      "desired_annual_spending": {
        "type": "integer"
      },
      "social_security_annual": {
        "type": "integer"
      },
      "withdrawal_rate_percent": {
        "type": "integer"
      }
    },
    "required": [
      "tool",
      "current_age",
      "retirement_age",
      "current_savings",
      "annual_contribution",
      "annual_return_percent",
      "annual_inflation_percent",
      "desired_annual_spending",
      "social_security_annual",
      "withdrawal_rate_percent"
    ]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "yearsToRetirement": {
        "type": "number"
      },
      "projectedNestEgg": {
        "type": "number"
      },
      "targetNestEgg": {
        "type": "number"
      },
      "fundingGap": {
        "type": "number"
      },
      "retirementIncomeFromNestEgg": {
        "type": "number"
      },
      "baristaIncomeNeeded": {
        "type": "number"
      },
      "requiredAnnualContribution": {
        "type": "number"
      },
      "coastFireAge": {
        "type": "null"
      },
      "timeline": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "age": {
              "type": "number"
            },
            "yearIndex": {
              "type": "number"
            },
            "balance": {
              "type": "number"
            },
            "inflationAdjustedBalance": {
              "type": "number"
            }
          }
        }
      },
      "assumptionsEcho": {
        "type": "object",
        "properties": {
          "currentAge": {
            "type": "number"
          },
          "retirementAge": {
            "type": "number"
          },
          "currentSavings": {
            "type": "number"
          },
          "annualContribution": {
            "type": "number"
          },
          "annualReturnPercent": {
            "type": "number"
          },
          "annualInflationPercent": {
            "type": "number"
          },
          "desiredAnnualSpending": {
            "type": "number"
          },
          "socialSecurityAnnual": {
            "type": "number"
          },
          "withdrawalRatePercent": {
            "type": "number"
          }
        }
      },
      "warnings": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  }
}