# 获取实时逐笔

get_rt_ticker(code, num=500)

  • 介绍

    获取已订阅股票的实时逐笔数据,必须要先订阅。

  • 参数

    参数 类型 说明
    code str 股票代码
    num int 最近逐笔个数
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK,返回逐笔数据
    str 当 ret != RET_OK,返回错误描述
    • 逐笔数据格式如下:
      字段 类型 说明
      code str 股票代码
      name str 股票名称
      sequence int 逐笔序号
      time str 成交时间
      price float 成交价格
      volume int 成交数量
      turnover float 成交金额
      ticker_direction TickerDirect 逐笔方向
      type TickerType 逐笔类型
  • Example

from futu import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

ret_sub, err_message = quote_ctx.subscribe(['US.AAPL'], [SubType.TICKER], subscribe_push=False, session=Session.ALL)
# 先订阅逐笔类型。订阅成功后 OpenD 将持续收到服务器的推送,False 代表暂时不需要推送给脚本
if ret_sub == RET_OK:  # 订阅成功
    ret, data = quote_ctx.get_rt_ticker('US.AAPL', 2)  # 获取美股AAPL最近2个逐笔
    if ret == RET_OK:
        print(data)
        print(data['turnover'][0])   # 取第一条的成交金额
        print(data['turnover'].values.tolist())   # 转为 list
    else:
        print('error:', data)
else:
    print('subscription failed', err_message)
quote_ctx.close()  # 关闭当条连接,OpenD 会在1分钟后自动取消相应股票相应类型的订阅
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
  • Output
code name                     time   price  volume  turnover ticker_direction             sequence     type
0  US.AAPL   苹果  2025-04-07 05:50:23.745  181.70       2    363.40          NEUTRAL  7490506385373790208  ODD_LOT
1  US.AAPL   苹果  2025-04-07 05:50:24.170  181.73       1    181.73          NEUTRAL  7490506389668757504  ODD_LOT
363.4
[363.4, 181.73]
1
2
3
4
5

接口限制

  • 最多能获取最近 1000 个逐笔数据,更多历史逐笔数据暂未提供
  • 港股期权期货在 LV1 权限下,不支持获取逐笔

提示