CarrotQuant

CarrotQuant 是基于 Python/Numba 的 1m+ 高性能通用全市场 (A股/美股/期货) 事件驱动与向量化量化回测引擎。

🌟 核心亮点

极致吞吐量：基于 Numba JIT 打平内联与连续 2D C-Contiguous 内存布局，零堆分配开销 (3000万+ Ticks/s)。
通用多空机制：buy / sell 天然支持做多与做空 (pos += amount 与 pos -= amount)，统一浮动资产计算 $PV = \text{Cash} + \sum \text{pos}_i \times \text{close}_i$。
轻量动态复权架构：data.close 为原始真实交割价，data.adj.close / ctx.adj.close 为动态懒求值复权视角。无复权需求或已有复权时零开销。
多表与自定义列按需/懒加载 (LazyCustomFields)：自动支持多表字段与自定义特征列（如因子 factor_b、pe_ttm、vwap 等）。支持 custom_columns 显式筛选与字段级懒透视，访问时才生成 2D 矩阵，未访问零开销。
物理严格防未来切片：策略通过 ctx.get('factor_b')（当前 $t$ 步切片）与 ctx.get_history('factor_b')（物理边界 [:t+1, :]）访问数据，绝无未来函数污染。
盘口流动性限制：支持设置 max_volume_ratio（例如 0.1 表示单笔交易上限为当前 Bar 10% 成交量）。
限价单与撤单机制：支持 buy_limit / sell_limit 限价单与 cancel_order 撤单，支持跨 Bar 订单保存与价格触达自动撮合。
做多/做空保证金率与融资融券扣费：支持设置 long_margin_ratio / short_margin_ratio（保证金率校验），以及 margin_interest_rate / borrow_interest_rate（日频融资与融券利息扣除）。
统一极简单入口 API (engine.run)：无论内存单 Container、磁盘分块 Stream，还是 JIT 信号矩阵，统一通过 engine.run(...) 单一方法启动。

🚀 快速开始

from carrotquant import strategy, BarContext, Engine, ColumnDataLoader

# 1. 定义策略 (使用 @strategy 装饰器，支持自定义列 factor_b)
@strategy
def dual_ma_strategy(ctx: BarContext):
    # 读取自定义因子列 factor_b 当前快照 (N,) 与 历史切片 [:t+1, :]
    factor_b = ctx.get("factor_b")
    
    for i in range(ctx.n_symbols):
        if not ctx.is_tradable[i]:
            continue

        # 使用 ctx.adj.close_history 读取后复权历史收盘价
        c_hist = ctx.adj.close_history[-20:, i]
        ma5 = c_hist[-5:].mean()
        ma20 = c_hist[-20:].mean()

        # 结合因子与均线信号买卖
        if ma5 > ma20 and factor_b[i] > 0.5 and ctx.positions[i] == 0:
            ctx.buy(symbol_idx=i, amount=100)
        elif ma5 < ma20 and ctx.positions[i] > 0:
            ctx.sell(symbol_idx=i, amount=ctx.positions[i])

# 2. 磁盘级惰性分块扫描 (指定按需加载特征列 custom_columns)
data_stream = ColumnDataLoader.scan_parquet_chunks(
    path="data/parquet/ashare.kline.1m",
    custom_columns=["factor_b"],
    partition_by="year"
)

# 3. 初始化并运行统一引擎 (设置印花税、佣金、万一滑点、盘口 10% 成交量比例)
engine = Engine(
    initial_cash=1_000_000.0,
    fee_rate=0.0003,
    min_fee=5.0,
    stamp_duty=0.0005,
    slippage=0.0001,
    max_volume_ratio=0.1,  # 盘口最多吃 10% 流动性
    matching_mode="close"  # 字符串指定按收盘价撮合
)

results = engine.run(strategy=dual_ma_strategy, data=data_stream)

# 4. 输出回测绩效与 Polars 交易日志
print(results.summary())
print(results.trade_logs)  # Polars DataFrame

Download files

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

Source Distribution

carrotquant_engine-1.0.3.tar.gz (17.8 kB view details)

Uploaded Aug 15, 2026 Source

Built Distribution

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.

carrotquant_engine-1.0.3-py3-none-any.whl (18.7 kB view details)

Uploaded Aug 15, 2026 Python 3

File details

Details for the file carrotquant_engine-1.0.3.tar.gz.

File metadata

Download URL: carrotquant_engine-1.0.3.tar.gz
Upload date: Aug 15, 2026
Size: 17.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for carrotquant_engine-1.0.3.tar.gz
Algorithm	Hash digest
SHA256	`f76b5e8ecd3e10b98fdcff8c2597542028f2781232a5f85df09d62e994697085`
MD5	`a9df0d5795f60250e468f09fe07af835`
BLAKE2b-256	`61f2b4f5744ba6df010292403853ac2c7d6a5ccfeeb3a384b2dad3ebd69d2172`

See more details on using hashes here.

Provenance

The following attestation bundles were made for carrotquant_engine-1.0.3.tar.gz:

Publisher: workflow.yml on CRThu/carrotquant-engine

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: carrotquant_engine-1.0.3.tar.gz
- Subject digest: f76b5e8ecd3e10b98fdcff8c2597542028f2781232a5f85df09d62e994697085
- Sigstore transparency entry: 2476544893
- Sigstore integration time: Aug 15, 2026
Source repository:
- Permalink: CRThu/carrotquant-engine@6e9d0f60a94aa1abaea18a7c59c95cdda17219e4
- Branch / Tag: refs/tags/v1.0.3
- Owner: https://github.com/CRThu
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: workflow.yml@6e9d0f60a94aa1abaea18a7c59c95cdda17219e4
- Trigger Event: push