# Clarity AI

## Overview

**Clarity AI** is an advanced, AI-powered engine that analyzes market patterns to score the quality and conviction of trade signals. It serves as a powerful confirmation tool, helping you filter out low-probability setups and focus only on the strongest trading opportunities.

When a signal is generated, Clarity AI assigns it a rating from 0 to 5 stars, which appears directly on the signal label. This rating is based on a deep analysis of historical data and the current market structure, giving you an instant measure of the signal's confidence.

<figure><img src="/files/RGB8A0VHzzrBb4RAeoPz" alt=""><figcaption></figcaption></figure>

## Settings

You can configure the Clarity AI engine to match your preferred trading timeframe and risk tolerance. These settings allow you to control the depth of the analysis and the minimum quality required for a signal to appear on your chart.

| Setting                       | Description                                                                                                                                                                              |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Clarity AI Ratings**        | Enables the AI analysis and sets the timeframe for its pattern recognition. You can choose **Short-term**, **Mid-term**, or **Long-term** to align the analysis with your trading style. |
| **Clarity AI Minimum Rating** | Acts as a filter, hiding any signals that do not meet the minimum star rating you set. A higher value will result in fewer, but higher-quality, signals.                                 |
| **Clarity AI Depth**          | Controls the computational depth of the AI analysis. **Maximum** provides the highest quality results but may be slower, while **Minimum** is faster with a more baseline analysis.      |
| **Clarity AI Data**           | Sets the amount of historical data used for the AI's analysis. **Maximum** is the most comprehensive but may be slower, while **Minimum** is faster.                                     |

## Best Practices & Usage

* **Filter for High-Quality Trades:** Set the **Clarity AI Minimum Rating** to a higher value (e.g., 3 or 4) to automatically hide weaker signals. This helps you focus only on high-conviction setups and avoid overtrading in uncertain market conditions.
* **Match Timeframe to Your Strategy:** Align the **Clarity AI Ratings** setting with your trading style. If you are a day trader, use **Short-term**. If you are a swing trader, use **Mid-term** or **Long-term** to ensure the AI is analyzing patterns relevant to your timeframe.
* **Balance Performance and Quality:** For most users, the **Limited** setting for **Clarity AI Depth** and **Clarity AI Data** provides a good balance between performance and analytical quality. Use **Maximum** if you require the highest possible accuracy and are not concerned about minor indicator lag.
* **Use as a Confirmation Tool:** Even if you set a low minimum rating, use the star rating on each signal as a guide. A 5-star signal in a key support or resistance zone is a much stronger confirmation than a 1-star signal.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lunefi.com/premium-tradingview-indicators/lune-indicators-suite/lune-market-analysis/clarity-ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.