跳到主要内容

创建投研因子路线

POST/research/factor-routes在线调试
POST https://api.shengkezhi.com/open/v1/research/factor-routes
等效 curl
curl "https://api.shengkezhi.com/open/v1/research/factor-routes" \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  --data '{"compute_engine":"示例值","economic_logic":"示例值","failure_scenarios":["示例值"],"key_inspect":"示例值","market_mechanism":"示例值","name":"示例名称","tags":["示例值"],"why_effective":"示例值"}'

POST /research/factor-routes — 创建投研因子路线。

需在请求头携带 Authorization: Bearer sk_xxx

请求体

字段类型必填说明
compute_enginestringnull
economic_logicstring经济逻辑,路线赖以生效的资金行为或市场结构解释;参与 route_code 哈希。
failure_scenariosstring[]失效场景列表,列举该路线可能失灵的市场情形;落库时存为 JSON 字符串数组。
key_inspectstring核心洞察,该路线量化捕捉的关键信号或市场规律;参与 route_code 哈希。
market_mechanismstring市场机制,收益来源归类(如「错误定价」或「风险溢价」);参与 route_code 哈希。
namestring路线名称,前端筛选下拉直接展示;参与 route_code 内容哈希的 5 个必填字段之一。
tagsstring[]路线标签列表(如「时序」「量价」「威科夫」);落库时存为 JSON 字符串数组。
why_effectivestring有效性依据,说明该逻辑为何能形成可持续的超额收益来源;参与 route_code 哈希。

响应 data

字段类型必填说明
codestringroute_code 同值的别名,兼容前端有的组件读 code、有的读 route_code 两种取字段习惯。
route_codestring新建研究路线的编码,后端按路线内容哈希幂等生成,重复提交同一路线返回同一编码。

调用示例

curl -X POST "https://api.shengkezhi.com/open/v1/research/factor-routes" \
-H "Authorization: Bearer sk_xxx" \
-H "Content-Type: application/json" \
-d '{"compute_engine":"示例值","economic_logic":"示例值","failure_scenarios":["示例值"],"key_inspect":"示例值","market_mechanism":"示例值","name":"示例名称","tags":["示例值"],"why_effective":"示例值"}'
{
"code": 0,
"data": {
"code": "STRAT_MOMENTUM_001",
"route_code": "90ec76ba1f23"
},
"msg": "ok"
}