股票热榜
hot_rank股票热榜(展开 items_json)
数据窗口:全量维表,建议配合 limit / offset 或过滤条件使用。
请求需携带有效 Token,接口地址为
https://api.mquant.com.cn/data/v1。
请求参数 8 项
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
captured_at |
日期 | 指定榜单快照时间,缺省返回最新一次采样 | 可选 |
dataset |
字符串 | 榜单数据集名称,多个用逗号分隔;缺省返回全部榜单 | 可选 |
end_date |
日期 | YYYYMMDD 或 YYYY-MM-DD,含当日 | 可选 |
fields |
字符串 | 逗号分隔的字段名,缺省返回全部字段 | 可选 |
limit |
整数 | 默认 1000,上限由账号单次返回行数决定 | 可选 |
offset |
整数 | 用于分页,配合 has_more 使用 | 可选 |
start_date |
日期 | YYYYMMDD 或 YYYY-MM-DD,含当日 | 可选 |
trade_date |
日期 | YYYYMMDD 或 YYYY-MM-DD;与开始/结束日期互斥 | 可选 |
请求示例
Python · MQData SDK
from mq_data import MQData
client = MQData(token="你的 Token")
rows = client.hot_rank(dataset="overall_hour", limit=50)
print(rows)
cURL · HTTP
curl -X POST https://api.mquant.com.cn/data/v1 \
-H "X-API-Token: $MQ_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_name": "hot_rank", "params": {"dataset": "overall_hour", "limit": 50}}'
返回字段 0 个
| 字段 | 说明 | 类型 / 单位 |
|---|
响应示例
JSON · 标准响应
{
"code": 0,
"msg": null,
"data": {
"fields": [],
"items": [
[]
],
"has_more": false
}
}
错误码
| HTTP / code | 含义 | 处理建议 |
|---|---|---|
| 400 | 参数错误 | 检查参数名、日期格式与日期跨度 |
| 401 | Token 无效 | 确认 Token 完整、未被删除 |
| 403 | Token 无权限或账号停用 | 在控制台检查 Token 状态 |
| 429 | 超过配额 | 降低频率,或等待下一分钟 / 次日 |
| 503 | 服务暂不可用 | 稍后重试;持续出现请查看服务状态 |