热门榜单列表查询

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

所属接口集：热门榜单

请求 URL

GET /v1/api/hot_rank_list

认证方式

Bearer Token（详见 认证与签名）

接口概述

从 hot_rank 表查询列表，支持对 tags_json 进行模糊匹配，并提供排序和分页参数。

请求参数

参数	类型	必填	说明
tags_json	string	否	模糊关键词，自动包裹为 LIKE '%keyword%'
sort	string	否	排序字段，默认 trade_day。可选：trade_day、stock_code、stock_name、seq、market_id、hot_rank、buy_value、sell_value、net_value、net_rate、change、range_days、limit_reason、org_net_value、hot_money_net_value
order	string	否	排序方向，asc 或 desc，默认 desc
page	int	否	页码，默认 1
page_size	int	否	每页数量，默认 50，最大 500

接口说明

• 不传 sort/order 时默认按 trade_day DESC
• tags_json 参数进行模糊匹配查询

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "items": [
      {
        "trade_day": "2026-01-13",
        "stock_code": "600519",
        "stock_name": "贵州茅台",
        "seq": 1,
        "market_id": 1,
        "hot_rank": 3,
        "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_json": "[\"白酒\"]",
        "tags_json": "[\"机构重仓\"]"
      }
    ],
    "page": 1,
    "page_size": 50,
    "sort": "trade_day",
    "order": "desc"
  }
}

返回状态

状态码	说明
200	成功
400	参数错误（page/page_size 非法）
401	未认证
403	无权限