Home › Guides › Form 4 open-market fields in the Aegwah API and ZIP
Form 4 open-market fields in the Aegwah API and ZIP
Aegwah parses SEC Form 4 filings for open-market purchases (code P) and open-market sales (code S). Awards, grants, option exercises, and gifts are excluded. This page documents the fields returned by /v1/insiders/{ticker} and the bulk ZIP.
Core transaction fields (Basic tier)
| Field | Description |
|---|---|
transaction_type | P = open-market purchase, S = open-market sale. Other SEC codes (A, M, G, etc.) are excluded. |
person_name | Reporting insider name from the Form 4 header. |
role | Officer title or Director, parsed from the filing (e.g. "CEO", "CFO", "Director"). |
transaction_date | Date the trade occurred. |
filed_date | Date the Form 4 was filed with the SEC (within two business days of the trade). |
shares | Number of shares bought or sold in the transaction. |
price_per_share | Execution price per share. |
shares_owned_after | Insider's total share holdings following the transaction. |
edgar_accession | SEC accession number for audit. |
edgar_filing_url | Direct link to the Form 4 on EDGAR. |
Scope and coverage
The dataset covers a recent window of Form 4 filings per ticker — not every Form 4 in a company's history. A ticker with zero rows usually means no open-market P/S activity in the recent window (awards-only period), not a failed scrape.
Pro-tier derived fields (field descriptions only)
Pro subscribers get additional endpoints that aggregate raw Form 4 data into derived fields. These describe the data — they are not trade recommendations.
- Clusters (
/v1/insiders/{ticker}/clusters): periods where 3 or more distinct insiders made open-market purchases within a 7-day window. Fields include cluster start/end dates, insider count, and total dollar value. - Conviction scores (
/v1/insiders/{ticker}/conviction): a 0–100 score per purchase based on purchase size relative to holdings, dollar value, and insider role (e.g. CEO/CFO vs. director). Higher scores reflect larger relative purchases by senior insiders — a descriptive metric, not a buy/sell signal. - Ownership summary (
/v1/insiders/{ticker}/ownership): most recent share count and percentage of company held by each insider.
Conviction tiers (VERY_HIGH, HIGH, MEDIUM, LOW) are categorical labels derived from the numeric score. They describe the relative size and seniority of a purchase — not investment advice.
Get institutional-quality earnings data
502 tickers · 16+ years of GAAP EPS · ZIP + REST API. From $30/month.
Research / data documentation only. Not investment advice. Aegwah is a dataset product.