Retirement

Roth vs traditional contribution comparator

Compares a Roth vs a traditional (pre-tax) retirement contribution on an apples-to-apples, after-tax basis. The same annual dollars go into either account; the traditional path also invests its up-front tax saving in a taxable side account (matching the out-of-pocket cost), whose gains are taxed at the end. Roth withdrawals are tax-free; traditional withdrawals are taxed at the retirement marginal rate. Returns each path's after-tax future value, the Roth advantage, the recommendation, and the breakeven retirement rate. Deterministic; not advice.

post/v1/roth-vs-traditional

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/roth-vs-traditional
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

annual_contributionnumber required

Dollars into the account each year.

yearsinteger required

Years until retirement.

expected_returnnumber required

Annual, e.g. 0.07.

current_marginal_ratenumber required

Tax rate now (drives the traditional tax saving).

retirement_marginal_ratenumber required

Expected rate on traditional withdrawals.

invest_tax_savingsboolean

Invest the traditional path's up-front tax saving in a taxable side account (default true — the fair, equal-out-of-pocket comparison).

capital_gains_ratenumber

Taxes the side account's gains at the end. Omit for 0.15; set it to 0 to model the 0% long-term capital-gains bracket (a low-income retiree).

Response

The after-tax comparison

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "rothvtrad_1a2b3c4d5e6f7a8b",
  "engine_version": "roth-vs-traditional-1.0.0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.