Skip to main content

简体中文 / English | Features · Installation · Examples · Links

Trading research at scale.

VectorBT is a Python toolkit for trading research. Explore market data, build indicators and signals, and compare thousands of ideas across assets and timeframes. NumPy arrays, Numba acceleration, and an optional Rust engine let you run large experiments in a few lines of Python.


Move from exploring price patterns to evaluating strategies in one workflow. Inspect trades, fees, drawdowns, and portfolio performance, then explore the results with interactive charts. Built for traders, researchers, and AI agents, VectorBT brings data analysis, strategy simulation, and visualization together in a composable Python API.

VectorBT is the open-source community edition of VectorBT PRO. PRO extends the library with parallelization, additional data integrations, portfolio optimization, pattern recognition, event projections, limit orders, leverage, and over 100 other features, with new features added weekly.

See VectorBT vs PRO or browse PRO feature examples.

Features

Fast, vectorized backtesting

Research strategies at scale with pandas, NumPy, and Numba.

Backtesting examples →

Optional Rust engine

Use precompiled kernels for supported operations without JIT compilation.

Rust engine →

Pandas-native API

Work with custom accessors and high-performance operations directly on pandas objects.

Pandas integration →

Flexible broadcasting

Analyze multiple assets and sweep large parameter grids with flexible array broadcasting.

Broadcasting API →

Rich indicator ecosystem

Build custom indicators and use integrations for TA-Lib, Pandas TA, and more.

Indicator features →

Portfolio backtesting

Analyze trades, drawdowns, and performance, with QuantStats integration.

Portfolio analysis →

Signal tooling

Generate, rank, map, and analyze the distribution of trading signals.

Signal features →

Built-in data access

Fetch market data, preprocess it, and generate synthetic time series.

Data features →

Robustness testing

Run walk-forward optimization and generate labels for machine learning workflows.

Robustness testing →

Interactive visualization

Explore results with Plotly charts, Jupyter widgets, and browser dashboards.

Plotting features →

Automation tools

Schedule data updates and send Telegram notifications.

Scheduling and notifications →

Composable Python API

Combine building blocks for rapid experimentation and AI agent-driven workflows.

Python workflows →

Installation

pip install -U vectorbt

To install the optional Rust engine:

pip install -U "vectorbt[rust]"

To install all optional integrations (TA-Lib, Pandas TA, etc.):

pip install -U "vectorbt[full]"

To install all optional integrations together with the Rust engine:

pip install -U "vectorbt[full,rust]"

Examples

Invest $100 in Bitcoin since 2014

import vectorbt as vbt

data = vbt.YFData.download("BTC-USD")
price = data.get("Close")

pf = vbt.Portfolio.from_holding(price, init_cash=100)
print(pf.total_profit())

Output:

19501.10906763755

Trade a dual-SMA crossover strategy

fast_ma = vbt.MA.run(price, 10)
slow_ma = vbt.MA.run(price, 50)
entries = fast_ma.ma_crossed_above(slow_ma)
exits = fast_ma.ma_crossed_below(slow_ma)

pf = vbt.Portfolio.from_signals(price, entries, exits, init_cash=100)
print(pf.total_profit())

Output:

34417.80960086067

Generate 1,000 random strategies

import numpy as np

symbols = ["BTC-USD", "ETH-USD"]
data = vbt.YFData.download(symbols, missing_index="drop")
price = data.get("Close")

n = np.random.randint(10, 101, size=1000).tolist()
pf = vbt.Portfolio.from_random_signals(price, n=n, init_cash=100, seed=42)

mean_expectancy = pf.trades.expectancy().groupby(["randnx_n", "symbol"]).mean()
fig = mean_expectancy.unstack().vbt.scatterplot(xaxis_title="randnx_n", yaxis_title="mean_expectancy")
fig.show()

Output:

Random-strategy mean trade expectancy

Test 10,000 dual-SMA window combinations

symbols = ["BTC-USD", "ETH-USD", "XRP-USD"]
data = vbt.YFData.download(symbols, missing_index="drop")
price = data.get("Close")

windows = np.arange(2, 101)
fast_ma, slow_ma = vbt.MA.run_combs(price, window=windows, r=2, short_names=["fast", "slow"])
entries = fast_ma.ma_crossed_above(slow_ma)
exits = fast_ma.ma_crossed_below(slow_ma)

pf = vbt.Portfolio.from_signals(price, entries, exits, size=np.inf, fees=0.001, freq="1D")

fig = pf.total_return().vbt.heatmap(
    x_level="fast_window",
    y_level="slow_window",
    slider_level="symbol",
    symmetric=True,
    trace_kwargs=dict(colorbar=dict(title="Total return", tickformat="%")),
)
fig.show()

Output:

Dual-SMA window combinations across assets

Inspect any strategy configuration

print(pf[(10, 20, "ETH-USD")].stats())

Output:

Start                          2017-11-09 00:00:00+00:00
End                            2026-01-03 00:00:00+00:00
Period                                2978 days 00:00:00
Start Value                                        100.0
End Value                                    1604.093789
Total Return [%]                             1504.093789
Benchmark Return [%]                          866.094127
Max Gross Exposure [%]                             100.0
Total Fees Paid                               204.226289
Max Drawdown [%]                               70.734951
Max Drawdown Duration                 1095 days 00:00:00
Total Trades                                          81
Total Closed Trades                                   80
Total Open Trades                                      1
Open Trade PnL                                -14.232533
Win Rate [%]                                       41.25
Best Trade [%]                                120.511071
Worst Trade [%]                               -27.772271
Avg Winning Trade [%]                          27.265519
Avg Losing Trade [%]                           -9.022864
Avg Winning Trade Duration    32 days 20:21:49.090909091
Avg Losing Trade Duration      8 days 16:51:03.829787234
Profit Factor                                   1.275515
Expectancy                                     18.979079
Sharpe Ratio                                    0.861945
Calmar Ratio                                    0.572758
Omega Ratio                                      1.20277
Sortino Ratio                                   1.301377
Name: (10, 20, ETH-USD), dtype: object

Plot any strategy configuration

pf[(10, 20, "ETH-USD")].plot().show()

Output:

Inspecting trades, zooming, and toggling the portfolio benchmark

Animate Bollinger Bands across multiple symbols

VectorBT goes beyond backtesting, with tools for financial data analysis and visualization:

symbols = ["BTC-USD", "ETH-USD", "XRP-USD"]
data = vbt.YFData.download(symbols, period="6mo", missing_index="drop")
price = data.get("Close")
bbands = vbt.BBANDS.run(price)


def plot(index, bbands):
    bbands = bbands.loc[index]
    fig = vbt.make_subplots(
        rows=2, cols=1, shared_xaxes=True, vertical_spacing=0.15, subplot_titles=("%B", "Bandwidth")
    )
    fig.update_layout(showlegend=False, width=750, height=400)
    bbands.percent_b.vbt.ts_heatmap(
        trace_kwargs=dict(
            zmin=0,
            zmid=0.5,
            zmax=1,
            colorscale="Spectral",
            colorbar=dict(y=(fig.layout.yaxis.domain[0] + fig.layout.yaxis.domain[1]) / 2, len=0.5),
        ),
        add_trace_kwargs=dict(row=1, col=1),
        fig=fig,
    )
    bbands.bandwidth.vbt.ts_heatmap(
        trace_kwargs=dict(colorbar=dict(y=(fig.layout.yaxis2.domain[0] + fig.layout.yaxis2.domain[1]) / 2, len=0.5)),
        add_trace_kwargs=dict(row=2, col=1),
        fig=fig,
    )
    return fig


vbt.save_animation(
    "bbands.gif", bbands.wrapper.index, plot, bbands, delta=90, step=3, fps=3, writer_kwargs=dict(loop=0)
)

Output:

100%|██████████| 31/31 [00:21<00:00,  1.21it/s]
Rolling Bollinger Bands percent-B and bandwidth heatmaps

Visit the website for more examples, documentation, and guides.

Example apps

Candlestick Patterns

Explore candlestick patterns interactively and backtest their signals with VectorBT.

Exploring candlestick patterns, inspecting trades, and comparing strategy statistics in the app

License

This work is fair-code distributed under the Apache 2.0 with Commons Clause license.

The source code is publicly available, and everyone (individuals and organizations) may use it for free. However, you may not sell products or services that are primarily this software.

If you have questions or want to request a license exception, please contact the author.

Installing optional dependencies may be subject to a more restrictive license.

Contributors

Thanks to everyone who has contributed to VectorBT!

VectorBT contributors

Star History

Star History Chart

Disclaimer

This software is for educational purposes only. Do not risk money you cannot afford to lose.

Use the software at your own risk. The authors and affiliates assume no responsibility for your trading results.

Metadata

Release files for vectorbt 1.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vectorbt 1.2.1
File Size Uploaded Provenance Actions
vectorbt-1.2.1.tar.gz 595.3 kB With provenance Details for vectorbt-1.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for vectorbt 1.2.1
File Interpreter ABI Platform Actions
vectorbt-1.2.1-py3-none-any.whl Python 3 none any Details for vectorbt-1.2.1-py3-none-any.whl

Total release size: 1.1 MB

Release files / vectorbt-1.2.1.tar.gz

Download URL vectorbt-1.2.1.tar.gz
Size 595.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a02625f960202f1771f6172e0b92b244d93679fbd68f181c2a1bee5906e2e920
BLAKE2b-256 checksum
How to use checksums
82de4bc151d32026ac2b2173f6849dd00d6efe8aa5a9656c9cfa6a3ea8a12675
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Release files / vectorbt-1.2.1-py3-none-any.whl

Download URL vectorbt-1.2.1-py3-none-any.whl
Size 466.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
352ee4d9f0777508c681110f7df3a748f4229d9a18dae31ed0621ace57b12fe6
BLAKE2b-256 checksum
How to use checksums
d858efef289cab672a984d7d0b84cefbf354c492b332ca11a67d8580cd59729d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Security for vectorbt 1.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for vectorbt-1.2.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.2.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page