查询热搜榜单，通过 `params.type` 指定雪球、通达信、同花顺、东方财富等榜单类型；可选按交易日查询历史。字段说明：不传 params.tradedate 时返回最新缓存，默认 fields 为 s,n,pc；传 params.tradedate 时返回日度历史，默认 fields 为 s,rank,tradedate,type。s=股票代码，n=股票名称，pc=涨跌幅，rank=榜单排名，tradedate=交易日，type=榜单类型。日度历史不支持 name/pct_chg/raw。最新缓存示例：{"apiname":"hotstock","fields":"s,n,pc","params":{"type":"tdx&resou"}}。
POST
/apiapiname:hotstock生产专线（默认）深圳
http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apiname | string（hotstock） | 必选 | hotstock | 固定接口名称，用于选择对应的数据能力。 |
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。 |
fields | string|null | 可选 | s,rank,tradedate,type | 需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。 |
params | object | 必选 | {"type":"xq&resou","tradedate":"20260611"} | 查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。 |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
type | string（ths&normal / ths&skyrocket / ths&tech / ths&value / ths&trend / xq&biaos / xq&repin / xq&zixuan / xq&zuhe / xq&resou / tdx&resou / tdx&biaos / tdx&zuori / dfcf&biaos / dfcf&renqi） | 必选 | xq&resou | 热搜类型。支持 ths&normal=同花顺&热股&大家都在看；ths&skyrocket=同花顺&热股&快速飙升中；ths&tech=同花顺&热股&技术交易派；ths&value=同花顺&热股&价值投资派；ths&trend=同花顺&热股&趋势投资派；xq&biaos=雪球&飙升榜；xq&repin=雪球&热评榜；xq&zixuan=雪球&自选榜；xq&zuhe=雪球&组合热股榜；xq&resou=雪球&热搜榜；tdx&resou=通达信&热搜榜；tdx&biaos=通达信&飙升榜；tdx&zuori=通达信&昨日榜；dfcf&biaos=东方财富&飙升榜；dfcf&renqi=东方财富&人气榜。 |
tradedate | string | 可选 | 20260611 | 可选交易日期，格式：YYYYMMDD；不传时返回最新缓存。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
s | string | 股票代码 | 000001 | 实时模式和历史模式均返回的 6 位股票代码。 |
n | string|null | 股票名称 | 平安银行 | 仅不传 tradedate 的实时模式返回。 |
pc | number|null | 涨跌幅（%） | 2.35 | 仅不传 tradedate 的实时模式返回。 |
rank | integer | 榜单排名 | 1 | 仅传 tradedate 的历史模式返回；榜单名次从 1 开始。 |
tradedate | string | 交易日期 | 20260611 | 仅传 tradedate 的历史模式返回，日期格式：YYYYMMDD。 |
type | string | 榜单类型 | xq&resou | 仅传 tradedate 的历史模式返回；与请求 params.type 一致。 |
请求与响应样例
固定样例
{
"apiname": "hotstock",
"apikey": "YOUR_API_KEY",
"fields": "s,rank,tradedate,type",
"params": {
"type": "xq&resou",
"tradedate": "20260611"
}
}{
"code": 200,
"message": "success",
"data": {
"fields": [
"s",
"rank",
"tradedate",
"type"
],
"items": [
[
"000001",
1,
"20260611",
"xq&resou"
]
]
}
}