# 板块
# 基础数据
目前，掘金量化支持板块基础数据查询。
| 交易所名称 | 市场代码 |
|---|---|
| 掘金板块 | BK |
# Python 数据接口
get_symbol_infos - 查询标的基本信息，获取指定(范围)交易标的基本信息，与时间无关。
get_symbols - 查询指定交易日多标的交易信息，获取指定交易日多个标的交易信息，包括基本信息及日度数据。
get_history_symbol - 查询指定标的多日交易信息，获取指定标的多个历史交易日的交易信息，包括基本信息及日度数据。
示例 1
获取提供行情数据的掘金板块列表：
get_symbol_infos(sec_type1=1070, df=True)
返回结果：
symbol sec_type1 sec_type2 exchange sec_id sec_name ...
0 BK.007001 1070 107001 BK 007001 军工 ...
1 BK.007003 1070 107001 BK 007003 煤化工 ...
2 BK.007004 1070 107001 BK 007004 新能源 ...
3 BK.007005 1070 107001 BK 007005 节能环保 ...
4 BK.007013 1070 107001 BK 007013 中字头 ...
.. ... ... ... ... ... ... ...
413 BK.007523 1070 107001 BK 007523 英伟达概念 ...
414 BK.007524 1070 107001 BK 007524 AI手机 ...
415 BK.007525 1070 107001 BK 007525 可控核聚变 ...
416 BK.007526 1070 107001 BK 007526 AIPC ...
417 BK.007527 1070 107001 BK 007527 娃哈哈概念 ...
[418 rows x 18 columns]
示例 2
获取“新能源板块”的基本数据及最新日频数据：
get_symbols(sec_type1=1070, symbols='BK.007004', df=False)
返回结果：
[{'trade_date': datetime.datetime(2024, 3, 15, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'pre_close': 1022.2467, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'upper_limit': 0.0, 'lower_limit': 0.0, 'turn_rate': 0.0, 'adj_factor': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'BK.007004', 'sec_type1': 1070, 'sec_type2': 107001, 'exchange': 'BK', 'sec_id': '007004', 'sec_name': '新能源', 'sec_abbr': 'xny', 'price_tick': 0.01, 'listed_date': datetime.datetime(2024, 1, 2, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'board': 0, 'trade_n': 0, 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}]
示例 3
获取“新能源板块”在 2024-03-13 -- 2024-03-14 的历史信息数据：
get_history_symbol(symbol='BK.007004', start_date='2024-03-13', end_date='2024-03-14', df=False)
返回结果：
[{'trade_date': datetime.datetime(2024, 3, 13, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'pre_close': 1023.6071, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'upper_limit': 0.0, 'lower_limit': 0.0, 'turn_rate': 0.0, 'adj_factor': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'BK.007004', 'sec_type1': 1070, 'sec_type2': 107001, 'exchange': 'BK', 'sec_id': '007004', 'sec_name': '新能源', 'sec_abbr': 'xny', 'price_tick': 0.01, 'listed_date': datetime.datetime(2024, 1, 2, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'board': 0, 'trade_n': 0, 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}, {'trade_date': datetime.datetime(2024, 3, 14, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'pre_close': 1024.9734, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'upper_limit': 0.0, 'lower_limit': 0.0, 'turn_rate': 0.0, 'adj_factor': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'BK.007004', 'sec_type1': 1070, 'sec_type2': 107001, 'exchange': 'BK', 'sec_id': '007004', 'sec_name': '新能源', 'sec_abbr': 'xny', 'price_tick': 0.01, 'listed_date': datetime.datetime(2024, 1, 2, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'board': 0, 'trade_n': 0, 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}]
# 其他语言数据接口
C#
C++
# 行情数据
# 实时行情数据
掘金量化目前支持获取板块的实时行情数据。（仅专业版/机构版可用）
包含 Tick 行情和 Bar 行情。
| 交易所名称 | 市场代码 |
|---|---|
| 掘金板块 | BK |
注：板块行情计算基于沪深两市股票，北交所股票不纳入板块行情的计算。
# Tick - Tick 行情
逐笔交易行情, 包含以下内容：
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | str | 标的代码 |
| open | float | 开盘价 |
| high | float | 最高价 |
| low | float | 最低价 |
| price | float | 最新价 |
| cum_volume | int | 成交总量/最新成交量,累计值 |
| cum_amount | float | 成交总金额/最新成交额,累计值 |
| trade_type | int | 交易类型 1: ‘双开’, 2: ‘双平’, 3: ‘多开’, 4: ‘空开’, 5: ‘空平’, 6: ‘多平’, 7: ‘多换’, 8: ‘空换’ |
| last_volume | int | 瞬时成交量 |
| cum_position | int | 合约持仓量(期),累计值（股票此值为 0） |
| last_amount | float | 瞬时成交额 (郑商所 last_amount 为 0) |
| created_at | datetime.datetime | 创建时间 |
| quotes | list[quote] | 股票提供买卖 1-5 档,list[0]~list[4]分别对应买卖一档到五档；跌停时无买方报价，涨停时无卖方报价 |
# Quote - 报价(dict)
| 参数名 | 类型 | 说明 |
|---|---|---|
| bid_p | float | 买价 |
| bid_v | int | 买量 |
| ask_p | float | 卖价 |
| ask_v | int | 卖量 |
# Bar - Bar 行情
支持以下多种频率的板块实时行情数据：
| 交易所名称 | 市场代码 | 数据频率 |
|---|---|---|
| 掘金板块 | BK | 60s, 300s, 900s, 1800s, 3600s |
注：s 表示“秒”。
行情包含以下数据:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | str | 标的代码 |
| frequency | str | 频率 |
| open | float | 开盘价 |
| close | float | 收盘价 |
| high | float | 最高价 |
| low | float | 最低价 |
| amount | float | 成交额 |
| volume | int | 成交量 |
| bob | datetime.datetime | bar 开始时间 |
| eob | datetime.datetime | bar 结束时间 |
# 历史行情数据
掘金量化目前支持获取板块的历史行情数据。（仅专业版/机构版可用）
包含 Tick 行情和 Bar 行情。
| 交易所名称 | 市场代码 |
|---|---|
| 掘金板块 | BK |
注：板块行情计算基于沪深两市股票，北交所股票不纳入板块行情的计算。
# Tick - Tick 行情
时间范围：最早支持2024-04-01
逐笔交易行情，包含以下内容：
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | str | 标的代码 |
| open | float | 开盘价 |
| high | float | 最高价 |
| low | float | 最低价 |
| price | float | 最新价 |
| cum_volume | int | 成交总量/最新成交量,累计值 |
| cum_amount | float | 成交总金额/最新成交额,累计值 |
| trade_type | int | 交易类型 1：‘双开’, 2：‘双平’, 3：‘多开’, 4：‘空开’, 5：‘空平’, 6：‘多平’, 7：‘多换’, 8：‘空换’ |
| last_volume | int | 瞬时成交量 |
| cum_position | int | 合约持仓量(期),累计值(股票该值为 0) |
| last_amount | float | 瞬时成交额（郑商所 last_amount 为 0） |
| created_at | datetime.datetime | 创建时间 |
| quotes | list[quote] | 股票提供买卖 1-5 档,list[0]~list[4]分别对应买卖一档到五档；跌停时无买方报价，涨停时无卖方报价 |
# Quote - 报价(dict)
| 参数名 | 类型 | 说明 |
|---|---|---|
| bid_p | float | 买价 |
| bid_v | int | 买量 |
| ask_p | float | 卖价 |
| ask_v | int | 卖量 |
# Bar - Bar 行情
支持以下多种频率的板块历史行情数据：
| 交易所名称 | 市场代码 | 频率以及数据范围 |
|---|---|---|
| 掘金板块 | BK | 60s, 300s, 900s, 1800s, 3600s(2024-04-01 - 至今), 1d(2024-04-01 - 至今), 不提供 60s 以下数据 |
注：s 表示“秒”, d 表示“天”。
行情包含以下数据:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | str | 标的代码 |
| frequency | str | 频率 |
| open | float | 开盘价 |
| close | float | 收盘价 |
| high | float | 最高价 |
| low | float | 最低价 |
| amount | float | 成交额 |
| volume | int | 成交量 |
| bob | datetime.datetime | bar 开始时间 |
| eob | datetime.datetime | bar 结束时间 |
← 指数