Skip to main content

Institutional Ownership


Implementation details​

Class names​

Model nameParameters classData class
InstitutionalOwnershipInstitutionalOwnershipQueryParamsInstitutionalOwnershipData

Import Statement​

from openbb_core.provider.standard_models.institutional_ownership import (
InstitutionalOwnershipData,
InstitutionalOwnershipQueryParams,
)

Parameters​

NameTypeDescriptionDefaultOptional
symbolUnion[str, List[str]]Symbol to get data for.False
include_current_quarterboolInclude current quarter data.FalseTrue
datedateA specific date to get data for.NoneTrue
providerLiteral['fmp']The provider to use for the query, by default None. If None, the provider specified in defaults is selected or 'fmp' if there is no default."fmp"True

Data​

NameTypeDescription
symbolstrSymbol representing the entity requested in the data.
cikstrCIK of the company.
datedateThe date of the data.
investors_holdingintNumber of investors holding the stock.
last_investors_holdingintNumber of investors holding the stock in the last quarter.
investors_holding_changeintChange in the number of investors holding the stock.
number_of_13f_sharesintNumber of 13F shares.
last_number_of_13f_sharesintNumber of 13F shares in the last quarter.
number_of_13f_shares_changeintChange in the number of 13F shares.
total_investedfloatTotal amount invested.
last_total_investedfloatTotal amount invested in the last quarter.
total_invested_changefloatChange in the total amount invested.
ownership_percentfloatOwnership percent.
last_ownership_percentfloatOwnership percent in the last quarter.
ownership_percent_changefloatChange in the ownership percent.
new_positionsintNumber of new positions.
last_new_positionsintNumber of new positions in the last quarter.
new_positions_changeintChange in the number of new positions.
increased_positionsintNumber of increased positions.
last_increased_positionsintNumber of increased positions in the last quarter.
increased_positions_changeintChange in the number of increased positions.
closed_positionsintNumber of closed positions.
last_closed_positionsintNumber of closed positions in the last quarter.
closed_positions_changeintChange in the number of closed positions.
reduced_positionsintNumber of reduced positions.
last_reduced_positionsintNumber of reduced positions in the last quarter.
reduced_positions_changeintChange in the number of reduced positions.
total_callsintTotal number of call options contracts traded for Apple Inc. on the specified date.
last_total_callsintTotal number of call options contracts traded for Apple Inc. on the previous reporting date.
total_calls_changeintChange in the total number of call options contracts traded between the current and previous reporting dates.
total_putsintTotal number of put options contracts traded for Apple Inc. on the specified date.
last_total_putsintTotal number of put options contracts traded for Apple Inc. on the previous reporting date.
total_puts_changeintChange in the total number of put options contracts traded between the current and previous reporting dates.
put_call_ratiofloatPut-call ratio, which is the ratio of the total number of put options to call options traded on the specified date.
last_put_call_ratiofloatPut-call ratio on the previous reporting date.
put_call_ratio_changefloatChange in the put-call ratio between the current and previous reporting dates.