insider_trading
Get data about trading by a company's management team and board of directors.
Examples
from openbb import obb
obb.equity.ownership.insider_trading(symbol='AAPL', provider='fmp')
obb.equity.ownership.insider_trading(symbol='AAPL', limit=500, provider='intrinio')
Parameters
- standard
- fmp
- intrinio
- sec
- tmx
symbol: str
Symbol to get data for.
limit: int
The number of data entries to return.
symbol: str
Symbol to get data for.
limit: int
The number of data entries to return.
transaction_type: Literal['award', 'conversion', 'return', 'expire_short', 'in_kind', 'gift', 'expire_long', 'discretionary', 'other', 'small', 'exempt', 'otm', 'purchase', 'sale', 'tender', 'will', 'itm', 'trust']
Type of the transaction.
statistics: bool
Default: False
Flag to return summary statistics for the given symbol. Setting as True will ignore other parameters except symbol.
symbol: str
Symbol to get data for.
limit: int
The number of data entries to return.
start_date: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
ownership_type: Literal['D', 'I']
Type of ownership.
sort_by: Literal['filing_date', 'updated_on']
Default: updated_on
Field to sort by.
symbol: str
Symbol to get data for.
limit: int
The number of data entries to return.
start_date: date | 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 | str
End date of the data, in YYYY-MM-DD format. Default is today.
use_cache: bool
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.
symbol: str
Symbol to get data for.
limit: int
The number of data entries to return.
summary: bool
Default: False
Return a summary of the insider activity instead of the individuals.
Returns
results: list[InsiderTrading]
Serializable results.
provider: Optional[Literal['fmp', 'intrinio', 'sec', 'tmx']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- fmp
- intrinio
- sec
- tmx
symbol: str
Symbol representing the entity requested in the data.
company_cik: str
CIK number of the company.
filing_date: Union[date, datetime]
Filing date of the trade.
transaction_date: date
Date of the transaction.
owner_cik: Union[str, int]
Reporting individual's CIK.
owner_name: str
Name of the reporting individual.
owner_title: str
The title held by the reporting individual.
ownership_type: str
Type of ownership, e.g., direct or indirect.
transaction_type: str
Type of transaction being reported.
acquisition_or_disposition: str
Acquisition or disposition of the shares.
security_type: str
The type of security transacted.
securities_owned: float
Number of securities owned by the reporting individual.
securities_transacted: float
Number of securities transacted by the reporting individual.
transaction_price: float
The price of the transaction.
filing_url: str
Link to the filing.
symbol: str
Symbol representing the entity requested in the data.
company_cik: str
CIK number of the company.
filing_date: Union[date, datetime]
Filing date of the trade.
transaction_date: date
Date of the transaction.
owner_cik: Union[str, int]
Reporting individual's CIK.
owner_name: str
Name of the reporting individual.
owner_title: str
The title held by the reporting individual.
ownership_type: str
Type of ownership, e.g., direct or indirect.
transaction_type: str
Type of transaction being reported.
acquisition_or_disposition: str
Acquisition or disposition of the shares.
security_type: str
The type of security transacted.
securities_owned: float
Number of securities owned by the reporting individual.
securities_transacted: float
Number of securities transacted by the reporting individual.
transaction_price: float
The price of the transaction.
filing_url: str
Link to the filing.
form_type: str
The SEC form type.
year: int
The calendar year for the statistics.
quarter: int
The calendar quarter for the statistics.
acquired_transactions: int
Number of acquired transactions (statistics only).
disposed_transactions: int
Number of disposed transactions (statistics only).
transactions_ratio: float
Ratio of acquired to disposed transactions (statistics only).
total_acquired: Union[float, int]
Total number of shares acquired (statistics only).
total_disposed: Union[float, int]
Total number of shares disposed (statistics only).
average_acquired: float
Average number of shares acquired per transaction (statistics only).
average_disposed: float
Average number of shares disposed per transaction (statistics only).
total_purchases: int
Total number of purchase transactions (statistics only).
total_sales: int
Total number of sale transactions (statistics only).
symbol: str
Symbol representing the entity requested in the data.
company_cik: str
CIK number of the company.
filing_date: Union[date, datetime]
Filing date of the trade.
transaction_date: date
Date of the transaction.
owner_cik: Union[str, int]
Reporting individual's CIK.
owner_name: str
Name of the reporting individual.
owner_title: str
The title held by the reporting individual.
ownership_type: str
Type of ownership, e.g., direct or indirect.
transaction_type: str
Type of transaction being reported.
acquisition_or_disposition: str
Acquisition or disposition of the shares.
security_type: str
The type of security transacted.
securities_owned: float
Number of securities owned by the reporting individual.
securities_transacted: float
Number of securities transacted by the reporting individual.
transaction_price: float
The price of the transaction.
filing_url: str
URL of the filing.
company_name: str
Name of the company.
conversion_exercise_price: float
Conversion/Exercise price of the shares.
deemed_execution_date: date
Deemed execution date of the trade.
exercise_date: date
Exercise date of the trade.
expiration_date: date
Expiration date of the derivative.
underlying_security_title: str
Name of the underlying non-derivative security related to this derivative transaction.
underlying_shares: Union[float, int]
Number of underlying shares related to this derivative transaction.
nature_of_ownership: str
Nature of ownership of the insider trading.
director: bool
Whether the owner is a director.
officer: bool
Whether the owner is an officer.
ten_percent_owner: bool
Whether the owner is a 10% owner.
other_relation: bool
Whether the owner is having another relation.
derivative_transaction: bool
Whether the owner is having a derivative transaction.
report_line_number: int
Report line number of the insider trading.
symbol: str
Symbol representing the entity requested in the data.
company_cik: str
CIK number of the company.
filing_date: Union[date, datetime]
Filing date of the trade.
transaction_date: date
Date of the transaction.
owner_cik: Union[str, int]
Reporting individual's CIK.
owner_name: str
Name of the reporting individual.
owner_title: str
The title held by the reporting individual.
ownership_type: str
Type of ownership, direct or indirect.
transaction_type: str
Type of transaction being reported.
acquisition_or_disposition: str
Acquisition or disposition of the shares.
security_type: str
The type of security transacted.
securities_owned: float
Number of securities owned by the reporting individual.
securities_transacted: float
Number of securities transacted by the reporting individual.
transaction_price: float
The price of the transaction.
filing_url: str
Link to the filing.
company_name: str
Name of the company.
form: Union[str, int]
Form type.
director: bool
Whether the owner is a director.
officer: bool
Whether the owner is an officer.
ten_percent_owner: bool
Whether the owner is a 10% owner.
other: bool
Whether the owner is classified as other.
other_text: str
Text for other classification.
transaction_timeliness: str
Timeliness of the transaction.
nature_of_ownership: str
Nature of the ownership.
exercise_date: date
Date of exercise.
expiration_date: date
Date of expiration for the derivative.
deemed_execution_date: date
Deemed execution date.
underlying_security_title: str
Title of the underlying security.
underlying_security_shares: float
Number of underlying shares associated with the derivative.
underlying_security_value: float
Value of the underlying security.
conversion_exercise_price: float
Price of conversion or exercise of the securities.
transaction_value: float
Total value of the transaction.
value_owned: float
Value of the securities owned after the transaction.
footnote: str
Footnote for the transaction.
symbol: str
Symbol representing the entity requested in the data.
company_cik: str
CIK number of the company.
filing_date: Union[date, datetime]
Filing date of the trade.
transaction_date: date
Date of the transaction.
owner_cik: Union[str, int]
Reporting individual's CIK.
owner_name: str
The name of the insider.
owner_title: str
The title held by the reporting individual.
ownership_type: str
Type of ownership, e.g., direct or indirect.
transaction_type: str
Type of transaction being reported.
acquisition_or_disposition: str
Acquisition or disposition of the shares.
security_type: str
The type of security transacted.
securities_owned: int
The number of shares held by the insider.
securities_transacted: int
The total number of shares traded by the insider over the period.
transaction_price: float
The price of the transaction.
filing_url: str
Link to the filing.
period: str
The period of the activity. Bucketed by three, six, and twelve months.
acquisition_or_deposition: str
Whether the insider bought or sold the shares.
number_of_trades: int
The number of shares traded over the period.
trade_value: float
The value of the shares traded by the insider.
securities_bought: int
The total number of shares bought by all insiders over the period.
securities_sold: int
The total number of shares sold by all insiders over the period.
net_activity: int
The total net activity by all insiders over the period.