| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 是 | 无 | 开发者凭据;支持现有 Query、Header 和 Bearer,多处值须一致。 |
| symbol | string | 是 | 无 | 单个六位基金代码,保留前导零。 |
| indicator | string | 是 | 无 | 单位净值走势、累计净值走势、累计收益率走势、同类排名走势、同类排名百分比、分红送配详情或拆分详情。 |
| beginDate | string | 是 | 无 | yyyyMMdd,区间最大 366 天;走势与排名按日期筛选,分红与拆分按起止年份筛选。 |
| endDate | string | 是 | 无 | yyyyMMdd;权益事件可能在指定日期区间之外,但必须属于起止年份。 |
| 字段 | 类型 | 说明 |
|---|---|---|
| DataStatus.RequestParameter | string | 真实、可读的业务请求参数;无业务参数时为空,不包含凭据。 |
| DataStatus.StatusCode | integer | |
| DataStatus.StatusDescription | string | |
| DataStatus.ResponseDateTime | string | |
| DataStatus.DataTotalCount | integer | 本次返回记录条数。 |
| Data | array | 各指标仅返回对应业务字段,保留现有默认值省略行 为。走势与排名按精确日期筛选,分红与拆分按起止年份筛选。分红字段保留来源中的每份或每 10 份单位文字,不能直接视为每份金额。有效区间无记录或无权益事件返回空数组;备用结果可能较旧。 |
| Data.DateKey | string | 走势/排名为 yyyyMMdd;分红/拆分保留来源年份文字。 |
| Data.Symbol | string | 当前历史记录所属开放式基金的 6 位代码,保留前导零 |
| Data.UnitNetWorth | number | 对应 DateKey 的单位净值;仅 indicator=单位净值走势时具有实际含义 |
| Data.DailyGrowthRate | number | 对应 DateKey 的单位净值日增长率,单位为百分比;仅单位净值走势使用 |
| Data.CumulativeNetWorth | number | 对应 DateKey 的累计净值;仅 indicator=累计净值走势时使用 |
| Data.CumulativeYieldRate | number | 对应 DateKey 的累计收益率,单位为百分比;仅累计收益率走势使用 |
| Data.SameTypeRanking | string | 同类排名走势时表示排名名次;同类排名百分比时表示排名百分位 |
| Data.TotalRanking | string | 当前日期参与同类排名的基金总数;仅同类排名走势使用 |
| Data.EquityRegistrationDate | string | 本次基金分红的权益登记日期;仅分红送配详情使用 |
| Data.ExDividendDate | string | 本次基金分红的除息日期;仅分红送配详情使用 |
| Data.DividendPerShare | string | 保留来源单位文字,例如每 10 份派现金金额。 |
| Data.DividendPaymentDate | string | 本次基金分红的实际发放日期;仅分红送配详情使用 |
| Data.SplitConversionDate | string | 基金份额拆分或折算的生效日期;仅拆分详情使用 |
| Data.SplitType | string | 基金份额拆分、合并或折算的事件类型;仅拆分详情使用 |
| Data.SplitConversionRatio | string | 基金份额拆分或折算比例说明;仅拆分详情使用 |
| 业务状态码 | 业务状态码解释 | 备注 |
|---|---|---|
| 100 | 成功 | HTTP 200 |
| 501 | 参数错误 | HTTP 400 |
| 901 | 依赖失败 | HTTP 503 |
| 502 | 频率受限 | HTTP 429 |
| 503 | 无权限或过期 | HTTP 403 |
| 504 | 凭据错误 | HTTP 401 |
| 505 | 额度不可用 | HTTP 403 |