Get Float Data
get_float
Get float data for a company: floatShares, floatDefinition, the as-of date and, when the headline float is withheld, the bounds and labelled stand-ins that replace it. Null, absent or withheld means not measured; it does not mean "no float", "no restricted shares" or zero. A numeric 0 is a measured zero, so the reason and marker fields ("floatWithheldReason", "restrictedBlockCount", "provenance", "direction") carry the verdict, not the value alone. The share count the float was judged against ("basisSharesOutstanding") is dated by "sharesOutstandingAsOf" and "sharesOutstandingAsOfKind" ("stated", "checked", or "none" = date not recorded) and "sharesOutstandingSource". "floatDefinition": "tradeable" (shares outstanding minus affiliates minus restricted/unregistered blocks; filing-derived snapshot tickers), "non_affiliate" (the SEC I.B.6 figure, which includes restricted shares held by non-affiliates and is not a trader's float), "non_affiliate_estimate" (from ownership filings), "free_float" (vendor). "floatDefinition" and "source" appear only on snapshot results; an absent floatDefinition means the figure is not a filing-derived tradeable float. "nonAffiliateFloatShares" (snapshot tickers) is the input that baby-shelf / I.B.6 math rests on; it is not tradeable supply, and the tradeable float is not an I.B.6 input. Precedence: when the snapshot carries any figure ("floatEstimate", "tradeableFloatCeiling", an "affiliateBasis" range), "floatShares" stays null and that figure is the answer. A lower tier fills "floatShares" (its own "source" and definition, with "snapshotFloatWithheldReason" as provenance context, not a second refusal) only when the snapshot has no figure, or its only figure is a trivial ceiling (at or above 99% of the share count), which is stripped. Floors, points, every "shares_outstanding_ceiling" and an "affiliate_sizing_estimate" (with its "reason" and "unsizedAffiliates") are kept. A lower tier that also answered appears as "otherSourceFloat" {floatShares, source, provenance:"other_source", floatDefinition, asOfDate}: a secondary other-source figure, not the float and not an input to arithmetic. A lower-tier figure that predates a split the snapshot names, predates recorded issuances of 10% or more of it, or falls outside the snapshot's bounds is refused: "fallbackRefusal" {reason, refusedSource, detail}. "floatShares" null with "floatWithheldReason" set and no lower-tier figure means no source could answer. A point (bound "point", or a "floatEstimate" with "statedAsOf" {asOf, source, events[]}) is a plain number as of asOf, with the unsized later issuances in "statedAsOf.events" as its caveat. A ceiling, floor or range is not a float figure: it means the filings put the float at most or at least N. Stand-ins on a withheld result are not floats and are not inputs to a market cap, percent-of-float, short-interest ratio, screen, sort or comparison. (1) "tradeableFloatCeiling": the tradeable float is at most this (null = no bound, not 0). (2) "affiliateBasis.floatLowerBound" / "floatUpperBound": a range for the non-affiliate float (still including non-affiliate restricted shares); each end is null independently; on a published float it is context only. (3) "floatEstimate" {shares, basis, direction, confidence, rung, bound, asOf, reason, qualifier, offBasis, statedAsOf, staleness}: "basis" says what it rests on; "direction" "overstates" = the true float is at most shares, "understates" = at least, "unknown"; "rung" names the ladder step; rung "best_estimate" is the most likely figure when every filing rung withheld ("basisKind" = what it rests on, "assumptions" = how each unsized holder was treated), an estimate and not a measurement; "qualifier" is the caveat that belongs with the figure. "offBasis": "pre_split_as_filed" (as of asOf, before "splitsAfter" [{ratio, effectiveDate, status}]), "ordinary_shares_unconverted" (ordinary shares, not ADSs), "count_predates_issuances" (dated cover count "countSource", later issuances uncounted); an offBasis figure is accurate only with its label and is not comparable with a price, market cap, another float or a threshold. "staleness" flags a point older than 12 months or post-dated by a known issuance. An estimate never becomes floatShares. Unrelated to the boolean "floatEstimated" (a published floatShares back-derived from a USD public-float disclosure). (4) "vendorFallback" {floatShares, provenance:"vendor", floatDefinition:"free_float", asOfDate, splitAdjusted}: a third-party free float as of its date, not Signal8's float. "restrictedShares" null means not measured (a block exists whose size the filings leave unstated), not zero; "restrictedBlockCount" 0 is a measured answer. "affiliateBasisStale" (basisSpanDays, affiliateAnchorDate) labels an affiliate table materially older than the share count. "tradeableBasis": "convention_conservative" means a published convention resolved the figure (see "tradeableConvention"), so it is not exact.
Schema valid · SHA-256 4dd117a90157…
View input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Stock ticker symbol (e.g., \"AAPL\", \"TSLA\")"
}
},
"required": [
"ticker"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}