提交你的第一个因子

安装 QuantGPT 开源引擎，在本地完成因子设计和验证。AI Agent 通过 MCP 工具自主完成回测、评分、反过拟合检验。

# 安装 QuantGPT
pip install quantgpt

# 启动服务
quantgpt serve

# 在 Claude Code / Cursor 中配置 MCP 连接后，AI Agent 可用的工具：
#   score_factor    — 因子评分（0-100, A/B/C/D）
#   run_backtest    — 完整回测（IC 分析 + 分组收益 + 净值曲线）
#   run_anti_overfit — 反过拟合检验（IC 稳定性 + 安慰剂 + 半衰期）
#   diagnose_factor — 失败模式诊断 + 改进建议

# 详细配置见 https://github.com/Miasyster/QuantGPT

在 QuantGPT Cloud 注册账户，生成 API Key 用于上传因子数据。

# 注册
curl -X POST /api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "your_password"}'

# 生成 API Key（推荐，长期有效）
curl -X POST /api/v1/auth/api-keys \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-key"}'

# 后续请求都用 X-API-Key 头
-H "X-API-Key: qgc_xxxxxxxxxx"

用 QuantGPT 本地回测验证通过的因子，计算截面值并上传到 Cloud。平台要求至少 120 个交易日。

import requests

API = ""
HEADERS = {"X-API-Key": "qgc_xxxxxxxxxx"}

# 创建因子（名称和表达式与 QuantGPT 本地研究一致）
r = requests.post(f"{API}/api/v1/factors", headers=HEADERS, json={
    "name": "Rev5D",
    "universe": "csi500",
    "description": "5-day reversal factor"
})
factor_id = r.json()["id"]

# factor_data 来自你本地计算的截面值
# 格式：{"2025-09-08": {"600519": -0.032, "000858": 0.015, ...}, ...}

# 分批上传（每次最多 500 条）
sorted_dates = sorted(factor_data.keys())
batch = []
for date_str in sorted_dates:
    batch.append({"date": date_str, "values": factor_data[date_str]})
    if len(batch) == 500:
        requests.post(f"{API}/api/v1/factors/{factor_id}/values",
                      headers=HEADERS, json={"entries": batch})
        batch = []
if batch:
    requests.post(f"{API}/api/v1/factors/{factor_id}/values",
                  headers=HEADERS, json={"entries": batch})

上传满 120 天后，因子状态变为 ready。提交后平台用自有行情数据独立计算 IC、换手率、相关性等指标。

# 提交验证（同步返回结果，通常 < 5 秒）
r = requests.post(f"{API}/api/v1/factors/{factor_id}/submit",
                  headers=HEADERS)
result = r.json()

print(f"状态：{result['status']}")     # active = 通过，rejected = 未通过
print(f"IC Mean：{result['is']['ic_mean']}")
print(f"IC IR：{result['is']['ic_ir']}")
print(f"Sharpe：{result['is']['sharpe']}")

# 查看各项检查详情
for c in result["checks"]:
    print(f"  {c['name']}: {c['result']} (值={c['value']}, 阈值={c['limit']})")