公告列表查询

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Notice.md

所属接口集：公告信息

请求 URL

GET /v1/api/notice/list

认证方式

Bearer Token（详见 认证与签名）

接口概述

查询股票公告列表，支持按股票代码、名称、公告类型、关键词、公告日期区间等多维度过滤，并提供分页和排序。

请求参数

参数	类型	必填	说明
stock_code	string	否	股票代码，如 600519，自动取后 6 位数字补零
stock_name	string	否	股票名称，模糊匹配（icontains）
notice_type	string	否	公告类型，模糊匹配（icontains）
keyword	string	否	关键词，匹配公告标题（icontains）
notice_date_from	string	否	公告日期起始，格式 YYYY-MM-DD 或 YYYYMMDD
notice_date_to	string	否	公告日期截止，格式 YYYY-MM-DD 或 YYYYMMDD
order	string	否	排序方向，asc 或 desc，默认 desc（按公告日期降序）
page	int	否	页码，默认 1
page_size	int	否	每页数量，默认 100，最大 500

接口说明

• 排序逻辑：先按公告日期排序，再按 id 降序
• 日期参数支持 YYYY-MM-DD 和 YYYYMMDD 两种格式

响应格式示例

{
  "data": {
    "items": [
      {
        "id": 12345,
        "art_code": "AN20260113001",
        "stock_code": "600519",
        "stock_name": "贵州茅台",
        "notice_title": "2025年度业绩预告",
        "notice_type": "业绩预告",
        "notice_date": "2026-01-13",
        "detail_url": "http://www.cninfo.com.cn/...",
        "updated_at": "2026-01-13T08:00:00"
      }
    ],
    "page": 1,
    "page_size": 100,
    "total": 1,
    "total_pages": 1
  }
}

返回状态

状态码	说明
200	成功
401	未认证
403	无权限

---