FilingFirehose

filing-firehose

FilingFirehose SEC EDGAR API 用の Python クライアントです。本文を解析した 8-K（埋もれたイベントの検出機能付き）、アクティビストタグ付きの 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 日間の分析では、項目 8.01 の提出書類の 7.3% に、より具体的な項目を使うべきだったことを示す記述が含まれています。これには、埋もれたサイバーインシデント（1.05）、役員の退任（5.02）、重要な契約（1.01）が含まれます。

ライセンス

MIT。