MCP: compact survey mode on get_insider_trades

get_insider_trades accepts compact=true: one summary row per filing — issuer, owners with roles, non-derivative/derivative leg counts, and open-market (code P/S) share and as-filed dollar aggregates — with the row cap raised from 25 to 100 for that mode. A compact row is ~10x smaller than a full filing object, so a day-wide sweep fits in a handful of calls instead of a paging run; full detail stays one get_insider_filing call away. Aggregates sum only legs with parseable as-filed numbers, and the leg counts make any gap visible. Full-object responses are unchanged.

MCP-minted links carry a channel marker

Every FilingPulse page link the MCP server serves — the source.web URL on list/status results and the free-key and docs links in its messages — now carries ?src=mcp. The marker is attribution only: pages serve identically without it. It exists because AI-chat clients routinely strip the Referer header, which made click-throughs from cited results structurally invisible to our analytics.

MCP dataset status reports data freshness

The MCP get_dataset_status tool gained the same data_freshness block as GET /v1/health: status (ok / warn / critical), stale_seconds, and allowance_seconds, judged against SEC EDGAR’s filing calendar by the same shared rule — the tool previously returned raw timestamps it never evaluated. Additive; existing fields are unchanged.

Health endpoint reports data freshness

GET /v1/health gained a data_freshness block: status (ok / warn / critical), stale_seconds, and allowance_seconds, judged against SEC EDGAR’s filing calendar with the same rule our internal monitor uses — the allowance stretches while EDGAR is closed overnight and on weekends, so quiet hours never read as stale. Additive; existing fields are unchanged.

Research hub at /research/

The five published studies — filing delay, amendment lag, Friday disclosure patterns, trading-after-earnings timing, and Form 4 composition by transaction code — now share one index at /research/, with each study’s script and committed results JSON linked beside it. llms.txt and llms-full.txt gained a Research section listing every study and its headline measurement.

MCP results carry source attribution

Every list and status result from the hosted MCP server now includes a source object with a web URL — the human-browsable FilingPulse page showing the same data: the issuer’s ticker page for ticker queries, the fixed /8-k/item-<code>/ page for item-code queries, or the matching directory. Agents presenting these filings to a reader can now cite a page a human can open; the linked page always exists for the arguments that produced the result. Envelope is otherwise unchanged; details on the MCP page.

Study #5: how much of “insider trading” data is actual trading?

Every transaction leg on every Form 4 filed in September 2026 (23,846 legs from 10,134 filings), classified by the SEC’s own transaction codes: open-market purchases and sales are 41.1% of legs and 36.5% of as-filed dollars — the rest are grants, option exercises, tax withholding, gifts and other plan mechanics, and sales outnumber purchases roughly 4:1. Per-day counts verified against EDGAR’s daily index, 21/21 exact. Reproducible on a free key: the study and the one script behind it.

Ticker filters understand multi-listed issuers

Issuers file their ticker field free-form: Watsco files “WSO; WSOB”, Zillow “Z AND ZG”, Kilroy “NYSE: KRC”. The ticker filter on /v1/insider-trades, the screener, the MCP tools, webhook ticker filters, and ticker→CIK resolution on /v1/events now match each symbol of those strings individually — ticker=WSO finds all of Watsco’s filings instead of reporting the ticker unknown. Roughly 6,500 filings across 87 multi-listed or exchange-prefixed issuers became queryable by ticker, and the affected issuers get their ticker pages too.

Jupyter notebook joins the recipes

A month of insider filings in pandas — a downloadable notebook that flattens Forms 3/4/5 transaction legs into a DataFrame, values open-market purchases and sales as filed, charts the issuers with the most insider buying, and cross-references the top issuer’s 8-K events by CIK. Runs top to bottom on a free key; its code cells are executed by the same regression suite as every other example.

Signup requires a real inbox

Free API keys are delivered by email, so signup now declines addresses on known disposable-email domains with a clear error instead of mailing a key into a throwaway inbox. Regular addresses are unaffected, and the free tier still needs nothing but an email.

8-K corporate events, browsable by item code

New page family: /8-k/ lists every official Form 8-K item code with the last 30 days of filing activity, and each code — earnings (2.02), officer changes (5.02), bankruptcies (1.03) and the rest — has its own page of recent filings with EDGAR source links. Classification comes from EDGAR index headers (item codes and links, never body text), the same data the events API serves as JSON.

MCP server speaks protocol 2025-11-25

The MCP endpoint now negotiates MCP spec revision 2025-11-25 (requested by ChatGPT's MCP client on every connection); 2025-06-18 and 2025-03-26 remain accepted, and clients on those revisions see no change. Tools, resources, and prompts are unchanged — the revision's new features are optional and none affect this read-only surface.

10b5-1 plan checkbox on insider filings

Every insider-filing object gains aff10b5_one — the Rule 10b5-1(c) trading-plan checkbox from Forms 4 and 5, as filed ("1"/"true" when the filer declares the transactions were made under a 10b5-1 plan). Additive and live-forward: rows stored before Oct 11, 2026 serve null (the stored data keeps no XML to re-extract from), so treat null as "not recorded", never "not a plan trade". On /v1/insider-trades, webhook payloads, and the MCP tools.

Study #4: Do insiders trade right after earnings?

Every open-market insider purchase and sale with a Q3 2026 transaction date, measured by days since the issuer's most recent earnings 8-K (item 2.02) — the first study to join the Form 4 and 8-K verticals on the issuer. 23.9% of matched trades fall within 10 days of the disclosure, against a 12.1% flat-timing baseline. Like its three siblings, it regenerates from one script on a free key, with both fetches cross-checked day-by-day against EDGAR's daily index. Read it.

MCP ticker prompts work without a ticker

The MCP server's insider_activity and events_digest prompts no longer require ticker: called bare, each renders a market-wide variant over the newest filings (7-day default window) that instructs the agent to state exactly how many of the window's total filings it reviewed. A ticker that is passed but invalid is still a named error — never a silent fall-back to market-wide.

Forms 3 and 5 join the insider dataset (live-forward)

GET /v1/insider-trades now ingests Form 3 (initial statements of beneficial ownership) and Form 5 (annual statements), plus their /A amendments, alongside Form 4 — same normalized schema, same webhook channel, filterable via form_type=3|5. Coverage is live-forward from Sep 23, 2026: there is no 3/5 history before that date, and Form 4 remains the only backfilled form. Additive schema fields shipped with it: holdings rows now carry the derivative-security fields (exercise price/dates, underlying security and shares — previously a derivative holding said almost nothing), and Form 3's no_securities_owned flag is exposed. Every documented field stays present on rows stored before the change (null-filled at the API layer).

MCP task prompts

The hosted MCP server now exposes three ready-made task prompts via prompts/list — insider_activity (Form 4 summary for a ticker), events_digest (8-K digest by item code), and ipo_pipeline (new registrations + freshly priced offerings) — with date windows computed server-side and unknown or malformed arguments rejected by name, the same contract as the tools.

Per-insider pages: /insiders/<cik>/

Every SEC reporting owner filed with a CIK now has a page of their Form 4 filings — issuers, roles as filed, transaction summaries, and a by-issuer rollup — one page per insider across the whole archive. Ticker pages link the insiders behind each issuer's recent activity, and /insiders/ lists recent filers. The same data as JSON: GET /v1/insider-trades?owner_cik=<cik>.

owner_cik= filter on /v1/insider-trades

Query one insider's Form 4 filings across every issuer by their reporting-owner CIK — the CIK on each filing's reporting_owners[]. Combines with the issuer filters (ticker, cik, since/until), works on the REST API and the MCP server's get_insider_trades tool, and covers the full dataset, historical backfill included. API docs.

Study #3: Which corporate events get disclosed on Fridays?

A year of 8-K filings measured by official item code and day of week — what actually gets filed, which items over-index on Fridays, and how EDGAR's 5:30 p.m. filing-date rule shapes what "Friday" even means. Like the two Form 4 studies, it regenerates from one script on a free key, with per-day coverage cross-checked against EDGAR's daily index. Read it.

GET /v1/usage — your key's own meter

Every key can now read its own limits: tier, monthly quota, requests used and remaining this month, per-minute rate limit, and webhook slots — served from the same counters the limits are enforced with, so the numbers cannot disagree with a 429 you just received. The endpoint never consumes the monthly quota, so it keeps working after a quota 429. The key-delivery email's quick-start is also copy-paste ready now (it previously showed a truncated key).

Per-insider rollup on ticker pages

Every ticker page's 90-day summary now includes a by-insider breakdown: open-market purchase and sale legs on non-derivative securities, grouped by the filing's reporting owner(s) — filings, legs, share and dollar totals per insider, largest priced activity first. Joint filings appear once, so the rows sum exactly to the aggregate totals above them. Dollar figures cover priced legs only, computed as shares × price exactly as filed.

Unknown filters are rejected, never silently ignored

The list endpoints (/v1/insider-trades, /v1/events, /v1/registrations) and the free screener now return an explanatory 422 for any query parameter they don't support, naming the offender and the full supported set. Previously a mistyped filter (?tickr=, ?symbol=) was silently dropped and the response was unfiltered data you believed was filtered. The hosted MCP server's tools reject unknown arguments the same way, and every tool schema now declares additionalProperties: false so well-behaved clients catch it before the call.

ticker= filter on /v1/events

8-K corporate events can now be filtered by issuer ticker — GET /v1/events?ticker=META — on both the REST API and the hosted MCP server's get_corporate_events tool. 8-K headers carry no ticker symbol, so the ticker is resolved to a CIK server-side using our own Form 4 dataset (the CIK whose Form 4 most recently carried the ticker wins, so renames resolve the way the filings do). An unknown ticker returns an explained 404 rather than a silently empty list; issuers with no Form 4 filings yet should keep using cik=.

Per-offering registration pages

Every tracked registration statement now has its own page at /registrations/<file-number>/ — the offering's full lifecycle (registration → amendments → effectiveness → final prospectus) as one timeline, threaded by SEC file number, regenerated with the dataset. The registrations index links every tracked offering and its file numbers now click through.

S-1 / IPO API overview page

A dedicated registration lifecycle vertical page: one real offering's complete lifecycle (S-1 → amendment → EFFECT → priced 424B4) shown as the verbatim production response, the seven form types we track, file-number threading, stage-filtered webhooks, and honest limits — live-forward since August 2026, header classification only, no body text.

8-K API overview page

A dedicated 8-K events vertical page: a real production response shown verbatim (one filing, three item codes), the item codes you can filter on, webhook subscriptions filtered by item, and honest limits — we serve the classification and links, not the filing body text.

Insider trading API overview page

A dedicated Form 4 vertical page: a real production response shown verbatim, the schema properties that make it dependable, every query filter with examples, measured freshness numbers from our two published studies, and an honest comparison of insider-data depth across providers.

n8n workflow templates

Three importable n8n workflows: real-time Form 4 insider trade alerts via signed webhooks, a polling variant that needs no public URL, and a daily 8-K corporate events digest. Each posts to Slack/Discord out of the box and swaps to any n8n node. Import from URL, paste a free key, activate.

OpenBB Platform extension

pip install openbb-filingpulse adds FilingPulse as a provider in the OpenBB Platform: Form 4 insider transactions through the standard obb.equity.ownership.insider_trading endpoint, with date-window filters that map to this API's since=/until= for reproducible queries. Details in the SDK docs.

Research study #2: when insider filings get corrected

Insiders re-file corrections as Form 4/A, and each amendment names the date of the original submission it corrects — so correction behavior is measurable. We measured every amendment filed over an eight-week window: how much filing traffic is corrections, how old the corrected filings were (the time a superseded version was the only version), and a lower-bound amendment rate for July 2026's originals — with per-day counts cross-checked against EDGAR's daily index. Like study #1, the whole thing runs from one standard-library script on a free key.

Every object now carries its accession number

8-K event and registration objects gained an accession field — the SEC accession number, the unique, stable identity of every filing. Form 4 objects have carried it since Aug 8; as of today every object served by /v1/events, /v1/registrations, and the matching webhook payloads has it too, including all historical rows (additive change, nothing else moved). Dedupe on accession, not source_url — the polling recipe has been updated to match. Also today: ticker and CIK filters got dedicated indexes, taking the hottest queries from ~150 ms (and multi-second cold-cache outliers) to single-digit milliseconds of server time.

Affiliate program, and referral attribution in the signup funnel

We now share revenue with people who send us customers: 25% recurring for the first 12 months of referred subscriptions, with the complete terms on one page — no income hype, disclosure required. Under the hood, ?ref= links attribute signups end-to-end (30-day window, last click wins), the code rides the Stripe subscription itself so renewals credit correctly, and a malformed ref can never break a signup. Also fixed in passing: the Terms page still described the service as free-of-charge early access — paid tiers have been live since July 31, and section 5 now says so.

Postman collection, and a nightly index-reconciliation pass

The whole REST surface is now importable into Postman in one click: filingpulse.postman_collection.json, generated from the API's own OpenAPI spec with key auth, example filter values, and per-parameter documentation prewired. And behind the scenes, the ingest daemon now re-checks the trailing three days against EDGAR's own daily indexes every night — on its first production run the pass recovered 8 filings the live feed had dropped, so gaps now self-heal within a day instead of waiting for someone to notice.

until= filter and research study #1: the Form 4 filing delay

All three list endpoints (and the MCP tools) now take until= alongside since= — an inclusive upper bound on filed_date, so a fixed date window returns the same population forever. Built for reproducible research and bounded historical pulls. First use: we measured the delay between insider transaction dates and EDGAR filing dates for every Form 4 filed in July 2026, with per-day counts cross-checked against EDGAR's own daily index — the whole study runs from one script on a free key. The check also caught (and we repaired) four filings our live feed had missed.

Free insider-trades screener

A no-signup screener over live Form 4 transaction legs: filter by ticker, transaction code, acquired/disposed, filing window, dollar value, and derivative table — every number exactly as filed, every row linking back to EDGAR. The view is shareable by URL and each ticker page now links straight into it. The JSON, CSV export, and webhooks behind the page remain a free API key away.

Comparison pages and llms.txt

Three new pages compare the realistic ways to get EDGAR data programmatically — Best SEC EDGAR API in 2026, sec-api.io alternatives, and FilingPulse vs sec-api.io — with every competitor fact read from the provider's own pages on a stated date, sources linked, and honest sections on when a competitor is the better choice. The site also now serves /llms.txt and /llms-full.txt: the whole product — endpoints, the frozen schema, tier limits, query patterns — as one machine-readable file for AI assistants, generated from the same contract the API serves so it cannot drift.

Hosted MCP server

FilingPulse now speaks the Model Context Protocol: point Claude, ChatGPT, Cursor, or any MCP client at https://mcp.filingpulse.io/mcp and query normalized Form 4, 8-K, and S-1/IPO data with seven read-only tools — no install, no key required to explore. Anonymous access is rate-limited (20 tool calls/min, 25 rows/call); the MCP page has per-client setup. The REST API also now sees real client IPs behind the proxy, so per-IP throttles apply per client instead of sharing one bucket.

Query patterns page

New Query patterns page: the questions the API gets asked most — filter by ticker, CIK, or amendment status, build an 8-K item digest, thread an offering by SEC file number, sync incrementally with since= and accession dedupe — each as a copy-paste request. Every request on the page is executed against a live API instance by the regression suite; the page is generated from the tested catalog, so it cannot document a request CI never ran.

Form 4 objects now carry accession and filed_date

Every Form 4 returned by the API — and every form4 webhook payload — now includes the SEC accession number (the filing's stable id, and the path parameter for fetching one filing) and the EDGAR acceptance date as filed_date (normalized YYYY-MM-DD, the value since= filters on). Additive change, applied to all historical rows; previously the only stable id on a Form 4 object was buried in source_url. The machine-readable schema at /v1/schema documents both fields.

JavaScript recipes

Two Node examples join the Recipes page: a poller that watches for new filings without re-downloading history (narrow with since=, dedupe by source_url, back off on rate limits), and a webhook receiver that verifies the HMAC signature over the raw request bytes — the thing every JSON body parser quietly breaks. Both run in CI against a live API instance, like the Python four.

Recipes: runnable examples, tested in CI

New Recipes page: four complete programs — CSV export of a ticker's Form 4 transactions, an 8-K item digest, a signature-verifying webhook receiver with Slack forwarding, and IPO threading by SEC file number. Every script is executed against a live API instance in the regression suite; the downloads are the tested files themselves.

S-1 registrations on the homepage

The homepage live section now includes the newest registration events alongside insider trades, and the 30-day volume band counts all three verticals.

Registration pipeline, browsable

New /registrations/ page: the S-1/F-1 pipeline with lifecycle stages and file-number threads, refreshed every six hours. Notices of effectiveness are listed separately — most cover form types we don't track yet, and the page says so.

Third data vertical: S-1/IPO registration lifecycle

GET /v1/registrations and the registration webhook event: S-1/F-1 registrations, amendments, SEC effectiveness notices, and final priced prospectuses, threaded across one offering by SEC file number. Live-forward from August 1; no backfill yet.

Self-serve signup opens — free and paid tiers

Key delivery by email at /signup.html; paid tiers checkout via Stripe. Official Python and JavaScript SDKs published to PyPI and npm. Support inbox live at keys@filingpulse.io.

Site redesign; search indexing begins

New public site with live dataset statistics on the homepage. Domain verified with Google Search Console; sitemap of 2,900+ issuer pages submitted and accepted.

Per-issuer data pages

2,911 ticker pages published at /insider-trades/ — insider transaction history and 8-K events per issuer, regenerated from the live dataset every six hours.

Automated pipeline monitoring

Health evaluation every ten minutes across ingestion freshness, backfill progress, and service state, with thresholds aware of EDGAR's filing calendar (quiet weekends don't false-alarm; weekday stalls surface within the hour).

Backfill resilience fix

Found and fixed a stall where EDGAR's unusual error behavior for never-published weekend index files could livelock historical backfill. Backfill errors are now fully isolated from live polling, with regression tests pinning the fix.

Public launch

filingpulse.io and api.filingpulse.io live with TLS. Production ingestion running in Ashburn, Virginia; 24-month historical backfill started.

Core platform

Normalized schema v1 frozen (values as filed, fields never missing, additive-only evolution). Form 4 and 8-K ingestion, REST API v1 with keys and rate limits, and HMAC-signed webhook delivery with automatic retries — all pinned by a regression corpus of real filings.