get_free_float
TOOLGet free floatscope: dataflow:freefloat.read · read-only
Tool description, as exposed to the agent
Returns the free-float of a publicly listed company on a given date — the number and fraction of shares held by the investing public, excluding shares held by long-term strategic holders (insiders, majority owners, treasury). 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). The response carries the company-level free_float (shares and capital fraction 0–1) plus a per-share-class breakdown in the stocks list. If the company has no published free-float reading on this date, the free_float field is null (zero would mean an actual zero free-float, which is different). Pair with get_shares_outstanding for the total shares context. 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: freefloat.snapshot. Successful calls consume Dataflow credits per your contract. See Credits & pricing.