7709-分类行情¶

作用¶

这是 0x054b 的底层原始分页接口：按分类查询行情列表，并让服务端按指定字段排序。它只返回一页原始协议结果；需要自动翻页、名称补全和排名时，使用上层封装 client.helpers.realtime_rank()。

项目	内容
调用方法	`client.quotes.list_by_category(...)`
底层接口	`0x054b`
返回模型	`CategoryQuotePage`
与实时榜单的关系	`client.helpers.realtime_rank()` 基于本方法自动翻页并整理为 `RealtimeRankTable`

这个方法传“列表范围 + 排序字段 + 分页位置”。服务端会按条件返回这一页有哪些证券。

示例¶

from eltdx import TdxClient

with TdxClient(timeout=3) as client:
    page = client.quotes.list_by_category("沪深A股", sort_by="涨幅", count=100)
    for item in page.records[:10]:
        print(item.full_code, item.last_price, item.change_pct)

按成交额取前 50 名：

with TdxClient(timeout=3) as client:
    page = client.quotes.list_by_category("沪深A股", sort_by="成交额", count=50)

分页：

first = client.quotes.list_by_category("沪深A股", sort_by="涨幅", start=0, count=80)
second = client.quotes.list_by_category("沪深A股", sort_by="涨幅", start=80, count=80)

参数¶

参数	含义
`category`	分类编号或别名；常用 `"沪深A股"`、`"A股"`，也可以直接传数字分类
`sort_by`	排序字段名或排序编号；默认 `None`（按代码顺序）
`start`	起始行，从 `0` 开始，默认 `0`
`count`	本页条数，默认 `80`
`ascending`	是否升序，默认 `False`（降序）

常用排序字段¶

`sort_by`	排序编号	说明
`"代码"`	`0x0000`	按列表默认代码顺序
`"现价"`	`0x0006`	按最新价
`"成交额"`	`0x000a`	按成交额
`"涨幅"`	`0x000e`	按 `change_pct`
`"封单额"`	`0x001c`	按 `locked_amount`
`"开盘金额"`	`0x001d`	按开盘金额
`"涨速"`	`0x002e`	按涨速
`"短换手"`	`0x00cc`	按短周期换手口径
`"量涨速"`	`0x00d0`	按量增速
`"开盘抢筹"`	`0x010a`	按开盘抢筹口径
`"2分钟金额"`	`0x010c`	按近 2 分钟金额
`"开盘涨幅"`	`0x0119`	按今开相对昨收涨幅
`"最高涨幅"`	`0x011a`	按最高价相对昨收涨幅
`"最低涨幅"`	`0x011b`	按最低价相对昨收涨幅
`"回撤"`	`0x011e`	按最高到现价的回撤
`"攻击"`	`0x011f`	按现价相对低点的攻击幅度

解析字段¶

`CategoryQuotePage` 字段	含义
`category`	分类编号
`sort_type`	排序编号
`start` / `request_count`	请求起点 / 请求条数
`sort_reverse`	排序方向原始值
`filter_raw`	过滤位图原始值
`header`	响应头标志，原样保留
`records`	行情记录列表
`count`	实际返回条数
`raw_payload`	原始 payload

`CategoryQuoteRecord` 字段	含义
`exchange` / `market_id`	市场前缀 / 市场编号
`code` / `full_code`	六位代码 / 完整代码
`active1` / `active2`	活跃序号 / 状态序号，原样保留
`last_price`	最新价 / 现价
`pre_close_price`	昨收价
`open_price` / `high_price` / `low_price`	今开 / 最高 / 最低
`server_time_raw`	行情时间原始值
`neg_price_raw`	负现价口径原始值
`total_hand`	总成交量，单位手
`current_hand`	现量，单位手
`amount`	成交额
`amount_raw`	成交额 compact-float 原始值
`inside_dish`	内盘，单位手
`outer_disc`	外盘，单位手
`after_outer_raw`	外盘后保留字段
`open_amount_raw`	开盘金额原始值
`open_amount`	开盘金额，单位元
`bid1` / `ask1`	买一 / 卖一价格
`bid_vol1` / `ask_vol1`	买一 / 卖一量
`status_or_sort_raw`	状态 / 排序辅助原始值
`rise_speed_raw` / `rise_speed`	涨速原始值 / 涨速
`short_turnover_raw` / `short_turnover`	短周期换手原始值 / 短周期换手
`min2_amount`	近 2 分钟金额口径字段
`opening_rush_raw` / `opening_rush`	开盘抢筹原始值 / 开盘抢筹
`extra_pair_raw`	附加字段组，原样保留
`vol_rise_speed`	量增速
`depth`	盘口强弱 / 盘口深度口径
`extra_meta_raw` / `tail_raw`	扩展原始字段
`record_hex`	单条记录原始十六进制

派生字段¶

字段	计算方式
`change`	`last_price - pre_close_price`
`change_pct`	`change / pre_close_price * 100`
`locked_amount`	`bid1 * bid_vol1 * 100`

协议文档里还确认过这些常见列表派生口径，当前模型没有单独做成属性时可以按下面公式自己算：

字段	计算方式
`open_pct`	`(open_price - pre_close_price) / pre_close_price * 100`
`high_pct`	`(high_price - pre_close_price) / pre_close_price * 100`
`low_pct`	`(low_price - pre_close_price) / pre_close_price * 100`
`amplitude_pct`	`(high_price - low_price) / pre_close_price * 100`
`drawdown_pct`	`(high_price - last_price) / high_price * 100`
`attack_pct`	`(last_price - low_price) / pre_close_price * 100`
`entrust_ratio`	`(bid_vol1 - ask_vol1) / (bid_vol1 + ask_vol1) * 100`
`bid_ask_diff`	`bid_vol1 - ask_vol1`

使用建议¶

场景	建议
做涨幅榜、成交额榜、量速榜	用这个方法，排序交给服务端
查指定几个代码	用 `client.helpers.full_quotes()`
列表第一页后继续翻页	下一页 `start += count`
需要五档盘口完整买一到买五	用 `client.helpers.full_quotes()` / `client.quotes.get_depth()`；分类行情和直接 `0x054c` 快照只返回已确认一档盘口

真实返回样本¶

真实返回 JSON · CategoryQuotePage（涨幅榜 1 条节选）

分类 / 排序沪深A股 / 涨幅

采样日期2026-08-17

返回类型CategoryQuotePage

真实采样；请求 count=2，JSON 仅展示涨幅榜第一条。

{
  "category": 6,
  "sort_type": 14,
  "start": 0,
  "request_count": 2,
  "count": 2,
  "records": [
    {
      "exchange": "bj",
      "code": "920107",
      "last_price": 30.05,
      "pre_close_price": 16.02,
      "open_price": 29.24,
      "high_price": 36.28,
      "low_price": 29.01,
      "total_hand": 182553,
      "amount": 567929152.0,
      "bid1": 30.05,
      "ask1": 30.06,
      "rise_speed": 0.03,
      "short_turnover": 1.44,
      "opening_rush": 0.83
    }
  ]
}