get_ownership_distribution
TOOLGet ownership distributionscope: dataflow:distribution.read · read-only
Tool description, as exposed to the agent
Returns the ownership composition of a publicly listed company as a single dated snapshot, broken down along one dimension you choose. Use search_securities first to obtain the company_id. The breakdown parameter selects the dimension: 'type' groups owners by kind (institution, fund company, physical person, …); 'country' shows foreign vs domestic and by owner domicile; 'region', 'size', 'age', and 'gender' give geographic and demographic cuts. Each bucket reports the share of capital and votes it holds, the absolute shares, and how many distinct owners it contains. Buckets are ordered by capital, largest first. Pair with get_owner_list for the named top owners behind these buckets. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | required | Company whose ownership distribution to return, from search_securities. Nonzero integer; the sign of the ID has NO meaning; negative IDs are normal and are NOT a flag for 'unlisted', 'private', or anything else. Pass it through verbatim. |
| breakdown | 'type' | 'country' | 'region' | 'size' | 'age' | 'gender' | optional | The dimension to break ownership down by. 'type' = owner type (institution, fund company, physical person, …); 'country' = domicile country of owners (foreign vs domestic); 'region' = geographic region; 'size' = holding-size cohort; 'age'/'gender' = demographic cohorts of physical owners. Default 'type'.default "type" |
| at | string | optional | Optional snapshot date in YYYY-MM-DD. Defaults to today UTC. Must not be in the future. |
Billing
Pricing key: distribution.snapshot. Successful calls consume Dataflow credits per your contract. See Credits & pricing.