版本 v1.4
最后更新:2026-11-13
证券代码与交易日历|代码格式与交易时段 - FTLib
统一的证券代码是跨数据域拼接的基础。FTLib 使用 代码.交易所 格式,并在所有行情、基本面与基金接口中保持一致。
代码格式
| 后缀 | 交易所 | 示例 |
|---|---|---|
.SH | 上海证券交易所 | 600519.SH、510300.SH |
.SZ | 深圳证券交易所 | 000001.SZ、159915.SZ |
.BJ | 北京证券交易所 | 430047.BJ |
代码大小写不敏感,但建议统一使用大写后缀。不要省略交易所后缀,因为同一数字代码可能在不同市场存在不同含义。
代码示例
| 品种 | 代码 | 说明 |
|---|---|---|
| 股票 | 600519.SH | 沪市主板 |
| 股票 | 000001.SZ | 深市主板 |
| 指数 | 000300.SH | 沪深 300 |
| ETF | 510300.SH | 沪深 300 ETF |
| LOF | 161725.SZ | 分级/LOF 基金 |
| 可转债 | 113050.SH | 沪市可转债 |
交易时段
| 时段 | 时间 | 说明 |
|---|---|---|
| 开盘集合竞价 | 09:15–09:25 | 09:20–09:25 不可撤单 |
| 连续竞价(上午) | 09:30–11:30 | 正常撮合 |
| 连续竞价(下午) | 13:00–14:57 | 正常撮合 |
| 收盘集合竞价 | 14:57–15:00 | 深市与部分沪市品种适用 |
北交所与科创板的部分交易规则存在差异,具体以交易所公告为准。时间戳统一使用 Asia/Shanghai。
交易日历
交易日历用于判断某日是否开市、补齐停牌日索引与计算 T+N 日期。建议在本地保存交易日历,并在每年交易所公布安排后更新。
bash
curl -H "Authorization: Bearer $FTLIB_API_KEY" \
"https://api.ftlib.com/v1/calendar?start=2026-01-01&end=2026-12-31"
不要用自然日代替交易日
停牌、节假日与调休会让自然日与交易日错位。计算持有期、公告日对齐与复权时,应使用交易日历。
特殊证券
- ST、*ST 证券的涨跌停幅度与主板不同,风险标识需单独处理。
- 科创板与创业板实行不同的价格笼子与涨跌幅规则。
- 可转债有独立的交易规则与临时停牌机制。
- 指数不提供逐笔委托与涨跌停价,字段可用性不同。
- 退市整理期证券的代码与简称可能变化,应保留历史映射。