FilingFirehose

filing-firehose

适用于 FilingFirehose SEC EDGAR API 的 Python 客户端 — 提供经过正文文本解析的 8-K（含隐藏事件检测）、带有 activist 标签的 Schedule 13D/G 申报，以及从 S-3 / 424B5 招股说明书补充文件中提取的 ATM 发行信息。

安装

pip install filing-firehose

快速开始

免费公共层可返回最近 72 小时的申报 — 无需 API 密钥：

from filing_firehose import FilingFirehose

ff = FilingFirehose()

# Recent 8-Ks where the body language flags items the filer didn't report
buried = ff.recent_8k(suspected_buried_only=True, limit=10)
for f in buried:
    print(f"{f.company_name}: filer reported {f.filer_reported_items}, "
          f"body suggests {f.suspected_buried_events}")

# Recent activist 13D / 13G filings
for f in ff.recent_13d(activist="Saba"):
    print(f"{f.company_name} — {f.percent_of_class}% by {f.activist_filers}")

# Recent ATM offerings with shelf size > $50M
for f in ff.recent_atm(min_shelf_million_usd=50):
    print(f"{f.company_name}: ${f.shelf_size_million_usd:.1f}M via {f.sales_agents}")

如需访问完整历史档案，请前往 filingfirehose.com 获取 API 密钥：

ff = FilingFirehose(api_key="ff_live_...")

# Search the entire archive for cyber events
for f in ff.search_8k(items="1.05", since="2026-01-01"):
    print(f.company_name, f.filed_at)

异步

import asyncio
from filing_firehose import AsyncFilingFirehose

async def main():
    async with AsyncFilingFirehose() as ff:
        filings = await ff.recent_8k(items="1.05,5.02")
        for f in filings:
            print(f.company_name, f.detected_items)

asyncio.run(main())

为什么选择此客户端

其独特之处在于：大多数 SEC 申报 API 都信任申报方报告的 8-K 项目代码。我们会对每份申报进行正文文本分类，并提供 suspected_buried_events 字段，用于标记正文措辞与申报方声称的项目代码不符的情况。根据对 4,251 份 8-K 的 21 天分析，7.3% 的 Item 8.01 申报包含表明本应使用更具体项目代码的措辞 — 包括隐藏的网络安全事件（1.05）、高管离职（5.02）和重大协议（1.01）。

许可证

MIT。