公募基金组合风险分析

分析基金组合的历史风险与分散效果。
详情页：https://www.gugudata.com/api/details/fundportfolioriskanalysis

当前接口契约

接口详情：https://www.gugudata.com/api/details/fundportfolioriskanalysis

功能说明

按基金代码和持仓权重分析组合风险；

支持 6 个月或 1 年分析周期；

支持 95% 或 99% 置信水平；

提供组合年化收益与年化波动率；

提供最大回撤及对应日期区间；

提供 VaR 与 CVaR 风险指标；

展示单只基金的收益、波动与风险贡献；

展示基金相关性与下行相关性；

展示组合分散效果与数据完整性；

结果基于历史数据，不构成投资建议；

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	付费后获取的 APPKEY。推荐使用 Authorization: Bearer YOUR_APPKEY；也支持 AppKey、X-GUGUDATA-APPKEY、X-API-Key 请求头和 appkey 查询参数。APPKEY 不属于 JSON 请求体 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
Positions	array	是	无	JSON 持仓数组，必须包含 2 至 10 个对象；FundCode 不得重复，返回结果保持提交的基金与权重
Positions[].FundCode	string	是	无	六位数字组成的公募基金代码，必须以 JSON 字符串传递以保留前导零，例如 012729
Positions[].Weight	number	是	无	当前组合权重，使用有限且大于 0 的小数；全部 Weight 之和与 1 的误差不得超过 0.000001，服务端不会自动归一化
Period	string	否	1Y	历史分析窗口，可选 6M 或 1Y，默认 1Y。6M 至少需要 100 个有效观察，1Y 至少需要 200 个有效观察
ConfidenceLevel	number	否	0.95	单日历史模拟 VaR 和 CVaR 的置信水平，仅支持 0.95 或 0.99，默认 0.95

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	业务状态码。100 表示请求正常完成；501 参数错误；502 请求频率受限；503 账号过期；504 APPKEY 错误；505 调用额度不足；900 服务内部错误；901 服务暂不可用
DataStatus.Status	string	机器可读的错误状态；成功响应通常不返回。参数错误为 invalid_argument，服务不可用为 service_unavailable
DataStatus.StatusDescription	string	本次请求的中文状态说明；程序判断应优先使用 StatusCode 和 AnalysisStatus
DataStatus.ResponseDateTime	string	服务端响应时间，格式为 YYYY-MM-DD HH:mm:ss.SSS
DataStatus.DataTotalCount	integer	当前响应中的分析结果数量；成功分析通常为 1，错误响应为 0
DataStatus.RequestId	string	请求追踪标识。咨询技术支持时可提供该值，但不要提供 APPKEY
DataStatus.NoDataReason	string	统一响应层的无数据原因码；基金组合的详细原因以 Data.NoDataReasons 为准
Data.AnalysisStatus	string	分析状态：AVAILABLE、PARTIAL 或 UNAVAILABLE
Data.ModelVersion	string	本次结果的版本标识
Data.Period	string	实际采用的历史分析周期，取值为 6M 或 1Y
Data.ConfidenceLevel	number	本次 VaR 和 CVaR 计算采用的置信水平，取值为 0.95 或 0.99
Data.WeightingMethod	string	组合收益的权重方法，固定为 CONSTANT_WEIGHT，表示在全部公共交易日期上使用请求中的恒定权重
Data.DataStartDate	string	组合严格公共样本的起始交易日期，格式为 YYYYMMDD
Data.DataEndDate	string	组合严格公共样本的结束交易日期，格式为 YYYYMMDD
Data.SnapshotTime	string	本次数据计算时间，使用 ISO 8601 格式并包含时区偏移
Data.ObservationCount	integer	全部请求基金严格共有的有效交易日期数量；该值不足周期门槛时 PortfolioMetrics 为 null
Data.CoverageRatio	number	全部基金严格公共日期数除以有效日期并集数量，范围为 0 至 1，越接近 1 表示日期对齐越完整
Data.RequestedFundCount	integer	请求中提交的基金数量
Data.AnalyzedFundCount	integer	满足周期数据要求并完成个体指标计算的基金数量
Data.PortfolioMetrics	object	组合层历史风险指标。仅当全部基金和严格公共样本均满足周期要求时返回对象，否则为 null
Data.PortfolioMetrics.AnnualizedReturn	number	基于组合日收益几何复利并按 252 个交易日年化；可为负数，小数表示，例如 0.08 表示 8%
Data.PortfolioMetrics.AnnualizedVolatility	number	组合年化波动率，按小数表示，例如 0.12 表示 12%
Data.PortfolioMetrics.MaximumDrawdown	number	分析期内组合累计收益从历史峰值到后续谷值的最大跌幅，按正数小数表示
Data.PortfolioMetrics.MaximumDrawdownStartDate	string	最大回撤起始日期，格式为 YYYYMMDD；无回撤时为 null
Data.PortfolioMetrics.MaximumDrawdownEndDate	string	最大回撤结束日期，格式为 YYYYMMDD；无回撤时为 null
Data.PortfolioMetrics.ValueAtRisk	number	按 ConfidenceLevel 计算的单日历史模拟风险价值，采用正损失口径；例如 0.02 表示阈值损失为 2%
Data.PortfolioMetrics.ConditionalValueAtRisk	number	超过 VaR 阈值后的单日平均尾部损失，采用正损失口径，并保证 CVaR 大于等于 VaR
Data.PortfolioMetrics.DiversificationRatio	number	加权个体年化波动率之和除以组合年化波动率；通常大于 1 表示存在分散化效果，零方差时为 null
Data.FundMetrics	array	按请求顺序返回每只基金的个体历史风险指标、覆盖率和组合风险贡献
Data.FundMetrics[].FundCode	string	六位基金代码
Data.FundMetrics[].FundName	string	基金名称；历史序列未提供名称时为 null
Data.FundMetrics[].Weight	number	请求中该基金的组合权重
Data.FundMetrics[].AnalysisStatus	string	该基金的个体指标状态，取值为 AVAILABLE 或 UNAVAILABLE；组合整体状态另见 Data.AnalysisStatus
Data.FundMetrics[].ObservationCount	integer	该基金在分析周期内的有效观察数
Data.FundMetrics[].CoverageRatio	number	该基金有效日期数占全部基金有效日期并集的比例
Data.FundMetrics[].AnnualizedReturn	number	该基金日收益按几何复利和 252 个交易日年化；数据不足时为 null
Data.FundMetrics[].AnnualizedVolatility	number	该基金日收益样本标准差按 252 个交易日年化；数据不足时为 null
Data.FundMetrics[].MaximumDrawdown	number	该基金在分析期内从峰值到谷值的最大跌幅，按正数小数表示；数据不足时为 null
Data.FundMetrics[].RiskContribution	number	该基金对组合风险的贡献占比；单只基金允许为负，组合可计算时各项之和约等于 1
Data.PairwiseDependencies	array	满足周期样本门槛的基金两两依赖关系；每个无序基金对返回一条记录
Data.PairwiseDependencies[].FundCodeA	string	相关性基金代码 A
Data.PairwiseDependencies[].FundCodeB	string	相关性基金代码 B
Data.PairwiseDependencies[].Correlation	number	两只基金在严格公共日期上的 Pearson 相关系数，范围为 -1 至 1；零方差等不可计算情况为 null
Data.PairwiseDependencies[].DownsideCorrelation	number	全部基金组合收益小于 0 的严格公共交易日期上计算；所有基金对使用同一组下行日期。少于 30 个下行样本或零方差时为 null
Data.DataQuality	object	当前周期的数据门槛、最旧最新记录的数据年龄和标准化警告码
Data.DataQuality.MinimumObservationCount	integer	当前周期要求的最低有效观察数
Data.DataQuality.LatestDataAgeDays	integer	最旧一只基金的最新记录距分析日期的天数
Data.DataQuality.Warnings	array	数据质量提示码数组，例如 INSUFFICIENT_DOWNSIDE_OBSERVATIONS 或 ZERO_PORTFOLIO_VARIANCE
Data.DataQuality.Warnings[]	string	单条警告码；部分警告会附带相关基金代码，便于程序定位但不影响其他可计算指标
Data.NoDataReasons	array	基金级或组合级不可计算原因数组；合法基金但数据不足仍返回 HTTP 200 和业务码 100
Data.NoDataReasons[].FundCode	string	原因对应的基金代码；组合级原因时为 null
Data.NoDataReasons[].Reason	string	稳定原因码，包括 FUND_NOT_FOUND、EMPTY_HISTORY、INSUFFICIENT_OBSERVATIONS、INSUFFICIENT_COMMON_OBSERVATIONS、STALE_HISTORY、CONFLICTING_DUPLICATE_DATE、INVALID_RETURN、INSUFFICIENT_DOWNSIDE_OBSERVATIONS 或 ZERO_PORTFOLIO_VARIANCE
Data.ComplianceNotice	string	历史风险分析免责声明；结果仅供信息参考，不构成投资建议
Data.IsDemo	boolean	是否为免鉴权演示结果。正式 POST 请求为 false，Demo 返回 true

业务状态说明

业务状态码	业务状态码解释	备注
100	正常返回	结合 AnalysisStatus 判断分析数据完整性
501	参数错误	请检查基金代码、持仓数量、权重、周期和置信水平
502	请求频率受限	请降低请求频率后重试
503	账号已过期	请确认订单有效期
504	APPKEY 错误	请检查 APPKEY 及接口权限
505	调用额度不足	请确认接口调用额度
900	服务内部错误	请稍后重试；持续失败时可提供 RequestId 联系支持
901	服务暂不可用	历史数据服务暂不可用，请稍后重试

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Header 参数

Body 参数application/json必填

示例

{
  "Positions": [
    {"FundCode": "012729", "Weight": 0.3},
    {"FundCode": "290008", "Weight": 0.25},
    {"FundCode": "000001", "Weight": 0.25},
    {"FundCode": "110022", "Weight": 0.2}
  ],
  "Period": "1Y",
  "ConfidenceLevel": 0.95
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0,
        "Status": "string",
        "RequestId": "string",
        "NoDataReason": "string"
    },
    "Data": {
        "DataEndDate": "string",
        "PairwiseDependencies": [
            {
                "FundCodeB": "string",
                "DownsideCorrelation": -1,
                "FundCodeA": "string",
                "Correlation": -1
            }
        ],
        "ObservationCount": 0,
        "ModelVersion": "string",
        "AnalyzedFundCount": 0,
        "RequestedFundCount": 0,
        "PortfolioMetrics": {
            "AnnualizedVolatility": 0,
            "ValueAtRisk": 0,
            "AnnualizedReturn": 0,
            "MaximumDrawdown": 0,
            "MaximumDrawdownStartDate": "string",
            "ConditionalValueAtRisk": 0,
            "DiversificationRatio": 0,
            "MaximumDrawdownEndDate": "string"
        },
        "WeightingMethod": "CONSTANT_WEIGHT",
        "ConfidenceLevel": 0.95,
        "DataQuality": {
            "Warnings": [
                "string"
            ],
            "MinimumObservationCount": 0,
            "LatestDataAgeDays": 0
        },
        "DataStartDate": "string",
        "IsDemo": true,
        "Period": "6M",
        "SnapshotTime": "string",
        "ComplianceNotice": "string",
        "CoverageRatio": 0,
        "FundMetrics": [
            {
                "ObservationCount": 0,
                "AnnualizedVolatility": 0,
                "Weight": 1,
                "AnnualizedReturn": 0,
                "MaximumDrawdown": 0,
                "FundName": "string",
                "FundCode": "string",
                "RiskContribution": 0,
                "CoverageRatio": 0,
                "AnalysisStatus": "AVAILABLE"
            }
        ],
        "AnalysisStatus": "AVAILABLE",
        "NoDataReasons": [
            {
                "Reason": "FUND_NOT_FOUND",
                "FundCode": "string"
            }
        ]
    }
}

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502数据服务暂时不可用，请稍后重试。

🔴503基金风险分析服务暂时不可用，业务状态码为 901，请稍后重试。

当前接口契约#

功能说明#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

功能说明

请求参数

正常响应字段

业务状态说明