Skip to content

README.md

Latest commit

 

History

History
233 lines (177 loc) · 5.94 KB

README.md

File metadata and controls

233 lines (177 loc) · 5.94 KB

TradingView Pine Script Strategies

This folder contains Pine Script strategies, indicators, and overlays developed using the TradingViewMCPServer Pine Script development tools.

📁 Folder Structure

examples/pine-scripts/
├── indicators/      # Technical indicators
├── strategies/      # Trading strategies
├── overlays/        # Chart overlays (S/R, patterns, etc.)
├── examples/        # Example scripts for learning
└── README.md        # This file

🎯 Purpose

Store and organize your Pine Script code developed with Claude Code and the TradingViewMCPServer Pine Script tools.

📝 Usage

1. Creating New Scripts

Ask Claude to create strategies:

"Create a MACD crossover strategy with proper risk management"
"Build an RSI divergence indicator"
"Make a support/resistance overlay using pivot points"

2. Validating Scripts

All scripts can be validated using the Pine Script MCP tools:

# Claude will automatically use:
validate_pine_script(code)

3. Testing Scripts

Test scripts in the sandbox before deploying:

test_pine_script(code, symbol="AAPL", timeframe="1h")

🔧 Pine Script Tools Available

Via TradingViewMCPServer MCP tools:

  • ✅ Real-time validation
  • ✅ Version detection (v1-v6)
  • ✅ Version conversion
  • ✅ Function documentation
  • ✅ Error explanations
  • ✅ Code testing sandbox
  • ✅ Intelligent autocomplete
  • ✅ Code templates

📚 Resources

🎓 Best Practices

File Naming

  • Use descriptive names: macd_crossover_strategy.pine
  • Include version: rsi_divergence_v6.pine
  • Use categories: strategies/, indicators/, overlays/

Code Organization

//@version=6
// ============================================================================
// STRATEGY/INDICATOR NAME
// Description: Clear description of what it does
// Author: Your Name
// Version: 1.0
// Created: 2025-01-XX
// ============================================================================

strategy("Strategy Name", overlay=true, initial_capital=10000)

// ===== INPUTS =====
length = input.int(14, "Period", minval=1)

// ===== INDICATORS =====
myIndicator = ta.sma(close, length)

// ===== STRATEGY LOGIC =====
longCondition = ta.crossover(close, myIndicator)

if longCondition
    strategy.entry("Long", strategy.long)

// ===== VISUALIZATION =====
plot(myIndicator, color=color.blue)

Documentation

  • Add clear comments
  • Document inputs
  • Explain strategy logic
  • Include usage notes

📊 Strategy Template

//@version=6
strategy("Template Strategy",
         overlay=true,
         initial_capital=10000,
         default_qty_type=strategy.percent_of_equity,
         default_qty_value=10,
         commission_type=strategy.commission.percent,
         commission_value=0.1)

// ===== INPUTS =====
fastLength = input.int(12, "Fast MA Length", minval=1)
slowLength = input.int(26, "Slow MA Length", minval=1)
riskPercent = input.float(2.0, "Risk %", minval=0.1, maxval=10)

// ===== INDICATORS =====
fastMa = ta.ema(close, fastLength)
slowMa = ta.ema(close, slowLength)

// ===== ENTRY CONDITIONS =====
longCondition = ta.crossover(fastMa, slowMa)
shortCondition = ta.crossunder(fastMa, slowMa)

// ===== RISK MANAGEMENT =====
atrValue = ta.atr(14)
stopLoss = 2 * atrValue
takeProfit = 3 * atrValue

// ===== EXECUTE TRADES =====
if longCondition
    strategy.entry("Long", strategy.long)
    strategy.exit("Long Exit", "Long", stop=close - stopLoss, limit=close + takeProfit)

if shortCondition
    strategy.entry("Short", strategy.short)
    strategy.exit("Short Exit", "Short", stop=close + stopLoss, limit=close - takeProfit)

// ===== VISUALIZATION =====
plot(fastMa, "Fast MA", color=color.blue, linewidth=2)
plot(slowMa, "Slow MA", color=color.red, linewidth=2)
plotshape(longCondition, "Long Signal", shape.triangleup, location.belowbar, color.green, size=size.small)
plotshape(shortCondition, "Short Signal", shape.triangledown, location.abovebar, color.red, size=size.small)

🚀 Quick Start

  1. Create a new strategy:

    Ask Claude: "Create a new trend-following strategy using EMA crossovers"

  2. Validate the code:

    Claude will automatically validate using validate_pine_script()

  3. Test it:

    Ask Claude: "Test this strategy on SPY 1h timeframe"

  4. Save it:

    Save to appropriate folder: strategies/, indicators/, or overlays/

  5. Deploy to TradingView:

    • Copy the validated code
    • Open TradingView Pine Editor
    • Paste and apply to chart

📈 Example Strategies to Try

Beginner

  • Moving Average Crossover
  • RSI Overbought/Oversold
  • Bollinger Band Breakout

Intermediate

  • MACD + RSI Combo
  • Support/Resistance Breakout
  • Fibonacci Retracement Levels

Advanced

  • Multi-timeframe Analysis
  • Custom Indicators with ML
  • Portfolio Rebalancing

⚠️ Important Notes

Backtesting

  • Use TradingView's Strategy Tester for full backtesting
  • The MCP sandbox provides syntax validation, not historical backtesting
  • Always backtest on multiple symbols and timeframes

Risk Management

  • Always include stop losses
  • Use proper position sizing
  • Test with paper trading first
  • Never risk more than 1-2% per trade

Live Trading

  • Thoroughly backtest all strategies
  • Start with small position sizes
  • Monitor performance regularly
  • Adjust parameters as needed

🤝 Contributing

Feel free to:

  • Share your successful strategies
  • Improve existing code
  • Add new examples
  • Report issues

📞 Support

  • Pine Script Issues: Use explain_pine_error() tool
  • Strategy Questions: Ask Claude
  • Documentation: See PINE_SCRIPT.md

Happy Trading! 📊🚀

Remember: Past performance does not guarantee future results. Trade responsibly.