---
id: "T:cAlgo.API.Indicators.VolumeOscillator"
kind: "interface"
namespace: "cAlgo.API.Indicators"
url: "https://help.ctrader.com/ctrader-algo/references/Indicators/VolumeOscillator/"
---

> Documentation index for agents: https://help.ctrader.com/ctrader-algo/llms.txt · machine index: https://help.ctrader.com/ctrader-algo/api.json

# VolumeOscillator (interface)

The Volume Oscillator identifies trends in volume using a two moving average system. A strong trend is signaled when it is positive. Falling volume indicates trend weakness.

Environments: Desktop supported · CLI supported · Cloud supported.

## Definition

```csharp
public interface VolumeOscillator
```

## Examples

C#:

```csharp
private VolumeOscillator _volumeOscillator;

protected override void Initialize()
{
   _volumeOscillator = Indicators.VolumeOscillator(ShortTerm, LongTerm);
}
public override void Calculate(int index)
{
   // Display Result of Indicator
   Result[index] = _volumeOscillator.Result[index];
}
```

Python:

```python
import clr
clr.AddReference("cAlgo.API")

from cAlgo.API import *

class Test():
    def initialize(self):
        self.volumeOscillator = api.Indicators.VolumeOscillator(api.ShortTerm, api.LongTerm)

    def calculate(self, index):
        api.Result[index] = self.volumeOscillator.Result[index]
```

config.json:

```json
{
  "Parameters": [
    {
      "Name": "ShortTerm",
      "DisplayName": "Short Term",
      "Type": "Integer",
      "DefaultValue": 9
    },
    {
      "Name": "LongTerm",
      "DisplayName": "Long Term",
      "Type": "Integer",
      "DefaultValue": 21
    }
  ],
  "LineOutputs": [
    {
      "Name": "Result",
      "DisplayName": "Main"
    }
  ]
}
```

C#:

```csharp
using cAlgo.API;
using cAlgo.API.Indicators;

namespace cAlgo.Robots
{
    // This sample cBot shows how to use the Volume Oscillator indicator
    public partial class VolumeOscillatorSample : Robot
    {
        private double _volumeInUnits;

        private VolumeOscillator _volumeOscillator;

        private SimpleMovingAverage _priceSimpleMovingAverage;
        private SimpleMovingAverage _volumeOscillatorSimpleMovingAverage;

        public Position[] BotPositions
        {
            get
            {
                return Positions.FindAll(Label);
            }
        }

        protected override void OnStart()
        {
            _volumeInUnits = Symbol.QuantityToVolumeInUnits(VolumeInLots);

            _volumeOscillator = Indicators.VolumeOscillator(9, 21);

            _volumeOscillatorSimpleMovingAverage = Indicators.SimpleMovingAverage(_volumeOscillator.Result, 14);

            _priceSimpleMovingAverage = Indicators.SimpleMovingAverage(Bars.ClosePrices, 14);
        }

        protected override void OnBar()
        {
            if (_volumeOscillator.Result.Last(1) < _volumeOscillatorSimpleMovingAverage.Result.Last(1)) return;

            if (Bars.ClosePrices.Last(1) > _priceSimpleMovingAverage.Result.Last(1) && Bars.ClosePrices.Last(2) <= _priceSimpleMovingAverage.Result.Last(2))
            {
                ClosePositions(TradeType.Sell);

                ExecuteMarketOrder(TradeType.Buy, SymbolName, _volumeInUnits, Label, StopLossInPips, TakeProfitInPips);
            }
            else if (Bars.ClosePrices.Last(1) < _priceSimpleMovingAverage.Result.Last(1) && Bars.ClosePrices.Last(2) >= _priceSimpleMovingAverage.Result.Last(2))
            {
                ClosePositions(TradeType.Buy);

                ExecuteMarketOrder(TradeType.Sell, SymbolName, _volumeInUnits, Label, StopLossInPips, TakeProfitInPips);
            }
        }

        private void ClosePositions(TradeType tradeType)
        {
            foreach (var position in BotPositions)
            {
                if (position.TradeType != tradeType) continue;

                ClosePosition(position);
            }
        }
    }
}
```

Python:

```python
import clr

clr.AddReference("cAlgo.API")

# Import cAlgo API types
from cAlgo.API import *

# Import trading wrapper functions
from robot_wrapper import *

class VolumeOscillatorSample():
    def on_start(self):
        self.volumeInUnits = api.Symbol.QuantityToVolumeInUnits(api.VolumeInLots)
        self.volumeOscillator = api.Indicators.VolumeOscillator(9, 21)
        self.volumeOscillatorSimpleMovingAverage = api.Indicators.SimpleMovingAverage(self.volumeOscillator.Result, 14)
        self.priceSimpleMovingAverage = api.Indicators.SimpleMovingAverage(api.Bars.ClosePrices, 14)

    def on_bar_closed(self):
        if self.volumeOscillator.Result.Last(0) < self.volumeOscillatorSimpleMovingAverage.Result.Last(0):
            return

        if api.Bars.ClosePrices.Last(0) > self.priceSimpleMovingAverage.Result.Last(0) and api.Bars.ClosePrices.Last(1) <= self.priceSimpleMovingAverage.Result.Last(1):
            self.close_positions(TradeType.Sell)
            api.ExecuteMarketOrder(TradeType.Buy, api.SymbolName, self.volumeInUnits, api.Label, api.StopLossInPips, api.TakeProfitInPips)
        elif api.Bars.ClosePrices.Last(0) < self.priceSimpleMovingAverage.Result.Last(0) and api.Bars.ClosePrices.Last(1) >= self.priceSimpleMovingAverage.Result.Last(1):
            self.close_positions(TradeType.Buy)
            api.ExecuteMarketOrder(TradeType.Sell, api.SymbolName, self.volumeInUnits, api.Label, api.StopLossInPips, api.TakeProfitInPips)

    def get_bot_positions(self):
        return api.Positions.FindAll(api.Label)

    def close_positions(self, tradeType):
        for position in self.get_bot_positions():
            if position.TradeType != tradeType:
                continue
            api.ClosePosition(position)
```

config.json:

```json
{
  "AccessRights": "None",
  "TimeZone": "UTC",
  "Parameters": [
    {
      "Name": "VolumeInLots",
      "DisplayName": "Volume (Lots)",
      "Type": "Double",
      "DefaultValue": 0.01
    },
    {
      "Name": "StopLossInPips",
      "DisplayName": "Stop Loss (Pips)",
      "Type": "Double",
      "DefaultValue": 10
    },
    {
      "Name": "TakeProfitInPips",
      "DisplayName": "Take Profit (Pips)",
      "Type": "Double",
      "DefaultValue": 10
    },
    {
      "Name": "Label",
      "Type": "String",
      "DefaultValue": "Sample"
    }
  ]
}
```

## Properties

- `IndicatorDataSeries Result {get; set;}` — Gets or sets the time series of the Volume Oscillator indicator. [details](https://help.ctrader.com/ctrader-algo/references/Indicators/VolumeOscillator/Result/index.md)

## Inherited members

- `ChartIndicator AddToChart()` (from StandardIndicator) [details](https://help.ctrader.com/ctrader-algo/references/General/StandardIndicator/AddToChart/index.md)
- `Symbol Symbol {get;}` (from StandardIndicator) [details](https://help.ctrader.com/ctrader-algo/references/General/StandardIndicator/Symbol/index.md)
- `TimeFrame TimeFrame {get;}` (from StandardIndicator) [details](https://help.ctrader.com/ctrader-algo/references/General/StandardIndicator/TimeFrame/index.md)
- `Bars Bars {get;}` (from StandardIndicator) [details](https://help.ctrader.com/ctrader-algo/references/General/StandardIndicator/Bars/index.md)