OPEN-SOURCE SCRIPT
Two Candle Theory (Filtered) - Labels & Colors

Overview
This Pine Script classifies each candle into one of nine sentiment categories based on how the candle closes within its own range and in relation to the previous candle’s high and low. It optionally filters the strongest bullish and bearish signals based on volume spikes.
The script is designed to help traders visually interpret market sentiment through configurable labels and candle colors.
⸻
Classification Logic
Each candle is assessed using two metrics:
1. Close Position – where the candle closes within its own high-low range (High, Mid, Low).
2. Close Comparison – how the current close compares to the previous candle’s high and low (Bull, Bear, or Range).
Based on this, a short label is assigned:
• Bullish Bias: Strongest (SBu), Moderate (MBu), Weak (WBu), Slight (SlB)
• Neutral: Neutral (N)
• Bearish Bias: Slight (SlS), Weak (WBa), Moderate (MBa), Strongest (SBa)
⸻
Volume Filter
A volume spike filter can be applied to the strongest signals:
• SBu and SBa are only shown if volume is significantly higher than the average (SMA × threshold).
• The filter is optional and user-configurable.
⸻
Display Options
Users can control:
• Whether to show labels, bar colors, or both.
• Which of the nine label types are visible.
• Custom colors for each label and corresponding bar.
⸻
Visual Output
• Labels appear above or below candles depending on bullish or bearish classification.
• Bar colors reflect sentiment for quicker visual scanning.
⸻
Use Case
Ideal for identifying momentum shifts, validating trade entries, and highlighting candles that break out of previous ranges with conviction and/or volume.
⸻
Summary
This script simplifies price action by translating each candle into an interpretable sentiment label and color. With optional volume filtering and full display customization, it offers a practical tool for discretionary and systematic traders alike.
This Pine Script classifies each candle into one of nine sentiment categories based on how the candle closes within its own range and in relation to the previous candle’s high and low. It optionally filters the strongest bullish and bearish signals based on volume spikes.
The script is designed to help traders visually interpret market sentiment through configurable labels and candle colors.
⸻
Classification Logic
Each candle is assessed using two metrics:
1. Close Position – where the candle closes within its own high-low range (High, Mid, Low).
2. Close Comparison – how the current close compares to the previous candle’s high and low (Bull, Bear, or Range).
Based on this, a short label is assigned:
• Bullish Bias: Strongest (SBu), Moderate (MBu), Weak (WBu), Slight (SlB)
• Neutral: Neutral (N)
• Bearish Bias: Slight (SlS), Weak (WBa), Moderate (MBa), Strongest (SBa)
⸻
Volume Filter
A volume spike filter can be applied to the strongest signals:
• SBu and SBa are only shown if volume is significantly higher than the average (SMA × threshold).
• The filter is optional and user-configurable.
⸻
Display Options
Users can control:
• Whether to show labels, bar colors, or both.
• Which of the nine label types are visible.
• Custom colors for each label and corresponding bar.
⸻
Visual Output
• Labels appear above or below candles depending on bullish or bearish classification.
• Bar colors reflect sentiment for quicker visual scanning.
⸻
Use Case
Ideal for identifying momentum shifts, validating trade entries, and highlighting candles that break out of previous ranges with conviction and/or volume.
⸻
Summary
This script simplifies price action by translating each candle into an interpretable sentiment label and color. With optional volume filtering and full display customization, it offers a practical tool for discretionary and systematic traders alike.
Mã nguồn mở
Theo đúng tinh thần TradingView, người tạo ra tập lệnh này đã biến tập lệnh thành mã nguồn mở để các nhà giao dịch có thể xem xét và xác minh công năng. Xin dành lời khen tặng cho tác giả! Mặc dù bạn có thể sử dụng miễn phí, nhưng lưu ý nếu đăng lại mã, bạn phải tuân theo Quy tắc nội bộ của chúng tôi.
Thông báo miễn trừ trách nhiệm
Thông tin và ấn phẩm không có nghĩa là và không cấu thành, tài chính, đầu tư, kinh doanh, hoặc các loại lời khuyên hoặc khuyến nghị khác được cung cấp hoặc xác nhận bởi TradingView. Đọc thêm trong Điều khoản sử dụng.
Mã nguồn mở
Theo đúng tinh thần TradingView, người tạo ra tập lệnh này đã biến tập lệnh thành mã nguồn mở để các nhà giao dịch có thể xem xét và xác minh công năng. Xin dành lời khen tặng cho tác giả! Mặc dù bạn có thể sử dụng miễn phí, nhưng lưu ý nếu đăng lại mã, bạn phải tuân theo Quy tắc nội bộ của chúng tôi.
Thông báo miễn trừ trách nhiệm
Thông tin và ấn phẩm không có nghĩa là và không cấu thành, tài chính, đầu tư, kinh doanh, hoặc các loại lời khuyên hoặc khuyến nghị khác được cung cấp hoặc xác nhận bởi TradingView. Đọc thêm trong Điều khoản sử dụng.