# 通用数据函数（免费）
C++ 通用数据 API 包含在 3.5.18 版本及以上版本，不需要引入新库
# get_symbol_infos - 查询标的基本信息
获取指定(范围)交易标的基本信息，与时间无关.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<SymbolInfo>* get_symbol_infos(long long sec_type1, long long sec_type2 = 0, const char *exchanges = NULL, const char *symbols = NULL)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| sec_type1 | int | 证券品种大类 | Y | 无 | 指定一种证券大类，只能输入一个. 证券大类 sec_type1 清单 1010: 股票， 1020: 基金， 1030: 债券 ， 1040: 期货， 1050: 期权， 1060: 指数，1070：板块. |
| sec_type2 | int | 证券品种细类 | N | 0 | 指定一种证券细类，只能输入一个. 默认0表示不区分细类，即证券大类下所有细类. 证券细类见 sec_type2 清单 - 股票 101001:A 股，101002:B 股，101003:存托凭证 - 基金 102001:ETF，102002:LOF，102005:FOF - 债券 103001:可转债，103008:回购 - 期货 104001:股指期货，104003:商品期货，104006:国债期货 - 期权 105001:股票期权，105002:指数期权，105003:商品期权 - 指数 106001:股票指数，106002:基金指数，106003:债券指数，106004:期货指数 - 板块：107001:概念板块 |
| exchanges | str | 交易所代码 | N | NULL | 输入交易所代码，可输入多个. 采用 str 格式时，多个交易所代码必须用英文逗号分割，如："SHSE,SZSE" 默认NULL表示所有交易所. 交易所代码清单 SHSE:上海证券交易所，SZSE:深圳证券交易所 ， CFFEX:中金所，SHFE:上期所，DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心 ，GFEX:广期所 |
| symbols | str | 标的代码 | N | NULL | 输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" 默认NULL表示所有标的. |
|
返回值：
SymbolInfo 结构数组，参见SymbolInfo定义与DataArray类的用法。
示例：
get_symbol_infos(1010, 0, NULL, "SHSE.600008,SZSE.000002")
注意：
1. sec_type1为必填参数，即一次只能查询一个品种的标的基本信息。
2. 查询的标的信息根据参数组合sec_type1, sec_type2, exchanges, symbols取交集，若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空)，则返回空
3. 若输入包含无效标的代码symbols，则返回只包含有效标的代码对应的数据。
4. 参数组合示例：
| 查询以下范围 symbol 的基本信息 | sec_type1 | sec_type2 | exchanges | symbols |
|---|---|---|---|---|
| 查询指定股票 | 1010 | 0 | NULL | "SHSE.600008,SZSE.000002" |
| 查询 A 股股票 | 1010 | 101001 | NULL | NULL |
| 查询深交所股票 | 1010 | 0 | "SZSE" | NULL |
| 查询 ETF | 1020 | 102001 | NULL | NULL |
| 查询上交所 LOF | 1020 | 102002 | "SHSE" | NULL |
| 查询可转债 | 1030 | 103001 | NULL | NULL |
| 查询深交所可转债 | 1030 | 103001 | "SZSE" | NULL |
| 查询股指期货 | 1040 | 104001 | NULL | NULL |
| 查询商品期货 | 1040 | 104003 | NULL | NULL |
| 查询郑商所和大商所期货 | 1040 | 0 | "CZCE,DCE" | NULL |
| 查询股票期权 | 1050 | 105001 | NULL | NULL |
| 查询上交所股票期权 | 1050 | 105001 | "SHSE" | NULL |
| 查询指数期权 | 1050 | 105002 | NULL | NULL |
| 查询商品期权 | 1050 | 105003 | NULL | NULL |
| 查询上期所商品期权 | 105003 | 0 | "SHFE" | NULL |
| 查询股票指数 | 1060 | 106001 | NULL | NULL |
# get_symbols_by_date - 查询指定交易日多标的交易信息
获取指定交易日多个标的交易信息，包括基本信息及日度数据.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<SymbolContent>* get_symbols_by_date(long long sec_type1, long long sec_type2 = 0, const char *exchanges = NULL, const char *symbols = NULL, bool skip_suspended = true, bool skip_st = true, const char *trade_date = NULL);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| sec_type1 | int | 证券品种大类 | Y | 无 | 指定一种证券大类，只能输入一个. 证券大类 sec_type1 清单 1010: 股票， 1020: 基金， 1030: 债券 ， 1040: 期货， 1050: 期权， 1060: 指数，1070：板块. |
| sec_type2 | int | 证券品种细类 | N | 0 | 指定一种证券细类，只能输入一个. 默认0表示不区分细类，即证券大类下所有细类. 证券细类见 sec_type2 清单 - 股票 101001:A 股，101002:B 股，101003:存托凭证 - 基金 102001:ETF，102002:LOF，102005:FOF - 债券 103001:可转债，103008:回购 - 期货 104001:股指期货，104003:商品期货，104006:国债期货 - 期权 105001:股票期权，105002:指数期权，105003:商品期权 - 指数 106001:股票指数，106002:基金指数，106003:债券指数，106004:期货指数 - 板块：107001:概念板块 |
| exchanges | str | 交易所代码 | N | NULL | 输入交易所代码，可输入多个. 采用 str 格式时，多个交易所代码必须用英文逗号分割，如："SHSE,SZSE" 默认NULL表示所有交易所. 交易所代码清单 SHSE:上海证券交易所，SZSE:深圳证券交易所 ， CFFEX:中金所，SHFE:上期所，DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心 ，GFEX:广期所 |
| symbols | str | 标的代码 | N | NULL | 输入标的代码，可输入多个. 采用 str 格式时，多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" 默认NULL表示所有标的. |
| skip_suspended | bool | 跳过停牌 | N | true | 是否跳过全天停牌，默认true跳过 |
| skip_st | bool | 跳过 ST | N | true | 是否跳过包含 ST 的股票：ST, *ST, SST, S*ST, 默认true跳过 |
| trade_date | str | 交易日期 | N | NULL | 交易日期，%Y-%m-%d 格式，默认NULL取最新截面(包含退市标的) |
返回值：
SymbolContent 结构数组，参见SymbolContent定义与DataArray类的用法。
示例：
get_symbols_by_date(sec_type1=1010, 0, NULL, "SHSE.600008,SZSE.000002")
注意：
1. sec_type1为必填参数，即一次只能查询一个品种的标的最新交易日信息。
2. 查询的标的信息根据参数组合sec_type1, sec_type2, exchanges, symbols取交集，若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空)，则返回空
3. 若输入包含无效标的代码symbols，则返回只包含有效标的代码对应的数据。
4. 获取全 A 股票代码示例get_symbols(1010, 101001)
5. 可转债的到期日(退市日期)为delisted_date，转股价值为转股价值 = 转股数*股价 = (100/可转债转股价) * 股价
# get_history_symbol - 查询指定标的多日交易信息
获取指定标的多个历史交易日的交易信息，包括基本信息及日度数据.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<SymbolContent>* get_history_symbol(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | str | 标的代码 | Y | 无 | 输入标的代码，只能输入一个. |
| start_date | str | 开始时间 | N | NULL | 开始时间日期，%Y-%m-%d 格式，默认NULL表示当前时间 |
| end_date | str | 结束时间 | N | NULL | 结束时间日期，%Y-%m-%d 格式，默认NULL表示当前时间 |
返回值：
SymbolContent 结构数组，参见SymbolContent定义与DataArray类的用法。
示例：
get_history_symbol("SZSE.000002", "2022-09-01", "2022-09-30")
注意：
1. 若输入包含无效标的代码symbol，则返回只包含有效标的代码对应的数据。
2. 停牌时且股票发生除权除息，涨停价和跌停价可能有误差。
3. 对每个标的，数据根据trade_date的升序进行排序。
4. start_date和end_date中月份和日期都可以只输入个位数，例:"2010-7-8"或"2017-7-30"
5. 当start_date大于或者等于 end_date 时, 取指定时间段的数据,当 start_date > end_date时, 返回报错
6. 可转债的到期日(退市日期)delisted_date，转股价值为转股价值 = 转股数*股价 = (100/可转债转股价) * 股价
# get_trading_dates_by_year - 查询年度交易日历
查询一个交易所的指定年份的交易日历.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<TradingDateContent>* get_trading_dates_by_year(const char *exchange, int start_year, int end_year);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| exchange | str | 交易所代码 | Y | 无 | 只能填写一个交易所代码 交易所代码清单: SHSE:上海证券交易所，SZSE:深圳证券交易所，CFFEX:中金所，SHFE:上期所，DCE:大商所，CZCE:郑商所，INE:上海国际能源交易中心，GFEX:广期所 |
| start_year | int | 开始年份 | Y | 无 | 查询交易日历开始年份（含），yyyy 格式 |
| end_year | int | 结束年份 | Y | 无 | 查询交易日历结束年份（含），yyyy 格式 |
**返回值:
TradingDateContent 结构数组，参见TradingDateContent定义与DataArray类的用法。
示例：
get_trading_dates_by_year("SHSE", 2020, 2023)
注意：
1. exchange参数仅支持输入单个交易所代码，若代码错误，会报错
2. 开始年份必须不晚于结束年份，否则返回空
# get_previous_n_trading_dates - 查询指定日期的前n个交易日
查询一个交易所指定日期的前n个交易日
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增
函数原型：
DataArray<TradingDate>* get_previous_n_trading_dates(const char *exchange, const char *date, int n)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| exchange | str | 交易所代码 | Y | 无 | 只能填写一个交易所代码，交易所代码清单： SHSE:上海证券交易所，SZSE:深圳证券交易所，CFFEX:中金所，SHFE:上期所，DCE:大商所，CZCE:郑商所，INE:能源中心，GFEX:广期所 |
| date | str | 指定日期 | Y | 无 | 指定的基准日期T，%Y-%m-%d 格式 |
| n | int | 交易日个数 | N | 无 | 前n个交易日，默认为1，即前一天，取值范围[1，支持的最早交易日至当前交易日个数-1] |
返回值：
TradingDate 结构数组，参见TradingDate定义与DataArray类的用法。
get_previous_n_trading_dates("SHSE", "2023-10-10", 10)
注意：
1. exchange参数仅支持输入单个交易所代码。
2. n必须为非零正整数，n=0时会报错，n超出最早支持的交易日时只会返回至最早交易日。
3. 获取date前N个交易日，不包括date日期。
# get_next_n_trading_dates - 查询指定日期的后n个交易日
查询一个交易所指定日期的后n个交易日
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准, gm SDK 3.6.14 版本新增
函数原型：
DataArray<TradingDate>* get_next_n_trading_dates(const char *exchange, const char *date, int n)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| exchange | str | 交易所代码 | Y | 无 | 只能填写一个交易所代码，交易所代码清单： SHSE:上海证券交易所，SZSE:深圳证券交易所，CFFEX:中金所，SHFE:上期所，DCE:大商所，CZCE:郑商所，INE:能源中心，GFEX:广期所 |
| date | str | 指定日期 | Y | 无 | 指定的基准日期T，%Y-%m-%d 格式 |
| n | int | 交易日个数 | N | 无 | 前n个交易日，默认为1，即前一天，取值范围[1，支持的最早交易日至当前交易日个数-1] |
返回值：
TradingDate 结构数组，参见TradingDate定义与DataArray类的用法。
get_next_n_trading_dates("SHSE", "2023-09-27", 10)
注意：
1. exchange参数仅支持输入单个交易所代码。
2. n必须为非零正整数，n=0时会报错，n超出最早支持的交易日时只会返回至最早交易日。
3. 获取date前N个交易日，不包括date日期。
# get_trading_session - 查询交易时段
查询一个标的所属品种交易时间段.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<TradingSession>* get_trading_session(const char *symbols);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | str | 标的代码 | Y | 无 | 输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" |
返回值：
TradingSession 结构数组，参见TradingSession定义与DataArray类的用法。
示例：
get_trading_session("SHFE.au2306")
注意：
1. 如果输入不存在的合约代码 symbol，会报错提示"该合约[symbol]不存在"。
# get_contract_expire_rest_days - 查询合约到期剩余天数
查询期货合约、期权合约、可转债的到期剩余天数。
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
DataArray<ContractExpireRestDays>* get_contract_expire_rest_days(const char *symbols, const char *start_date, const char *end_date, bool trade_flag = false);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | str | 标的代码 | Y | 无 | 输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："CFFEX.IF2212,CFFEX.IC2212" |
| start_date | str | 开始日期 | Y | 无 | %Y-%m-%d 格式，不早于合约上市日 |
| end_date | str | 结束日期 | Y | 无 | %Y-%m-%d 格式，不早于指定的开始日期，否则返回报错 |
| trade_flag | bool | 交易日 | N | false | 是否需要按交易日计算，默认false按自然日计算，则返回到期剩余自然日天数; 设置为true按交易日计算，则返回到期剩余交易日天数 |
返回值：
ContractExpireRestDays 结构数组，参见ContractExpireRestDays定义与DataArray类的用法。
示例：
get_contract_expire_rest_days("CFFEX.IM2212", "2022-12-12", "2022-12-16", true)
注意：
1. 参数start_date和end_date必须是yyyy-mm-dd字符串格式
2. 在到期日当天，到期剩余天数为 0。正数表示距离到期日的剩余天数，0 表示到期日当天，负数表示距离到期日已经过去的天数。
3. 如果输入不存在的合约代码symbol，会报错提示"该合约[symbol]不存在"。
4. 如果输入的合约代码symbol在时间段内的某个日期未上市，在该日期的到期剩余天数返回空。
5. 用于剩余天数计算的到期日是最后交易日。