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.pyto 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 templatequbx run- Start a strategy with given configurationqubx simulate- Run strategy simulationqubx ls- List all strategies in a directoryqubx release- Package a strategy into a zip filequbx deploy- Deploy a strategy from a zip filequbx 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.
- Website: xlydian.com
- X: @xLydian_xyz
- Contact: info@xlydian.com
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.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file qubx-3.2.1.tar.gz.
File metadata
- Download URL: qubx-3.2.1.tar.gz
- Upload date:
- Size: 980.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ad47530deb23f8cc353a257b77a7c4a6c9273b2350a9ccfae092dddc943d63a0
|
|
| MD5 |
2b9e7af97b105b1decf9a58334e0d3a5
|
|
| BLAKE2b-256 |
0b632f26815f242d35a0684a6313833bb3b2b1dc7b6b981ac38b36d68ea5d6b2
|
Provenance
The following attestation bundles were made for qubx-3.2.1.tar.gz:
Publisher:
release.yml on xLydianSoftware/Qubx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qubx-3.2.1.tar.gz -
Subject digest:
ad47530deb23f8cc353a257b77a7c4a6c9273b2350a9ccfae092dddc943d63a0 - Sigstore transparency entry: 2437851791
- Sigstore integration time:
-
Permalink:
xLydianSoftware/Qubx@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/xLydianSoftware
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file qubx-3.2.1-cp313-cp313-win_amd64.whl.
File metadata
- Download URL: qubx-3.2.1-cp313-cp313-win_amd64.whl
- Upload date:
- Size: 2.1 MB
- Tags: CPython 3.13, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c701860a3fb2b66659bb39ad056da85e9cd1bb3db0c88c3e89ea2a5e2a03a7c
|
|
| MD5 |
fdd2c3fb8f4b1ba575484d2052996d6d
|
|
| BLAKE2b-256 |
ef1893b8c8cfdc08ff80bfd07aec99e715a32434549bcd97e97f468fb55a9ebe
|
Provenance
The following attestation bundles were made for qubx-3.2.1-cp313-cp313-win_amd64.whl:
Publisher:
release.yml on xLydianSoftware/Qubx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qubx-3.2.1-cp313-cp313-win_amd64.whl -
Subject digest:
3c701860a3fb2b66659bb39ad056da85e9cd1bb3db0c88c3e89ea2a5e2a03a7c - Sigstore transparency entry: 2437851902
- Sigstore integration time:
-
Permalink:
xLydianSoftware/Qubx@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/xLydianSoftware
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file qubx-3.2.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: qubx-3.2.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 2.3 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/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e2a963f52287124055fcc4a87b0cbf05d7ac208788358926e3a93441dc48cfd
|
|
| MD5 |
6997a90d56a07c6e860732a3c688790e
|
|
| BLAKE2b-256 |
9fdd1e55fbcd606cebc378b272016df71b137a1cde08fde0e3b496ad43e7679d
|
Provenance
The following attestation bundles were made for qubx-3.2.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:
Publisher:
release.yml on xLydianSoftware/Qubx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qubx-3.2.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl -
Subject digest:
8e2a963f52287124055fcc4a87b0cbf05d7ac208788358926e3a93441dc48cfd - Sigstore transparency entry: 2437852011
- Sigstore integration time:
-
Permalink:
xLydianSoftware/Qubx@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/xLydianSoftware
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file qubx-3.2.1-cp313-cp313-macosx_11_0_arm64.whl.
File metadata
- Download URL: qubx-3.2.1-cp313-cp313-macosx_11_0_arm64.whl
- Upload date:
- Size: 2.0 MB
- Tags: CPython 3.13, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f734223a3879425664a7d709eab6580f11dfa63d00b19652fc94127729aa66f
|
|
| MD5 |
8a85adaec9a033abbeb8e113d4dc64a9
|
|
| BLAKE2b-256 |
3fe9fe4a9581955841c17c2c1e78c97f1f7403f0d74e5a0e00405fb496f05f1d
|
Provenance
The following attestation bundles were made for qubx-3.2.1-cp313-cp313-macosx_11_0_arm64.whl:
Publisher:
release.yml on xLydianSoftware/Qubx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qubx-3.2.1-cp313-cp313-macosx_11_0_arm64.whl -
Subject digest:
7f734223a3879425664a7d709eab6580f11dfa63d00b19652fc94127729aa66f - Sigstore transparency entry: 2437852176
- Sigstore integration time:
-
Permalink:
xLydianSoftware/Qubx@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/xLydianSoftware
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file qubx-3.2.1-cp312-cp312-win_amd64.whl.
File metadata
- Download URL: qubx-3.2.1-cp312-cp312-win_amd64.whl
- Upload date:
- Size: 2.1 MB
- Tags: CPython 3.12, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2665739f53a0f129613f76f3bd40736dc16a664c9365f653bdfdef804cfc193e
|
|
| MD5 |
4a69e67c0d0ced751bec15bfb81a26a9
|
|
| BLAKE2b-256 |
38c8447b0cbddb5ae7995e548b16c02f6cb8e3a4d6af780becd8f0c31fe8b0a7
|
Provenance
The following attestation bundles were made for qubx-3.2.1-cp312-cp312-win_amd64.whl:
Publisher:
release.yml on xLydianSoftware/Qubx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qubx-3.2.1-cp312-cp312-win_amd64.whl -
Subject digest:
2665739f53a0f129613f76f3bd40736dc16a664c9365f653bdfdef804cfc193e - Sigstore transparency entry: 2437851855
- Sigstore integration time:
-
Permalink:
xLydianSoftware/Qubx@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/xLydianSoftware
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file qubx-3.2.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.
File metadata
- Download URL: qubx-3.2.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
- Upload date:
- Size: 2.3 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/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9af0fcf11f3234358bda32fd570a017a49fccef191d328ac3a852938fed00a04
|
|
| MD5 |
faf04832533979d7f6bb264194790e68
|
|
| BLAKE2b-256 |
931a663e722fb4bd58d68252aa6d9a9af2ea09468c8d6271c78f54a0e3f1732f
|
Provenance
The following attestation bundles were made for qubx-3.2.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:
Publisher:
release.yml on xLydianSoftware/Qubx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qubx-3.2.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl -
Subject digest:
9af0fcf11f3234358bda32fd570a017a49fccef191d328ac3a852938fed00a04 - Sigstore transparency entry: 2437852089
- Sigstore integration time:
-
Permalink:
xLydianSoftware/Qubx@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/xLydianSoftware
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file qubx-3.2.1-cp312-cp312-macosx_11_0_arm64.whl.
File metadata
- Download URL: qubx-3.2.1-cp312-cp312-macosx_11_0_arm64.whl
- Upload date:
- Size: 2.0 MB
- Tags: CPython 3.12, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2587e02596aa0c6424ad886da4ba9ef7179367842c1bc3a37410e3434e8f3519
|
|
| MD5 |
e96ad47a7f63b3e7d92b2d148f11439b
|
|
| BLAKE2b-256 |
59bb759037376123d335c12077a4c4dde0c76f631e726a0c5fcee40964836194
|
Provenance
The following attestation bundles were made for qubx-3.2.1-cp312-cp312-macosx_11_0_arm64.whl:
Publisher:
release.yml on xLydianSoftware/Qubx
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qubx-3.2.1-cp312-cp312-macosx_11_0_arm64.whl -
Subject digest:
2587e02596aa0c6424ad886da4ba9ef7179367842c1bc3a37410e3434e8f3519 - Sigstore transparency entry: 2437851940
- Sigstore integration time:
-
Permalink:
xLydianSoftware/Qubx@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/xLydianSoftware
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@306b885498be99a7f9f02be59bd047e1bbd9ffc8 -
Trigger Event:
push
-
Statement type:
