题材字典
theme_list题材字典
数据窗口:全量维表,建议配合 limit / offset 或过滤条件使用。
请求需携带有效 Token,接口地址为
https://api.mquant.com.cn/data/v1。
请求参数 8 项
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
category |
字符串 | 题材或公告的类目 | 可选 |
end_date |
日期 | YYYYMMDD 或 YYYY-MM-DD,含当日 | 可选 |
fields |
字符串 | 逗号分隔的字段名,缺省返回全部字段 | 可选 |
limit |
整数 | 默认 1000,上限由账号单次返回行数决定 | 可选 |
offset |
整数 | 用于分页,配合 has_more 使用 | 可选 |
parent |
字符串 | 一级题材分类 | 可选 |
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.theme_list(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": "theme_list", "params": {"limit": 50}}'
返回字段 5 个
| 字段 | 说明 | 类型 / 单位 |
|---|---|---|
name |
名称 | 原值 |
category |
分类 | 原值 |
parent |
父级题材 | 原值 |
note |
备注 | 原值 |
updated_at |
更新时间 | 原值 |
响应示例
JSON · 标准响应
{
"code": 0,
"msg": null,
"data": {
"fields": [
"name",
"category",
"parent",
"note"
],
"items": [
[
"示例值",
"示例值",
"示例值",
"示例值"
]
],
"has_more": false
}
}
错误码
| HTTP / code | 含义 | 处理建议 |
|---|---|---|
| 400 | 参数错误 | 检查参数名、日期格式与日期跨度 |
| 401 | Token 无效 | 确认 Token 完整、未被删除 |
| 403 | Token 无权限或账号停用 | 在控制台检查 Token 状态 |
| 429 | 超过配额 | 降低频率,或等待下一分钟 / 次日 |
| 503 | 服务暂不可用 | 稍后重试;持续出现请查看服务状态 |