Coverage
What you get
| Item | Detail |
|---|---|
| Product code | STK-OWNERSHIP |
| Coverage | US issuers: insider transactions (Forms 3, 4 and 5), institutional 13F holdings, congressional trade disclosures |
| Granularity | One row per disclosed transaction or holding |
| History | Full EDGAR history: Form 4 from 2003, 13F XML from 2013 |
| Delivery | REST, CSV and JSON files |
| Update speed | Per filing; real-time Form 4 alerts on Pro |
All three record types share one schema, with record_type telling them apart. A CEO's sale, a fund's quarterly position and a senator's disclosed purchase can sit in the same DataFrame without three separate parsers.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Ticker of the issuer |
record_type |
string | yes | insider, institutional, congress |
filer_name |
string | yes | Insider, fund or politician name |
filer_role |
string | optional | e.g. CEO, Director, 10% owner, Senator |
transaction_date |
string | yes | Trade date (period end for 13F) |
filed_date |
string | yes | Disclosure date |
transaction_code |
string | optional | SEC Form 4 code (P, S, A, M...) |
side |
string | optional | buy, sell |
shares |
number | optional | Shares traded or held |
price |
number | optional | Price per share |
value |
number | optional | shares x price |
shares_owned_after |
number | optional | Holding after trade |
amount_min / amount_max |
number | optional | Congress value range |
is_10b5_1 |
boolean | optional | Pre-planned trade flag |
accession_number |
string | optional | SEC accession number |
Example record (illustrative values, not a real filing):
{
"symbol": "META",
"record_type": "insider",
"filer_name": "Example Insider",
"filer_role": "CFO",
"transaction_date": "2026-11-14",
"filed_date": "2026-11-18",
"transaction_code": "S",
"side": "sell",
"shares": 2150,
"price": 589.4,
"value": 1267210,
"shares_owned_after": 81442,
"is_10b5_1": true,
"accession_number": "0001326801-26-000412"
}
Sample data
Sample data
No free ownership sample yet. The source filings are public, and we're building the parser on the same EDGAR pipeline as our fundamentals sample. A sample file is available on request for any ticker.
Use cases
Use cases
Insider buying clusters. Filter record_type = insider, transaction_code = P (an open-market purchase) and count distinct filer_name per symbol over 30 days. Several insiders buying with their own money is a different signal from one director exercising options.
Dropping planned sales. Sales under a 10b5-1 plan were scheduled months earlier. Set is_10b5_1 to false in your filter and what's left are the discretionary trades.
Following a fund. Pull 13F rows for one filer_name across quarters and diff shares to see what it added and sold. Keep in mind 13F reports land up to 45 days after quarter end, so filed_date is when you could have known.
Congress trades. Disclosures give a value range, not an exact amount, so use amount_min and amount_max rather than value when you size the trade.
Code
Code examples
Example: open-market insider purchases for META this year.
curl "https://api.marketdata.co/v1/stocks/ownership?symbol=META&record_type=insider&transaction_code=P&start=2026-01-01" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, insider net buying by month.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/stocks/ownership",
params={"symbol": "META", "record_type": "insider", "start": "2025-01-01"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
df = pd.DataFrame(resp.json()["results"])
df["filed_date"] = pd.to_datetime(df["filed_date"])
df["signed_value"] = df["value"].where(df["side"] == "buy", -df["value"])
print(df.groupby(df["filed_date"].dt.to_period("M"))["signed_value"].sum())
Pricing
Pricing
| Plan | Ownership data |
|---|---|
| Starter, $29/mo | Insider, 13F and congress trades, full EDGAR history |
| Pro, $79/mo | Adds real-time Form 4 alerts |
| Business, $249/mo | Commercial use |
Planned files: full insider transaction history at $79 one-off, and 13F holdings at $49 per quarter or $299 for all history. Prices are early access and may change.
The vendors we studied charge $50 to $299 a month for this data, median $124. Three give it away free.
Side by side
How we compare
13 of the 50 providers we studied sell insider or institutional ownership data. Few publish how far back it goes. Ours follows EDGAR's own history, costs $29 a month with the price on the page, and uses the same symbol, filed_date and accession_number fields as our SEC filings API, so you can click from a trade to the form it came from.
FAQ
Frequently asked questions
How soon after a trade does it show up?
Insiders must file Form 4 within two business days of the trade, and we pick it up when EDGAR publishes. 13F reports come quarterly, up to 45 days after quarter end.
What do the transaction codes mean?
They're the SEC's Form 4 codes. P is an open-market purchase, S a sale, A a grant or award, and M an option exercise.
Are congress trades exact?
No. The STOCK Act only requires a value range, which we store in amount_min and amount_max.
Which date should a backtest use?
filed_date. transaction_date is when the trade happened, but nobody outside the company knew until the filing.
Can I get the data as files?
Yes. Every query can return CSV or JSON, and the full-history files are planned as one-off downloads.
Keep reading
Related
- Asset hub: Stocks
- Symbols: AAPL, MSFT, NVDA, AMZN, GOOGL, META
- Docs: API reference: fundamentals
- Learn: Choosing a market data provider