# 批量获取快照数据get_market_snapshot_batch
# 根据证券代码列表批量获取实时行情快照,含现价、买卖五档、内外盘、涨速等
get_market_snapshot_batch(
stock_list: list[str] = [],
field_list: list[str] = [],
return_df: bool = False
) -> Dict
1
2
3
4
5
2
3
4
5
# 输入参数
| 参数 | 是否必选 | 参数类型 | 参数说明 |
|---|---|---|---|
| stock_list | Y | list[str] | 证券代码列表,须带市场后缀,例如 ["600000.SH", "688318.SH"] |
| field_list | N | list[str] | 指定返回字段,为空 [] 返回全部字段,未知字段静默忽略 |
| return_df | N | bool | 为 True 且已安装 pandas 时返回 DataFrame(行索引为证券代码),否则返回 dict |
# 返回数据
| 数据字段 | 默认返回 | 数据类型 | 数据说明 |
|---|---|---|---|
| ItemNum | Y | str | 快照笔数 |
| LastClose | Y | str | 前收盘价 |
| Open | Y | str | 开盘价 |
| Max | Y | str | 最高价 |
| Min | Y | str | 最低价 |
| Now | Y | str | 现价 |
| Volume | Y | str | 总手 |
| NowVol | Y | str | 现手(总手差) |
| RefreshTime | Y | str | 行情刷新时间,格式 HHMMSS |
| Amount | Y | str | 总成交金额 |
| Inside | Y | str | 内盘(板块指数时为跌停家数) |
| Outside | Y | str | 外盘(板块指数时为涨停家数) |
| TickDiff | Y | str | 笔涨跌(价位差) |
| InOutFlag | Y | str | 内外盘标志:0=Buy, 1=Sell, 2=Unknown |
| Jjjz | Y | str | 基金净值 |
| Buyp | Y | List[str] | 五档买价(5 个元素) |
| Buyv | Y | List[str] | 五档买盘量(5 个元素) |
| Sellp | Y | List[str] | 五档卖价(5 个元素) |
| Sellv | Y | List[str] | 五档卖盘量(5 个元素) |
| UpHome | Y | str | 上涨家数(对指数有效) |
| DownHome | Y | str | 下跌家数(对指数有效) |
| Before5MinNow | Y | str | 5 分钟前价格 |
| Average | Y | str | 均价 |
| XsFlag | Y | str | 小数位数 |
| Zangsu | Y | str | 涨速 |
| ZAFPre3 | Y | str | 3 日涨幅 |
外层结构为 {证券代码: {字段: 值}},每个证券一条记录、键顺序与 stock_list 入参顺序一致。单只无行情时该代码的记录为空或字段返回 null。
# 接口使用
批量获取 600000.SH 与 688318.SH 的实时行情快照。
snap = tq.get_market_snapshot_batch(
stock_list=["600000.SH", "688318.SH"],
)
print(snap)
1
2
3
4
2
3
4
# 数据样本
{
"600000.SH": {
"Amount": "46996.94",
"Average": "9.08",
"Before5MinNow": "9.09",
"Buyp": ["9.07", "9.06", "9.05", "9.04", "9.03"],
"Buyv": ["4467", "11048", "7788", "5161", "4586"],
"DownHome": "0",
"InOutFlag": "2",
"Inside": "247892",
"ItemNum": "3716",
"Jjjz": "3330583.75",
"LastClose": "9.06",
"Max": "9.15",
"Min": "9.00",
"Now": "9.07",
"NowVol": "53978",
"Open": "9.05",
"Outside": "269701",
"RefreshTime": "153058",
"Sellp": ["9.08", "9.09", "9.10", "9.11", "9.12"],
"Sellv": ["2564", "1316", "2574", "5680", "6306"],
"TickDiff": "0.00",
"UpHome": "0",
"Volume": "517592",
"XsFlag": "2",
"ZAFPre3": "1.01",
"Zangsu": "-0.22"
},
"688318.SH": {
"Amount": "47346.57",
"Average": "79.40",
"Before5MinNow": "80.49",
"Buyp": ["80.50", "80.49", "80.48", "80.46", "80.44"],
"Buyv": ["5", "101", "10", "34", "20"],
"DownHome": "0",
"InOutFlag": "2",
"Inside": "26450",
"ItemNum": "3006",
"Jjjz": "35856.73",
"LastClose": "77.18",
"Max": "81.27",
"Min": "77.50",
"Now": "80.52",
"NowVol": "1027",
"Open": "78.60",
"Outside": "33178",
"RefreshTime": "153103",
"Sellp": ["80.52", "80.53", "80.55", "80.56", "80.57"],
"Sellv": ["41", "107", "12", "34", "7"],
"TickDiff": "0.00",
"UpHome": "0",
"Volume": "59628",
"XsFlag": "2",
"ZAFPre3": "9.53",
"Zangsu": "0.04"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58