# 获取区间涨跌幅

get_period_change_rank(market, period_type=None, sort_dir=None, count=10, offset=None, filter_list=None)

  • 介绍

    获取区间涨跌幅排行,返回指定市场中按不同时间周期(5分钟至250日/年初至今)的涨跌幅排行,支持丰富的筛选条件(市值、价格、PE、PB、换手率、量比、振幅等)。

  • 参数

    参数 类型 说明
    market Market 市场类型(HK/US)(必填)
    period_type RankPeriodType 排序周期,默认 5 分钟
    sort_dir RankSortDir 排序方向,默认降序
    count int 返回数量 [1, 200],默认 10
    offset int 起始位置,默认 0
    filter_list list[PeriodChangeRankFilter] 筛选条件列表(多条件为 AND 关系)
  • 输入限制

    • filter_list 筛选条件(PeriodChangeRankFilter):

      构造参数 说明
      indicator_type 筛选因子类型(PeriodChangeIndicatorType,必填)
      interval_min 范围最小值(闭区间)
      interval_max 范围最大值(闭区间)
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK,返回 (all_count, DataFrame) 元组
    str 当 ret != RET_OK,返回错误描述
    • 数据格式如下:
      字段 类型 说明
      security str 股票代码(如 'US.AAPL'
      name str 股票名称
      cur_price float 最新价
      change_ratio float 今日涨跌幅(%)
      turnover float 成交额
      volume int 成交量
      market_cap float 市值
      change_rate_5min float 5分钟涨跌幅(%)
      change_rate_5d float 5日涨跌幅(%)
      change_rate_10d float 10日涨跌幅(%)
      change_rate_20d float 20日涨跌幅(%)
      change_rate_60d float 60日涨跌幅(%)
      change_rate_120d float 120日涨跌幅(%)
      change_rate_250d float 250日涨跌幅(%)
      change_rate_ytd float 年初至今涨跌幅(%)
      pe_ttm float 市盈率 TTM
      pb float 市净率
      turnover_ratio float 换手率(%)
      volume_ratio float 量比
      amplitude float 振幅(%)
  • Example

from futu import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

ret, data = quote_ctx.get_period_change_rank(market=Market.US, count=2)
if ret == RET_OK:
    all_count, df = data
    print(f'总数据量: {all_count}')
    print(df)
else:
    print('error:', data)

quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
13
  • Output
总数据量: 6429
  security                           name  cur_price  change_ratio  turnover  volume   market_cap  change_rate_5min  change_rate_5d  change_rate_10d  change_rate_20d  change_rate_60d  change_rate_120d  change_rate_250d  change_rate_ytd   pe_ttm       pb  turnover_ratio  volume_ratio  amplitude
0   US.JYD                         佳裕达物流       0.93        11.537  271197.0  311313   7717977.00             9.540           32.80           30.875           20.779          -68.150           -80.128           -90.610          -81.374 -0.40558  0.49892           5.220         0.732      20.94
1  US.RAIN  Rain Enhancement Technologies       2.23        19.892  112286.0   56451  18261097.59             9.313           -2.62            1.826           -6.302          -21.754           -71.914           -22.299          -61.815 -1.79838 -1.27283           2.812         0.816      27.15
1
2
3
4

接口限制

  • 30 秒内最多 60 次请求
  • 分页请求仅首页计入限频统计