# 通用数据函数（免费）
C# 股票与指数数据 API 包含在 3.3.1 版本及以上版本
# GetSymbolInfos - 查询标的基本信息
获取指定(范围)交易标的基本信息，与时间无关.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
public static GMDataList<SymbolInfo> GetSymbolInfos(int secType1, int secType2 = 0, string exchanges = null, string symbols = null)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| secType1 | int | 证券品种大类 | Y | 无 | 指定一种证券大类，只能输入一个. 证券大类 secType1 清单 1010: 股票， 1020: 基金， 1030: 债券 ， 1040: 期货， 1050: 期权， 1060: 指数，1070：板块. |
| secType2 | int | 证券品种细类 | N | 0 | 指定一种证券细类，只能输入一个. 默认0表示不区分细类，即证券大类下所有细类. 证券细类见 secType2 清单 - 股票 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 | string | 交易所代码 | N | null | 输入交易所代码，可输入多个. 采用 string 格式时，多个交易所代码必须用英文逗号分割，如："SHSE,SZSE" 默认null表示所有交易所. 交易所代码清单 SHSE:上海证券交易所，SZSE:深圳证券交易所 ， CFFEX:中金所，SHFE:上期所，DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心 ，GFEX:广期所 |
| symbols | string | 标的代码 | N | null | 输入标的代码，可输入多个. 采用 string 格式时，多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" 默认null表示所有标的. |
返回值：
SymbolInfo 结构列表，参见SymbolInfo定义与GMDataList类的用法。
示例：
GetSymbolInfos(1010, 0, null, "SHSE.600008,SZSE.000002")
注意：
secType1为必填参数，即一次只能查询一个品种的标的基本信息。查询的标的信息根据参列表合
secType1, secType2, exchanges, symbols取交集，若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空)，则返回空若输入包含无效标的代码
symbols，则返回只包含有效标的代码对应的数据。参列表合示例：
| 查询以下范围 symbol 的基本信息 | secType1 | secType2 | 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 |
# GetSymbols - 查询指定交易日多标的交易信息
获取指定交易日多个标的交易信息，包括基本信息及日度数据.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
public static GMDataList<Symbol> GetSymbols(int secType1, int secType2 = 0, string exchanges = null, string symbols = null, bool skipSuspended = true, bool skipSt = true, string tradeDate = null);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| secType1 | int | 证券品种大类 | Y | 无 | 指定一种证券大类，只能输入一个. 证券大类 secType1 清单 1010: 股票， 1020: 基金， 1030: 债券 ， 1040: 期货， 1050: 期权， 1060: 指数，1070：板块. |
| secType2 | int | 证券品种细类 | N | 0 | 指定一种证券细类，只能输入一个. 默认0表示不区分细类，即证券大类下所有细类. 证券细类见 secType2 清单 - 股票 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 | string | 交易所代码 | N | null | 输入交易所代码，可输入多个. 采用 string 格式时，多个交易所代码必须用英文逗号分割，如："SHSE,SZSE" 默认null表示所有交易所. 交易所代码清单 SHSE:上海证券交易所，SZSE:深圳证券交易所 ， CFFEX:中金所，SHFE:上期所，DCE:大商所， CZCE:郑商所， INE:上海国际能源交易中心 ，GFEX:广期所 |
| symbols | string | 标的代码 | N | null | 输入标的代码，可输入多个. 采用 string 格式时，多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" 默认null表示所有标的. |
| skipSuspended | bool | 跳过停牌 | N | true | 是否跳过全天停牌，默认true跳过 |
| skipSt | bool | 跳过 ST | N | true | 是否跳过包含 ST 的股票：ST, ST, SST, SST, 默认true跳过 |
| tradeDate | string | 交易日期 | N | null | 交易日期，%Y-%m-%d 格式，默认null取最新截面(包含退市标的) |
返回值：
Symbol 结构列表，参见Symbol定义与GMDataList类的用法。
示例：
GetSymbols(secType1=1010, 0, null, "SHSE.600008,SZSE.000002")
注意：
secType1为必填参数，即一次只能查询一个品种的标的最新交易日信息。查询的标的信息根据参列表合
secType1, secType2, exchanges, symbols取交集，若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空)，则返回空若输入包含无效标的代码
symbols，则返回只包含有效标的代码对应的数据。获取全 A 股票代码示例
GetSymbols(1010, 101001)可转债的到期日(退市日期)为
delistedDate，转股价值为转股价值 = 转股数股价 = (100/可转债转股价) 股价
# GetHistorySymbol - 查询指定标的多日交易信息
获取指定标的多个历史交易日的交易信息，包括基本信息及日度数据.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
public static GMDataList<Symbol> GetHistorySymbol(string symbol, string startDate, string endDate);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbol | string | 标的代码 | Y | 无 | 输入标的代码，只能输入一个. |
| startDate | string | 开始时间 | Y | null | 开始时间日期，%Y-%m-%d 格式. |
| endDate | string | 结束时间 | Y | null | 结束时间日期，%Y-%m-%d 格式. |
返回值：
Symbol 结构列表，参见Symbol定义与GMDataList类的用法。
示例：
GetHistorySymbol("SZSE.000002", "2022-09-01", "2022-09-30")
注意：
若输入包含无效标的代码
symbol，则返回只包含有效标的代码对应的数据。停牌时且股票发生除权除息，涨停价和跌停价可能有误差。
对每个标的，数据根据
tradeDate的升序进行排序。startDate和endDate，例:'2010-7-8'或'2017-7-30'当
startDate大于或者等于endDate时, 取指定时间段的数据,当startDate>endDate时, 返回报错可转债的到期日(退市日期)
delistedDate，转股价值为转股价值 = 转股数股价 = (100/可转债转股价) 股价
# GetTradingDatesByYear - 查询年度交易日历
查询一个交易所的指定年份的交易日历.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
public static GMDataList<TradingDate> GetTradingDatesByYear(string exchange, int startYear, int endYear);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| exchange | string | 交易所代码 | Y | 无 | 只能填写一个交易所代码 交易所代码清单: SHSE:上海证券交易所，SZSE:深圳证券交易所，CFFEX:中金所，SHFE:上期所，DCE:大商所，CZCE:郑商所，INE:上海国际能源交易中心，GFEX:广期所 |
| startYear | int | 开始年份 | Y | 无 | 查询交易日历开始年份（含），yyyy 格式 |
| endYear | int | 结束年份 | Y | 无 | 查询交易日历结束年份（含），yyyy 格式 |
返回值:
TradingDate 结构列表，参见TradingDate定义与GMDataList类的用法。
示例：
GetTradingDatesByYear("SHSE", 2020, 2023)
注意：
exchange参数仅支持输入单个交易所代码，若代码错误，会报错开始年份必须不晚于结束年份，否则返回
空
# GetTradingSession - 查询交易时段
查询一个标的所属品种交易时间段.
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
public static GMDataList<TradingSession> GetTradingSession(string symbols);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | string | 标的代码 | Y | 无 | 输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："SHSE.600008,SZSE.000002" |
返回值：
TradingSession 结构列表，参见TradingSession定义与GMDataList类的用法。
示例：
GetTradingSession("SHFE.au2306")
注意：
- 如果输入不存在的合约代码 symbol，会报错提示"该合约[symbol]不存在"。
# GetContractExpireRestDays - 查询合约到期剩余天数
查询期货合约、期权合约、可转债的到期剩余天数。
此函数为掘金公版(体验版/专业版/机构版)函数，券商版以升级提示为准
函数原型：
public static GMDataList<ContractExpireRestDays> GetContractExpireRestDays(string symbols, string startDate, string endDate, bool tradeFlag = false);
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| symbols | string | 标的代码 | Y | 无 | 输入标的代码，可输入多个. 多个标的代码必须用英文逗号分割，如："CFFEX.IF2212,CFFEX.IC2212" |
| startDate | string | 开始日期 | Y | 无 | %Y-%m-%d 格式，不早于合约上市日 |
| endDate | string | 结束日期 | Y | 无 | %Y-%m-%d 格式，不早于指定的开始日期，否则返回报错 |
| tradeFlag | bool | 交易日 | N | false | 是否需要按交易日计算，默认false按自然日计算，则返回到期剩余自然日天数; 设置为true按交易日计算，则返回到期剩余交易日天数 |
返回值：
ContractExpireRestDays 结构列表，参见ContractExpireRestDays定义与GMDataList类的用法。
示例：
GetContractExpireRestDays("CFFEX.IM2212", "2022-12-12", "2022-12-16", true)
注意：
参数
startDate和endDate必须是yyyy-mm-dd字符串格式在到期日当天，到期剩余天数为 0。正数表示距离到期日的剩余天数，0 表示到期日当天，负数表示距离到期日已经过去的天数。
如果输入不存在的合约代码
symbol，会报错提示"该合约[symbol]不存在"。如果输入的合约代码
symbol在时间段内的某个日期未上市，在该日期的到期剩余天数返回空。用于剩余天数计算的到期日是最后交易日。