跳到主要内容

挖掘结果因子详情

GET/research/mining/{run_id}/factors/{factor_name}在线调试
GET https://api.shengkezhi.com/open/v1/research/mining/{run_id}/factors/{factor_name}
等效 curl
curl "https://api.shengkezhi.com/open/v1/research/mining/{run_id}/factors/{factor_name}" \
  -H "Authorization: Bearer sk_xxx"

GET /research/mining/{run_id}/factors/{factor_name} — 挖掘结果因子详情。

需在请求头携带 Authorization: Bearer sk_xxx。

路径参数​

参数必填说明
run_id是挖掘记录 ID
factor_name是因子名称

响应​

响应 data — MiningFactorDetail

字段类型必填说明
aggobject（自由形）✔聚合汇总：最佳夏普及其 problem、夏普均值与中位数、正夏普占比等。
compute_enginestring✔计算引擎短码：TSA（时序）或 CSA（截面）。
create_timestring✔因子创建时间。
descriptionstring✔因子描述（含研究逻辑与失效提示）。
direction_compareobject（自由形）[]✔方向对比：多空与多头两方向各指标的跨问题均值（段为训练集）。
factor_codestring✔因子 AST 表达式源码（含换行）。
factor_namestring✔因子名，格式 {引擎}_{YYMMDD}_{HASH6}，如 TSA_260531_6BEFDD。
metricsobject（自由形）✔指标 map：跨研究问题的均值（方向多空、段训练集），键为指标中文名。
per_problemobject（自由形）[]✔逐研究问题明细：每个 problem 在训练集多空方向下的核心指标。
problem_countinteger✔该因子评估覆盖的研究问题数。
segment_robustnessobject（自由形）[]✔分段稳健性：训练集及 A 段、B 段、C 段各指标的跨问题均值（方向多空）。

调用示例​

curl "https://api.shengkezhi.com/open/v1/research/mining/20260531_053509_90ec76ba/factors/TSA_260531_6BEFDD" -H "Authorization: Bearer sk_xxx"
{
  "code": 0,
  "data": {
    "agg": {
      "best_problem": "FTS_PROBLEM_8C7C30",
      "best_sharpe": 1.5,
      "mean_sharpe": 1.5,
      "median_calmar": 5.0,
      "median_sharpe": 1.5,
      "pos_sharpe_ratio": 1.0,
      "problem_count": 1
    },
    "compute_engine": "TSA",
    "create_time": "2026-05-31 05:35:09",
    "description": "20 日动量：收盘价较 20 日前的变化率",
    "direction_compare": [
      {
        "direction": "多头",
        "交易胜率": 0.58,
        "夏普比率": 0.9,
        "年化收益": 0.12,
        "最大回撤": -0.03
      },
      {
        "direction": "多空",
        "交易胜率": 0.6,
        "夏普比率": 1.5,
        "年化收益": 0.2,
        "最大回撤": -0.04
      }
    ],
    "factor_code": "Sub($close, Ref($close, 20))",
    "factor_name": "TSA_260531_6BEFDD",
    "metrics": {
      "交易胜率": 0.6,
      "卡玛比率": 5.0,
      "夏普比率": 1.5,
      "年化收益": 0.2,
      "年化波动率": 0.12,
      "日胜率": 0.55,
      "最大回撤": -0.04
    },
    "per_problem": [
      {
        "group": "FTS",
        "problem": "FTS_PROBLEM_8C7C30",
        "交易胜率": 0.6,
        "卡玛比率": 5.0,
        "夏普比率": 1.5,
        "年化收益": 0.2,
        "最大回撤": -0.04
      }
    ],
    "problem_count": 1,
    "segment_robustness": [
      {
        "segment": "训练集",
        "交易胜率": 0.6,
        "卡玛比率": 5.0,
        "夏普比率": 1.5,
        "年化收益": 0.2,
        "最大回撤": -0.04
      },
      {
        "segment": "训练集A段",
        "交易胜率": null,
        "卡玛比率": null,
        "夏普比率": 1.1,
        "年化收益": null,
        "最大回撤": null
      },
      {
        "segment": "训练集B段",
        "交易胜率": null,
        "卡玛比率": null,
        "夏普比率": 1.2,
        "年化收益": null,
        "最大回撤": null
      },
      {
        "segment": "训练集C段",
        "交易胜率": null,
        "卡玛比率": null,
        "夏普比率": 1.3,
        "年化收益": null,
        "最大回撤": null
      }
    ]
  },
  "msg": "ok"
}