{
  "markdown": "# filing-firehose\n\nPython client for the [FilingFirehose](https://filingfirehose.com) SEC EDGAR\nAPI — body-text-parsed 8-Ks (with buried-event detection), activist-tagged\nSchedule 13D/G filings, and ATM offerings extracted from S-3 / 424B5 prospectus\nsupplements.\n\n## Install\n\n```\npip install filing-firehose\n```\n\n## Quick start\n\nThe free public tier returns the last 72 hours of filings — no API key required:\n\n```python\nfrom filing_firehose import FilingFirehose\n\nff = FilingFirehose()\n\n# Recent 8-Ks where the body language flags items the filer didn't report\nburied = ff.recent_8k(suspected_buried_only=True, limit=10)\nfor f in buried:\n    print(f\"{f.company_name}: filer reported {f.filer_reported_items}, \"\n          f\"body suggests {f.suspected_buried_events}\")\n\n# Recent activist 13D / 13G filings\nfor f in ff.recent_13d(activist=\"Saba\"):\n    print(f\"{f.company_name} — {f.percent_of_class}% by {f.activist_filers}\")\n\n# Recent ATM offerings with shelf size > $50M\nfor f in ff.recent_atm(min_shelf_million_usd=50):\n    print(f\"{f.company_name}: ${f.shelf_size_million_usd:.1f}M via {f.sales_agents}\")\n```\n\nFor the full historical archive, get an API key at\n[filingfirehose.com](https://filingfirehose.com):\n\n```python\nff = FilingFirehose(api_key=\"ff_live_...\")\n\n# Search the entire archive for cyber events\nfor f in ff.search_8k(items=\"1.05\", since=\"2026-01-01\"):\n    print(f.company_name, f.filed_at)\n```\n\n## Async\n\n```python\nimport asyncio\nfrom filing_firehose import AsyncFilingFirehose\n\nasync def main():\n    async with AsyncFilingFirehose() as ff:\n        filings = await ff.recent_8k(items=\"1.05,5.02\")\n        for f in filings:\n            print(f.company_name, f.detected_items)\n\nasyncio.run(main())\n```\n\n## Why this client\n\nThe wedge: most SEC filings APIs trust the filer-reported item codes on\n8-K filings. We body-text-classify every filing and surface a\n`suspected_buried_events` field flagging when the body language doesn't match\nthe filer's claimed item codes. From a [21-day analysis of 4,251 8-Ks](https://filingfirehose.com/research/buried-events),\n**7.3% of Item 8.01 filings contain language suggesting a more specific item\nshould have been used** — including buried cyber incidents (1.05), officer\ndepartures (5.02), and material agreements (1.01).\n\n## License\n\nMIT.\n",
  "bytes": 2296,
  "sha": "9b5dfc339324e18165d55ee2f1ec61a04e8a2305d1ad724a3209cda68483ae6f",
  "repo_slug": "jaablon/filingfirehose-python",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_filingfirehose_firehose_3b998962/readme"
}