Skip to main content

Qubx - Quantitative Trading Framework

Project description

Qubx - Quantitative Trading Framework

CI

⠀⠀⡰⡖⠒⠒⢒⢦⠀⠀
⠀⢠⠃⠈⢆⣀⣎⣀⣱⡀  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

poetry install

2. Create a Strategy

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

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

3. Run Your Strategy

cd my_strategy

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

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

Available Templates

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

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

Strategy Development Workflow

  1. Initialize: poetry run qubx init - Create strategy from template
  2. Develop: Edit strategy.py to implement your trading logic
  3. Test: poetry run qubx run config.yml --paper - Run in paper mode
  4. Debug: ./jpaper.sh - Use Jupyter for interactive development
  5. 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.10 or higher
  • C/C++ compiler for Cython compilation
  • Poetry for dependency management

Installation

Using pip

pip install qubx

Development Setup

  1. Clone the repository
  2. Install dependencies using Poetry:
poetry install

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.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

qubx-0.7.39.tar.gz (783.4 kB view details)

Uploaded Source

Built Distribution

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

qubx-0.7.39-cp312-cp312-manylinux_2_39_x86_64.whl (1.9 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.39+ x86-64

File details

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

File metadata

  • Download URL: qubx-0.7.39.tar.gz
  • Upload date:
  • Size: 783.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for qubx-0.7.39.tar.gz
Algorithm Hash digest
SHA256 e898ab3eebf87d4a8862e01679d62725b8ba091a9b0ec70c7c5e298c76cd6d08
MD5 52adabf56c56c80b3c9a9dabeab881bf
BLAKE2b-256 6c30e944318686a6229a13f7ed68c75f15dbd56cb9a8fd06613c91add94aa165

See more details on using hashes here.

Provenance

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

Publisher: ci.yml on xLydianSoftware/Qubx

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

File details

Details for the file qubx-0.7.39-cp312-cp312-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for qubx-0.7.39-cp312-cp312-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 009b9bdd7c6fbdf5fa8ad235366cee3b142552a60ffa015fa29f002478aa4fea
MD5 f905185d6f13985a02f775bcd1d05884
BLAKE2b-256 620016386f190fa90c124bc7680e6e41f98456c15da6afb03f57462660378867

See more details on using hashes here.

Provenance

The following attestation bundles were made for qubx-0.7.39-cp312-cp312-manylinux_2_39_x86_64.whl:

Publisher: ci.yml on xLydianSoftware/Qubx

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page