Data sources
Every record this API returns comes from a filing submitted to the SEC (U.S. Securities and Exchange Commission) and published through EDGAR, its public filing system. This page explains which forms we read and what each one actually says, so you can judge what a number means before you build on it.
Why the form matters
A filing is a legal document with a deadline, not a market feed. The form tells you what a record can and cannot say: how quickly it had to be filed, whether it reports a single event or a quarter in aggregate, and whether it corrects something filed earlier. Two records from the same endpoint can therefore be a day and a quarter old.
Insider transactions
/insider
- Form 4
- A company insider — an officer, a director or an owner of more than ten percent of the shares — reports that their holding changed: a purchase, a sale, an option exercise, a grant. Due within two business days of the transaction, which is why this is the timely part of insider data.
- Form 5
- The annual catch-up: transactions that were exempt from Form 4 during the year, such as gifts or inherited shares, plus anything that missed its Form 4 deadline. Filed after the end of the company’s fiscal year, so it describes the past year, not the past days.
- Form 4/A and 5/A
- An amendment to a Form 4 or Form 5 already filed: a corrected price or share count, or a line the insider left out — sometimes months later. It is read like the form it corrects and kept as rows of its own next to the original, which stays unchanged. An amendment names the date of the original filing but not its accession number; that date is in original_filed_on.
Material events
/events
- Form 8-K
- The report a company files when something material happens between its quarterly reports — a bankruptcy, a merger, a change in leadership, a cyber incident. Due within four business days of the event. Each 8-K names the item numbers it reports under, and those numbers are what we normalise into an event type.
- Form 8-K/A
- An amendment to an 8-K already filed: a correction, or a detail the company did not have ready in time. It runs through the same normalisation as the original.
- Form NT 10-K and NT 10-Q
- A notification of late filing: the company announces that its annual report (10-K) or quarterly report (10-Q) will not arrive on time, and why. These become events of type late_filing — an admission that is often news in itself.
Institutional holdings
/institutional
- Form 13F-HR
- The quarterly holdings report of an institutional investment manager that holds more than 100 million dollars in qualifying US securities: which securities it held at the end of the quarter, how many shares and at what value. It is a snapshot of one day per quarter, not a record of the trades that led there.
- Form 13F-HR/A
- An amendment to a holdings report. Its cover page says how it is meant to be read: as a restatement, which replaces the portfolio we hold for that quarter, or as additional holdings, which are added to it — typically positions whose confidential treatment has expired.
- Form 13F-NT
- A notice that a manager files when its holdings are reported in another manager’s filing instead of its own. It carries no positions, so it creates no holdings here; we process it to keep the picture of who reported what complete.
Filing deadlines
A deadline is the SEC’s, not ours: it bounds how fresh a record can be at best, however fast we process it. Many filings arrive well before their deadline.
| Form | Must be filed |
|---|---|
| Form 4 | Within two business days of the transaction |
| Form 5 | After the end of the company’s fiscal year |
| Form 8-K, 8-K/A | Within four business days of the event |
| Form NT 10-K, NT 10-Q | No later than one business day after the due date of the late report |
| Form 13F-HR, 13F-HR/A, 13F-NT | Up to 45 days after the end of the quarter |
From filing to answer
We poll EDGAR for the forms above, store each filing as it arrived, and read the numbers out of it into the endpoints. Nothing is fetched from the SEC while your request is running, so a slow day at EDGAR shows up as older data, not as a slow response. What a record was derived from stays visible: filing_id and source_url point at the original document — see every record names its source.
How current the data is per source — last filing seen, last successful import — is answered by /status, and every response carries meta.data_freshness. For events there is a measured figure for the delay between a filing being accepted at the SEC and reaching a connected client.
Where the form shows up in the data
Insider transactions carry the form_type field with the value 4, 5, 4/A or 5/A, and the same name works as a filter — useful when you want only the timely reports and not the annual catch-up. Insider amendments are not applied to the original: an amendment usually repeats the whole filing, so do not add an original and its amendment together. Cluster buys and the officer buy/sell ratio count originals only. Late-filing notices appear as the event type late_filing. Holdings, by contrast, are reported per quarter with amendments already applied, so you read the corrected state rather than a stack of filings. The endpoint reference lists the exact fields and values.