FILING EVENTS API · v1

Stop parsing EDGAR.
Get structured filing events in real time.

Register a rule once. The moment an 8-K, Form 4 (insider), or S-3 (dilution) hits SEC EDGAR for the tickers and forms you care about, we push you a clean, ticker-mapped, item-coded JSON event — by webhook or poll. No XML. No scraping. No maintenance.

Get a free key →

Base URL · https://catalystedgescanner.com/api/v1/filing

Why

Real-timeEvents fire within seconds of a filing appearing on EDGAR — off the same pipeline that powers our live scanner.

StructuredTicker-resolved, form-labeled, with the canonical SEC URL. Drop it straight into your app, bot, or AI agent.

Zero plumbingSkip weeks of EDGAR ingestion + the constant breakage. One POST to register, one webhook to receive.

1 · Get a key

Free tier, self-serve. Save the key — it is shown only once.

curl -X POST https://catalystedgescanner.com/api/v1/filing/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

# → {"api_key":"ce_F_...", "tier":"filing", ...}

2 · Register a rule

Match by form, ticker, or both. Add a webhook_url (https) to get pushed events, or omit it and poll.

# Every insider Form 4 for NVDA → your webhook
curl -X POST https://catalystedgescanner.com/api/v1/filing/rules \
  -H "X-API-Key: ce_F_..." -H "Content-Type: application/json" \
  -d '{"form":"4","ticker":"NVDA","webhook_url":"https://your.app/hook"}'

# Every 8-K, any ticker (poll mode — no webhook)
curl -X POST https://catalystedgescanner.com/api/v1/filing/rules \
  -H "X-API-Key: ce_F_..." -H "Content-Type: application/json" \
  -d '{"form":"8-K"}'

Manage rules: GET /api/v1/filing/rules · DELETE /api/v1/filing/rules/{id}

3 · Receive events

Webhook (push)

We POST each match to your webhook_url:

{
  "type": "filing.event",
  "data": {
    "ticker": "NVDA",
    "form": "4",
    "form_label": "Insider transaction (Form 4)",
    "filed_utc": "2026-06-26T17:46:26-04:00",
    "sec_url": "https://www.sec.gov/Archives/edgar/data/.../index.htm",
    "detected_utc": "2026-06-26T17:46:31+00:00"
  }
}

Poll

curl https://catalystedgescanner.com/api/v1/filing/events?limit=50 \
  -H "X-API-Key: ce_F_..."
# → {"events":[ { ...same shape as data above... } ]}

Form types

form	meaning
4	Insider buy/sell (Form 4)
8-K	Material event (item-coded)
S-3	Shelf registration — dilution risk
S-1	Registration statement
13D / 13G	Activist / passive stake
424B5	Prospectus supplement (ATM/offering)

Tiers

tier	price	limits
Free	$0	Up to 5 rules · poll + webhook · best-effort latency
Pro	$49/mo	50 rules · priority webhook dispatch · higher event volume — upgrade
Scale	usage-based	Unlimited rules · SLA · bulk + historical

Upgrade to Pro

Hit the 5-rule free cap? Upgrade to Pro (50 rules, $49/mo) — returns a Stripe Checkout link:

curl -X POST https://catalystedgescanner.com/api/v1/filing/upgrade \
  -H "Content-Type: application/json" -d '{"api_key":"$KEY"}'
# → {"checkout_url":"https://checkout.stripe.com/..."}  (open it to pay; your key flips to Pro on success)

Get your free key →

Why