Move Significance
Calculate how unusual each move of every series is: the change in units of its trailing volatility and of its trailing Value at Risk, its percentile among the earlier moves and the date of the last move at least as large in the same direction (“the largest one-day rise since”).
This is get_move_significance (Risk) for any series rather than the returns of the Toolkit’s tickers: with Econometrics(data=..., changes="difference") a yield, rate or spread moves in points, so a rise of the 2-year Treasury yield from 4.56% to 4.73% is a move of 0.0017, measured against the earlier daily moves of the same yield. Where get_level_significance asks how unusual a level is, this asks how unusual a change is.
The formula is as follows:
\[\text{Volatility Multiple} (t) = \operatorname{Change}(t) / \sigma(\operatorname{Change}(t - \text{window}),\; ...,\; \operatorname{Change}(t - 1))\] \[\text{VaR Multiple} (t) = \operatorname{Change}(t) / | \operatorname{Quantile}(\operatorname{Change}(t - \text{window}),\; ...,\; \operatorname{Change}(t - 1) \text{;} \alpha) |\] \[\operatorname{Percentile}(t) = \operatorname{Count}(| \operatorname{Change}(s) | < | \operatorname{Change}(t) |,\; s < t) / \operatorname{Count}(s < t)\] \[\text{Largest Since} (t) = \max(s < t \text{:} \;\text{Change} (s) \leq \operatorname{Change}(t)) \text{if Change} (t) < 0\] \[\text{Largest Since} (t) = \max(s < t \text{:} \;\text{Change} (s) \geq \operatorname{Change}(t)) \text{if Change} (t) > 0\]The Change is the series’ change as changes defines it: a percentage change by default, the difference with changes="difference" and the series itself with changes="none". The volatility σ uses ddof=1 and the quantile is the historic Value at Risk, interpolated linearly. Each measure only uses the changes before the period itself (no look-ahead), and Largest Since compares falls with falls and rises with rises, as a headline does.
Also known as: sigma move, largest move since, biggest daily rise since, standardized change, yield move significance.
Move Significance in Python
Install the Finance Toolkit with:
pip install financetoolkit -U
Then call get_move_significance as shown below.
from financetoolkit import Econometrics, FixedIncome
fixedincome = FixedIncome(start_date='2025-01-01', end_date='2026-11-10')
treasury_rates = fixedincome.get_treasury_rates(maturities=['2Y', '10Y'])
econometrics = Econometrics(data=treasury_rates, changes='difference')
econometrics.get_move_significance().loc['2026-11-10'].unstack(level=0)
Which returns:
| Return | Volatility Multiple | VaR Multiple | Percentile | Largest Since | |
|---|---|---|---|---|---|
| 2 Year | 0.0017 | 3.5345 | 2.4286 | 0.9935 | 2025-04-09 |
| 10 Year | 0.001 | 2.2808 | 1.6667 | 0.9546 | 2026-09-23 |
| Return | Volatility Multiple | VaR Multiple | Percentile | Largest Since | |
| 2 Year | 0.0017 | 3.5345 | 2.4286 | 0.9935 | 2025-04-09 |
| 10 Year | 0.001 | 2.2808 | 1.6667 | 0.9546 | 2026-09-23 |
Using Your Own Data
get_move_significance runs on any data, not only prices: ratios, economic indicators, yield curves or your own dataset. Pass a DataFrame, a Series or a dictionary of them to Econometrics as data, with the dates in the rows or the columns, and set changes to how its changes are calculated: "percentage", "log", "difference" for rates and ratios, or None when the data are changes already. For example, for the monthly unemployment rates of the United States and Germany:
from financetoolkit import Economics, Econometrics
economics = Economics(start_date="2000-01-01")
unemployment = economics.get_unemployment_rate(
countries=["United States", "Germany"], period="monthly"
)
econometrics = Econometrics(data=unemployment, changes="difference")
econometrics.get_move_significance()
Parameters
get_move_significance accepts the following parameters.
| Parameter | Type | Description | Example |
|---|---|---|---|
period | str | None | The data frequency (daily, weekly, monthly, quarterly or yearly). Defaults to None, which is daily. | "weekly" |
window | int | None | The number of earlier changes the volatility is measured over, which the percentile also needs at least. Defaults to None, which uses a year of observations with a minimum of 20 (252 daily, 52 weekly and 20 monthly, quarterly or yearly changes). | 20 |
alpha | float | The tail probability of the trailing historic Value at Risk the VaR Multiple divides by (0.05 for the 95% VaR). Defaults to 0.05. | 0.01 |
include_benchmark | bool | Whether to include the benchmark of a Toolkit. Defaults to False. | True |
rounding | int | None | The number of decimals to round the results to. Defaults to None, which uses the rounding of the class (4 unless set otherwise). | 2 |
show_columns | str | list[str] | None | The columns to keep, a name or a list of names, matched on every column level, or the rows when no column has those names (such as the line items of a financial statement). Names that do not exist are logged, and when none exist the result is returned in full. Defaults to None, which keeps every column. | None, which keeps every column |