Qubx - Quantitative Trading Framework

⠀⠀⡰⡖⠒⠒⢒⢦⠀⠀
⠀⢠⠃⠈⢆⣀⣎⣀⣱⡀  QUBX | Quantitative Backtesting Environment
⠀⢳⠒⠒⡞⠚⡄⠀⡰⠁         (c) 2026, by xLydian
⠀⠀⠱⣜⣀⣀⣈⣦⠃⠀⠀⠀

Qubx is a next-generation quantitative trading framework designed for efficient backtesting and live trading. Built with Python, it offers a robust environment for developing, testing, and deploying trading strategies.

Qubx is under active development. We are continuously improving the framework and will update our documentation in the coming days/weeks. This will include comprehensive end-to-end examples for running simulations and live trading.

Supported Data Types

Qubx supports a wide range of market data:

OHLC (candlestick data)
L2 Orderbook
Liquidations
Funding rates
And more...

Quick Start

1. Install Dependencies

just install

2. Create a Strategy

# Create a simple strategy template (default)
uv run qubx init

# Or specify a name and symbols
uv run qubx init --name my_strategy --symbols BTCUSDT,ETHUSDT

3. Run Your Strategy

cd my_strategy

# Run in paper trading mode
uv run qubx run config.yml --paper

# Or run in Jupyter mode for interactive development
./jpaper.sh

Available Templates

# List available strategy templates
uv run qubx init --list-templates

# Create strategy with full project structure and MACD example
uv run qubx init --template project --name my_project

Strategy Development Workflow

Initialize: uv run qubx init - Create strategy from template
Develop: Edit strategy.py to implement your trading logic
Test: uv run qubx run config.yml --paper - Run in paper mode
Debug: ./jpaper.sh - Use Jupyter for interactive development
Deploy: Configure for live trading when ready

Features

High-performance backtesting engine
Live trading support
Advanced data analysis tools
Integration with multiple exchanges
Comprehensive strategy development toolkit
Detailed performance analytics

Documentation

For detailed documentation, visit Qubx Documentation

Prerequisites

To build and run Qubx, you need:

Python 3.11 or higher
C/C++ compiler for Cython compilation
uv for dependency management

Installation

Using pip

pip install qubx

Development Setup

Clone the repository
Install dependencies using uv:

uv sync --all-extras

Example trading strategies can be found in the examples/ directory.

CLI Usage

Qubx comes with a command-line interface that provides several useful commands:

qubx --help  # Show all available commands

Available commands:

qubx init - Create a new strategy from template
qubx run - Start a strategy with given configuration
qubx simulate - Run strategy simulation
qubx ls - List all strategies in a directory
qubx release - Package a strategy into a zip file
qubx deploy - Deploy a strategy from a zip file
qubx browse - Browse backtest results using interactive TUI

Development

Running Tests

Run the test suite:

just test

Additional Commands

Check code style: just style-check
Build package: just build
Run verbose tests: just test-verbose

In Production

Qubx powers the AllegedAlpha public pool on Lighter. Public pools allow users to deposit funds from their blockchain wallet into a smart contract. The pool operator manages the trading strategy, and a performance fee is taken from profits (X: @allegedalpha).

About xLydian

Qubx is developed by xLydian.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qubx-1.12.0.tar.gz (932.8 kB view details)

Uploaded Jul 21, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

qubx-1.12.0-cp313-cp313-win_amd64.whl (2.0 MB view details)

Uploaded Jul 21, 2026 CPython 3.13Windows x86-64

qubx-1.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.2 MB view details)

Uploaded Jul 21, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

qubx-1.12.0-cp313-cp313-macosx_11_0_arm64.whl (1.9 MB view details)

Uploaded Jul 21, 2026 CPython 3.13macOS 11.0+ ARM64

qubx-1.12.0-cp312-cp312-win_amd64.whl (2.1 MB view details)

Uploaded Jul 21, 2026 CPython 3.12Windows x86-64

qubx-1.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (2.2 MB view details)

Uploaded Jul 21, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

qubx-1.12.0-cp312-cp312-macosx_11_0_arm64.whl (2.0 MB view details)

Uploaded Jul 21, 2026 CPython 3.12macOS 11.0+ ARM64

File details

Details for the file qubx-1.12.0.tar.gz.

File metadata

Download URL: qubx-1.12.0.tar.gz
Upload date: Jul 21, 2026
Size: 932.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for qubx-1.12.0.tar.gz
Algorithm	Hash digest
SHA256	`cdc5f6e66e481989906a7e9bd6993aeadeb9b0bf8b275df88dbab2322a74633a`
MD5	`149eb10139115aa4605686428dd47232`
BLAKE2b-256	`bd8b3b472da275b94437cf4a0142a4072365f08e66bfee3981362f59dc8d84f3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-1.12.0.tar.gz:

Publisher: release.yml on xLydianSoftware/Qubx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qubx-1.12.0.tar.gz
- Subject digest: cdc5f6e66e481989906a7e9bd6993aeadeb9b0bf8b275df88dbab2322a74633a
- Sigstore transparency entry: 2212099617
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: xLydianSoftware/Qubx@f34dbd836f59b95cc55c220948a491e975bbec3d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/xLydianSoftware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f34dbd836f59b95cc55c220948a491e975bbec3d
- Trigger Event: push

File details

Details for the file qubx-1.12.0-cp313-cp313-win_amd64.whl.

File metadata

Download URL: qubx-1.12.0-cp313-cp313-win_amd64.whl
Upload date: Jul 21, 2026
Size: 2.0 MB
Tags: CPython 3.13, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for qubx-1.12.0-cp313-cp313-win_amd64.whl
Algorithm	Hash digest
SHA256	`7920f7f86ba3b3eb6b969e6be8b902bbb523d1f19b8c27fbc05559cfc4d96ee8`
MD5	`26fee24bac75f5441d96bbf80c78222d`
BLAKE2b-256	`7606c98ea7389bb9dba94051be4ed32bc089cfac67dfaca538e2dd7a32cfebd6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-1.12.0-cp313-cp313-win_amd64.whl:

Publisher: release.yml on xLydianSoftware/Qubx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qubx-1.12.0-cp313-cp313-win_amd64.whl
- Subject digest: 7920f7f86ba3b3eb6b969e6be8b902bbb523d1f19b8c27fbc05559cfc4d96ee8
- Sigstore transparency entry: 2212099792
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: xLydianSoftware/Qubx@f34dbd836f59b95cc55c220948a491e975bbec3d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/xLydianSoftware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f34dbd836f59b95cc55c220948a491e975bbec3d
- Trigger Event: push

File details

Details for the file qubx-1.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: qubx-1.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Upload date: Jul 21, 2026
Size: 2.2 MB
Tags: CPython 3.13, manylinux: glibc 2.17+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for qubx-1.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`25e57fe94ae4752aba2a9c55d274e7f6a066e08f757c680d4c5b2326e5e59a18`
MD5	`f3749189a4c0fecd9790beece031e3aa`
BLAKE2b-256	`4b8d2f1d3bc3107e3ac343d8fc0a6ae8264ab70dd70b11113dbb1eb9250d68ce`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-1.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: release.yml on xLydianSoftware/Qubx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qubx-1.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
- Subject digest: 25e57fe94ae4752aba2a9c55d274e7f6a066e08f757c680d4c5b2326e5e59a18
- Sigstore transparency entry: 2212099704
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: xLydianSoftware/Qubx@f34dbd836f59b95cc55c220948a491e975bbec3d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/xLydianSoftware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f34dbd836f59b95cc55c220948a491e975bbec3d
- Trigger Event: push

File details

Details for the file qubx-1.12.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

Download URL: qubx-1.12.0-cp313-cp313-macosx_11_0_arm64.whl
Upload date: Jul 21, 2026
Size: 1.9 MB
Tags: CPython 3.13, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for qubx-1.12.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`25cb94a2466d2aa3a4ac448c9c48d9e09fcb4c9078655f94300c46e0a06b79c7`
MD5	`55ab82e282b867a6ad0cc6d0e2d57164`
BLAKE2b-256	`dda286426a3531862af8ae9ca195915e1971e943995faccc432b25fe80810142`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-1.12.0-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: release.yml on xLydianSoftware/Qubx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qubx-1.12.0-cp313-cp313-macosx_11_0_arm64.whl
- Subject digest: 25cb94a2466d2aa3a4ac448c9c48d9e09fcb4c9078655f94300c46e0a06b79c7
- Sigstore transparency entry: 2212099771
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: xLydianSoftware/Qubx@f34dbd836f59b95cc55c220948a491e975bbec3d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/xLydianSoftware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f34dbd836f59b95cc55c220948a491e975bbec3d
- Trigger Event: push

File details

Details for the file qubx-1.12.0-cp312-cp312-win_amd64.whl.

File metadata

Download URL: qubx-1.12.0-cp312-cp312-win_amd64.whl
Upload date: Jul 21, 2026
Size: 2.1 MB
Tags: CPython 3.12, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for qubx-1.12.0-cp312-cp312-win_amd64.whl
Algorithm	Hash digest
SHA256	`c9371d89c2f6bd9813255119477f908eaba75032748b13f135a1d179a89f0084`
MD5	`5c31912a2bb1a18cfc46a3b423d897c4`
BLAKE2b-256	`7edcec2cd50c4c2dcaa9ca8754da47a1c321732f9df738f25e7a75618f462642`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-1.12.0-cp312-cp312-win_amd64.whl:

Publisher: release.yml on xLydianSoftware/Qubx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qubx-1.12.0-cp312-cp312-win_amd64.whl
- Subject digest: c9371d89c2f6bd9813255119477f908eaba75032748b13f135a1d179a89f0084
- Sigstore transparency entry: 2212099679
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: xLydianSoftware/Qubx@f34dbd836f59b95cc55c220948a491e975bbec3d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/xLydianSoftware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f34dbd836f59b95cc55c220948a491e975bbec3d
- Trigger Event: push

File details

Details for the file qubx-1.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: qubx-1.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Upload date: Jul 21, 2026
Size: 2.2 MB
Tags: CPython 3.12, manylinux: glibc 2.17+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for qubx-1.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`7afeed22735beb52036646ee41cbfc9b481dd17f92dfc483e0a893f6514c893f`
MD5	`8a30fea64b8d75f22a8734b0841d15d1`
BLAKE2b-256	`3353eee911c12708676b45a33db701739eb36ad46b3cd77de2dce8a512e5fe84`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-1.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: release.yml on xLydianSoftware/Qubx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qubx-1.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
- Subject digest: 7afeed22735beb52036646ee41cbfc9b481dd17f92dfc483e0a893f6514c893f
- Sigstore transparency entry: 2212099649
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: xLydianSoftware/Qubx@f34dbd836f59b95cc55c220948a491e975bbec3d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/xLydianSoftware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f34dbd836f59b95cc55c220948a491e975bbec3d
- Trigger Event: push

File details

Details for the file qubx-1.12.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

Download URL: qubx-1.12.0-cp312-cp312-macosx_11_0_arm64.whl
Upload date: Jul 21, 2026
Size: 2.0 MB
Tags: CPython 3.12, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for qubx-1.12.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`09e57a04612db798b2bec08ed1aba2447a56e95c2340f8b27aee04f8fb8415e4`
MD5	`6b63f44dae9b2554167c947ca4567080`
BLAKE2b-256	`5450d0589d8e4c94f471b559e35b854824bd9ef0995500090afacf9c4e851e1c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-1.12.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release.yml on xLydianSoftware/Qubx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qubx-1.12.0-cp312-cp312-macosx_11_0_arm64.whl
- Subject digest: 09e57a04612db798b2bec08ed1aba2447a56e95c2340f8b27aee04f8fb8415e4
- Sigstore transparency entry: 2212099742
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: xLydianSoftware/Qubx@f34dbd836f59b95cc55c220948a491e975bbec3d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/xLydianSoftware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f34dbd836f59b95cc55c220948a491e975bbec3d
- Trigger Event: push