> 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/macro-and-liquidity/macro-credit-model/usage.md).

# Usage

Macro Credit Model Usage

<figure><img src="https://3870127617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCBVnUk5c5TVytimjy972%2Fuploads%2FfjNHkx6UEB03JD00Pfj2%2Fdocs-macro-credit-model-002.png?alt=media&amp;token=c86cbdb4-ef33-4e7e-ab21-7b54973d3926" alt=""><figcaption></figcaption></figure>

The Macro Credit Model is a structural compass. It is best used as a macro filter to decide how aggressive or defensive your overall portfolio positioning should be.

### How it works

The indicator pulls daily closing data from FRED for High Yield (BAMLH0A0HYM2) and Investment Grade (BAMLC0A0CM) bond spreads. It calculates the spread differential, smooths it via an EMA, and then normalizes it using a rolling Z-Score. By comparing this Z-Score against predefined standard deviation thresholds (e.g., +2.0 for Stress, -2.0 for Extreme Low), the model objectively classifies the current macroeconomic regime.

### Interpreting the Regimes

* **Stress Zone (Risk-Off)**: When the Z-Score breaks above the +2.0 threshold (Top Zone Highlight), credit markets are panicking. Liquidity is drying up, and default risks are being aggressively priced in. This is a massive red flag for equities and typically precedes deep market drawdowns. You should aggressively de-risk.
* **Elevated Zone**: A Z-Score between +1.0 and +2.0 suggests caution. Credit conditions are worsening, signaling a potential late-cycle environment.
* **Low Risk Zone (Risk-On)**: When the Z-Score drops into negative territory, investors are confidently buying risky corporate debt. This confirms a healthy macroeconomic backdrop, heavily supporting long positions in equities and risk assets.
* **Extreme Low Zone**: A Z-Score below -2.0 signifies euphoric credit conditions. While this is highly bullish in the short term, it can occasionally signal a late-stage bubble where risk is not being properly priced.

### Important Note on Timeframes

Because FRED reports this data at the end of the day, **this indicator requires a 1D timeframe or higher** to function correctly.


---

# 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/macro-and-liquidity/macro-credit-model/usage.md?ask=<question>&goal=<user_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.
