COT - Weekly Summary

ayer

# COT Weekly Summary Dashboard - User Manual

## 📊 Overview

**COT Weekly Summary** is an advanced Pine Script dashboard that provides comprehensive real-time analysis of CFTC COT (Commitment of Traders) data. This professional tool allows you to monitor net positions of non-commercial traders across currencies, precious metals, and commodities, all within a single elegant and customizable interface.

### 🎯 Key Features
- **Multi-Asset Analysis**: Major currencies, precious metals, and commodities
- **Real-Time Data**: Automatic weekly updates from CFTC reports
- **BestPair Detector**: Automatically identifies the best trading opportunities
- **Customizable Interface**: Colors, sizes, and positioning fully configurable
- **Dynamic Watermark**: Motivational phrases that change with each new bar

---

## ⚙️ Configuration and Customization

### 📍 Table Position
**Setting**: `Table Position`
- **Top Left**: Top left corner
- **Top Center**: Top center
- **Top Right**: Top right corner
- **Middle Left**: Middle left
- **Middle Center**: Screen center
- **Middle Right**: Middle right
- **Bottom Left**: Bottom left corner
- **Bottom Center**: Bottom center
- **Bottom Right**: Bottom right corner

### 📊 Data Type
**Setting**: `Data Type`
- **Futures Only**: Futures contracts only
- **Futures and Options**: Futures + options (more complete data)

### 🎨 Color Customization

#### Base Table Colors
- **Header Background**: Header background color
- **Header Text**: Header text color
- **Frame Color**: Table frame color
- **Border Color**: Cell border color

#### Dynamic Row Colors
- **Positive Background**: Background for positive changes
- **Positive Text**: Text for positive changes
- **Negative Background**: Background for negative changes
- **Negative Text**: Text for negative changes
- **Neutral Background**: Background for neutral changes

#### BestPair Colors (Dynamic Gradient)
- **Red Background**: Pairs with strength 0-10
- **Orange Background**: Pairs with strength 10-20
- **Yellow Background**: Pairs with strength 20-30
- **Light Green Background**: Pairs with strength 30-70
- **Dark Green Background**: Pairs with strength 70+

### 📏 Text Size
**Available options**: Tiny, Small, Normal, Large, Huge

---

## 📋 Asset Categories

### 💱 Major Currencies
**Activation**: `Show Major Currencies`

Monitors the 8 main Forex currencies:
- **EUR** - Euro
- **GBP** - British Pound
- **JPY** - Japanese Yen
- **CHF** - Swiss Franc
- **CAD** - Canadian Dollar
- **AUD** - Australian Dollar
- **NZD** - New Zealand Dollar
- **USD** - US Dollar

### 🥇 Metals
**Activation**: `Show Metals`

Includes the main precious metals:
- **GOLD** - Gold
- **SILVER** - Silver
- **PLATINUM** - Platinum
- **PALLADIUM** - Palladium
- **COPPER** - Copper

### 🌾 Commodities
**Activation**: `Show Commodities`

Covers the most important commodities:
- **WTI** - West Texas Intermediate Oil
- **NATURAL GAS** - Natural Gas
- **COCOA** - Cocoa
- **CORN** - Corn
- **SUGAR** - Sugar
- **COFFEE** - Coffee
- **SOYBEANS** - Soybeans

### 🎯 BestPair Detection
**Activation**: `Show BestPair`

The BestPair system automatically analyzes all currencies and identifies the best trading opportunities by combining:
- Currencies with positive changes (bullish trend)
- Currencies with negative changes (bearish trend)
- Calculation of "Strength Score" for each pair

**How it works**:
1. Identifies currencies with opposite trends
2. Calculates relative strength of each pair
3. Applies dynamic colors based on strength
4. Shows only the most promising pairs

---

## 📊 Data Interpretation

### Table Columns
1. **ASSET**: Asset name (currency, metal, commodity)
2. **NET POSITIONS**: Current net positions of non-commercial traders
3. **# CHANGE**: Numerical change from previous week
4. **% CHANGE**: Percentage change (determines row color)

### 🎨 Color System
- **Green**: Positive changes (bullish sentiment)
- **Red**: Negative changes (bearish sentiment)
- **Neutral**: Minimal or no changes

### 📈 BestPair Strength Score
The color system for BestPair indicates pair strength:
- **🔴 Red (0-10)**: Low strength
- **🟠 Orange (10-20)**: Moderate strength
- **🟡 Yellow (20-30)**: Good strength
- **🟢 Light Green (30-70)**: High strength
- **🟢 Dark Green (70+)**: Excellent strength

---

## 💡 Usage Tips

### ⏰ **IMPORTANT: Weekly Timeframe Only**
**This indicator works ONLY on Weekly (1W) timeframe. Make sure your chart is set to Weekly before using the dashboard.**

### 📊 Weekly Analysis
- COT data is updated every Tuesday (previous Friday's data)
- Focus on percentage changes rather than absolute values
- Changes above 10% are generally significant

### 🎯 Trading with BestPair
- Dark green pairs (70+) offer the best opportunities
- Combine COT analysis with technical analysis
- Consider opposite sentiment as potential reversal

### ⚡ Performance Optimization
- Disable unnecessary categories to reduce loading times
- Use "Futures Only" if you don't need options data
- Position the table where it doesn't interfere with your charts

---

## ❓ Troubleshooting

### Common Issues
1. **Table not appearing**: Check that you're on Weekly timeframe
2. **Data not updating**: COT data is released with a 3-day delay
3. **Performance issues**: Disable unused asset categories
4. **Colors not showing**: Verify color settings in Style tab

### Technical Requirements
- **Timeframe**: Weekly (1W) only
- **Market**: Works on any symbol (data is independent)
- **Account**: Works with any TradingView account type

---

## 🤝 Support the Project

If this indicator has been helpful for your trading analysis, consider supporting its development:

**☕ Buy Me a Coffee**: buymeacoffee.com/cotweeklysummary

Your support helps maintain and improve this tool for the entire trading community!

---

**Happy Trading! 📈**

---

ayer

Notas de prensa

# COT Weekly Summary Dashboard - User Manual

## 📊 Overview

**COT Weekly Summary** is an advanced Pine Script dashboard that provides comprehensive real-time analysis of CFTC COT (Commitment of Traders) data. This professional tool allows you to monitor net positions of non-commercial traders across currencies, precious metals, and commodities, all within a single elegant and customizable interface.

### 🎯 Key Features
- **Multi-Asset Analysis**: Major currencies, precious metals, and commodities
- **Real-Time Data**: Automatic weekly updates from CFTC reports
- **BestPair Detector**: Automatically identifies the best trading opportunities
- **Customizable Interface**: Colors, sizes, and positioning fully configurable
- **Dynamic Watermark**: Motivational phrases that change with each new bar

---

## ⚙️ Configuration and Customization

### 📍 Table Position
**Setting**: `Table Position`
- **Top Left**: Top left corner
- **Top Center**: Top center
- **Top Right**: Top right corner
- **Middle Left**: Middle left
- **Middle Center**: Screen center
- **Middle Right**: Middle right
- **Bottom Left**: Bottom left corner
- **Bottom Center**: Bottom center
- **Bottom Right**: Bottom right corner

### 📊 Data Type
**Setting**: `Data Type`
- **Futures Only**: Futures contracts only
- **Futures and Options**: Futures + options (more complete data)

### 🎨 Color Customization

#### Base Table Colors
- **Header Background**: Header background color
- **Header Text**: Header text color
- **Frame Color**: Table frame color
- **Border Color**: Cell border color

#### Dynamic Row Colors
- **Positive Background**: Background for positive changes
- **Positive Text**: Text for positive changes
- **Negative Background**: Background for negative changes
- **Negative Text**: Text for negative changes
- **Neutral Background**: Background for neutral changes

#### BestPair Colors (Dynamic Gradient)
- **Red Background**: Pairs with strength 0-10
- **Orange Background**: Pairs with strength 10-20
- **Yellow Background**: Pairs with strength 20-30
- **Light Green Background**: Pairs with strength 30-70
- **Dark Green Background**: Pairs with strength 70+

### 📏 Text Size
**Available options**: Tiny, Small, Normal, Large, Huge

---

## 📋 Asset Categories

### 💱 Major Currencies
**Activation**: `Show Major Currencies`

Monitors the 8 main Forex currencies:
- **EUR** - Euro
- **GBP** - British Pound
- **JPY** - Japanese Yen
- **CHF** - Swiss Franc
- **CAD** - Canadian Dollar
- **AUD** - Australian Dollar
- **NZD** - New Zealand Dollar
- **USD** - US Dollar

### 🥇 Metals
**Activation**: `Show Metals`

Includes the main precious metals:
- **GOLD** - Gold
- **SILVER** - Silver
- **PLATINUM** - Platinum
- **PALLADIUM** - Palladium
- **COPPER** - Copper

### 🌾 Commodities
**Activation**: `Show Commodities`

Covers the most important commodities:
- **WTI** - West Texas Intermediate Oil
- **NATURAL GAS** - Natural Gas
- **COCOA** - Cocoa
- **CORN** - Corn
- **SUGAR** - Sugar
- **COFFEE** - Coffee
- **SOYBEANS** - Soybeans

### 🎯 BestPair Detection
**Activation**: `Show BestPair`

The BestPair system automatically analyzes all currencies and identifies the best trading opportunities by combining:
- Currencies with positive changes (bullish trend)
- Currencies with negative changes (bearish trend)
- Calculation of "Strength Score" for each pair

**How it works**:
1. Identifies currencies with opposite trends
2. Calculates relative strength of each pair
3. Applies dynamic colors based on strength
4. Shows only the most promising pairs

---

## 📊 Data Interpretation

### Table Columns
1. **ASSET**: Asset name (currency, metal, commodity)
2. **NET POSITIONS**: Current net positions of non-commercial traders
3. **# CHANGE**: Numerical change from previous week
4. **% CHANGE**: Percentage change (determines row color)

### 🎨 Color System
- **Green**: Positive changes (bullish sentiment)
- **Red**: Negative changes (bearish sentiment)
- **Neutral**: Minimal or no changes

### 📈 BestPair Strength Score
The color system for BestPair indicates pair strength:
- **🔴 Red (0-10)**: Low strength
- **🟠 Orange (10-20)**: Moderate strength
- **🟡 Yellow (20-30)**: Good strength
- **🟢 Light Green (30-70)**: High strength
- **🟢 Dark Green (70+)**: Excellent strength

---

## 💡 Usage Tips

### ⏰ **IMPORTANT: Weekly Timeframe Only**
**This indicator works ONLY on Weekly (1W) timeframe. Make sure your chart is set to Weekly before using the dashboard.**

### 📊 Weekly Analysis
- COT data is updated every Tuesday (previous Friday's data)
- Focus on percentage changes rather than absolute values
- Changes above 10% are generally significant

### 🎯 Trading with BestPair
- Dark green pairs (70+) offer the best opportunities
- Combine COT analysis with technical analysis
- Consider opposite sentiment as potential reversal

### ⚡ Performance Optimization
- Disable unnecessary categories to reduce loading times
- Use "Futures Only" if you don't need options data
- Position the table where it doesn't interfere with your charts

---

## ❓ Troubleshooting

### Common Issues
1. **Table not appearing**: Check that you're on Weekly timeframe
2. **Data not updating**: COT data is released with a 3-day delay
3. **Performance issues**: Disable unused asset categories
4. **Colors not showing**: Verify color settings in Style tab

### Technical Requirements
- **Timeframe**: Weekly (1W) only
- **Market**: Works on any symbol (data is independent)
- **Account**: Works with any TradingView account type

---

## 🤝 Support the Project

If this indicator has been helpful for your trading analysis, consider supporting its development:

**☕ Buy Me a Coffee**: buymeacoffee.com/cotweeklysummary

Your support helps maintain and improve this tool for the entire trading community!

---

**Happy Trading! 📈*

---