# 基金增值数据函数（付费）
C++ 基金数据 API 包含在 3.5.18 版本及以上版本
# fnd_get_etf_constituents - 查询 ETF 最新成分股
查询某只 ETF 在最新交易日的成分股持有情况和现金替代信息
函数原型：
DataArray<FndEtfConstituents>* fnd_get_etf_constituents(const char *symbol);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | ETF 代码 | Y | 无 | 必填，只能输入一个 symbol, 如：SZSE.159919 |
返回值：
FndEtfConstituents 结构数组，参见FndEtfConstituents定义与DataArray类的用法。
示例：
fnd_get_etf_constituents("SHSE.510050")
注意：
1. 只返回上交所、深交所的成分股，不提供其余交易所的成分股票。
# fnd_get_stock_portfolio - 查询基金资产组合(股票投资组合)
查询某只基金在指定日期的基金资产组合(股票投资组合)
函数原型：
DataArray<FndPortfolioStockInfo>* fnd_get_stock_portfolio(const char *symbol, int report_type, const char *start_date = NULL, const char *end_date = NULL);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol]，如：SZSE.161133 |
| report_type | int | 报表类别 | Y | 无 | 公布持仓所在的报表类别，必填，可选： 1:第一季度 2:第二季度 3:第三季报 4:第四季度 6:中报 9:前三季报 12:年报 |
| start_date | str | 开始时间 | N | NULL | 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间 |
| end_date | str | 结束时间 | N | NULL | 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间 |
返回值：
FndPortfolioStockInfo 结构数组，参见FndPortfolioStockInfo定义与DataArray类的用法。
示例：
fnd_get_stock_portfolio("SHSE.510300", 1)
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的资产组合数据。
2. 当start_date == end_date时，取离end_date最近公告日期的一条数据，
当start_date < end_date时，取指定时间段的数据，
当start_date > end_date时，返回报错。
# fnd_get_bond_portfolio - 查询基金资产组合(债券投资组合)
查询某只基金在指定日期的基金资产组合(债券投资组合)
函数原型：
DataArray<FndPortfolioBondInfo>* fnd_get_bond_portfolio(const char *symbol, int report_type, const char *start_date = NULL, const char *end_date = NULL);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol]，如：SZSE.161133 |
| report_type | int | 报表类别 | Y | 无 | 公布持仓所在的报表类别，必填，可选： 1:第一季度 2:第二季度 3:第三季报 4:第四季度 6:中报 9:前三季报 12:年报 |
| start_date | str | 开始时间 | N | NULL | 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间 |
| end_date | str | 结束时间 | N | NULL | 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间 |
返回值：
FndPortfolioBondInfo 结构数组，参见FndPortfolioBondInfo定义与DataArray类的用法。
示例：
fnd_get_bond_portfolio("SHSE.510300", 1)
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的资产组合数据。
2. 当start_date == end_date时，取离end_date最近公告日期的一条数据，
当start_date < end_date时，取指定时间段的数据，
当start_date > end_date时，返回报错。
# fnd_get_fund_portfolio - 查询基金资产组合(基金投资组合)
查询某只基金在指定日期的基金资产组合(基金投资组合)
函数原型：
DataArray<FndPortfolioFundInfo>* fnd_get_fund_portfolio(const char *symbol, int report_type, const char *start_date = NULL, const char *end_date = NULL);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol]，如：SZSE.161133 |
| report_type | int | 报表类别 | Y | 无 | 公布持仓所在的报表类别，必填，可选： 1:第一季度 2:第二季度 3:第三季报 4:第四季度 6:中报 12:年报 |
| start_date | str | 开始时间 | N | NULL | 开始时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间 |
| end_date | str | 结束时间 | N | NULL | 结束时间日期（公告日），%Y-%m-%d 格式，默认NULL表示最新时间 |
返回值：
FndPortfolioFundInfo 结构数组，参见FndPortfolioFundInfo定义与DataArray类的用法。
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的资产组合数据。
2. 当start_date == end_date时，取离end_date最近公告日期的一条数据，
当start_date < end_date时，取指定时间段的数据，
当start_date > end_date时，返回报错。
# fnd_get_net_value - 查询基金净值数据
查询某只基金在指定时间段的基金净值数据
函数原型：
DataArray<FndNetValueInfo>* fnd_get_net_value(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol]如：SZSE.159919 |
| start_date | str | 开始时间 | N | NULL | 开始时间日期，%Y-%m-%d 格式，默认NULL表示最新时间 |
| end_date | str | 结束时间 | N | NULL | 结束时间日期，%Y-%m-%d 格式，默认NULL表示最新时间 |
返回值：
FndNetValueInfo 结构数组，参见FndNetValueInfo定义与DataArray类的用法。
示例：
fnd_get_net_value("SHSE.510300")
注意：
1. 仅提供场内基金（ETF、LOF、FOF-LOF）的净值数据。
2. 当start_date == end_date时，取离end_date最近日期的一条数据，
当start_date < end_date时，取指定时间段的数据，
当start_date > end_date时，返回报错。
# fnd_get_adj_factor - 查询基金复权因子
查询某只基金在一段时间内的复权因子
函数原型：
DataArray<FndAdjFactorInfo>* fnd_get_adj_factor(const char *symbol, const char *start_date = NULL, const char *end_date = NULL, const char *base_date = NULL);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol]，如：SZSE.159919 |
| start_date | str | 开始时间 | N | NULL | 开始时间交易日期，%Y-%m-%d 格式， 默认NULL表示最新时间 |
| end_date | str | 结束时间 | N | NULL | 结束时间交易日期，%Y-%m-%d 格式， 默认NULL表示最新时间 |
| base_date | str | 复权基准日 | N | NULL | 前复权的基准日，%Y-%m-%d 格式， 默认NULL表示最新时间 |
返回值：
FndAdjFactorInfo 结构数组，参见FndAdjFactorInfo定义与DataArray类的用法。
示例：
fnd_get_adj_factor("SHSE.510300")
注意：
1. T+1 日复权因子会二次更新，分别在 T 日 19:00 和 T+1 日 19:00 更新。仅提供场内基金（ETF、LOF、FOF-LOF）的复权因子数据。
2. 复权价格计算：
T日后复权价格 = T日不复权价格 * T日累计后复权因子 T日前复权价格 = T日不复权价格 * T日前复权因子
3. 上市首日后复权因子合累计后复权因子为 1，最近一次除权除息日后的交易日前复权因子为 1
4. 前复权基准日base_date应不早于设定的结束日期end_date，不晚于最新交易日。若设定的基准日早于end_date则等同于end_date，若设定的基准日晚于最新交易日则等同于最新交易日。
5. 当start_date 小于或等于 end_date 时取指定时间段的数据,当start_date > end_date时返回报错.
# fnd_get_dividend - 查询基金分红信息
查询指定基金在一段时间内的分红信息
函数原型：
DataArray<FndDividendInfo>* fnd_get_dividend(const char *symbol, const char *start_date, const char *end_date);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol], 如：SZSE.159919 |
| start_date | str | 开始时间 | Y | 无 | 必填，开始时间日期（场内除息日），%Y-%m-%d 格式 |
| end_date | str | 结束时间 | Y | 无 | 必填，结束时间日期（场内除息日），%Y-%m-%d 格式 |
返回值：
FndDividendInfo 结构数组，参见FndDividendInfo定义与DataArray类的用法。
示例：
fnd_get_dividend("SHSE.510300", "2021-1-1", "2023-1-1")
# fnd_get_split - 查询基金拆分折算信息
查询指定基金在一段时间内的拆分折算信息
函数原型：
DataArray<FndSplitInfo>* fnd_get_split(const char *symbol, const char *start_date, const char *end_date);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol]，如：SZSE.159919 |
| start_date | str | 开始时间 | Y | 无 | 必填，开始时间日期（场内除权日），%Y-%m-%d 格式 |
| end_date | str | 结束时间 | Y | 无 | 必填，结束时间日期（场内除权日），%Y-%m-%d 格式 |
返回值：
FndSplitInfo 结构数组，参见FndSplitInfo定义与DataArray类的用法。
示例：
fnd_get_split("SZSE.161725", "2000-01-01", "2022-09-07")
# fnd_get_split - 查询基金规模数据
查询基金规模数据
函数原型：
DataArray<FndShareRecord>* fnd_get_share(const char *fund, const char *start_date = NULL, const char *end_date = NULL)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 基金代码 | Y | 无 | 必填，只能输入一个基金的[symbol]，如：SZSE.159919 |
| start_date | str | 开始时间 | N | NULL | 开始时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间 |
| end_date | str | 结束时间 | N | NULL | 结束时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间 |
返回值：
FndShareRecord 结构数组，参见FndShareRecord定义与DataArray类的用法。
示例：
fnd_get_share("SZSE.161725")