AKQuant

io.github.akfamily由 GitHub 帳號 akfamily 發布v0.3.82更新於 Nov 7, 2026

Write and backtest trading strategies with AKQuant: API lookup, strategy checks, backtest runs

概覽

AI 產生的概覽

AKQuant 的 MCP 服務讓助理查詢 AKQuant API、撰寫並檢查交易策略、執行回測,並回傳結構化結果與錯誤訊息。

可以做什麼
  • 查詢 AKQuant API 參考,協助撰寫策略程式碼
  • 在專案目錄中撰寫並檢查交易策略
  • 執行回測,讀取結構化結果與錯誤報告
  • 搭配行情資料 MCP 服務,由助理取得資料、撰寫策略並解讀回測結果
適用情境
適合在 AI 助理中以自然語言開發與回測量化交易策略,例如用 A 股日線執行均線交叉策略並回報報酬與最大回撤。
執行需求
透過 uvx 以 stdio 在本機執行 akquant[mcp] 套件,需先安裝 uv;需事先建立並以 --root 指定專案目錄。未宣告驗證、環境變數或標頭。取得資料通常需另一個行情資料 MCP 服務(如 AKShare 官方 MCP)。
安裝前請注意
回測會在 --root 指定的專案目錄寫入策略與資料檔案。未傳 broker_profile 或明確費率、T+1、最小交易單位時,結果為理想化,報酬可能偏樂觀。回測僅為模擬,不構成實盤交易或投資建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AKQuant,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[AKQuant]

[PyPI Version] [Python Versions] [License] [AKShare] [Downloads]

AKQuant 是一款专为量化投研设计的下一代高性能混合框架。核心引擎采用 Rust 编写以确保极致的执行效率,同时提供优雅的 Python 接口以维持灵活的策略开发体验。

🚀 核心亮点:

  • 高性能内核:得益于 Rust 的零开销抽象与 Zero-Copy 数据导入(add_arrays 借用 NumPy 缓冲入引擎;策略侧 get_history 等读取则返回安全快照拷贝),AKQuant 在部分回测场景下可显著降低 Python 层开销;实际运行速度取决于策略逻辑、数据规模、回调频率与运行环境。
  • 原生 ML 支持:内置 Walk-forward Validation(滚动训练)框架,无缝集成 PyTorch/Scikit-learn,让 AI 策略开发从实验到回测一气呵成。
  • TA-Lib 指标生态:内置 akquant.talib 双后端(python/rust)兼容能力,支持 104 个指标。
  • 因子表达式引擎:内置 Polars 驱动的高性能因子计算引擎,支持 Rank(Ts_Mean(Close, 5)) 等 Alpha101 风格公式,自动处理并行计算与数据对齐。
  • 参数优化:内置多进程网格搜索(Grid Search)框架,支持策略参数的高效并行优化。
  • 专业级风控:内置完善的订单流管理与即时风控模块,支持多资产组合回测。
  • AI 助手(MCP):自带 MCP 服务,在 WorkBuddy、DeepSeek Harness、Codex、Cursor、Claude 等 AI 助手中用自然语言写策略、跑回测,助手能读到结构化的结果和报错;已上架 MCP 官方注册表(io.github.akfamily/akquant)。

👉 阅读完整文档 | English Documentation

安装说明

AKQuant 已发布至 PyPI,无需安装 Rust 环境即可直接使用。

bash
pip install akquant

在 AI 助手中使用(MCP)

先安装 uv,然后在 WorkBuddy、DeepSeek Harness、Codex、Claude Code 等 AI 助手中说一句话就能装好:

安装 AKShare 和 AKQuant 的官方 MCP,项目目录用 /path/to/akquant-demo,运行一个示例策略并报告结果

助手会自己配置好两个服务,再下载数据、编写策略、运行回测并解读结果,不需要事先安装 AKQuant。助手没能自动安装,或者想手动配置时,--root 是项目目录(请先建好),策略和数据文件都放在里面:

bash
claude mcp add akquant -- uvx --from "akquant[mcp]" akquant-mcp --root /path/to/akquant-democodex mcp add akquant -- uvx --from "akquant[mcp]" akquant-mcp --root /path/to/akquant-demo

WorkBuddy、Cursor、Claude Desktop 等使用 JSON 配置的客户端:

json
{  "mcpServers": {    "akquant": {      "command": "uvx",      "args": ["--from", "akquant[mcp]", "akquant-mcp", "--root", "/path/to/akquant-demo"]    }  }}

DeepSeek Harness 不读 JSON,要把同样的命令写进 ~/.dsh/profiles/web/cordis.patch.yml,写法见 MCP 服务文档。

接入后可以直接说“用平安银行近三年的日线跑一个均线交叉策略,报告收益和最大回撤”。和 AKTools(AKShare 的官方 MCP)一起接入,助手可以自己查数据、写策略、跑回测。各客户端的配置、工具清单与注意事项见 MCP 服务文档。

快速开始

以下是一个简单的策略示例:

python
import akquant as aqimport akshare as akfrom akquant import Strategy
# 1. 准备数据# 使用 akshare 获取 A 股历史数据 (需安装: pip install akshare)df = ak.stock_zh_a_daily(symbol="sh600000", start_date="20250212", end_date="20260212")# 交易日历: 不传时按工作日推算, 节假日会被当作交易日trade_dates = ak.tool_trade_date_hist_sina()["trade_date"]

class MyStrategy(Strategy):    def on_bar(self, bar):        # 简单策略示例:        # 当收盘价 > 开盘价 (阳线) -> 买入        # 当收盘价 < 开盘价 (阴线) -> 卖出
        # 获取当前持仓        current_pos = self.get_position(bar.symbol)
        if current_pos == 0 and bar.close > bar.open:            self.buy(symbol=bar.symbol, quantity=100)            print(f"[{bar.timestamp_iso}] Buy 100 at {bar.close:.2f}")  # UTC ISO 8601
        elif current_pos > 0 and bar.close < bar.open:            self.close_position(symbol=bar.symbol)            print(f"[{bar.timestamp_iso}] Sell 100 at {bar.close:.2f}")  # UTC ISO 8601

# 运行回测result = aq.run_backtest(    data=df,    strategy=MyStrategy,    initial_cash=100000.0,    symbols="sh600000",    broker_profile="cn_stock_t1_low_fee",  # A 股佣金/印花税/过户费、T+1、一手 100 股    trading_calendar=trade_dates,)
# 打印回测结果print("\n=== Backtest Result ===")print(result)
# 生成最小基准对比报告benchmark_returns = (    df.set_index("date")["close"].pct_change().fillna(0.0).rename("SIMPLE_BENCH"))result.viz.report(    filename="quickstart_report.html",    show=False,    benchmark=benchmark_returns,)

调用 result.viz.report(..., benchmark=...) 后,报告会新增“基准对比 (Benchmark Comparison)”区块,展示策略/基准/超额累计收益曲线,以及累计超额收益、年化超额收益、跟踪误差、信息比率、Beta、Alpha 等相对指标。

注意:run_backtest 默认不计交易成本、不开 T+1。 不传 broker_profile 也不传费率时,佣金、印花税、过户费都是 0,可以当日买卖,最小交易单位是 1 股——这样得到的是理想化的结果,换手越高越偏乐观。A 股回测请像上面这样传 broker_profile(内置 cn_stock_miniqmt、cn_stock_t1_low_fee、cn_stock_sim_high_slippage),或者显式传 commission_rate、stamp_tax_rate、transfer_fee_rate、min_commission、t_plus_one=True、lot_size=100。模板的印花税按 2023-08-28 起的现行税率 0.05% 计,回测此前的行情请显式传 stamp_tax_rate=0.001。

运行结果示例:

text
=== Backtest Result ===BacktestResult:                                            Valuenamestart_time              2025-02-12 15:00:00+08:00end_time                2026-02-12 15:00:00+08:00duration                        365 days, 0:00:00total_bars                                    249closed_trade_count                           62.0execution_count                             124.0open_position_count                           0.0initial_market_value                     100000.0end_market_value                     99379.212386total_pnl                             -620.787614unrealized_pnl                                0.0total_return_pct                        -0.620788annualized_return                       -0.006208volatility                               0.002456total_profit                              544.624total_loss                              -755.5086total_commission                       409.903014max_drawdown                             0.006234max_drawdown_value                     623.409236max_drawdown_pct                         0.623393win_rate                                22.580645loss_rate                               77.419355winning_trades                               14.0losing_trades                                48.0avg_pnl                                 -3.401365avg_return_pct                          -0.219536avg_trade_bars                           1.967742avg_profit                              38.901714avg_profit_pct                           3.350484avg_winning_trade_bars                        4.5avg_loss                               -15.739762avg_loss_pct                            -1.260791avg_losing_trade_bars                    1.229167largest_win                              119.7522largest_win_pct                         10.156084largest_win_bars                              7.0largest_loss                             -70.2532largest_loss_pct                        -5.399399largest_loss_bars                             1.0max_wins                                      2.0max_losses                                    9.0sharpe_ratio                            -2.574886sortino_ratio                            -3.16692profit_factor                            0.720871ulcer_index                              0.003099upi                                     -2.003008equity_r2                                0.871776std_error                               69.889352calmar_ratio                            -0.995821exposure_time_pct                       48.995984var_95                                  -0.000262var_99                                  -0.000623cvar_95                                 -0.000427cvar_99                                 -0.000702sqn                                     -0.800105kelly_criterion                         -0.087435max_leverage                             0.014604min_margin_level                        68.473617

复杂订单助手 (OCO / Bracket)

AKQuant 提供了两组复杂订单助手,减少手写订单联动逻辑:

  • place_oco(first_order_id, second_order_id, group_id=None):将两个订单绑定为 OCO,任一成交后自动撤销另一单。
  • place_bracket(symbol, quantity, entry_price=None, stop_trigger_price=None, take_profit_price=None, ...):一次性提交 Bracket 结构;进场成交后自动挂出止损/止盈,并在双退出单场景下自动绑定 OCO。
python
from akquant import OrderStatus, Strategy
class BracketHelperStrategy(Strategy):    def __init__(self):        self.entry_order_id = ""
    def on_bar(self, bar):        if self.get_position(bar.symbol) > 0 or self.entry_order_id:            return
        self.entry_order_id = self.place_bracket(            symbol=bar.symbol,            quantity=100,            stop_trigger_price=bar.close * 0.98,            take_profit_price=bar.close * 1.04,            entry_tag="entry",            stop_tag="stop",            take_profit_tag="take",        )
    def on_order(self, order):        if order.id == self.entry_order_id and order.status in (            OrderStatus.Cancelled,            OrderStatus.Rejected,        ):            self.entry_order_id = ""

可直接运行完整示例:

bash
python examples/06_complex_orders.py

流式回测 (Streaming)

如果你希望在回测执行过程中实时消费事件,可直接使用 run_backtest 并传入 on_event:

python
def on_event(event):    if event["event_type"] == "finished":        payload = event["payload"]        print("status:", payload.get("status"))        print("callback_error_count:", payload.get("callback_error_count"))
result = aq.run_backtest(    data=df,    strategy=MyStrategy,    symbols="sh600000",    on_event=on_event,    show_progress=False,    stream_progress_interval=10,    stream_equity_interval=10,    stream_batch_size=32,    stream_max_buffer=256,    stream_error_mode="continue",)

on_event 为可选参数:不传时保持传统阻塞语义,传入时可实时消费事件。

关键参数:

  • stream_progress_interval / stream_equity_interval: 进度与权益事件采样间隔
  • stream_batch_size / stream_max_buffer: 缓冲与批量刷新控制
  • stream_error_mode: 回调异常策略,支持 "continue" 与 "fail_fast"

可视化 (Visualization)

AKQuant 内置了基于 Plotly 的强大可视化模块,仅需一行代码即可生成包含权益曲线、回撤分析、月度热力图等详细指标的交互式 HTML 报告。

python
# 生成交互式 HTML 报告,自动在浏览器中打开result.viz.report(    show=True,    compact_currency=True,  # 金额列按 K/M/B 紧凑显示(默认 True))
# 如果你希望金额列保留原始数值精度(不缩写),可关闭:result.viz.report(    show=False,    filename="report_raw_amount.html",    compact_currency=False,)

你也可以直接复用结构化分析结果做二次研究:

python
exposure = result.exposure_df()             # 暴露分解(净暴露/总暴露/杠杆)attr_by_symbol = result.attribution_df(by="symbol")attr_by_tag = result.attribution_df(by="tag")capacity = result.capacity_df()             # 容量代理(成交率/换手等)orders_by_strategy = result.orders_by_strategy()         # 按策略归属聚合订单executions_by_strategy = result.executions_by_strategy() # 按策略归属聚合成交

[Strategy Dashboard]
👉 点击查看交互式报表示例 (Interactive Demo)

文档索引

  • 📖 核心特性与架构: 了解 AKQuant 的设计理念与性能优势。
  • 🛠️ 安装指南: 详细的安装步骤(含源码编译)。
  • 🚀 快速入门: 更多示例与基础用法。
  • 🤖 机器学习指南: 如何使用内置的 ML 框架进行滚动训练。
  • 📚 API 参考: 详细的类与函数文档。
  • 🧩 MCP 服务: 让 WorkBuddy、DeepSeek Harness、Codex、Cursor、Claude 等 AI 助手查 API、写策略、跑回测、读结构化报错。
  • 💻 贡献指南: 如何参与项目开发。

🧪 测试与质量保证

AKQuant 采用严格的测试流程以确保回测引擎的准确性:

  • 单元测试: 覆盖核心 Rust 组件与 Python 接口。
  • 黄金测试 (Golden Tests): 使用合成数据验证关键业务逻辑(如 T+1、涨跌停、保证金、期权希腊值),并与锁定的基线结果进行比对,防止算法回退。

运行测试:

bash
# 1. 使用 uv 环境运行命令uv sync
# 2. 构建并绑定 Rust 扩展# 注意:不要使用 `uv run maturin develop`,它会先尝试安装当前项目,# 对于以 maturin 作为 build backend 的仓库可能卡在 Preparing packages。uvx maturin develop
# 3. 运行所有测试uv run pytest
# 4. 运行 Rust 核心测试(自动处理 macOS + uv 环境动态库路径)./scripts/cargo-test.sh -q
# 5. 仅运行黄金测试uv run pytest tests/golden/test_golden.py

Citation

Please use this bibtex if you want to cite this repository in your publications:

bibtex
@misc{akquant,    author = {Albert King and Yaojie Zhang and Chao Liang},    title = {AKQuant},    year = {2026},    publisher = {GitHub},    journal = {GitHub repository},    howpublished = {\url{https://github.com/akfamily/akquant}},}

License

MIT License

來源:README.md,提交 162e56f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.3.82最新Nov 7, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分