---
id: "E:cAlgo.API.CustomTimeFrame.BarsUnloaded"
kind: "event"
type: "T:cAlgo.API.CustomTimeFrame"
url: "https://help.ctrader.com/ctrader-algo/references/Plugin/TimeFrame/Custom/CustomTimeFrame/BarsUnloaded/"
---

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

# CustomTimeFrame.BarsUnloaded

Member of [CustomTimeFrame](https://help.ctrader.com/ctrader-algo/references/Plugin/TimeFrame/Custom/CustomTimeFrame/index.md).

## BarsUnloaded

Occurs when a custom bars is unloaded and not being used anymore.

Environments: Desktop supported · CLI not supported · Cloud not supported.

- CLI: Available to plugins only, and plugins cannot run in the CLI.
- Cloud: Available to plugins only, and plugins cannot run in the cloud.

C#:

```csharp
event Action<CustomTimeFrameBarsUnloadedEventArgs> BarsUnloaded;
```

Python:

```python
customTimeFrame.BarsUnloaded += handler  # handler(obj: CustomTimeFrameBarsUnloadedEventArgs)
```

### Returns

`Action<CustomTimeFrameBarsUnloadedEventArgs>` — 

Available since cAlgo.API 5.3.

### Examples

C#:

```csharp
protected override void OnStart()
{
    var customTimeFrame = TimeFrameManager.Custom.Add("My Custom TF");
    customTimeFrame.BarsUnloaded += OnBarsUnloaded;
}

private void OnBarsUnloaded(CustomTimeFrameBarsUnloadedEventArgs args)
{
    var isRemoved = args.CustomTimeFrame.RemoveBars(args.CustomBars.Symbol);
    Print("Unloaded bars of {0} removed: {1}", args.CustomBars.Symbol.Name, isRemoved);
}
```

Python:

```python
def on_start(self):
    customTimeFrame = api.TimeFrameManager.Custom.Add("My Custom TF")
    customTimeFrame.BarsUnloaded += self.on_bars_unloaded

def on_bars_unloaded(self, args):
    isRemoved = args.CustomTimeFrame.RemoveBars(args.CustomBars.Symbol)
    api.Print(f"Unloaded bars of {args.CustomBars.Symbol.Name} removed: {isRemoved}")
```