Historical Crash Survival Calculator — Step-by-Step Guide

AlamToolKit.com built this calculator to answer one question honestly: how would my portfolio have survived a real market crash? Not a hypothetical stress test. Not a Monte Carlo simulation. A replay of actual historical episodes — 1929, 2008, COVID, 2022, and thirteen more — applied to your own holdings, with every number shown and every assumption disclosed.

This guide explains every field, shows you how to validate your inputs, and gives you worked examples you can check by hand. By the end you will know exactly what the calculator does, where its limits are, and how to use it for real-world decisions.

Anatomy of a portfolio crash

The same six checkpoints are reported for every replay. Maximum drawdown is measured from the running peak, not from your entry point — so it can be larger than the fall from where you started.

On desktop the diagram scales to the full card width and stays sharp at any zoom. On mobile it shrinks fluidly without horizontal scrolling.

Basic inputs

How do you want to describe your holdings?

Two radio buttons let you choose the input style. You can switch at any time; the other mode keeps its own data.

Sample portfolio and risk limit

Run buttons

• Run the crash test — runs the currently selected episode and jumps to the Results tab.
• Test all 17 crashes — runs your portfolio against every episode in the library and builds a comparison table and chart.

Try a scenario

Six one-click examples: $100K 60/40 in 2008, $50K all-stock in COVID, $100K tech-heavy in Dot-Com, $25K crypto in 2022, $250K gold-heavy in 2022, and $500K All-Weather across all crashes. Each button loads the portfolio, the crash and the right settings, then runs the replay.

Hypothetical crash builder

Only visible when you select Hypothetical scenario. Nine fields let you set the decline for each asset class and the recovery period:

Press Use this hypothetical scenario to apply the shocks and re-run.

Contributions & withdrawals during the crash

Common mistake: setting a withdrawal rate that looks safe on day one but becomes dangerous after a crash. The calculator shows you this: a $20,000 draw on $500,000 is 4%, but after a 37% fall the same inflation-adjusted draw is 6.8% of the portfolio. That is the sequence-of-returns risk retirees actually face.

Rebalancing, fees & taxes

Inflation & currency

Leverage stress test

This section models what happens when you borrow to invest. Full forced-liquidation modelling lives in the separate Margin Call & Liquidation Calculator.

Common mistake: assuming leverage only multiplies gains. The calculator flags the exact month the maintenance margin is breached. For full liquidation modelling, use the separate Margin Call & Liquidation Calculator.

Reverse crash test

Instead of asking “how bad would this crash be?”, this asks “how big a crash could I survive?”

Portfolio A vs Portfolio B

Tick Enable comparison to run a second portfolio alongside yours and see which one holds up better. Portfolio A is your main portfolio. Portfolio B is a simple four-field mix.

Press Run A vs B to see a side-by-side table of drawdown, dollar loss, recovery time, gain needed and resilience score.

Historical dataset (editable JSON)

The library ships with rounded, publicly reported peak-to-trough figures so the tool works offline in a single file. Values are approximations, not licensed series.

• View / edit the episode data (JSON) — open the accordion to see the raw data.
• Apply edited JSON — validates and loads your changes.
• Restore defaults — returns to the shipped dataset.
• Download JSON — saves the current library as a file.

Verdict card

A single, plain-language answer: would your portfolio have survived? Three possible outcomes:

• Yes — survived inside your risk limit Your drawdown stayed inside the limit you set in Step 1.
• Survived — but breached your risk limit Capital survived, but the drawdown exceeded your comfort zone. This is the scenario that drives panic selling.
• Capital wiped out The leveraged path was liquidated.

The sub-line shows your maximum drawdown against your limit, and whether you regained your pre-crash peak. The distinction between the first two is the whole point: almost every equity-heavy portfolio survived 2008 in the sense that its value stayed above zero, but many breached a 20–30% comfort limit.

KPI grid — eight numbers that matter

Plain English summary

A single paragraph that reads the result back to you in normal language: the episode name, the drawdown, the dollar loss, the trough value, the gain needed, the recovery time, and whether you breached your limit.

Crash timeline

A horizontal strip of milestones: when the replay started, when the market peaked, when it bottomed, when the previous high was regained, and where the portfolio ended. Each shows the month and the dollar value.

Scenario scrubber

A slider that lets you walk through the crash month by month. For each month it shows the portfolio value and the drawdown from the running peak. Use it to see exactly when the worst pain occurred. This is the most tactile way to understand sequence-of-returns risk.

Charts

• Crash equity curve — your portfolio (orange) versus the benchmark (dashed grey), with the crash low and recovery points marked.
• Normalised crash chart — both lines start at 100, so you can compare shapes regardless of starting value.
• Underwater (drawdown) chart — how far below the running peak you were at each month.
• Loss attribution chart — a bar chart showing the dollar impact of each holding.
• All-crisis drawdown chart — your portfolio’s maximum drawdown in every episode.

Two buttons let you download the equity chart, or all charts, as PNG files. The results table can be copied as TSV or downloaded as CSV.

Which holdings caused the damage?

A table with one row per holding: name, asset class, weight, crash return, dollar impact, share of the total loss, and a data-quality flag.

Two callouts below the table name the biggest source of loss and the best protection. This is the field that answers “which holdings caused the damage?”

You vs. the benchmark

A comparison table: maximum drawdown, dollar loss, recovery time, gain needed, and end value — for your portfolio and the benchmark, with the difference shown.

A short note explains whether you lost more or less than the benchmark, in percentage points. A second note explains the recovery maths: how much gain is needed and how long it might take.

Survival diagnosis

• Capital survival — did the portfolio stay above zero?
• Risk-limit survival — did the drawdown stay inside your comfort limit?
• Leverage warning — if you used leverage and the maintenance margin was breached, the month of forced liquidation is reported here, along with the lowest margin ratio reached.

All-crisis stress test

Only appears after you press Test all 17 crashes. It shows a table of every episode with drawdown, dollar loss, recovery time, gain needed and whether you breached your limit.

Eight summary KPIs appear above the table: worst case, best case, average drawdown, median drawdown, longest recovery, shortest recovery, limit breaches, and episodes tested.

A bar chart shows your drawdown in each crisis side by side.

Sensitivity — what would change the outcome?

A table showing how your maximum drawdown changes if you shift 10 percentage points from your biggest holding into your second-biggest (or into cash).

A note below explains which change would most reduce your drawdown.

Copy, share & export

• Copy result summary — copies a plain-text report of the results.
• Copy all entered data — copies every input you set.
• Copy result table (TSV) — copies the table in a format that pastes straight into Excel or Google Sheets.
• Download results (CSV) — downloads the full monthly equity series plus the attribution table.
• Copy shareable link — stores your entire scenario in the URL hash. No account, no server.
• Print / Save as PDF — opens the print dialog.
• Reset everything — clears all inputs and results.

How this result was calculated

A bullet list of the modelling assumptions used in your run: the episode, entry point, rebalancing rule, fees, tax drag, leverage, inflation and results basis.

A “known limitations” paragraph explains that episode returns are rounded public figures, the intra-episode path is a modelled shape, and that historical results never guarantee future results.

Worked examples — check the maths by hand

Example 1 — $500,000 all-stock portfolio, −37% first year

A $500,000 all-stock portfolio withdrawing $20,000 (a 4% rate) hits a −37% first year:

1. Withdrawal is taken first: 500,000 − 20,000 = 480,000. The calculator applies withdrawals at the start of each month, which is the conservative convention.
2. Then the return applies: 480,000 × 0.63 = $302,400. That is the crash low for the first year.
3. Next year’s inflation-adjusted draw is $20,600. As a percentage of the portfolio: 20,600 ÷ 302,400 = 6.8%. That is the danger signal — a withdrawal rate that looked safe at 4% is now 6.8%.
4. Breakeven on the decline alone needs 1 ÷ (1 − 0.396) − 1 = +58.7%. The dollar loss is 500,000 − 302,400 = $197,600.

Example 2 — $100,000 60/40 portfolio in 2008

A $100,000 60/40 portfolio entering at the October 2007 peak:

• US stocks fell ≈ −56.8%, bonds gained ≈ +6% (flight to quality).
• Weighted decline: 0.60 × (−56.8%) + 0.40 × (+6%) = −31.7%.
• Dollar loss: 100,000 × 31.7% = $31,700. Trough value: $68,300.
• Gain needed to recover: 1 ÷ (1 − 0.317) − 1 = +46.5%.
• Recovery time: roughly 36 months from the trough, matching the benchmark’s own recovery window.

Run this exact scenario with the “$100K 60/40 in 2008” example chip. Your numbers should match these within rounding.

Verification runs — numbers actually executed

The finished calculator file was loaded in a headless DOM and the real buttons were driven. These are the results, not assertions.

What is this calculation used for?

Historical crash replay is a risk-sizing tool, not a forecasting tool. It is used for six practical jobs:

Where to apply it — real-world usage

• Personal portfolio review: once a year, replay your current allocation against the 2008 GFC and the 2022 rate shock. If the dollar loss would change your behaviour, adjust the allocation before the market does it for you.
• Retirement plan stress test: set your actual withdrawal rate, inflation adjustment, and 60/40 or 50/50 allocation. Run 2000–2009 as a slow-bleed decade. If the plan fails, reduce the withdrawal rate or add a cash buffer.
• Advisor–client meetings: load the client’s real holdings as custom tickers, run the all-crisis test, and print the PDF. The dollar-loss numbers turn a philosophical risk discussion into a concrete one.
• Leverage and margin policy: before using margin, set leverage to 2×, financing cost to your broker’s rate, and maintenance margin to your broker’s requirement. The liquidation month tells you how much room you actually have.
• Education and content: the shareable link and copy-report buttons make it easy to embed a specific scenario in a blog post, a classroom exercise, or a newsletter.
• Pre-trade risk check: before adding a concentrated position, run the custom-holdings mode with the new ticker included and see how it changes the loss attribution.

Common mistakes — and how the calculator catches them

Key user pain points — and how this calculator solves them

1. Portfolio return and roll-forward

r_p,t = Σ w_i · r_i,t

V_t+1 = (V_t − W_t)(1 + r_p,t − f) + C_t (withdrawal mode)

V_t+1 = V_t(1 + r_p,t − f) + C_t (saving mode)

In plain terms: money you take out is not exposed to that month’s return; money you add is.

2. Drawdown, maximum drawdown and dollar loss

DD_t = (V_t − max V_k) ÷ max V_k

MDD = min_t DD_t

Dollar loss = V_0 × MDD

V_trough = V_0 × (1 + MDD)

• Drawdown at any month = (current value ÷ highest previous value) − 1.
• Maximum drawdown = the worst of those readings.

3. Gain required to recover, and recovery time

G = 1 ÷ (1 − d) − 1

Recovery time = the first month the portfolio value regains its pre-crash peak.

A −40% loss needs +66.7% merely to break even — and the gain required grows faster than the loss: −20% needs +25%, −33% needs +50%, −50% needs +100%, −80% needs +400%.

4. Inflation, real return and fees

r_real = (1 + r) ÷ (1 + π) − 1

V_real_t = V_t ÷ (1 + π)^(t/12)

Fees are deducted monthly, so they compound against you during both the crash and the recovery.

5. Leverage, financing cost and margin

r_L = L · r_p − (L − 1) · c

Margin ratio = (L · f − (L − 1)) ÷ (L · f)

f_min = (L − 1) ÷ (L · (1 − m)) → liquidation when f ≤ f_min

6. Resilience score

S = 45 · (1 − d) + 35 · (τ_bench ÷ τ) + 20 · (1 − H), clamped to 0–100.

• 45 points — drawdown resilience: how small the drawdown was.
• 35 points — recovery resilience: how fast you recovered relative to the benchmark.
• 20 points — diversification: how spread out your weights are (Herfindahl index).

The score is fully disclosed — no black box. Full derivations, symbols and edge cases are on the calculator page itself.

Accuracy note — what this tool is and is not

Frequently asked questions

Troubleshooting

• Nothing happens when I press Run. Make sure at least one holding or slider has a weight above zero.
• The results look identical across episodes. Check you are not in hypothetical mode with the same shocks each time.
• The share link does not restore my data. The link stores data in the URL hash after #hcsc=. Some email clients and chat apps strip the hash. Copy the full URL from the share field.
• Chart download fails. PNG export needs a modern browser. Try Chrome, Edge, Firefox or Safari.
• My custom ticker is flagged as a proxy. That ticker is not in the built-in mapping. It is treated as Other / unclassified and flagged honestly rather than guessed.
• The results table is too wide on my phone. Tables scroll horizontally inside their container. The KPI cards and charts reflow to a single column on small screens.

Keep going — related risk tools on AlamToolKit

Each of these answers a different question. This page only answers “would my portfolio have survived that crash?”