---
title: "vBase"
description: "With our vBase integration, you can create a verifiable record of when data was created, by whom, and how it has changed."
canonical: https://www.quantconnect.com/docs/v2/writing-algorithms/live-trading/signal-exports/vbase
markdown: https://www.quantconnect.com/docs/v2/writing-algorithms/live-trading/signal-exports/vbase.md
language: python
source: https://github.com/QuantConnect/Documentation/tree/master/03%20Writing%20Algorithms/40%20Live%20Trading/99%20Signal%20Exports/04%20vBase
modified: 2026-10-22
index: https://www.quantconnect.com/llms.txt
---

# vBase

[Documentation](https://www.quantconnect.com/docs/v2.md) > [Writing Algorithms](https://www.quantconnect.com/docs/v2/writing-algorithms.md) > [Live Trading](https://www.quantconnect.com/docs/v2/writing-algorithms/live-trading.md) > [Signal Exports](https://www.quantconnect.com/docs/v2/writing-algorithms/live-trading/signal-exports.md) > vBase

> Code examples are shown in Python. Append `?lang=csharp` to this URL for the C# version of this page.

## Introduction

[validityBase](https://qnt.co/vbase) enables you to create a globally credible, independently verifiable audit trail for trading track records, models and signals. This ensures anyone viewing your results can confirm that your results are point-in-time, complete, free from cherry-picking and fully out-of-sample.

QuantConnect users can use validityBase to publish live, verifiable, indices of their trading strategies and signals - increasing their credibility with allocators, clients and potential employers, and significantly increasing their commercial value. Integration is simple. With a single function call from your QuantConnect code, you can automatically build an immutable blockchain-backed audit trail for your signals and models.

## Add Providers

To export signals to vBase from your algorithm, during [initialization](https://www.quantconnect.com/docs/v2/writing-algorithms/initialization.md), add a vBase signal export provider.

```python
self.signal_export.add_signal_export_provider(VBaseSignalExport(api_key, collection_name, store_stamped_file=True, idempotent=False))
```

The `VBaseSignalExport` constructor accepts the following arguments:

### Argument: `api_key`

Your vBase API key. You can find it in your profile Account Settings tab.

Data Type: `str`

### Argument: `collection_name`

The name of the vBase [collection](https://docs.vbase.com/web-tools/how-to-use-vbase-stamper#why-use-collections) to which the signals will be sent. You can create and manage collections in the vBase app Collections tab. Think of a collection like a strategy or dataset name.

Data Type: `str`

### Argument: `store_stamped_file`

Whether to store a stamped copy of the signal in vBase. **Important** if this is marked "no", then you will be responsible for maintaining an exact copy of your stamped data. Losing or accidentally modifying stamped outputs will prevent your work from being verifiable.

Data Type: `bool` | Default Value: `True`

### Argument: `idempotent`

Whether to make the signal export idempotent. If true, sending the same signal multiple times will only create one record in vBase.

Data Type: `bool` | Default Value: `False`

You can add multiple signal export providers to a single algorithm.

## Asset Classes

Our vBase integration supports all asset classes.

## Send Portfolio Targets

To send targets, pass a list of `PortfolioTarget` objects to the `set_target_portfolio` method. The method returns a boolean value indicating whether the targets were successfully sent to vBase.

**What gets stamped?** The provider builds a `sym,wt` (symbol-weight) CSV directly from your portfolio targets. Each target's `quantity` value is treated as the portfolio weight (percentage of holdings), so you should pass percentage-based targets (e.g., 0.25 for 25% of the portfolio). Default behavior can be customized by overriding the `BuildCsv` method of the `VBaseSignalExport` class.

```python
success = self.signal_export.set_target_portfolio(targets)
```

## Examples

**Demonstration Algorithms**

- [VBaseSignalExportDemonstrationAlgorithm.py](https://github.com/QuantConnect/Lean/blob/master/Algorithm.Python/VBaseSignalExportDemonstrationAlgorithm.py) (Python)