Home » Strategy Functions » Understanding strategy.grossloss Function in Pine Script

Understanding strategy.grossloss Function in Pine Script

Photo of author
Published on

In Pine Script, the strategy.grossloss function is an integral part of creating and analyzing trading strategies. This function returns the total gross loss of all losing trades in the strategy’s currency. Understanding how to use strategy.grossloss effectively can provide you with deeper insights into the performance of your trading strategies. This tutorial will guide you through the basics of strategy.grossloss, including how to incorporate it into your scripts, and how to interpret its output to improve your trading strategy.

Utilizing strategy.grossloss

To begin, strategy.grossloss is a built-in function in Pine Script that helps quantify the losses of a trading strategy, making it a crucial metric for risk management and strategy evaluation. Here’s a simple example to demonstrate its use:

Example Code:

strategy("My Strategy", overlay=true)

// Example strategy conditions
longCondition = ta.crossover(ta.sma(close, 14), ta.sma(close, 28))
if (longCondition)
    strategy.entry("Long", strategy.long)

shortCondition = ta.crossunder(ta.sma(close, 14), ta.sma(close, 28))
if (shortCondition)
    strategy.entry("Short", strategy.short)

// Implementing strategy.grossloss
grossLoss = strategy.grossloss
plot(grossLoss, title="Total Gross Loss", color=color.red)

Walkthrough of code

  • //@version=5: This line specifies that the script uses Pine Script language version 5.
  • strategy("My Strategy", overlay=true): This command initializes a trading strategy named “My Strategy” that will be overlaid on the chart. The overlay=true argument ensures that the strategy’s plots and signals are displayed on the main price chart.
  • longCondition = ta.crossover(ta.sma(close, 14), ta.sma(close, 28)): This line defines a condition for entering a long position. It checks for a crossover between two simple moving averages (SMAs): one with a period of 14 and the other with a period of 28. A crossover occurs when the shorter SMA (14) crosses above the longer SMA (28).
  • if (longCondition) strategy.entry("Long", strategy.long): If the longCondition is met, a long entry order is placed using strategy.entry. The first argument “Long” is a user-defined identifier for this order.
  • shortCondition = ta.crossunder(ta.sma(close, 14), ta.sma(close, 28)): Similarly, this line defines a condition for entering a short position, based on a crossunder event where the shorter SMA (14) crosses below the longer SMA (28).
  • if (shortCondition) strategy.entry("Short", strategy.short): If the shortCondition is true, a short entry order is executed.
  • grossLoss = strategy.grossloss: This line assigns the total gross loss from all losing trades within the strategy to the variable grossLoss. The strategy.grossloss function automatically calculates this value based on the performance of the strategy.
  • plot(grossLoss, title="Total Gross Loss", color=color.red): The total gross loss is then plotted on the chart. This visualization helps you to see how the gross loss of the strategy evolves over time. The plot will be colored red for easy identification.

Key Features and Takeaways

  • Function Usability: strategy.grossloss can be called without any parameters. It automatically calculates the total gross loss based on the strategy’s executed trades.
  • Syntax: The syntax is straightforward, with the function simply being called as strategy.grossloss.
  • Application: This function is invaluable for risk assessment and strategy optimization. By understanding your strategy’s gross loss, you can make informed decisions about potential adjustments to minimize losses and improve overall performance.


  • strategy.grossloss provides the total gross loss of all losing trades, offering a critical metric for evaluating the performance of a trading strategy.
  • It requires no parameters and is easy to implement within any strategy script in Pine Script version 5.
  • Analyzing the output of strategy.grossloss can help you refine your trading strategies, enhancing profitability and reducing unnecessary risk.

Leave a Comment