Insider trades

GET /v1/companies/{id}/insider-trades

Transactions that a company’s insiders reported on SEC Forms 3, 4 and 5, newest first. {id} is the company whose shares were traded. Each row is one transaction from one filing.

curl -H "X-API-Key: $BELFORT_API_KEY" \
  "https://belfort-data-api.vercel.app/v1/companies/AAPL/insider-trades?limit=20"

Parameters

Parameter	Values	Default
limit	1–50 rows per page.	20
cursor	The previous page’s meta.next_cursor.

One transaction

Field	Meaning
issuer_cik, issuer_name, issuer_trading_symbol	The company, as the filing names it.
accession, filing_url	The filing, and its page on EDGAR.
form, amends, filed	The form, whether it amends an earlier one, and the day it was filed.
period_of_report, original_filing_date	The filing’s period, and for an amendment, when the original was filed.
owners	Every reporting owner on the filing, each with cik, name, role and title.
owner, role	The owner and their role, set only when the filing has exactly one owner.
table	nonderivative (shares) or derivative (options, warrants and the like).
security_title	The security traded, as filed.
date, code	The transaction date, and the SEC transaction code.
shares, price, shares_after	Shares traded, price per share, and shares held afterwards.
acquired_disposed	Whether the shares were acquired or disposed of.
ownership, nature_of_ownership	Direct (D) or indirect (I) ownership, and how indirect ownership is held.

What to expect

• A blank price is null, never 0. A price filed as 0 stays 0.
• Several owners on one filing share each transaction row; owners lists them all. Don’t add their positions together as if each held the shares separately.
• Amendments. When an amendment can be matched to exactly one original filing, the original’s transactions are dropped in favour of the amendment’s. When it can’t be matched, or matches more than one, every filing is kept.
• Holdings-only rows are left out. A form that reports a holding with no transaction adds no row.