Build an SEC filings bot for X
8-K events, insider trades, 13D stakes

import os, re, json, time, requests, xml.etree.ElementTree as ET
from pathlib import Path

SEC = {"User-Agent": "Your Name you@example.com"}   # SEC asks every client to declare who it is
OT = {"Authorization": f"Bearer {os.environ['OPENTWEET_API_KEY']}"}
FEED = "https://www.sec.gov/cgi-bin/browse-edgar?action=getcurrent&type=8-K&count=100&output=atom"
NS = {"a": "http://www.w3.org/2005/Atom"}
SEEN = Path("seen.json")

WATCH = {  # 8-K items worth a post, in plain words
    "1.01": "signed a material agreement",
    "1.03": "filed for bankruptcy or receivership",
    "2.01": "closed an acquisition or sale of assets",
    "3.01": "got a delisting or listing-rule notice",
    "4.02": "said past financials can no longer be relied on",
    "5.01": "reported a change in control",
    "5.02": "reported an executive or board change",
}

tickers = {}
for v in requests.get("https://www.sec.gov/files/company_tickers.json", headers=SEC, timeout=30).json().values():
    tickers.setdefault(v["cik_str"], v["ticker"])  # first ticker is the common stock
seen = set(json.loads(SEEN.read_text())) if SEEN.exists() else set()

feed = ET.fromstring(requests.get(FEED, headers=SEC, timeout=30).content)
for e in feed.findall("a:entry", NS):
    acc = e.find("a:id", NS).text.rsplit("=", 1)[1]
    m = re.match(r"8-K - (.+) \((\d{10})\) \(Filer\)", e.find("a:title", NS).text)
    if acc in seen or not m:
        continue
    seen.add(acc)
    name, cik = m.group(1), int(m.group(2))
    items = re.findall(r"Item (\d\.\d\d)", e.find("a:summary", NS).text or "")
    hits = [WATCH[i] for i in items if i in WATCH]
    if not hits or cik not in tickers:  # listed companies only
        continue
    text = (f"${tickers[cik]} {name} {' and '.join(hits)}.\n\n"
            f"8-K filed {e.find('a:updated', NS).text[:10]} (Items {', '.join(items)})")
    requests.post("https://opentweet.io/api/v1/posts", headers=OT,
                  json={"text": text, "publish_now": True}).raise_for_status()
    time.sleep(2)

SEEN.write_text(json.dumps(sorted(seen)))

$GTCH GBT Technologies Inc. signed a material agreement and reported an executive or board change.

8-K filed 2026-11-05 (Items 1.01, 2.03, 3.02, 5.02, 7.01, 8.01, 9.01)