# 获取实时逐笔

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(['HK.00700'], [SubType.TICKER], subscribe_push=False)
# 先订阅逐笔类型。订阅成功后 OpenD 将持续收到服务器的推送,False 代表暂时不需要推送给脚本
if ret_sub == RET_OK:  # 订阅成功
    ret, data = quote_ctx.get_rt_ticker('HK.00700', 2)  # 获取港股00700最近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  HK.00700  腾讯控股  2023-07-19 15:59:58  332.4      100      33240.0             SELL  7257436441708356760  AUTO_MATCH
1  HK.00700  腾讯控股  2023-07-19 16:08:12  333.0  1667000  555111000.0          NEUTRAL  7257438563422200985     AUCTION
33240.0
[33240.0, 555111000.0]
1
2
3
4
5

接口限制

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

提示