get_shares_outstanding
TOOLGet shares outstandingscope: dataflow:shares.read · read-only
Tool description, as exposed to the agent
Returns the number of shares outstanding and total voting rights for a publicly listed company on a given date, broken into two perspectives: regulatory (the total number of shares the company has issued, including treasury shares the company holds itself) and market (issued minus treasury — what is actually held by external owners). Use search_securities first to obtain the company_id. The 'at' parameter selects the date; omit it for the latest available reading (max 5 years in the past). Each share class is also broken out individually in the stocks list, including the voting-rights weight per share (useful when companies have multi-class structures where one share class carries more votes than another). Pair with get_free_float on the same company_id for the publicly-traded fraction view. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | required | Company to read for, 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. |
| at | string | optional | Optional snapshot date in YYYY-MM-DD. Omit for the latest available reading. Maximum 5 years in the past. |
Billing
Pricing key: shares.outstanding. Successful calls consume Dataflow credits per your contract. See Credits & pricing.