Skip to content

chenxiangyi101/dinggonggao-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

盯公告 Python SDK · A股公告事件 + 跨市场关联数据 API

PyPI License

盯公告(DingGongGao)是一个 A股公告事件数据 API:把沪深北交易所全市场每天上千条公告,实时结构化成 27 类"事件"(股东减持、业绩预告、股份回购、并购重组、退市风险……),抽出净利区间、减持金额/比例等可交易的结构化数字,并把每只股票关联到相关的大宗商品、美股龙头(SEC 事件)、美国宏观(利率/非农/CPI/美元)——形成一只 A股的跨市场全景。通过 REST API + Webhook 提供,让事件驱动策略能直接消费,而不必自己下载 PDF、写正则、维护分类。

试用与文档:https://dinggonggao.com


它解决什么问题

做 A股事件驱动 / 基本面 / 风险预警策略时,你需要的是"结构化的公告事件",而不是原始 PDF。盯公告把公告变成可编程的数据:

{
  "code": "002466", "name": "天齐锂业",
  "event_type": "earnings_forecast", "event_name": "业绩预告", "importance": 4,
  "fields": { "direction": "预增", "net_profit_low": 88000, "net_profit_high": 110000, "yoy_low": 120 }
}

并且能一次拿到一只股票的跨市场全景(这是别处没有的):它自己的公告 + 影响它的商品异动(碳酸锂)+ 相关美股龙头事件 + 相关美国宏观传导。

A股公告 / 事件数据方案对比

方案 公告事件结构化 抽结构化数字 跨市场关联 实时推送 适合
官方披露平台(网页/PDF) ❌ 要自己解析 人工查阅
通用行情/数据接口 弱(仅标题列表) 行情为主 自建、能写解析
盯公告(事件 API) ✅ 27 类 ✅ 净利/减持金额等 ✅ 商品/美股/宏观 ✅ 分钟级 Webhook 事件驱动/风险/跨市场

安装

pip install git+https://github.com/chenxiangyi101/dinggonggao-python

快速开始

from dinggonggao import DingGongGao

dgg = DingGongGao(api_key="你的_API_KEY")   # /events 需要 key;其余公开端点可不填

# 1) 最新交易日的高价值事件
feed = dgg.latest()
for e in feed["events"][:10]:
    print(e["code"], e["name"], e["event_name"], e.get("fields"))

# 2) 只要"重要度≥4 的减持 / 业绩预告"
dgg.events(min_importance=4, types=["share_reduce", "earnings_forecast"])

# 3) 一只股票的跨市场全景:公告 + 商品 + 美股 + 宏观
p = dgg.stock("002466")     # 天齐锂业
print(p["commodity_links"]) # 碳酸锂(方向/弹性/领先滞后)
print(p["us_links"])        # 相关美股龙头
print(p["macro_links"])     # 相关美国宏观传导

# 4) 跨市场关联总览
dgg.commodity()    # 商品异动 → 相关A股
dgg.crossmarket()  # 美股龙头SEC事件 → A股
dgg.macro()        # 美国宏观 → A股传导

API 方法

方法 说明 是否需 Key
latest() 最新交易日全市场公告事件
events(date, types, min_importance) 按条件查询事件
types() 事件类型枚举
stock(code) 个股跨市场全景
commodity() / crossmarket() / macro() 跨市场关联
subscribe(webhook, codes, types, min_importance) 订阅 Webhook 实时推送
status() 系统实时状态

支持的事件类型(部分)

股东减持、业绩预告、股份回购、并购重组、重大合同/中标、退市/ST风险、问询/关注函、分红派息、股票异常波动……共 27 类,每类带重要度(0–5)。

Webhook 实时推送(出一条推一条)

订阅后,新公告出现约 1 分钟内,把匹配你所关注股票/事件类型的结构化事件 POST 到你的接收地址——无需轮询。

dgg = DingGongGao(api_key="你的_API_KEY")
dgg.subscribe(
    webhook="https://your-server.com/dgg-hook",   # 你的接收地址(http/https)
    codes=["002466", "300750"],                    # 只推这些6位股票代码(空=不限)
    types=["share_reduce", "earnings_forecast"],   # 只推这些事件类型(空=不限)
    min_importance=4,                              # 只推重要度≥4 的事件
)
# 再次调用会覆盖上次的订阅(按 API Key 唯一)

你的 webhook 会收到 POSTContent-Type: application/json):

{
  "count": 1,
  "events": [
    { "code": "002466", "name": "天齐锂业",
      "event_type": "earnings_forecast", "event_name": "业绩预告", "importance": 4,
      "title": "……业绩预告", "time": "2026-07-07 …",
      "fields": { "direction": "预增", "net_profit_low": 88000, "net_profit_high": 110000, "yoy_low": 120 } }
  ]
}

不用 SDK 也可以直接 HTTP:POST https://dinggonggao.com/subscribe,body {"key","webhook","codes","types","min_importance"}key 也可放在 X-API-Key 头)。

免责

跨市场关联为监控 / 结构化背景,非买卖信号——方向可能反转、股价常领先商品与事件,请独立判断。数据为公开披露信息的结构化加工,非投资建议。

定价与试用

https://dinggonggao.com 免费试用;基础版 ¥99/月、专业版 ¥299/月,微信扫码订阅后 API Key 自动发送到邮箱。

License

MIT

About

盯公告 — A股公告事件 + 跨市场关联(商品/美股/宏观)数据 API 的 Python SDK · dinggonggao.com

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages