insider_trading
Get data about trading by a company's management team and board of directors.
Examples
from openbb import obb
obb.sec.insider_trading(symbol='AAPL', provider='sec')
Parameters
- standard
- sec
symbol: str
Symbol to get data for.
limit: int | None
The number of data entries to return.
symbol: str
Symbol to get data for.
limit: int | None
The number of data entries to return.
start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. Wide date ranges can result in long download times. Recommended to use a smaller date range, default is 120 days ago.
end_date: date | None | str
End date of the data, in YYYY-MM-DD format. Default is today.
use_cache: bool | None
Default: True
Persist the data locally for future use. Default is True. Each form submission is an individual download and the SEC limits the number of concurrent downloads. This prevents the same file from being downloaded multiple times.
Returns
results: SecInsiderTrading
Serializable results.
provider: str | None
Provider name.
warnings: Optional[list[Warning_]]
List of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- sec
symbol: str | None
Symbol representing the entity requested in the data.
company_cik: str | None
CIK number of the company.
filing_date: date | datetime | None
Filing date of the trade.
transaction_date: date | None
Date of the transaction.
owner_cik: int | str | None
Reporting individual's CIK.
owner_name: str | None
Name of the reporting individual.
owner_title: str | None
The title held by the reporting individual.
ownership_type: str | None
Type of ownership, e.g., direct or indirect.
transaction_type: str | None
Type of transaction being reported.
acquisition_or_disposition: str | None
Acquisition or disposition of the shares.
security_type: str | None
The type of security transacted.
securities_owned: float | None
Number of securities owned by the reporting individual.
securities_transacted: float | None
Number of securities transacted by the reporting individual.
transaction_price: float | None
The price of the transaction.
filing_url: str | None
Link to the filing.
symbol: str | None
Symbol representing the entity requested in the data.
company_cik: str | None
CIK number of the company.
filing_date: date | datetime | None
Filing date of the trade.
transaction_date: date | None
Date of the transaction.
owner_cik: int | str | None
Reporting individual's CIK.
owner_name: str | None
Name of the reporting individual.
owner_title: str | None
The title held by the reporting individual.
ownership_type: str | None
Type of ownership, direct or indirect.
transaction_type: str | None
Type of transaction being reported.
acquisition_or_disposition: str | None
Acquisition or disposition of the shares.
security_type: str | None
The type of security transacted.
securities_owned: float | None
Number of securities owned by the reporting individual.
securities_transacted: float | None
Number of securities transacted by the reporting individual.
transaction_price: float | None
The price of the transaction.
filing_url: str | None
Link to the filing.
company_name: str | None
Name of the company.
form: int | str | None
Form type.
director: bool | None
Whether the owner is a director.
officer: bool | None
Whether the owner is an officer.
ten_percent_owner: bool | None
Whether the owner is a 10% owner.
other: bool | None
Whether the owner is classified as other.
other_text: str | None
Text for other classification.
transaction_timeliness: str | None
Timeliness of the transaction.
nature_of_ownership: str | None
Nature of the ownership.
exercise_date: date | None
Date of exercise.
expiration_date: date | None
Date of expiration for the derivative.
deemed_execution_date: date | None
Deemed execution date.
underlying_security_title: str | None
Title of the underlying security.
underlying_security_shares: float | None
Number of underlying shares associated with the derivative.
underlying_security_value: float | None
Value of the underlying security.
conversion_exercise_price: float | None
Price of conversion or exercise of the securities.
transaction_value: float | None
Total value of the transaction.
value_owned: float | None
Value of the securities owned after the transaction.
footnote: str | None
Footnote for the transaction.