QUANTAXIS

https://github.com/yutiansut/quantaxis
Admin
QUANTAXIS is a quantitative financial framework that integrates a high-performance Rust core (QARS2)...
Tokens:167,207
Snippets:1,500
Trust Score:9
License:MIT
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install MongoDB on macOS

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Install and start the MongoDB service using Homebrew.

```bash
# 使用Homebrew安装
brew tap mongodb/brew
brew install mongodb-community@6.0

# 启动MongoDB
brew services start mongodb-community@6.0

# 验证安装
mongosh --version
```

--------------------------------

### Install ClickHouse on Linux

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Install and start the ClickHouse server and client for large-scale data analysis.

```bash
# Ubuntu/Debian
sudo apt-get install -y apt-transport-https ca-certificates dirmngr
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update
sudo apt-get install -y clickhouse-server clickhouse-client

# 启动服务
sudo systemctl start clickhouse-server
sudo systemctl enable clickhouse-server
```

--------------------------------

### Install QUANTAXIS dependencies

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/advanced/resource-manager.md

Install the necessary drivers for MongoDB, RabbitMQ, ClickHouse, and Redis.

```bash
# 基础依赖 (MongoDB)
pip install pymongo motor

# RabbitMQ
pip install pika

# ClickHouse
pip install clickhouse-driver

# Redis
pip install redis

# 完整安装
pip install quantaxis[full]
```

--------------------------------

### Install MongoDB on Linux

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Install and start the MongoDB service on Ubuntu or Debian systems.

```bash
# 导入MongoDB公钥
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -

# 添加MongoDB源
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

# 安装MongoDB
sudo apt-get update
sudo apt-get install -y mongodb-org

# 启动MongoDB
sudo systemctl start mongod
sudo systemctl enable mongod

# 验证安装
mongo --version
```

--------------------------------

### Perform full installation

Source: https://github.com/yutiansut/quantaxis/blob/master/README.md

Install all components including Rust core, data swap, and Polars support.

```bash
# 安装所有组件
pip install -e .[full]

# 包含:
# - QARS2 Rust核心
# - QADataSwap跨语言通信
# - Polars高性能DataFrame
# - 所有可选依赖
```

--------------------------------

### Install QARS3

Source: https://github.com/yutiansut/quantaxis/blob/master/UPGRADE_PLAN.md

Install the Rust-based core engine for QUANTAXIS.

```bash
pip install qars3  # 或从源码编译
```

--------------------------------

### Install QADataSwap via PyPI

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Install the QADataSwap component using pip.

```bash
pip install qadataswap
```

--------------------------------

### Run QUANTAXIS examples and benchmarks

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/quickstart.md

Use these shell commands to explore available examples and execute performance tests.

```bash
# 查看所有示例
ls examples/

# 运行QARSBridge示例
python examples/qarsbridge_example.py

# 运行QADataBridge示例
python examples/qadatabridge_example.py

# 运行性能测试
python scripts/benchmark_databridge.py
```

--------------------------------

### Run the project

Source: https://github.com/yutiansut/quantaxis/blob/master/qapro-rs/readme.md

Executes the project or the API example using the provided configuration file.

```bash
cargo run --release example.toml
```

```bash
cargo run --example api --release example.toml [开启的服务在example.toml中配置 默认5000端口]
```

--------------------------------

### Install with Cython Acceleration

Source: https://github.com/yutiansut/quantaxis/wiki/ABOUT-QUANTAXIS

Optional steps to build with Cython for performance optimization before installing in editable mode.

```bash
python setup_cython.py build_ext --inplace

再继续 pip install -e .
```

--------------------------------

### Install for Local Development

Source: https://github.com/yutiansut/quantaxis/wiki/ABOUT-QUANTAXIS

Clone the repository and install in editable mode for local development.

```bash
git clone https://github.com/quantaxis/quantaxis --depth 1

cd quantaxis

pip install -e .
```

--------------------------------

### Install Docker on Ubuntu

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/docker.md

Use the provided script to install Docker on Linux systems.

```bash
wget https://raw.githubusercontent.com/QUANTAXIS/QUANTAXIS/master/config/install_docker.sh
sudo bash install_docker.sh
```

--------------------------------

### Setup Pre-commit Hooks

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/development/testing.md

Configures pre-commit hooks for linting and formatting, along with installation and execution commands.

```bash
# .pre-commit-config.yaml
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.4.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
  
  - repo: https://github.com/psf/black
    rev: 23.3.0
    hooks:
      - id: black
  
  - repo: https://github.com/PyCQA/pylint
    rev: v2.17.4
    hooks:
      - id: pylint

# 安装
pip install pre-commit
pre-commit install

# 运行所有文件
pre-commit run --all-files
```

--------------------------------

### Install and Use Rust Performance Components

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/migration/v2.0-to-v2.1.md

Install the optional Rust-accelerated components and initialize the high-performance account class.

```bash
# 安装Rust组件 (可选)
pip install quantaxis[rust]
```

```python
# 使用Rust加速的账户
from QUANTAXIS import QARSAccount

account = QARSAccount("account_id", init_cash=100000.0)
# 性能提升100x!
```

--------------------------------

### Install New Version

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Install the latest version including Rust support.

```bash
# 安装完整版
pip install quantaxis[rust]
```

--------------------------------

### Run and Connect to QAEXCHANGE-RS

Source: https://github.com/yutiansut/quantaxis/blob/master/UPGRADE_PLAN.md

Start the simulated exchange server and connect using Python clients.

```bash
cd /home/quantaxis/qaexchange-rs
cargo run --release --bin qaexchange-server
```

```python
from QUANTAXIS.QAExchange import QAExchangeClient, QAExchangeWebSocket

# HTTP客户端
client = QAExchangeClient("http://localhost:8080")
client.login("user1", "password")
order = client.send_order("000001", 100, 10.5, "BUY")

# WebSocket实时行情
ws = QAExchangeWebSocket("ws://localhost:8080/ws")
ws.on_tick = lambda data: print(f"收到tick: {data}")
ws.connect(token=client.token)
ws.subscribe_market(["000001", "000002"])
```

--------------------------------

### Install QUANTAXIS via Git

Source: https://github.com/yutiansut/quantaxis/blob/master/README.md

Clone the repository and install the package in editable mode.

```bash
# 克隆仓库
git clone https://github.com/QUANTAXIS/QUANTAXIS.git
cd QUANTAXIS

# 安装依赖
pip install -e .
```

--------------------------------

### Deploy Core Services

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/overview.md

Initializes the core QUANTAXIS services by cloning the repository and starting the containers.

```bash
# 克隆仓库
git clone https://github.com/QUANTAXIS/QUANTAXIS.git
cd QUANTAXIS/docker/qa-service-v2.1

# 复制环境变量配置
cp .env.example .env
# 编辑.env修改密码(生产环境必须!)

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f
```

--------------------------------

### Initialize QA_SERVICE on Windows/Mac

Source: https://github.com/yutiansut/quantaxis/blob/master/docker/readme.md

Commands to create Docker volumes and start the service on non-Linux platforms.

```bash
docker volume create --name=qamg
docker volume create --name=qacode
```

```bash
cd D:/qa  (此处就是你心爱的文件夹的目录)

docker-compose up
```

```bash
cd D:/qa  (此处就是你心爱的文件夹的目录)

docker-compose pull (这里的意思是更新docker文件)

docker-compose up
```

--------------------------------

### Install QADataSwap

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/advanced/data-bridge.md

Install the necessary dependencies to resolve ImportError issues.

```bash
# 方式1: 安装QUANTAXIS with Rust
pip install quantaxis[rust]

# 方式2: 单独安装QADataSwap
cd /home/quantaxis/qadataswap
pip install -e .
```

--------------------------------

### Install via Pip

Source: https://github.com/yutiansut/quantaxis/wiki/ABOUT-QUANTAXIS

Standard command to install or upgrade the QUANTAXIS package.

```bash
pip install quantaxis -U
```

--------------------------------

### Run QA_SERVICE on Mac/Windows

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/docker.md

Navigate to the directory containing the docker-compose.yaml file and start the services.

```bash
cd D:/qa  (此处就是你心爱的文件夹的目录)

docker-compose up
```

--------------------------------

### Deploy Full Services

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/overview.md

Starts all available services including ClickHouse and market data collection.

```bash
# 启动所有服务(包括ClickHouse和行情采集)
docker-compose --profile full up -d
```

--------------------------------

### Verify installation

Source: https://github.com/yutiansut/quantaxis/blob/master/README.md

Check the installed version and verify Rust support status.

```python
import QUANTAXIS as QA
from QUANTAXIS.QARSBridge import has_qars_support

print(f"QUANTAXIS版本: {QA.__version__}")
print(f"QARS2支持: {has_qars_support()}")

# 预期输出:
# QUANTAXIS版本: 2.1.0.alpha2
# QARS2支持: True
```

--------------------------------

### Install QUANTAXIS with various configurations

Source: https://github.com/yutiansut/quantaxis/blob/master/README.md

Use these pip commands to install the package with different levels of feature support, including Rust components and performance optimizations.

```bash
# 基础安装
pip install -e .

# 包含Rust组件 (推荐)
pip install -e .[rust]

# 包含性能优化包
pip install -e .[performance]

# 完整安装
pip install -e .[full]
```

--------------------------------

### Install Helm

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/overview.md

Commands to download and verify the Helm installation on a Linux-based system.

```bash
# 下载Helm
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

# 验证安装
helm version
```

--------------------------------

### Start QA_SERVICE

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/docker.md

Launch the QUANTAXIS service containers in detached mode.

```bash
docker-compose up -d
```

--------------------------------

### Compile QARS2 from Source

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Build QARS2 from the repository, ensuring Rust is installed on the system.

```bash
# 克隆QARS2仓库
cd /home/quantaxis
git clone https://github.com/yutiansut/qars2.git
cd qars2

# 安装Rust（如果未安装）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# 编译安装
pip install -e .
```

--------------------------------

### Install TeX Live on Linux

Source: https://github.com/yutiansut/quantaxis/blob/master/qabook/README.md

Install the full TeX Live distribution or a minimal set with Chinese language support on Ubuntu/Debian systems.

```bash
# 安装完整的TeX Live
sudo apt-get update
sudo apt-get install texlive-full

# 或者安装基础版本 + 中文支持
sudo apt-get install texlive-base texlive-latex-extra \
    texlive-xetex texlive-lang-chinese texlive-fonts-recommended
```

--------------------------------

### Stock Trading Strategy Example

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/api-reference/qamarket.md

Shows how to place a buy order and a corresponding stop-loss order for a stock.

```python
# 股票买卖示例
def stock_trading_strategy():
    # 买入信号
    buy_order = QA_Order(
        code='000001',
        price=10.50,
        volume=1000,
        direction=ORDER_DIRECTION.BUY,
        market_type=MARKET_TYPE.STOCK_CN
    )

    # 设置止损单
    stop_loss_order = QA_Order(
        code='000001',
        price=9.50,
        volume=1000,
        direction=ORDER_DIRECTION.SELL,
        order_type='STOP_LOSS'
    )

    return [buy_order, stop_loss_order]
```

--------------------------------

### Minimal MongoDB usage example

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/advanced/resource-manager.md

Demonstrates the recommended context manager approach for MongoDB operations.

```python
from QUANTAXIS.QAUtil.QAResourceManager import QAMongoResourceManager

# 使用with语句(推荐)
with QAMongoResourceManager() as mongo:
    db = mongo.get_database('quantaxis')
    result = db.stock_day.find_one({'code': '000001'})
    print(result)
# 自动关闭连接,无需手动close()
```

--------------------------------

### Export Documentation to PDF

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/MDBOOK_GUIDE.md

Install the mdbook-pdf plugin and configure the output settings in book.toml to enable PDF generation.

```bash
# 安装mdbook-pdf
cargo install mdbook-pdf

# 配置book.toml
[output.pdf]
enable = true

# 构建PDF
mdbook build
```

--------------------------------

### 更新 setup.py 中的 Python 版本检查

Source: https://github.com/yutiansut/quantaxis/blob/master/UPGRADE_PLAN.md

修改 setup.py 以强制要求 Python 3.9-3.12 版本。

```python
# 当前
if sys.version_info.major != 3 or sys.version_info.minor not in [5, 6, 7, 8, 9, 10]:
    print('wrong version, should be 3.5/3.6/3.7/3.8/3.9 version')

# 升级后
if sys.version_info < (3, 9) or sys.version_info >= (4, 0):
    print('错误: 需要 Python 3.9-3.12 版本')
    print('当前版本: {}.{}.{}'.format(*sys.version_info[:3]))
    sys.exit(1)
```

--------------------------------

### Initialize QA_SERVICE on Linux

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/docker.md

Download and run the service initialization script for Linux environments.

```bash
wget https://raw.githubusercontent.com/QUANTAXIS/QUANTAXIS/master/docker/qaservice_docker.sh
sudo bash qaservice_docker.sh
```

--------------------------------

### Define Rust Integration File Structure

Source: https://github.com/yutiansut/quantaxis/blob/master/UPGRADE_PLAN.md

Lists the recommended file structure for new Rust integration examples.

```text
examples/rust_integration/
├── 01_qars_account_basic.py          # QARS账户基础用法
├── 02_polars_data_processing.py      # Polars数据处理
├── 03_dataswap_pubsub.py             # 跨语言通信
├── 04_qaexchange_trading.py          # 模拟交易所对接
├── 05_performance_comparison.py      # 性能对比测试
└── README.md                          # 示例说明
```

--------------------------------

### Install QUANTAXIS with Rust support

Source: https://github.com/yutiansut/quantaxis/blob/master/README.md

Install the package with QARS2 Rust components for performance, or install QARS2 manually.

```bash
# 安装QUANTAXIS + QARS2
pip install -e .[rust]

# 或手动安装QARS2
cd /home/quantaxis/qars2
pip install -e .
```

--------------------------------

### Install Dependencies

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/advanced/resource-manager.md

Install required packages to resolve ImportError.

```bash
pip install pymongo motor pika clickhouse-driver redis
# 或
pip install quantaxis[full]
```

--------------------------------

### Install MacTeX on macOS

Source: https://github.com/yutiansut/quantaxis/blob/master/qabook/README.md

Use Homebrew to install the MacTeX distribution.

```bash
# 使用Homebrew安装MacTeX
brew install --cask mactex

# 或下载完整安装包
# https://www.tug.org/mactex/
```

--------------------------------

### Verify QADataSwap Installation

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Check if the QADataSwap component is correctly installed and supported.

```python
from QUANTAXIS.QADataBridge import has_dataswap_support

if has_dataswap_support():
    print("✅ QADataSwap已安装")
else:
    print("❌ QADataSwap未安装")
```

--------------------------------

### Initialize a Basic QIFI Account

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/api-reference/qifi.md

Demonstrates creating a simulation account with initial cash settings.

```python
from QUANTAXIS.QIFI import QIFI_Account

# 创建模拟账户
account = QIFI_Account(
    username='test_user',
    password='password',
    model='SIM',
    init_cash=1000000
)

# 获取账户信息
print(f"用户ID: {account.user_id}")
print(f"账户模式: {account.model}")
print(f"初始资金: {account.init_cash}")
```

--------------------------------

### Verify QARS2 Installation

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Check if the QARS2 engine is correctly installed and supported.

```python
from QUANTAXIS.QARSBridge import has_qars_support

if has_qars_support():
    print("✅ QARS2已安装")
else:
    print("❌ QARS2未安装")
```

--------------------------------

### Execute QIFI Account Operations

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/api-reference/overview.md

Example demonstrating account creation, order execution via receive_simpledeal, and position/balance inspection.

```python
# 创建账户
account = QA.QIFI_Account("test", "test", "stock", 100000)

# 买入
account.receive_simpledeal({
    'code': '000001',
    'price': 10.5,
    'amount': 1000,
    'datetime': '2024-01-15',
    'towards': 'buy'
})

# 查看持仓
print(account.positions)

# 卖出
account.receive_simpledeal({
    'code': '000001',
    'price': 11.0,
    'amount': 1000,
    'datetime': '2024-01-20',
    'towards': 'sell'
})

# 查看盈亏
print(f"总盈亏: {account.balance - account.init_cash}")
```

--------------------------------

### Verify LaTeX installation

Source: https://github.com/yutiansut/quantaxis/blob/master/qabook/README.md

Check the installed version of XeLaTeX to confirm the environment is ready.

```bash
# 检查XeLaTeX版本
xelatex --version

# 应该输出类似：
# XeTeX 3.141592653-2.6-0.999995 (TeX Live 2024)
```

--------------------------------

### Configure Strategy Deployment Stages

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/user-guide/live-trading.md

Demonstrates the progression from simulation to live trading with varying initial capital.

```python
# 阶段1: 模拟盘测试（1-2周）
strategy = MyStrategy(model='sim', init_cash=1000000)

# 阶段2: 小资金实盘（1-2周）
strategy = MyStrategy(model='live', init_cash=100000)

# 阶段3: 正常资金实盘
strategy = MyStrategy(model='live', init_cash=1000000)
```

--------------------------------

### Manage Multiple Accounts with QA_QIFIMANAGER

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/api-reference/qifi.md

Shows how to instantiate multiple accounts, register them with a manager, and perform bulk updates.

```python
from QUANTAXIS.QIFI import QA_QIFIMANAGER

# 创建管理器
manager = QA_QIFIMANAGER()

# 创建多个账户
accounts = []
for i in range(5):
    account = QIFI_Account(
        username=f'user_{i}',
        password='password',
        portfolio=f'portfolio_{i}'
    )
    accounts.append(account)
    manager.add_account(account)

# 批量管理
manager.update_all_positions()
manager.calculate_total_pnl()
```

--------------------------------

### Install LaTeX dependencies

Source: https://github.com/yutiansut/quantaxis/blob/master/qabook/README.md

Commands to install missing LaTeX packages on various operating systems.

```bash
# Linux
sudo apt-get install texlive-latex-extra

# macOS
sudo tlmgr install <package-name>

# Windows (MiKTeX)
# 使用MiKTeX Package Manager安装缺失的包
```

--------------------------------

### Create Docker Volumes

Source: https://github.com/yutiansut/quantaxis/blob/master/docker/kite/qa-community-rust2/qa-community-rust2.md

Initialize the necessary persistent storage volumes for Kite, QAMG, and QACODE before the first container startup.

```bash
docker volume create kite

docker volume create qamg

docker volume create qacode
```

--------------------------------

### Configure MongoDB and RabbitMQ Connections

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/advanced/resource-manager.md

Demonstrates initializing resource managers with custom URIs or authentication credentials.

```python
# 从环境变量获取
import os
mongo_uri = os.getenv('MONGODB_URI', 'mongodb://localhost:27017')

with QAMongoResourceManager(uri=mongo_uri) as mongo:
    db = mongo.get_database('quantaxis')
```

```python
with QARabbitMQResourceManager(
    host='rabbitmq.example.com',
    username='quantaxis_user',
    password='secure_password',
    vhost='/quantaxis'
) as rabbitmq:
    channel = rabbitmq.get_channel()
```

--------------------------------

### Install Rust Toolchain

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Required for components utilizing Rust; ensure the environment is sourced after installation.

```bash
# 安装Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# 更新Rust
rustup update

# 重新安装
pip install --force-reinstall quantaxis[rust]
```

--------------------------------

### Install QARS2 via PyPI

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Use pip to install the QARS2 Rust account engine.

```bash
pip install qars3
```

--------------------------------

### Install LaTeX Packages on macOS

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/qabook/build-guide.md

Command to install missing packages using tlmgr on macOS.

```bash
# 使用tlmgr安装缺失的包
sudo tlmgr install <package-name>
```

--------------------------------

### QA_util_get_trade_date(start, end)

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/api-reference/overview.md

Retrieves a list of trading dates between the specified start and end dates.

```APIDOC
## QA_util_get_trade_date(start, end)

### Parameters
- **start** (str): Start date
- **end** (str): End date

### Returns
- **list**: List of trading dates
```

--------------------------------

### Install LaTeX Packages on Linux

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/qabook/build-guide.md

Commands to install necessary LaTeX packages on Debian-based Linux distributions.

```bash
# 安装扩展包
sudo apt-get install texlive-latex-extra

# 或安装完整版
sudo apt-get install texlive-full
```

--------------------------------

### Implement and Test a Simple MA Strategy

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/development/testing.md

Demonstrates defining a strategy class inheriting from QAStrategyCtaBase and verifying backtest results using assertions.

```python
# tests/test_backtest.py
from QUANTAXIS.QAStrategy import QAStrategyCtaBase
import QUANTAXIS as QA


class TestBacktest:
    """回测测试"""
    
    def test_simple_ma_strategy(self):
        """测试简单MA策略"""
        
        class SimpleMAStrategy(QAStrategyCtaBase):
            def user_init(self):
                self.ma_period = 20
            
            def on_bar(self, bar):
                market_data = self.get_code_marketdata(bar.code)
                if len(market_data) < self.ma_period:
                    return
                
                close_prices = [x['close'] for x in market_data]
                ma = sum(close_prices[-self.ma_period:]) / self.ma_period
                
                positions = self.acc.positions
                if bar.close > ma and bar.code not in positions:
                    self.BuyOpen(bar.code, 1)
                elif bar.close < ma and bar.code in positions:
                    self.SellClose(bar.code, 1)
        
        # 运行回测
        strategy = SimpleMAStrategy(
            code='rb2501',
            frequence='5min',
            start='2024-01-01',
            end='2024-12-31',
            init_cash=1000000
        )
        strategy.run_backtest()
        
        # 验证结果
        acc = strategy.acc
        assert acc.balance > 0
        assert acc.total_return is not None
        assert len(acc.trades) > 0
    
    def test_strategy_metrics(self):
        """测试策略指标"""
        strategy = create_test_strategy()
        strategy.run_backtest()
        acc = strategy.acc
        
        # 基本指标
        assert acc.sharpe_ratio is not None
        assert acc.max_drawdown is not None
        assert acc.win_rate >= 0 and acc.win_rate <= 1
        
        # 收益率
        total_return = (acc.balance / acc.init_cash - 1) * 100
        assert total_return >= -100  # 最大亏损100%
```

--------------------------------

### Initialize and Start Live Trading

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/api-reference/qastrategy.md

Instantiates the live trading engine, assigns a strategy and configuration, and initiates the execution loop.

```python
from QUANTAXIS import QA_LiveTrading

# 创建实盘交易实例
live_trading = QA_LiveTrading()

# 设置策略和配置
live_trading.set_strategy(MyTrendStrategy)
live_trading.set_config(live_config)

# 启动实盘交易
live_trading.start()
```

--------------------------------

### 使用build.sh脚本编译

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/qabook/build-guide.md

通过build.sh脚本执行编译、清理及监控任务。

```bash
cd qabook/

# 编译PDF
bash build.sh

# 清理临时文件
bash build.sh clean

# 监控模式 (文件变更自动重新编译)
bash build.sh watch
```

--------------------------------

### Install Rust Performance Components

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/migration/v2.0-to-v2.1.md

Installs optional Rust-based components to improve performance for account operations and data handling.

```bash
# 完整安装 (包括Rust组件)
pip install quantaxis[rust]

# 或分别安装
pip install qars3>=0.0.45
pip install qadataswap>=0.1.0
```

--------------------------------

### Install Chinese Fonts on Linux

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/qabook/build-guide.md

Commands to install Chinese language support and fonts, followed by a font cache refresh.

```bash
# 安装中文字体
sudo apt-get install -y \
    texlive-lang-chinese \
    fonts-wqy-microhei \
    fonts-wqy-zenhei \
    fonts-arphic-ukai \
    fonts-arphic-uming

# 刷新字体缓存
fc-cache -f -v
```

--------------------------------

### Deploy to Production

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/appendix/faq.md

Deployment methods using Docker, Kubernetes, and Systemd service configuration.

```bash
# 1. 使用Docker
docker-compose up -d

# 2. 使用Kubernetes
kubectl apply -f k8s/

# 3. 使用Systemd
# /etc/systemd/system/quantaxis.service
[Unit]
Description=QUANTAXIS Strategy
After=network.target

[Service]
Type=simple
User=quantaxis
WorkingDirectory=/home/quantaxis/strategies
ExecStart=/usr/bin/python3 strategy.py
Restart=always

[Install]
WantedBy=multi-user.target

# 启动服务
sudo systemctl enable quantaxis
sudo systemctl start quantaxis
```

--------------------------------

### Troubleshoot Pod startup failures

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/kubernetes.md

Use these commands to inspect Pod status, events, and logs to identify common issues like image pull errors or resource constraints.

```bash
# 查看Pod详情
kubectl describe pod <pod-name> -n quantaxis

# 查看事件
kubectl get events -n quantaxis

# 常见原因：
# 1. 镜像拉取失败 → 检查镜像名称和权限
# 2. 资源不足 → kubectl top nodes
# 3. 配置错误 → kubectl logs <pod-name>
```

--------------------------------

### Install Required Python Version

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/migration/v2.0-to-v2.1.md

Commands to install Python 3.11+ on various operating systems to meet runtime requirements.

```bash
# Ubuntu/Debian
sudo apt install python3.11

# CentOS/RHEL
sudo yum install python311

# macOS
brew install python@3.11

# Windows
# 从python.org下载安装3.11+
```

--------------------------------

### QAWebServer Web服务模块使用示例

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/RemainingModules.md

展示如何创建基于 Tornado 的 Web 服务并添加路由。

```python
from QUANTAXIS.QAWebServer import QAWebServer

# 创建Web服务
app = QAWebServer()

# 添加路由
@app.route('/api/data')
def get_data(request):
    return {'data': 'sample_data'}

# 启动服务
app.run(port=8888)
```

--------------------------------

### Deploy QUANTAXIS resources

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/deployment/overview.md

Commands to initialize namespaces, secrets, storage, and core services in a Kubernetes cluster.

```bash
cd QUANTAXIS/docker/k8s-deployment

# 1. 创建命名空间
kubectl apply -f 00-namespace.yaml

# 2. 创建ConfigMap和Secret
kubectl apply -f 01-configmap.yaml

# 修改密码 (生产环境必须!)
kubectl create secret generic mongodb-secret \
  --from-literal=MONGO_ROOT_USER=root \
  --from-literal=MONGO_ROOT_PASSWORD='your-strong-password' \
  --from-literal=MONGO_USER=quantaxis \
  --from-literal=MONGO_PASSWORD='quantaxis-password' \
  --namespace=quantaxis --dry-run=client -o yaml | kubectl apply -f -

# 3. 创建存储
kubectl apply -f 03-storage.yaml

# 4. 部署数据库服务
kubectl apply -f 10-mongodb.yaml
kubectl apply -f 11-rabbitmq.yaml
kubectl apply -f 12-redis.yaml

# 5. 等待数据库就绪
kubectl wait --for=condition=ready pod -l app=mongodb -n quantaxis --timeout=300s
kubectl wait --for=condition=ready pod -l app=rabbitmq -n quantaxis --timeout=300s

# 6. 部署QUANTAXIS核心服务
kubectl apply -f 50-quantaxis.yaml

# 7. 验证部署
kubectl get pods -n quantaxis
kubectl get svc -n quantaxis
```

--------------------------------

### Uninstall Old Version

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/getting-started/installation.md

Remove the existing installation before upgrading.

```bash
pip uninstall quantaxis
```

--------------------------------

### Check QARS Support

Source: https://github.com/yutiansut/quantaxis/blob/master/doc/api-reference/overview.md

Verify if the QARS2 bridge is installed and available.

```python
from QUANTAXIS.QARSBridge import has_qars_support

if has_qars_support():
    print("✅ QARS2可用")
```

--------------------------------

### Compile QABook using build script

Source: https://github.com/yutiansut/quantaxis/blob/master/qabook/README.md

Use the provided bash script to compile, clean, or watch for changes in the documentation.

```bash
# 进入qabook目录
cd qabook/

# 编译PDF
bash build.sh

# 清理临时文件
bash build.sh clean

# 监控模式（文件变更自动重新编译）
bash build.sh watch
```

--------------------------------

### Update setup.py dependencies

Source: https://github.com/yutiansut/quantaxis/blob/master/UPGRADE_PLAN.md

Defines required and optional dependencies including Rust-based components for the project.

```python
# 新增依赖
install_requires=[
    # ... 现有依赖 ...
    'polars>=0.20.0,<0.22.0',
    'orjson>=3.10.0',
    'msgpack>=1.1.0',
],

# 可选依赖
extras_require={
    'rust': [
        'qars3>=0.0.45',
        'qadataswap>=0.1.0',
    ],
    'full': [
        'qars3>=0.0.45',
        'qadataswap>=0.1.0',
        'polars>=0.20.0',
        'jupyter>=1.0.0',
    ],
},
```

--------------------------------

### GET /api/v1/positions

Source: https://github.com/yutiansut/quantaxis/blob/master/UPGRADE_PLAN.md

Retrieves the current list of positions for the authenticated user.

```APIDOC
## GET /api/v1/positions

### Description
Fetches the current holdings and positions.

### Method
GET

### Endpoint
/api/v1/positions
```

--------------------------------

### Start database services with Docker Compose

Source: https://github.com/yutiansut/quantaxis/blob/master/qapro-rs/readme.md

Launches the required infrastructure services (ClickHouse, Redis, MongoDB, RabbitMQ) using a Docker Compose file.

```bash
docker-compose -f database.yaml up -d
```
Tokens:
Raw