Question

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_dat < 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_dat < 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_dat < 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")

---