公告
announcement公告
数据窗口:不传日期时默认返回最近 7 天;可用 start_date / end_date 指定区间。
请求需携带有效 Token,接口地址为
https://api.mquant.com.cn/data/v1。
请求参数 11 项
| 参数 | 类型 | 说明 | 必填 |
|---|---|---|---|
category |
字符串 | 题材或公告的类目 | 可选 |
code |
字符串 | 与 ts_code 等价,支持纯数字代码 | 可选 |
end_date |
日期 | YYYYMMDD 或 YYYY-MM-DD,含当日 | 可选 |
fields |
字符串 | 逗号分隔的字段名,缺省返回全部字段 | 可选 |
hard_risk |
字符串 | true 只看硬风险公告 | 可选 |
keyword |
字符串 | 按名称或代码模糊匹配 | 可选 |
limit |
整数 | 默认 1000,上限由账号单次返回行数决定 | 可选 |
offset |
整数 | 用于分页,配合 has_more 使用 | 可选 |
start_date |
日期 | YYYYMMDD 或 YYYY-MM-DD,含当日 | 可选 |
trade_date |
日期 | YYYYMMDD 或 YYYY-MM-DD;与开始/结束日期互斥 | 可选 |
ts_code |
字符串 | 支持 600519.SH / 600519,多个用英文逗号分隔,上限 50 个 | 可选 |
请求示例
Python · MQData SDK
from mq_data import MQData
client = MQData(token="你的 Token")
rows = client.announcement(start_date="20260101", end_date="20260107", limit=20)
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": "announcement", "params": {"start_date": "20260101", "end_date": "20260107", "limit": 20}}'
返回字段 7 个
| 字段 | 说明 | 类型 / 单位 |
|---|---|---|
trade_date |
交易日期 | 日期 YYYYMMDD |
ts_code |
股票代码 | 证券代码(带后缀) |
name |
名称 | 原值 |
title |
标题 | 原值 |
category |
分类 | 原值 |
url |
链接 | 原值 |
hard_risk |
硬风险 | 原值 |
响应示例
JSON · 标准响应
{
"code": 0,
"msg": null,
"data": {
"fields": [
"trade_date",
"ts_code",
"name",
"title"
],
"items": [
[
"20260105",
"600519.SH",
"示例值",
"示例值"
]
],
"has_more": false
}
}
错误码
| HTTP / code | 含义 | 处理建议 |
|---|---|---|
| 400 | 参数错误 | 检查参数名、日期格式与日期跨度 |
| 401 | Token 无效 | 确认 Token 完整、未被删除 |
| 403 | Token 无权限或账号停用 | 在控制台检查 Token 状态 |
| 429 | 超过配额 | 降低频率,或等待下一分钟 / 次日 |
| 503 | 服务暂不可用 | 稍后重试;持续出现请查看服务状态 |