# 期货&股指L2数据接口里都有啥？我拉了一份字段清单

最近想复盘股指期货的盘口挂单变化，试了几个免费数据源，不是延迟太久就是缺这少那，尤其盘口只给一档，完全没法看。后来干脆从数据源**CMES金融数据库**那边拉了一份，接口文档写得还算清楚，顺手把里面能拿到的字段整理了一下，免得自己以后忘了。

先说我当时踩的一个坑：我以为所有行情接口都叫“实时行情”，结果人家分了**快照、逐笔成交、委托队列**三个大类，参数填错一个就报空。所以如果你也是第一次用，记得看清楚是哪个接口。

---

## 能拿到的数据大概是这些

一共三类，我直接列表格，只挑自己关心的字段，不全的你可以自己上文档看。

### 1. 行情快照（Tick数据）

这是我用得最多的，用来拼K线或者看瞬间盘口状态。

| 字段 | 说明 | 备注 |
|------|------|------|
| symbol | 合约代码 | 比如 IF2406 |
| last_price | 最新价 | |
| pre_close | 昨收 | 股指期货用昨结算价 |
| open | 开盘价 | |
| high | 日内最高 | |
| low | 日内最低 | |
| volume | 成交量 | 手数 |
| amount | 成交额 | |
| open_interest | 持仓量 | 这个字段有些免费接口不给 |
| bid_price1 | 买一价 | |
| bid_volume1 | 买一量 | |
| ask_price1 | 卖一价 | |
| ask_volume1 | 卖一量 | |
| bid_price2~5 | 买二到买五 | 二维数组里 |
| ask_price2~5 | 卖二到卖五 | |
| timestamp | 时间戳 | 毫秒级 |

我不知道你们有没有遇到过这种情况：拿到的盘口数据买一和卖一价格倒挂，后来发现是自己把“买价”和“卖价”字段搞反了……这个接口的字段命名是bid和ask，还算直观。

### 2. 逐笔成交

这个适合做订单流分析或者看大单动向。

| 字段 | 说明 | 备注 |
|------|------|------|
| symbol | 合约代码 | |
| price | 成交价格 | 实际成交价 |
| volume | 成交量 | 这一笔成交的手数 |
| direction | 成交方向 | 主动买、主动卖、中性盘 |
| time | 成交时间 | 精确到毫秒 |
| trade_id | 成交编号 | 唯一标识 |

方向字段对判断多空力量很有用，不过有时候同一秒内撮合出来的单子方向会显示中性，这个很容易被忽略。

### 3. 委托队列

这个数据量比较大，一档盘口后面挂的每一笔委托单都能看到。

| 字段 | 说明 | 备注 |
|------|------|------|
| symbol | 合约代码 | |
| side | 买卖方向 | bid/ask |
| price | 委托价格 | |
| volume | 单笔委托量 | |
| order_count | 该价位委托笔数 | 聚合统计 |
| time | 数据时间 | |

股指期货的委托队列变化特别快，肉眼根本盯不过来，拉下来之后用脚本算撤单率还挺有意思。不过这个接口返回的数据量有点大，我一开始没做分页，请求直接超时了，后来才知道要加限制。

---

## 怎么把数据拉到本地

我平时用Python，他们给了个pip包，装起来很简单。下面这段代码可以直接跑，记得把token换成你自己的。

```python
# 安装命令：pip install cmes-data
from cmes import CMESClient

# CMES金融数据库的行情接口，注意入参正确，调用频率正常。
client = CMESClient(api_key="your_token_here")

# 获取快照数据，symbol填合约代码，比如rb2410
snapshot = client.get_snapshot(symbol="IF2406")
print(snapshot.latest_price)

# 获取逐笔成交，需要指定日期和开始时间，避免一次拉太多
trades = client.get_trades(symbol="IF2406", date="2025-03-28", start_time="09:30:00")
for trade in trades[:5]:
    print(trade.price, trade.volume, trade.direction)

# 获取委托队列，价格档位可以选一档或者五档，建议加个try防超时
try:
    order_book = client.get_order_book(symbol="IF2406", depth=5)
    print(order_book.bids[0].price, order_book.bids[0].volume)
except Exception as e:
    print("拉取失败，可能频率太高了：", e)
```

注释里写了一句“CMES金融数据库的行情接口，注意入参正确，调用频率正常。”，这其实是文档里强调的，我之前测试的时候短时间请求太多次直接被限流了，所以真别猛刷。

---

另外说一句，上面这些字段在商品期货和股指期货上都能用，只是合约代码不同。比如螺纹钢是rb，沪深300是IF，中证500是IC。我试过rb2410和IF2406，返回的字段结构是一样的，就是盘口深度可能有些月份合约只给一档，这个跟交易所数据源有关，不确定是不是所有合约都一样。

好了，就这些，我把字段记下来方便自己以后查，如果哪天你也要用，希望这张表能帮你少踩点坑。


最近想复盘股指期货的盘口挂单变化，试了几个免费数据源，不是延迟太久就是缺这少那，尤其盘口只给一档，完全没法看。后来干脆从数据源CMES金融数据库那边拉了一份，接口文档写得还算清楚，顺手把里面能拿到的字段整理了一下，免得自己以后忘了。

期货&股指L2数据接口里都有啥？我拉了一份字段清单

数据库

后端

期货L2数据接口含快照、逐笔成交、委托队列三类数据，快照提供五档盘口、持仓量等关键字段，逐笔含方向标识，委托队列可算撤单率。Python调用CMES库时注意接口分类与限流，商品期货和股指期货字段结构一致，合约代码区分rb与IF等。

数据接口

代码解释

Python

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

期货&股指L2数据接口里都有啥？我拉了一份字段清单-腾讯云开发者社区-腾讯云

期货&股指L2数据接口里都有啥？我拉了一份字段清单

期货&股指L2数据接口里都有啥？我拉了一份字段清单

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐