涨停榜单（AkShare 实时/存储回退）

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Ranking.md

所属接口集：排行榜

请求 URL

GET /v1/api/ranking

认证方式

Bearer Token（详见 认证与签名）

接口概述

查询涨停榜单数据。优先从 AkShare 实时获取，若 AkShare 不可用则回退到已存储的榜单数据。返回按板块和行业两组分类的结果，并注入实时行情和主力控盘数据。

请求参数

参数	类型	必填	说明
date	string	否	查询日期，格式 YYYYMMDD，默认今天
sort	string	否	排序字段，main_control 按主力控盘排序
order	string	否	排序方向，asc 或 desc，默认 desc

接口说明

• AkShare 获取失败时自动回退到数据库存储的榜单数据
• 结果注入实时行情：close、pct_chg、latest_price（来自 Redis 1m state）
• 结果注入主力控盘：main_control（来自 MonitorChipMetricSnapshot，freq_days=5）
• 支持 sort=main_control 按主力控盘值排序，null 值排末尾

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "sorted_by_board": [
      {
        "代码": "600519",
        "名称": "贵州茅台",
        "最新价": 1810.0,
        "流通市值": 1800000000000,
        "换手率": 0.85,
        "连板数": 2,
        "所属行业": "白酒",
        "成交额": 15000000000,
        "总市值": 2200000000000,
        "封板资金": 500000000,
        "首次封板时间": "09:30:15",
        "最后封板时间": "14:55:30",
        "炸板次数": 0,
        "涨停统计": "3/2",
        "概念题材": ["白酒", "消费升级"],
        "主题": ["机构重仓"],
        "close": 1810.0,
        "pct_chg": 0.56,
        "latest_price": 1810.0,
        "main_control": 0.75
      }
    ],
    "sorted_by_industry": []
  }
}

返回状态

状态码	说明
200	成功
401	未认证
403	无权限

---