Float

GET

/stocks/vX/float

This endpoint is experimental and the interface may change.

Retrieve the latest free float for a specified stock ticker. Free float represents the shares outstanding that are considered available for public trading, after accounting for shares held by strategic or long-term holders.

Shares held by founders, officers and directors, employees, controlling shareholders, affiliated companies, private equity and venture capital firms, sovereign wealth funds, government entities, employee plans, trusts, restricted or locked-up holdings, and any shareholder owning 5% or more of total issued shares are not treated as part of the tradable supply. Shares held by pension funds, mutual funds, ETFs, hedge funds without board representation, depositary banks, and other broadly diversified investors are generally treated as part of the public free float.

Free float reflects a stock’s effective tradable supply and is a key input for assessing liquidity, volatility, market impact, and ownership structure. Figures may reflect ownership changes with a reporting lag, since they are based on publicly available disclosures and ownership information rather than real-time trading activity.

Use cases: liquidity analysis, volatility modeling, position sizing, market impact estimation, and ownership structure analysis.

Plan

Access

Plan Accessloading..

Plan

Recency

Updated as needed

Updated as needed

Updated as needed

Updated as needed

Updated as needed

Plan Recencyloading..

Plan HistoryNot applicable to this endpoint

Query Parameters

ticker

string

The primary ticker symbol for the stock.

free_float_percent

number

Percentage of total shares outstanding that are available for public trading, rounded to two decimal places. Value must be a floating point number.

limit

integer

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '5000'.

sort

string

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'ticker' if not specified. The sort order defaults to 'asc' if not specified.

Response Attributes

next_url

string

optional

If present, this value can be used to fetch the next page.

request_id

string

A request id assigned by the server.

results

array (object)

The results for this request.

effective_date

string

optional

The effective date of the free float measurement.

free_float

integer

optional

Number of shares freely tradable in the market. Free float shares represent the portion of a company's outstanding shares that is freely tradable in the market, excluding any holdings considered strategic, controlling, or long term. This excludes insiders, directors, founders, 5 percent plus shareholders, cross holdings, government stakes except pensions, restricted or locked up shares, employee plans, and any entities with board influence, leaving only shares that are genuinely available for public trading.

free_float_percent

number

optional

Percentage of total shares outstanding that are available for public trading, rounded to two decimal places.

ticker

string

optional

The primary ticker symbol for the stock.

status

enum (OK)

The status of this request's response.

Code Examples

loading...

Query URL

GET

Run query unavailable

Create account or sign in to Massive

Scroll to see updated query response

Response Object

loading...