Folionomiq

One holding already in the portfolio, measured at every weight from none to all, with the rest of the money shared out in proportion: volatility, the holding's share of the risk and the number of independent bets at each point. Use it for 'how much of this is enough to change anything?'; for one specific change use test_a_change, for a holding not yet owned check_before_you_buy. ticker must be one of the holdings; base sets the currency (default USD). It never says which weight to hold.

sweep_holding

How one portfolio's daily moves line up with four common patterns (the market, small versus large companies, value versus growth, momentum): each sensitivity, whether it is distinguishable from zero, and how much of the movement the four explain together. Use it for 'what style am I really exposed to?'; for how many independent bets there are, portfolio_structure. Holdings as weights or amounts; base sets the currency the returns are measured in (default USD). A sensitivity that cannot be told from zero is reported as such, not as a number to act on.

factor_exposure

Three or four plain-language sentences about one portfolio (what its risk is built from and its worst historical fall), each with the window it rests on. Use it for the shortest answer, or for a reader new to investing; every figure is in measure_portfolio. Amounts make the fall come out in money, in the base currency (default USD). No tables and no numbered report.

plain_findings

The written report on one portfolio, with every figure numbered F1, F2... beside the method and the window behind it. For a reader who wants something to quote or keep; measure_portfolio returns this same report together with structure, look-through and crises. Amounts make the report speak in money, in the base currency (default USD). The window starts when the youngest holding starts, and the report says so.

portfolio_report

One portfolio read along three separate questions: what its risk is built from (concentration), how it behaved when markets broke (resilience), and what it returned for the risk taken (efficiency), each with its own figures. Use it when the reader asks whether something is off in how the portfolio is built; for the full measurement use measure_portfolio. Holdings as weights or amounts; base sets the currency (default USD). No overall score is returned, and an axis with too little history, such as no crisis in the window, comes back without a reading instead of a guessed one.

health_axes

What one portfolio returned over its record: growth per year, before and after inflation, best and worst months and years, the range of any 12 months in a row, returns by month and year, and how far the weights drift between rebalances. Use it for 'how did this do?'; for crises only use past_crises, for money put in every month monthly_plan. Base sets the currency the growth is measured in (default USD), which changes the result for holdings priced in other currencies. Past record only, not a forecast.

return_history

For a portfolio held in one currency but priced partly in others: how much of it is outside the base currency, and what exchange-rate moves added to its growth, volatility and worst fall compared with the same holdings currency-hedged. Use it only when some holdings are priced in another currency than the holder's; for a portfolio entirely in one currency it has nothing to show. Needs base set to the holder's currency to mean anything.

currency_effect

Starts from a loss the reader names and finds the least extreme combination of market moves that would produce it on this portfolio, beside the worst each of those moves actually did in the record. Use it for 'what would it take to lose that much?'; for what past crises actually did use past_crises. loss is a fraction (0.25 is a quarter); base sets the currency (default USD). No probability is computed: the answer says how large the moves would be, not how likely.

reverse_stress

Only past crises for one portfolio: 2008, 2020, 2022 and others inside its price history, with the fall, the worst day and the days it took to come back. Use it for 'what did crashes do to this?'; for the whole record use return_history. Give amounts to get each fall in money, in the base currency (default USD). Crises before a holding existed are named as not tested, not estimated.

past_crises

The companies a portfolio owns through its funds, added up across funds: the largest names with their share of the whole portfolio, names reached through more than one fund, and sectors. Use it for 'what do I really own?'; for the full measurement use measure_portfolio, for one fund alone asset_info. Give holdings as money amounts to get each company in money; base sets that currency (default USD). Figures are minimums: they count only the companies the measurement can name, and the answer says how much of the money that is.

look_through

Whether re-optimising an allocation would have helped: fit on the years before each date, hold on prices it had not seen, repeat, and compare that record with the portfolio actually held and with equal weights. Use it only when the reader asks whether an optimiser would have beaten what they hold; it is not for choosing weights. tickers are the candidates (2 to 30); holdings, if given, is the portfolio compared against; objective picks what each fit maximises (default max_sharpe); train_years and step_months set how much history each fit uses and how often it refits. Returns the record, never an allocation to hold.

walk_forward

No public description for this tool yet.