事件/研报类实体（2）

research_report — 券商研报

主日期列 trade_date · 支持 as_of

券商研究报告：标题、摘要、机构、行业、作者等。

GET /api/v1/entities/research_report

参数

参数	类型	说明
`as_of`	YYYYMMDD	point-in-time 锚点：只返回公告日 <= as_of 的行，防未来函数（强烈建议显式传）。

字段（10 个）

字段	类型	说明
`trade_date`	string	发布日期 YYYYMMDD
`abstr`	string	摘要
`title`	string	研报标题
`report_type`	string	报告类型
`author`	string	作者
`name`	string	股票名称
`ts_code`	string	股票代码
`inst_csname`	string	机构名称
`ind_name`	string	行业名称
`url`	string	原文链接

数据样例

{
  "entity": "research_report",
  "data_version": "2026-08-14T22:50:21+00:00",
  "columns": [{"name": "trade_date", "dtype": "string"}, {"name": "abstr", "dtype": "string"}, {"name": "title", "dtype": "string"}, {"name": "report_type", "dtype": "string"}, {"name": "author", "dtype": "string"}, {"name": "name", "dtype": "string"}, {"name": "ts_code", "dtype": "string"}, {"name": "inst_csname", "dtype": "string"}, {"name": "ind_name", "dtype": "string"}, {"name": "url", "dtype": "string"}],
  "rows": [["20170101", null, "信通院产业与规划研究所_2016年12月国内手机市场运行分析报告_2017-01-01.pdf", "行业研报", null, null, null, "信通院产业与规划研究所", "文化传媒", "https://pdf.dfcfw.com/pdf/H3_AP201703200421703871_1.pdf?1490030934000.pdf"]],
  "count": 1,
  "truncated": false,
  "next_cursor": null
}

Python 示例

import requests
r = requests.get(f"{BASE}/api/v1/entities/research_report",
                 params={"limit": 10},
                 headers={"Authorization": f"Bearer {TOKEN}"})
d = r.json()
print(d["columns"], d["rows"][0])

anns_d — 上市公司公告

主日期列 ann_date · 支持 as_of

上市公司公告：标题、URL、时间。

GET /api/v1/entities/anns_d

参数

参数	类型	说明
`as_of`	YYYYMMDD	point-in-time 锚点：只返回公告日 <= as_of 的行，防未来函数（强烈建议显式传）。

字段（6 个）

字段	类型	说明
`ann_date`	string	公告日期 YYYYMMDD
`ts_code`	string	股票代码
`name`	string	股票名称
`title`	string	公告标题
`url`	string	公告链接
`rec_time`	string	收录时间

数据样例

{
  "entity": "anns_d",
  "data_version": "2026-08-14T22:50:21+00:00",
  "columns": [{"name": "ann_date", "dtype": "string"}, {"name": "ts_code", "dtype": "string"}, {"name": "name", "dtype": "string"}, {"name": "title", "dtype": "string"}, {"name": "url", "dtype": "string"}, {"name": "rec_time", "dtype": "string"}],
  "rows": [["20100101", "300011", "鼎汉技术", "关于完成工商变更登记的公告", "http://static.cninfo.com.cn/finalpage/2010-01-01/57461177.PDF", null]],
  "count": 1,
  "truncated": false,
  "next_cursor": null
}

Python 示例

import requests
r = requests.get(f"{BASE}/api/v1/entities/anns_d",
                 params={"limit": 10},
                 headers={"Authorization": f"Bearer {TOKEN}"})
d = r.json()
print(d["columns"], d["rows"][0])