数据查询函数

数据查询函数

current - 查询当前行情快照

查询当前行情快照，返回tick数据。回测时，返回回测时间点的tick数据

函数原型:

DataArray<Tick>* current(const char *symbols);

参数：

示例：

DataArray<Tick>* current_data = current('SZSE.000001,SZSE.000002');

注意：

1.start_time和end_time中月,日,时,分,秒均可以只输入个位数,例:'2010-7-8 9:40:0'或'2017-7-30 12:3:0',但若对应位置为零，则0不可被省略,如不可输入'2017-7-30 12:3: '

history_ticks - 查询历史Tick行情

函数原型:

DataArray<Tick>* history_ticks(const char *symbols, const char *start_time, const char *end_time, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

示例：

DataArray<Tick>* history_tick = history_ticks(symbol='SHSE.000300', start_time='2010-07-28',  end_time='2017-07-30')

注意：

1.start_time和end_time中月,日,时,分,秒均可以只输入个位数,例:'2010-7-8 9:40:0'或'2017-7-30 12:3:0',但若对应位置为零，则0不可被省略,如不可输入'2017-7-30 12:3: '

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回33000, 超出部分不返回

history_bars - 查询历史Bar行情

函数原型:

 DataArray<Bar>* history_bars(const char *symbols, const char *frequency, const char *start_time, const char *end_time, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

示例：

//获取1分钟的bar
DataArray<Bar>* history_bar = history_bars(symbol='SHSE.000300', '60s', start_time='2010-07-28',  end_time='2017-07-30');

//获取60分钟的bar
DataArray<Bar>* history_bar = history_bars(symbol='SHSE.000300', '3600s', start_time='2010-07-28',  end_time='2017-07-30');

//获取日线
DataArray<Bar>* history_bar = history_bars(symbol='SHSE.000300', '1d', start_time='2010-07-28',  end_time='2018-07-30');

注意：

1.start_time和end_time中月,日,时,分,秒均可以只输入个位数,例:'2010-7-8 9:40:0'或'2017-7-30 12:3:0',但若对应位置为零，则0不可被省略,如不可输入'2017-7-30 12:3: '

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回33000, 超出部分不返回

history_ticks_n - 查询最新n条Tick行情

函数原型:

DataArray<Tick>* history_ticks_n(const char *symbols, int n, const char *end_time = NULL, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

示例：

//获取沪深300最新10条tick
DataArray<Tick>* history_tick_n = history_ticks_n(symbol='SHSE.000300', 10);

注意：

1.end_time中月,日,时,分,秒均可以只输入个位数,例:'2010-7-8 9:40:0'或'2017-7-30 12:3:0',但若对应位置为零，则0不可被省略,如不可输入'2017-7-30 12:3: '

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回33000, 超出部分不返回

history_bars_n - 查询最新n条Bar行情

函数原型:

DataArray<Bar>* history_bars_n(const char *symbols, const char *frequency, int n, const char *end_time = NULL, int adjust = 0, const char *adjust_end_time = NULL, bool skip_suspended = true, const char *fill_missing = NULL);

参数：

示例：

//获取沪深300最新10条1分钟bar
DataArray<Bar>* history_bars_n = history_bars_n(symbol='SHSE.000300', 60s, 10);

注意：

1.end_time中月,日,时,分,秒均可以只输入个位数,例:'2010-7-8 9:40:0'或'2017-7-30 12:3:0',但若对应位置为零，则0不可被省略,如不可输入'2017-7-30 12:3: '

2. skip_suspended 和 fill_missing 参数暂不支持

3. 单次返回数据量最大返回33000, 超出部分不返回

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)

参数：

返回值：

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. 参数组合示例：

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);

参数：

返回值：

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);

参数：

返回值：

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);

参数：

**返回值:

TradingDateContent 结构数组，参见TradingDateContent定义与DataArray类的用法。

示例：

get_trading_dates_by_year("SHSE", 2020, 2023)

注意：

1. exchange参数仅支持输入单个交易所代码，若代码错误，会报错

2. 开始年份必须不晚于结束年份，否则返回空

get_previous_n_trading_dates - 查询指定日期的前n个交易日

查询一个交易所指定日期的前n个交易日

函数原型：

DataArray<TradingDate>* get_previous_n_trading_dates(const char *exchange, const char *date, int n)

参数：

返回值：

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个交易日

函数原型：

DataArray<TradingDate>* get_next_n_trading_dates(const char *exchange, const char *date, int n)

参数：

返回值：

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);

参数：

返回值：

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);

参数：

返回值：

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. 用于剩余天数计算的到期日是最后交易日。

stk_get_index_constituents - 查询指数成分股

查询指定指数在最新交易日的成分股和权重

函数原型：

DataArray<StkIndexConstituent>* stk_get_index_constituents(const char *symbol, const char *trade_date = NULL);

参数：

返回值：

StkIndexConstituent 结构数组，参见StkIndexConstituent定义与DataArray类的用法。

示例：

stk_get_index_constituents("SHSE.000300")

注意：

1. 数据日频更新，在交易日约 20 点更新当日数据。如果当日数据尚未更新，调用时不指定trade_date会返回前一交易日的成分数据，调用时指定trade_date为当日会返回空。

2. trade_date输入非交易日，会返回空。trade_date出入的日期格式错误，会报错。

3. 指数列表参考

stk_get_fundamentals_balance - 查询资产负债表数据

查询指定时间段某一股票所属上市公司的资产负债表数据

函数原型：

DataSet* stk_get_fundamentals_balance(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_fundamentals_balance("SHSE.600000", "lt_eqy_inv")

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

资产负债表

stk_get_fundamentals_cashflow - 查询现金流量表数据

查询指定时间段某一股票所属上市公司的现金流量表数据

函数原型：

DataSet* stk_get_fundamentals_cashflow(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_fundamentals_cashflow("SHSE.600000", "cash_pay_fee")

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

现金流量表

stk_get_fundamentals_income - 查询利润表数据

查询指定时间段某一股票所属上市公司的利润表数据

函数原型：

DataSet* stk_get_fundamentals_income(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_fundamentals_income("SHSE.600000", "inc_oper")

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

利润表

stk_get_fundamentals_balance_pt - 查询资产负债表截面数据（多标的）

查询指定日期截面的股票所属上市公司的资产负债表数据（point-in-time）

函数原型：

DataSet* stk_get_fundamentals_balance_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_fundamentals_balance_pt("SHSE.600000,SZSE.000001", "fix_ast")

注意：

1. 为避免未来数据问题，指定查询日期date后，返回距离此日期最近发布的一条数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_fundamentals_cashflow_pt - 查询现金流量表截面数据（多标的）

查询指定日期截面的股票所属上市公司的现金流量表数据（point-in-time）

函数原型：

DataSet* stk_get_fundamentals_cashflow_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_fundamentals_cashflow_pt("SHSE.600000, SZSE.000001", "cash_pay_fee")

注意：

1. 为避免未来数据问题，指定查询日期date后，返回距离此日期最近发布的一条数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 无效”。

stk_get_fundamentals_income_pt - 查询利润表截面数据（多标的）

查询指定日期截面的股票所属上市公司的利润表数据（point-in-time）

函数原型：

DataSet* stk_get_fundamentals_income_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_fundamentals_income_pt("SHSE.600000, SZSE.000001", "inc_oper")

注意：

1. 为避免未来数据问题，指定查询日期date后，返回距离此日期最近发布的一条数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_finance_prime - 查询财务主要指标数据

查询指定时间段股票所属上市公司的财务主要指标

函数原型：

DataSet* stk_get_finance_prime(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_finance_prime("SHSE.600000", "eps_basic,eps_dil")

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

财务主要指标

stk_get_finance_deriv - 查询财务衍生指标数据

查询指定时间段股票所属上市公司的财务衍生指标

函数原型：

DataSet* stk_get_finance_deriv(const char *symbol, const char *fields, int rpt_type = 0, int data_type = 0, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_finance_deriv("SHSE.600000", "eps_basic,eps_dil2,eps_dil,eps_basic_cut", 9)

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

财务衍生指标指标

stk_get_daily_valuation - 查询估值指标每日数据

查询指定时间段股票的每日估值指标

函数原型：

DataSet* stk_get_daily_valuation(const char *symbol, const char *fields, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_daily_valuation("SHSE.600000", "pe_ttm,pe_lyr,pe_mrq")

注意：

1. 当start_date == end_date时，取离 end_date 最近交易日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 如果fields参数的指标字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

估值指标

stk_get_daily_mktvalue - 查询市值指标每日数据

查询指定时间段股票的每日市值指标

函数原型：

DataSet* stk_get_daily_mktvalue(const char *symbol, const char *fields, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_daily_mktvalue("SHSE.600000", "tot_mv,tot_mv_csrc,a_mv")

注意：

1. 当start_date == end_date时，取离 end_date 最近交易日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 如果fields参数的指标字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

市值指标

stk_get_daily_basic - 查询基础指标每日数据

查询指定时间段股票的每日基础指标

函数原型：

DataSet* stk_get_daily_basic(const char *symbol, const char *fields, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_daily_basic("SHSE.600000", "tclose,turnrate,ttl_shr,circ_shr")

注意：

1. 当start_date == end_date时，取离 end_date 最近交易日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

基础指标

stk_get_finance_prime_pt - 查询财务主要指标截面数据（多标的）

查询指定日期截面上，股票所属上市公司的财务主要指标数据（point-in-time）

函数原型：

DataSet* stk_get_finance_prime_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_finance_prime_pt("SZSE.000001,SZSE.300002", "eps_basic,eps_dil")

注意：

1. 为避免未来数据问题，指定查询日期date后，返回距离此日期最近发布的一条数据。 若多个报告期报表的最新发布日期相同，返回报告日期rpt_date距离查询日期date最近的一个报告期的报表数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_finance_deriv_pt - 查询财务衍生指标截面数据（多标的）

查询指定日期截面上，股票所属上市公司的财务衍生指标数据（point-in-time）

函数原型：

DataSet* stk_get_finance_deriv_pt(const char *symbols, const char *fields, int rpt_type = 0, int data_type = 0, const char *date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_finance_deriv_pt("SZSE.000001,SZSE.300002", "eps_basic,eps_dil2")

注意：

1. 为避免未来数据问题，指定查询日期date后，返回距离此日期最近发布的一条数据。 若多个报告期报表的最新发布日期相同，返回报告日期rpt_date距离查询日期date最近的一个报告期的报表数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_valuation_pt - 查询估值指标单日截面数据（多标的）

查询指定日期截面上，股票的单日估值指标（point-in-time）

函数原型：

DataSet* stk_get_daily_valuation_pt(const char *symbols, const char *fields, const char *trade_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_daily_valuation_pt("SZSE.000001,SZSE.300002", "pe_ttm,pe_lyr,pe_mrq")

注意：

1. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_mktvalue_pt - 查询市值指标单日截面数据（多标的）

查询指定日期截面上，股票的单日截面数据（point-in-time）

函数原型：

DataSet* stk_get_daily_mktvalue_pt(const char *symbols, const char *fields, const char *trade_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_daily_mktvalue_pt("SZSE.000001,SZSE.300002", "tot_mv,tot_mv_csrc,a_mv")

注意：

1. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_basic_pt - 查询基础指标单日截面数据（多标的）

查询指定日期截面上，股票的单日市值指标（point-in-time）

函数原型：

DataSet* stk_get_daily_basic_pt(const char *symbols, const char *fields, const char *trade_date = NULL);

参数：

返回值：

一个结果集，参见DataSet类的用法，结果集中返回字段如下：

示例：

stk_get_daily_basic_pt("SZSE.000001,SZSE.300002", "tclose,turnrate,ttl_shr")

注意：

1. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_industry_category - 查询行业分类

查询指定行业来源的行业列表

函数原型：

DataArray<StkIndustryCategory>* stk_get_industry_category(const char *source = NULL, int level = 0);

参数：

返回值：

StkIndustryCategory 结构数组，参见StkIndustryCategory定义与DataArray类的用法。

示例：

stk_get_industry_category("sw2021", 2)

注意：

1. 证监会行业分类 2012 没有三级行业，若输入source="zjh2012", level=3则参数无效，返回空

stk_get_industry_constituents - 查询行业成分股

查询指定某个行业的成分股

函数原型：

DataArray<StkIndustryConstituent>* stk_get_industry_constituents(const char *industry_code, const char *date = NULL);

参数：

返回值：

StkIndustryConstituent 结构数组，参见StkIndustryConstituent定义与DataArray类的用法。

示例：

stk_get_industry_constituents("A", "2022-09-05")

注意：

1. 只能指定一个行业代码查询成分股。

stk_get_symbol_industry - 查询股票的所属行业

查询指定股票所属的行业

函数原型：

DataArray<StkSymbolIndustry>* stk_get_symbol_industry(const char *symbols, const char *source = NULL, int level = 0, const char *date = NULL);

参数：

返回值：

StkSymbolIndustry 结构数组，参见StkSymbolIndustry定义与DataArray类的用法。

示例：

stk_get_symbol_industry("SHSE.600000, SZSE.000002", "zjh2012", 1)

注意：

1. 证监会行业分类 2012 没有三级行业，若输入source="zjh2012", level=3则参数无效，返回空

stk_get_sector_category - 查询板块分类

查询指定类型的板块列表

函数原型：

DataArray<StkSectorCategory>* stk_get_sector_category(const char *sector_type);

参数：

返回值：

StkSectorCategory 结构数组，参见StkSectorCategory定义与DataArray类的用法。

示例：

stk_get_sector_category("1003")

stk_get_sector_constituents - 查询板块成分股

查询指定某个板块的成分股

函数原型：

DataArray<StkSectorConstituent>* stk_get_sector_constituents(const char *sector_code);

参数：

返回值：

StkSectorConstituent 结构数组，参见StkSectorConstituent定义与DataArray类的用法。

示例：

stk_get_sector_constituents("007089")

注意：

1. 只能指定一个板块代码查询成分股。

stk_get_symbol_sector - 查询股票的所属板块

查询指定股票所属的板块

函数原型：

DataArray<StkSymbolSector>* stk_get_symbol_sector(const char *symbols, const char *sector_type);

参数：

返回值：

StkSectorConstituent 结构数组，参见StkSectorConstituent定义与DataArray类的用法。

示例：

stk_get_symbol_sector("SHSE.600008,SZSE.000002", "1002")

stk_get_dividend - 查询股票分红送股信息

查询指定股票在一段时间内的分红送股信息

函数原型：

DataArray<StockDividend>* stk_get_dividend(const char *symbol, const char *start_date, const char *end_date);

参数：

返回值：

StockDividend 结构数组，参见StockDividend定义与DataArray类的用法。

示例：

stk_get_dividend("SHSE.600000", "2022-07-01", "2022-07-31")

注意：

1. 当start_date小于或等于end_date 时取指定时间段的数据,当start_date>end_date时返回报错.

stk_get_ration - 查询股票配股信息

查询指定股票在一段时间内的配股信息

函数原型：

DataArray<StkRation>* stk_get_ration(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

StkRation 结构数组，参见StkRation定义与DataArray类的用法。

示例：

stk_get_ration("SZSE.000728", "2005-01-01", "2022-09-30")

注意：

1. 当start_date 小于或等于 end_date 时取指定时间段的数据,当start_date > end_date时返回报错.

stk_get_adj_factor - 查询股票的复权因子

查询某只股票在一段时间内的复权因子

函数原型：

DataArray<StkAdjFactor>* stk_get_adj_factor(const char *symbol, const char *start_date = NULL, const char *end_date = NULL, const char *base_date = NULL);

参数：

返回值：

StkAdjFactor 结构数组，参见StkAdjFactor定义与DataArray类的用法。

示例：

stk_get_adj_factor("SZSE.000651", "2015-01-01", "2022-09-01")

注意：

1. T+1 日复权因子会二次更新，分别约在 T 日 19:00 和 T+1 日 19:00 更新

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时返回报错.

stk_get_shareholder_num - 查询股东户数

查询上市公司股东总数，A 股股东、B 股股东、H 股股东总数

函数原型：

DataArray<StkShareholderNum>* stk_get_shareholder_num(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

StkShareholderNum 结构数组，参见StkShareholderNum定义与DataArray类的用法。

示例：

stk_get_shareholder_num("SZSE.002594", "2022-01-01", "2022-08-01")

注意：

当start_date == end_date时，取离end_date最近公告日期的一条数据， 当start_dat < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

stk_get_top_shareholder - 查询十大股东

查询上市公司前十大股东的持股情况，包括持股数量，所持股份性质等

函数原型：

DataArray<StkShareholder>* stk_get_top_shareholder(const char *symbol, const char *start_date = NULL, const char *end_date = NULL, bool tradable_holder = false);

参数：

返回值：

StkShareholder 结构数组，参见StkShareholder定义与DataArray类的用法。

示例：

stk_get_top_shareholder("SHSE.603906", "2022-06-01", "2022-08-01")

注意：

当start_date == end_date时，取离end_date最近公告日期的一条数据， 当start_dat < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

stk_get_share_change - 查询股本变动

查询上市公司的一段时间内公告的股本变动情况

函数原型：

DataArray<StkShareChange>* stk_get_share_change(const char *symbol, const char *start_date = NULL, const char *end_date = NULL);

参数：

返回值：

StkShareChange 结构数组，参见StkShareChange定义与DataArray类的用法。

示例：

stk_get_share_change("SHSE.605090", "2020-01-01", "2022-10-01")

注意：

当start_date == end_date时，取离end_date最近发布日期的一条数据， 当start_dat < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

stk_abnor_change_stocks - 查询龙虎榜股票数据

查询指定时间段龙虎榜股票数据

函数原型：

DataArray<StkAbnorChangeStocks>* stk_abnor_change_stocks(const char *symbols = NULL, const char *change_types = NULL, const char *trade_date = NULL);

参数：

返回值：

StkAbnorChangeStocks 结构数组，参见StkAbnorChangeStocks定义与DataArray类的用法。

示例：

stk_abnor_change_stocks(NULL, "106")

输出：

注意：

1. 数据日频更新，在交易日约20点更新当日数据。如果当前交易日数据尚未更新，调用时不指定trade_date会返回前一交易日的数据，调用时指定trade_date为当前交易日会返回空。

2. trade_date输入非交易日，会返回空。

stk_abnor_change_detail - 查询龙虎榜营业部数据

查询指定时间段龙虎榜营业数据

函数原型：

DataArray<StkAbnorChangeDetail>* stk_abnor_change_detail(const char *symbols = NULL, const char *change_types = NULL, const char *trade_date = NULL)

参数：

返回值：

StkAbnorChangeDetail 结构数组，参见StkAbnorChangeDetail定义与DataArray类的用法。

示例：

stk_abnor_change_detail("SZSE.300799", NULL, "2024-01-23")

注意：

1. 数据日频更新，在交易日约20点更新当日数据。如果当前交易日数据尚未更新，调用时不指定trade_date会返回前一交易日的数据，调用时指定trade_date为当前交易日会返回空。

2. trade_date输入非交易日，会返回空。

stk_quota_shszhk_infos - 查询沪深港通额度数据

查询指定时间段沪深港通额度数据

函数原型：

DataArray<StkQuotaShszhkInfos>* stk_quota_shszhk_infos(const char *types = NULL, const char *start_date = NULL, const char *end_date = NULL, int count = 0)

参数：