joinquant 股票行业查询：get_industry 函数返回值结构与解析

在 JoinQuant（聚宽）量化交易平台中，get_industry 函数用于查询指定股票在某一特定日期所所属的行业分类信息。

一、get_industry 返回值结构

get_industry 函数返回一个 Python 字典（dict）：

• Key（键）：标的代码（如 '000001.XSHE'）。
• Value（值）：包含该股票在多种分类标准下行业信息的嵌套字典。

行业分类字段说明

每个标的对应的嵌套字典中，包含以下多套行业分类体系：

二、返回值 JSON 结构示例

以查询 '000001.XSHE'（平安银行）和 '000002.XSHE'（万科A）在 2018-06-01 的行业信息为例，返回结果结构如下：

{
  '000001.XSHE': {
    'jq_l1': {'industry_code': 'HY007', 'industry_name': '金融指数'},
    'jq_l2': {'industry_code': 'HY493', 'industry_name': '多元化银行指数'},
    'sw_l1': {'industry_code': '801780', 'industry_name': '银行I'},
    'sw_l2': {'industry_code': '801192', 'industry_name': '银行II'},
    'sw_l3': {'industry_code': '851911', 'industry_name': '银行III'},
    'zjw': {'industry_code': 'J66', 'industry_name': '货币金融服务'}
  },
  '000002.XSHE': {
    'jq_l1': {'industry_code': 'HY011', 'industry_name': '房地产指数'},
    'jq_l2': {'industry_code': 'HY509', 'industry_name': '房地产开发指数'},
    'sw_l1': {'industry_code': '801180', 'industry_name': '房地产I'},
    'sw_l2': {'industry_code': '801181', 'industry_name': '房地产开发II'},
    'sw_l3': {'industry_code': '851811', 'industry_name': '房地产开发III'},
    'zjw': {'industry_code': 'K70', 'industry_name': '房地产业'}
  }
}

三、Python 使用示例

在 JoinQuant 策略或研究环境中，可以通过如下代码获取并解析股票的行业分类：

# 查询指定股票在指定日期的行业信息
res = get_industry(security=['000001.XSHE', '000002.XSHE'], date='2018-06-01')

# 获取平安银行的申万一级行业名称
payh_sw1 = res['000001.XSHE']['sw_l1']['industry_name']
print(f'平安银行申万一级行业：{payh_sw1}') # 输出：银行I

# 获取万科A的证监会行业代码
wka_zjw_code = res['000002.XSHE']['zjw']['industry_code']
print(f'万科A证监会行业代码：{wka_zjw_code}') # 输出：K70

四、注意事项

1. 时间参数说明：date 参数支持字符串（YYYY-MM-DD）或 datetime 对象。若传入 datetime，其时分秒部分会被忽略。
2. 默认日期：在研究环境中 date 默认为当天，在回测环境中 date 默认随回测逻辑时间 context.current_dt 动态变化。
3. Python 2 格式化输出提示：若在 Python 2 环境中使用 print 打印包含中文的字典，可使用 print(repr(res).decode("unicode-escape")) 进行解码显示。