热门榜单查询

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

所属接口集：热门榜单

请求 URL

GET /v1/api/hot_rank

认证方式

Bearer Token（详见 认证与签名）

接口概述

查询 hot_rank 表的热门榜单数据。支持按日期分页查询，或按股票代码 + 日期区间查询。

请求参数

参数	类型	必填	说明
date	string	否	查询日期，格式 YYYY-MM-DD。无 stock_code 时必填
start_date	string	否	区间起始日期，格式 YYYY-MM-DD。需与 end_date 同时提供，且需提供 stock_code
end_date	string	否	区间结束日期，格式 YYYY-MM-DD
stock_code	string	否	股票代码，支持逗号分隔多个，如 600519,000001
page	int	否	页码，默认 1
size	int	否	每页数量，默认 50

接口说明

• 无 stock_code 时必须提供 date，返回当日分页数据
• 有 stock_code 时可选 date 或 start_date + end_date 进行区间查询
• 当日查询排序：hot_rank ASC, seq ASC
• 区间查询排序：trade_day ASC, hot_rank ASC, seq ASC

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "items": [
      {
        "trade_day": "2026-01-13",
        "page": 1,
        "seq": 1,
        "stock_code": "600519",
        "stock_name": "贵州茅台",
        "market_id": 1,
        "hot_rank": 1,
        "buy_value": 12345678.9,
        "sell_value": 2345678.9,
        "net_value": 10000000.0,
        "net_rate": 0.0123,
        "change": 0.0345,
        "range_days": 3,
        "limit_reason": "大单资金净流入",
        "org_net_value": 1111.11,
        "hot_money_net_value": 2222.22,
        "concept_list": ["白酒", "消费"],
        "tags": ["机构重仓"]
      }
    ],
    "page": 1,
    "size": 50
  }
}

返回状态

状态码	说明
200	成功
400	参数错误（缺少必填日期、page/size 非法等）
401	未认证
403	无权限

---