pairs-trading

name	pairs-trading
description	配对交易策略，通过协整检验寻找长期均衡关系并基于价差均值回归生成交易信号。适用于量化金融教学与统计套利概念演示；基于简化协整模型，不适用于实盘交易。
version	1.0.0
author	wangyi

pairs-trading

配对交易策略：通过协整检验寻找具有长期均衡关系的两只股票，基于价差的均值回归特性生成交易信号。

📌 说明：本工具基于简化模型实现，仅使用 Python 标准库。结果仅供学习参考，不构成投资建议或交易依据。

脚本API

calc_mean(data)

计算列表的算术平均值。 必填: data

calc_variance(data, ddof=1)

计算列表的方差。 必填: data

calc_std(data, ddof=1)

计算列表的标准差。 必填: data

calc_covariance(data_a, data_b)

计算两个等长列表的协方差。 必填: data_a, data_b

calc_hedge_ratio(prices_a, prices_b)

通过最小二乘法计算对冲比率 β。 必填: prices_a, prices_b

calc_spread(prices_a, prices_b, hedge_ratio)

计算价差序列。 必填: prices_a, prices_b, hedge_ratio

simplified_adf_test(spread)

简化版 ADF（Augmented Dickey-Fuller）检验。 必填: spread

rolling_zscore(spread, window=20)

计算滚动 Z-score。 必填: spread

generate_signals(z_scores, entry_threshold=2.0, exit_threshold=0.5)

生成配对交易信号。 必填: z_scores

calc_stats(signals, spread)

计算策略统计信息。 必填: signals, spread

run_pairs_trading(prices_a, prices_b, window=20, entry_threshold=2.0, exit_threshold=0.5)

运行完整的配对交易策略。 必填: prices_a, prices_b

调用示例

python scripts/main.py \
  --prices-a <prices_a> \
  --prices-b <prices_b> \
  --window <window> \
  --entry-threshold <entry_threshold> \
  --exit-threshold <exit_threshold>