跳到主要内容

组合详情

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

GET /research/portfolios/{code} — 组合详情。

传入 fee_bp 和 price_field 时读取对应回测文件,不回退到默认结果。场景文件缺失时返回组合定义及 has_performance=false。不传时兼容默认产物。section=overview 不读历史持仓与组合构成;composition 不读回测与历史持仓;positions 不读回测与策略配置。未指定时返回完整详情。仅 overview 和 composition 分组固定缓存30秒;positions 和完整详情不缓存;最新权重及实盘持仓截面每次直接读取,响应为 private, no-store。

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

请求参数​

参数位置类型必填默认值说明
codepathstring是-组合编号
sectionquerystring否-页面按需读取的分组;默认 full 保持完整详情兼容。
fee_bpqueryinteger否-费率 bp:0、1、2、3、5、8、10;与 price_field 一起传入。
price_fieldquerystring否-成交价格列,例如 TP#NOPEN、TP#VWAP3。

响应 data​

字段类型必填说明
compareCompareSeries是多空、分腿、基准和超额的累计收益对比曲线。
compare_metricsobject是多空关键指标对比(leg → 指标 map)。
curvesobject(动态键,值为 PerformanceCurve)是多空、多头、空头、基准和超额的完整绩效曲线。
drawdownsDrawdownRow[]是主要回撤区间。
has_performanceboolean是当前请求场景是否有绩效 MsgPack;缺少时返回 false,不回退到其他场景。
has_reportboolean是是否存在可由 /api/portfolios/{code}/report 获取的 HTML 完整报告。
history_position_snapshotsPortfolioHistorySnapshot[]是按原始数据时间升序排列的全部历史持仓截面,不截成日期、不限制最近十期。
latest_weightsTargetWeight[]是最近一个再平衡日的目标标的权重。
latest_weights_atstring是最新权重文件名(兼容旧客户端),并非生成时间。
latest_weights_data_atstring是—
latest_weights_updated_atstring是—
metaPortfolioMeta是组合配置与构建元信息。
metricsobject | null否全样本核心指标(中文键 → 数值);缺少绩效数据时为 null。
monthlyMonthlyRow[]是按年份组织的月度收益矩阵。
navNavSeries是组合净值、回撤和累计收益曲线。
normalized_20object(动态键,值为 PerformanceCurve)是各绩效腿按 20% 年化波动率归一化后的曲线。
position_snapshotsPortfolioPositionSnapshot[]是实盘目标持仓截面,与回测每日持仓矩阵独立。
positionsPositions是历史每日持仓权重矩阵。
rebalance_datesstring[]是配置的再平衡日期,格式 YYYY-MM-DD。
strategiesPortfolioStrategy[]是参与组合的策略及组合层权重。
strategy_weight_snapshotsPortfolioStrategySnapshot[]是按日期升序排列的历史策略配置;仅包含已落盘的再平衡日。
symbol_returnsSymbolReturn[]是各标的累计收益贡献,供归因排序展示。
verdictobject是wbt is_good_strategy 判定(history + recent)。
yearlyobject(动态键,值为 number)是年度收益,年份字符串映射至收益率。

CompareSeries 字段​

字段类型必填说明
datesstring[]是交易日期轴,所有归因曲线均与其等长。
seriesobject是leg 名到累计收益序列的映射;常见键为 多空、多头、空头、基准、超额。

PerformanceCurve 字段​

字段类型必填说明
cumnumber[]是单利累计收益序列。
dailynumber[]是日收益序列,与组合交易日期轴等长。
drawdownnumber[]是相对历史累计收益高点的回撤序列。

DrawdownRow 字段​

字段类型必填说明
depthnumber是回撤深度,小数表示且不大于 0。
drawdown_daysinteger是从开始至谷底的自然日或交易日计数,口径由 wbt 产物决定。
endstring是回撤谷底日期。
new_high_gapinteger | null否相邻新高之间的天数;不可计算时为 null。
recoverstring | null否净值恢复至前高的日期;尚未恢复时为 null。
recover_daysinteger | null否从谷底至恢复的天数;尚未恢复时为 null。
startstring是回撤开始日期。

PortfolioHistorySnapshot 字段​

字段类型必填说明
dtstring是history_positions.feather 的原始时间,保留时分秒,不添加未记录的时区。
weightsTargetWeight[]是同一数据时点的标的权重,包含有效的零权重。

TargetWeight 字段​

字段类型必填说明
symbolstring是标的代码,例如 600519.SH。
weightnumber是目标权重,小数表示;正数为多头,负数为空头。

PortfolioMeta 字段​

字段类型必填说明
codestring是组合编号。
descriptionstring是组合描述。
statusstring是组合业务状态。
base_marketstring是基础市场代码。
base_freqstring是基础数据频率。
price_fieldstring是回测价格字段,例如 close。
rebalance_methodstring是再平衡方法,例如 equal_weight。
lookback_daysinteger是优化器使用的历史回看交易日数。
config_hashstring是生成配置的内容哈希,用于追踪产物版本。
generated_atstring是产物生成时间,RFC3339 或 workspace 产物记录的等价格式。
fee_bpnumber是单边费率,单位为基点(bp)。
digitsinteger是权重保存的小数位数。
symbol_countinteger是回测覆盖的标的数量。
sdtstring是回测起始日期,格式 YYYY-MM-DD。
edtstring是回测结束日期,格式 YYYY-MM-DD。

MonthlyRow 字段​

字段类型必填说明
valuesnumber[]是12 个月的收益率;无数据的月份为 null。
yearinteger是公历年份。
字段类型必填说明
datesstring[]是交易日期轴,格式 YYYY-MM-DD。
navnumber[]是累计净值,与 dates 等长,通常从 1.0 起。
drawdownnumber[]是回撤序列,与 dates 等长且不大于 0。
cum_returnnumber[]是累计收益序列,与 dates 等长,等于净值减 1。

PortfolioPositionSnapshot 字段​

字段类型必填说明
data_atstring是元数据明确记录的持仓数据时点;旧产物缺失时为空。
dtstring是时间轴标识:优先数据时点,旧产物回退文件名时间,不能据此推断数据时点。
updated_atstring是权重产物生成时间,缺失为空字符串。
weightsTargetWeight[]是—

Positions 字段​

字段类型必填说明
datesstring[]是持仓日期轴,格式 YYYY-MM-DD。
symbolsstring[]是权重矩阵覆盖的全部标的代码。
weightsobject是symbol → 每日权重(对齐 dates,缺失为 null)。

PortfolioStrategy 字段​

字段类型必填说明
strategy_idstring是实盘策略编号。
weightnumber是策略在组合中的配置权重,小数表示。

PortfolioStrategySnapshot 字段​

字段类型必填说明
dtstring是strategy_configs 文件名中的业务日期,格式 YYYY-MM-DD,不作时区转换。
strategiesPortfolioStrategy[]是同一策略的各标的配置权重求和;保留小数、零值和杠杆,不重新归一化。 空数组表示文件明确记录空配置;缺少文件时不生成该日期的快照。

SymbolReturn 字段​

字段类型必填说明
retnumber是该标的对组合累计收益的贡献,小数表示。
symbolstring是标的代码。

HTTP 状态​

状态码说明
200组合详情
404组合不存在
422费率或交易价无效
500组合产物读取失败

调用示例​

curl -X GET "https://api.shengkezhi.com/open/v1/research/portfolios/FP01" \
-H "Authorization: Bearer sk_xxx"
{
"code": 0,
"msg": "ok",
"data": {
"meta": {
"code": "FP01",
"description": "",
"status": "实盘",
"base_market": "stock",
"base_freq": "60min",
"price_field": "close",
"rebalance_method": "equal_weight",
"lookback_days": 120,
"config_hash": "",
"generated_at": "2026-08-21T16:11:50.164355",
"fee_bp": 0.0,
"digits": 2,
"symbol_count": 0,
"sdt": "",
"edt": ""
},
"strategies": [
{
"strategy_id": "STS_60M_1I7G6TS4",
"weight": 1.0
}
],
"rebalance_dates": [
"2025-01-13",
"2026-01-01"
],
"latest_weights": [],
"latest_weights_at": "",
"metrics": null,
"compare_metrics": {},
"compare": {
"dates": [],
"series": {}
},
"curves": {},
"normalized_20": {},
"nav": {
"dates": [],
"nav": [],
"drawdown": [],
"cum_return": []
},
"monthly": [],
"yearly": {},
"symbol_returns": [],
"drawdowns": [],
"verdict": {
"history": null,
"recent": null
},
"positions": {
"dates": [],
"symbols": [],
"weights": {}
},
"has_report": true,
"has_performance": false,
"strategy_weight_snapshots": [],
"latest_weights_data_at": "",
"latest_weights_updated_at": "",
"position_snapshots": [],
"history_position_snapshots": []
}
}