- 官方文档:https://tushare.pro/document/2?doc_id=214
- 功能描述:获取股票每日停复牌信息
- 返回限量:单次请求最大返回5000行
- 接口权限:2000积分:200次/分钟;5000积分:500次/分钟;
- 说明:
- 本接口记录的是股票停复牌的每日快照;
- 该接口同时也记录了公告中公布,但还未实际到达的日期事件;
输入参数:
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ts_code | str | N | 股票代码(可输入多值) |
| trade_date | str | N | 交易日日期 |
| start_date | str | N | 停复牌查询开始日期 |
| end_date | str | N | 停复牌查询结束日期 |
| suspend_type | str | N | 停复牌类型:S-停牌,R-复牌 |
输出参数:
| 名称 | 类型 | 默认显示 | 描述 |
|---|---|---|---|
| ts_code | str | Y | TS代码 |
| trade_date | str | Y | 停复牌日期(覆盖从停牌到覆盖期间的连续日期) |
| suspend_timing | str | Y | 日内停牌时间段(日内停牌才有值,否则为空值) |
| suspend_type | str | Y | 停复牌类型:S-停牌,R-复牌 |
示例:
示例1:获取某个交易日停复牌股票信息
通过传递trade_date参数可指定获取某个交易日停复牌股票信息。
日内停复牌会
suspend_timing字段会有值,否则为空值。
python
import tushare as ts
pro = ts.pro_api()
df = pro.suspend_d(trade_date='20200312')
df.head(10)
输出结果:
xml
ts_code trade_date suspend_timing suspend_type
0 300070.SZ 20200312 None R
1 000029.SZ 20200312 None S
2 000502.SZ 20200312 None S
3 000977.SZ 20200312 None S
4 002450.SZ 20200312 None S
5 300592.SZ 20200312 None S
6 300819.SZ 20200312 09:30-10:00 S
7 300821.SZ 20200312 09:30-10:00 S
8 600145.SH 20200312 None S
9 600228.SH 20200312 None S
示例2:获取某支股票停牌历史
通过传递ts_code可指定返回特定股票数据,传递suspend_type可指定返回数据的停复牌类型。本示例运行时间为2026/08/25 15:30。查询的是湖南黄金(002155.SZ)停牌历史。
从数据中可以看出,只要股票还是在停牌,接口就会记录该日期。也就是说本接口记录的是股票停复牌的每日快照。
python
df = pro.suspend_d(ts_code='002155.SZ', suspend_type='S')
df
输出结果:
xml
ts_code trade_date suspend_timing suspend_type
0 002155.SZ 20070816 None S
1 002155.SZ 20080215 None S
2 002155.SZ 20080219 None S
3 002155.SZ 20080415 None S
4 002155.SZ 20080605 None S
... ... ... ... ...
97 002155.SZ 20260123 None S
98 002155.SZ 20260820 None S
99 002155.SZ 20260821 None S
100 002155.SZ 20260824 None S
101 002155.SZ 20260825 None S
102 rows × 4 columns
示例3:获取某段时间停牌记录
通过传递start_date和end_date可限定返回数据停复牌的日期范围。本示例演示的是获取长园集团(600525.SH)在2026/08/01到2028/09/30之间的停服牌信息。示例运行的时间是2026/08/25 15:57。
新京报贝壳财经讯 8月24日,ST长园(5.780, 0.00, 0.00%)(维权)公告,公司此前因2024年度内部控制审计报告被出具否定意见,自2025年4月30日起被实施其他风险警示;上海证券交易所于2026年8月24日同意撤销,股票将于2026年8月25日停牌一天,2026年8月26日复牌并撤销其他风险警示,A股简称由"ST长园"变更为"长园集团"。
从返回数据可以看出,该接口同时也记录了公告中公布,但还未实际到达的日期事件。
python
df = pro.suspend_d(ts_code='600525.SH', start_date='20260801', end_date='20260930')
df
输出结果:
xml
ts_code trade_date suspend_timing suspend_type
0 600525.SH 20260825 None S
1 600525.SH 20260826 None R
说明:
该接口返回指定交易日或指定股票的停复牌记录。股票停牌意味着该股票在特定时间段内无法交易,对于量化策略来说,如果在回测时忽略停牌因素,会导致"幸存者偏差"------回测收益看起来很漂亮,实盘却因资金被停牌股锁住而大幅跑输预期。suspend_d接口正是解决这一问题的关键工具。