跳到主要内容

因子详情

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

GET /research/factors/{factor_name} — 因子详情。

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

路径参数​

参数必填说明
factor_name是因子名称

响应​

响应 data — FactorDetail

字段类型必填说明
compute_enginestring✔计算引擎简称：TSA 时序或 CSA 截面。
create_timestring✔因子创建时间。
creatorstring✔因子创建者：生成该因子的 agent 或模型标识。
delete_reasonstring｜null删除原因；未删除或老库缺该列时为 null。
descriptionstring✔因子描述：逻辑说明与已知局限。
engine_fullstring✔计算引擎全称，如 TimeSeriesAstEngine。
evaluationsFactorEvaluation[]✔逐 problem 评估摘要（各时段多空方向核心指标）。
factor_codestring✔因子 AST 源码。
factor_namestring✔因子名，格式 引擎_YYMMDD_HASH6，系统按内容哈希自动生成，不可手命名。
is_deletedboolean✔是否已删除。
routestring✔所属路线编码。
route_namestring✔所属路线名称，缺失时回落为路线编码。
tagsFactorTagDetail[]✔质检标签明细列表（含 detail 说明）。

P3 · 因子挖掘单次结果​

调用示例​

curl "https://api.shengkezhi.com/open/v1/research/factors/TSA_260531_6BEFDD" -H "Authorization: Bearer sk_xxx"
{
  "code": 0,
  "data": {
    "compute_engine": "TSA",
    "create_time": "2026-05-31 05:35:09",
    "creator": "route_factor_miner",
    "delete_reason": null,
    "description": "20 日动量：收盘价较 20 日前的变化率",
    "engine_full": "TimeSeriesAstEngine",
    "evaluations": [
      {
        "calmar": 5.0,
        "method": "default",
        "problem": "FTS_PROBLEM_8C7C30",
        "segments": {
          "训练集": {
            "交易胜率": 0.6,
            "夏普比率": 1.5,
            "年化收益": 0.2,
            "年胜率": null,
            "最大回撤": -0.04
          },
          "训练集A段": {
            "交易胜率": null,
            "夏普比率": 1.1,
            "年化收益": null,
            "年胜率": null,
            "最大回撤": null
          },
          "训练集B段": {
            "交易胜率": null,
            "夏普比率": 1.2,
            "年化收益": null,
            "年胜率": null,
            "最大回撤": null
          },
          "训练集C段": {
            "交易胜率": null,
            "夏普比率": 1.3,
            "年化收益": null,
            "年胜率": null,
            "最大回撤": null
          }
        },
        "sharpe": 1.5,
        "status": "success"
      }
    ],
    "factor_code": "Sub($close, Ref($close, 20))",
    "factor_name": "TSA_260531_6BEFDD",
    "is_deleted": false,
    "route": "90ec76ba1f23",
    "route_name": "量价共振趋势因子",
    "tags": [
      {
        "detail": "",
        "tag": "detect_passed"
      },
      {
        "detail": "",
        "tag": "量价"
      },
      {
        "detail": "",
        "tag": "positive_passed"
      }
    ]
  },
  "msg": "ok"
}