This release is a pre-release and may not be stable for production use.
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
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
Metadata
2 maintainers
Release files for Qubx 4.0.0.dev1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| qubx-4.0.0.dev1.tar.gz | 1.1 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| qubx-4.0.0.dev1-cp313-cp313-win_amd64.whl | CPython 3.13 | CPython 3.13 | Windows x86-64 | Details |
| qubx-4.0.0.dev1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64 | Details |
| qubx-4.0.0.dev1-cp313-cp313-macosx_11_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 11.0+ ARM64 | Details |
| qubx-4.0.0.dev1-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| qubx-4.0.0.dev1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| qubx-4.0.0.dev1-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details |
Total release size: 14.6 MB
Release files / qubx-4.0.0.dev1.tar.gz
| Download URL | qubx-4.0.0.dev1.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a9cd5996b09e2c33b824e5221823be0262a90d97ebbbd24da8252a9a096fa4c8
|
|
BLAKE2b-256 checksum How to use checksums |
a045222139cd7c8efc12b7d15d79ec2c22ac229d4f634946f68d89bfd3bf1dea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 3, 2026.
Transparency logRelease files / qubx-4.0.0.dev1-cp313-cp313-win_amd64.whl
| Download URL | qubx-4.0.0.dev1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d89bbcf617a556f8855df0b97dbbb54540177ff639c2a5646c57abf761b99af8
|
|
BLAKE2b-256 checksum How to use checksums |
56a212ea6cfb79edb13b98eae83d7640984b16754b8c5ccc92c8ad9128d943cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 3, 2026.
Transparency logRelease files / qubx-4.0.0.dev1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qubx-4.0.0.dev1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
350a411540623ff6148b8e3add5ad88bfdde62ba12aea9fb6ac8b42f1d9a6abb
|
|
BLAKE2b-256 checksum How to use checksums |
040f66ae52f321f361755719566abc976e73ac2421143d5e01ee60b07ddbdbab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 3, 2026.
Transparency logRelease files / qubx-4.0.0.dev1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | qubx-4.0.0.dev1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
8642c656a9cfe73fc975217674a9539ca064e9e715b2a95c28d1775e81f96f0b
|
|
BLAKE2b-256 checksum How to use checksums |
5fec85779f9392a37428cfabad645549d89dd5091234d9bd64c1af5600d38cc8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 3, 2026.
Transparency logRelease files / qubx-4.0.0.dev1-cp312-cp312-win_amd64.whl
| Download URL | qubx-4.0.0.dev1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0a61538a6192b7736c5444b5f94a7cfcb25c7ebbebec48fbf959cdb7cc64cde8
|
|
BLAKE2b-256 checksum How to use checksums |
632e10581a53ded9ba246ff6f31bb4b9753a17554dd30d95b8d826f705969d1a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 3, 2026.
Transparency logRelease files / qubx-4.0.0.dev1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | qubx-4.0.0.dev1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
33881d904f16a18c1da02b6a0844c96c0b5da19a80c62850fdc6ee0a0f1a0166
|
|
BLAKE2b-256 checksum How to use checksums |
7ef5f2a352a767961e9eae763e911c14829c245a9a48e5d34c74ca71ca5fd969
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 3, 2026.
Transparency logRelease files / qubx-4.0.0.dev1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | qubx-4.0.0.dev1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
897ddaf3eb3f33b59180084a34d269c103fc0507c5f04b5de9369b07f8ca1d67
|
|
BLAKE2b-256 checksum How to use checksums |
41fe81715d91a79c2c9024502024ae4c66a38ee52d0c0334efea5bd18b4bce02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 3, 2026.
Transparency log
