> For the complete documentation index, see [llms.txt](https://docs.candelacharts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.candelacharts.com/investing/risk-and-portfolio-management/vix-risk-z-score/usage.md).
# Usage
VIX Risk Z-score Usage
The VIX Risk Z-Score is a crucial tool for contrarian investing, allowing you to systematically buy when there is "blood in the streets" and exercise caution when markets become overly euphoric.
### How it works
The indicator pulls daily VIX closing data directly from the Federal Reserve Economic Data (FRED) database. It calculates a long-term moving average and standard deviation (defaulting to a 365-day lookback). It then computes the Z-Score, measuring exactly how many standard deviations the current VIX is from its mean. The resulting oscillator and candle overlays visually alert you when volatility reaches extreme statistical tails.
### Interpreting the Regimes
* **Overbought / Panic (Z-Score > 2.0)**: When the VIX spikes and pushes the Z-Score above the +2.0 threshold, the market is experiencing intense fear and panic selling. The indicator highlights this by coloring the candles and the oscillator (default Blue). These periods are historically the most lucrative times to aggressively buy the dip in risk assets, as fear has peaked.
* **Neutral (Z-Score between -2.0 and 2.0)**: The VIX is trading within its normal historical bounds. Volatility is behaving as expected, and traditional trend-following strategies tend to work best here (default Gray candles).
* **Oversold / Complacency (Z-Score < -2.0)**: When the VIX grinds extremely low and pushes the Z-Score below the -2.0 threshold, the market is deeply complacent. Investors are pricing in zero risk. The indicator highlights this (default Orange). While markets can remain complacent for long periods, this reading warns you to tighten stop-losses, avoid using excessive leverage, and prepare for a potential volatility spike.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.candelacharts.com/investing/risk-and-portfolio-management/vix-risk-z-score/usage.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
