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

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

# MomentumOscillator (interface)

The calculation of the Momentum Oscillator indicator.

Environments: Desktop supported · CLI supported · Cloud supported.

## Definition

```csharp
public interface MomentumOscillator
```

## Remarks

Momentum measures the rate of price change over time and provides a leading indicator of changes in trend. It gives signals before price action happens. The momentum oscillator is unbounded i.e. there is no maximum or minimum value. It is calculated as the closing price now minus the closing price n periods ago.

## Examples

C#:

```csharp
private MomentumOscillator _momentum;
protected override void Initialize()
{
    _momentum = Indicators.MomentumOscillator(Bars.ClosePrices, 14);
}

public override void Calculate(int index)
{
    double momentum = _momentum.Result[index];
}
```

Python:

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

from cAlgo.API import *

class Test():
    def initialize(self):
        self.momentum = api.Indicators.MomentumOscillator(api.Bars.ClosePrices, 14)

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

C#:

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

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

        private MomentumOscillator _momentumOscillator;

        private SimpleMovingAverage _simpleMovingAverage;

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

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

            _momentumOscillator = Indicators.MomentumOscillator(Bars.ClosePrices, 14);

            _simpleMovingAverage = Indicators.SimpleMovingAverage(_momentumOscillator.Result, 14);
        }

        protected override void OnBar()
        {
            if (_momentumOscillator.Result.Last(1) > _simpleMovingAverage.Result.Last(1))
            {
                ClosePositions(TradeType.Sell);

                if (_momentumOscillator.Result.Last(2) <= _simpleMovingAverage.Result.Last(2))
                {
                    ExecuteMarketOrder(TradeType.Buy, SymbolName, _volumeInUnits, Label, StopLossInPips, TakeProfitInPips);
                }
            }
            else if (_momentumOscillator.Result.Last(1) < _simpleMovingAverage.Result.Last(1))
            {
                ClosePositions(TradeType.Buy);

                if (_momentumOscillator.Result.Last(2) >= _simpleMovingAverage.Result.Last(2))
                {
                    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 MomentumOscillatorSample():
    def on_start(self):
        self.volumeInUnits = api.Symbol.QuantityToVolumeInUnits(api.VolumeInLots)
        self.momentumOscillator = api.Indicators.MomentumOscillator(api.Bars.ClosePrices, 14)
        self.simpleMovingAverage = api.Indicators.SimpleMovingAverage(self.momentumOscillator.Result, 14)

    def on_bar_closed(self):
        if self.momentumOscillator.Result.Last(0) > self.simpleMovingAverage.Result.Last(0):
            self.close_positions(TradeType.Sell)
            if self.momentumOscillator.Result.Last(1) <= self.simpleMovingAverage.Result.Last(1):
                api.ExecuteMarketOrder(TradeType.Buy, api.SymbolName, self.volumeInUnits, api.Label, api.StopLossInPips, api.TakeProfitInPips)
        elif self.momentumOscillator.Result.Last(0) < self.simpleMovingAverage.Result.Last(0):
            self.close_positions(TradeType.Buy)
            if self.momentumOscillator.Result.Last(1) >= self.simpleMovingAverage.Result.Last(1):
                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;}` — Gets the resulting series of the Momentum Oscillator indicator calculation. [details](https://help.ctrader.com/ctrader-algo/references/Indicators/MomentumOscillator/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)