跳到主要内容

创建组合

POST/research/portfolios在线调试
POST https://api.shengkezhi.com/open/v1/research/portfolios
等效 curl
curl "https://api.shengkezhi.com/open/v1/research/portfolios" \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  --data '{"portfolio_code":"BONDS_MONTH_END","description":"T/TL 月末调仓:风险归一后最小化半方差","status":"暂停","candidate_strategies":["LIVE_BOND_01","LIVE_BOND_02","LIVE_BOND_03","LIVE_BOND_04","LIVE_BOND_05","LIVE_BOND_06","LIVE_BOND_07","LIVE_BOND_08","LIVE_BOND_09","LIVE_BOND_10","LIVE_BOND_11","LIVE_BOND_12","LIVE_BOND_13","LIVE_BOND_14","LIVE_BOND_15","LIVE_BOND_16","LIVE_BOND_17","LIVE_BOND_18"],"rebalance_dates":[],"rebalance_date_rules":["每月最后一天"],"rebalance_method":"skfolio","lookback_days":120,"skip_existing":false,"strategy_selector":{},"symbol_selector":{"name":"allowed_symbols","symbols":["T999.CFX","TL999.CFX"]},"rebalance_params":{"fallback_method":"inverse_vol","lookback_days":252,"min_observations":120,"optimizer":"MeanRisk","risk_normalization":{"max_scale":2,"method":"volatility","min_observations":60,"target_volatility":0.2,"trading_days_per_year":252},"optimizer_params":{"max_weights":0.15,"objective_function":"MINIMIZE_RISK","risk_measure":"SEMI_VARIANCE","solver":"CLARABEL"}}}'

POST /research/portfolios — 创建组合。

校验请求并异步提交组合优化任务。接口只等待云函数受理后返回 202;组合产物落盘后才会出现在查询结果中。新建仅允许暂停;显式日期与规则由 FOX 合并、排序、去重,规则无需显式日期。symbol_selector、strategy_selector、rebalance_params 原样下发。外层 lookback_days 仅保留配置,不替代 rebalance_params.lookback_days 训练窗口;市场和频率由候选策略派生。rebalance_params 为 JSON 对象,内部字段、类型和取值不做限制;其他未知或不支持的配置字段返回422。相同编号已有生成中任务时复用该任务,已存在的组合返回409,请使用刷新接口。

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

请求体​

字段类型必填说明
portfolio_codestring是新组合编号,1~160 个字符,仅允许字母、数字、下划线和连字符。
descriptionstring否组合用途或构建思路;缺省为空字符串。
statusstring | null否新建仅允许暂停;省略时由创建入口设置暂停。
candidate_strategiesstring[]是候选实盘策略编号,至少一项;云函数从中优化组合层权重。
rebalance_datesstring[]否显式调仓日期;与 rebalance_date_rules 至少提供一项,两者按 FOX 合并排序去重。
rebalance_date_rulesstring[] | null否调仓规则,与显式日期合并、排序、去重。支持每月/每季度/每年的第一天或最后一天、 每周一至每周日、每月1号至每月31号(也接受“日”);由计算引擎展开日期。
rebalance_methodstring否再平衡方法,缺省 equal_weight。 默认值:"equal_weight"。
lookback_daysinteger | null否保留 FOX 外层配置;不替代 rebalance_params.lookback_days 优化训练窗口。
skip_existingboolean | null否计算引擎的跳过已有结果选项,原样下发。
strategy_selectornull | PortfolioSelector否策略筛选器:min_history、min_recent_sharpe 或 drop_high_corr;空对象表示不筛选。
symbol_selectornull | PortfolioSelector否品种筛选器:allowed_symbols 或 top_amount_percent;空对象表示不筛选。
rebalance_paramsobject(动态键,值为 任意 JSON 值) | null否再平衡参数对象,内部字段、类型和取值不做限制,原样下发给计算引擎。
schema_versionstring | null否配置版本;提供时仅支持 1.0。
base_freqstring否兼容旧客户端的频率提示,不控制计算;实际频率由候选策略派生。 默认值:"1d"。
base_marketstring否兼容旧客户端的市场提示;实际计算市场由候选策略派生。
price_fieldstring否兼容旧客户端的价格提示,不控制计算;FOX 生成标准执行价及敏感性结果。 默认值:"close"。

响应 data​

字段类型必填说明
portfolio_codestring是已受理的组合编号;可用它轮询 GET /api/portfolios。
run_idstring是本次执行的唯一编号,与组合编号分开。
statusstring是固定 pending:已受理,正在后台生成。

PortfolioSelector 字段​

字段类型必填说明
amount_columnstring | null否top_amount_percent 使用的成交额列名称。
corr_thresholdnumber | null否drop_high_corr 的相关性阈值,取值 (0, 1]。
keep_bystring | null否drop_high_corr 保留策略的依据:sharpe 或 return。
lookback_daysinteger | null否策略筛选回看窗口;提供时必须大于 0。
metricstring | null否drop_high_corr 使用的指标:sharpe 或 return。
min_sharpenumber | null否min_recent_sharpe 的夏普阈值;提供时必须大于 0。
namestring | null否空对象表示不筛选;非空时 name 必填。支持 FOX 内置选择器,不接受自定义代码。
percentnumber | null否top_amount_percent 的筛选比例,取值 (0, 1]。
symbolsstring[] | null否allowed_symbols 的品种白名单,至少一个非空品种编码。

HTTP 状态​

状态码说明
202任务已受理
400请求体无法解析
409组合已存在
422组合参数或候选策略无效
500任务登记失败
503组合计算服务未配置或未受理

调用示例​

curl -X POST "https://api.shengkezhi.com/open/v1/research/portfolios" \
-H "Authorization: Bearer sk_xxx" \
-H "Content-Type: application/json" \
-d '{"portfolio_code":"BONDS_MONTH_END","description":"T/TL 月末调仓:风险归一后最小化半方差","status":"暂停","candidate_strategies":["LIVE_BOND_01","LIVE_BOND_02","LIVE_BOND_03","LIVE_BOND_04","LIVE_BOND_05","LIVE_BOND_06","LIVE_BOND_07","LIVE_BOND_08","LIVE_BOND_09","LIVE_BOND_10","LIVE_BOND_11","LIVE_BOND_12","LIVE_BOND_13","LIVE_BOND_14","LIVE_BOND_15","LIVE_BOND_16","LIVE_BOND_17","LIVE_BOND_18"],"rebalance_dates":[],"rebalance_date_rules":["每月最后一天"],"rebalance_method":"skfolio","lookback_days":120,"skip_existing":false,"strategy_selector":{},"symbol_selector":{"name":"allowed_symbols","symbols":["T999.CFX","TL999.CFX"]},"rebalance_params":{"fallback_method":"inverse_vol","lookback_days":252,"min_observations":120,"optimizer":"MeanRisk","risk_normalization":{"max_scale":2,"method":"volatility","min_observations":60,"target_volatility":0.2,"trading_days_per_year":252},"optimizer_params":{"max_weights":0.15,"objective_function":"MINIMIZE_RISK","risk_measure":"SEMI_VARIANCE","solver":"CLARABEL"}}}'
{
"code": 0,
"msg": "已受理,正在后台生成",
"data": {
"portfolio_code": "BONDS_MONTH_END",
"run_id": "example-run",
"status": "pending"
}
}