How to Retrieve Company Share Float Data Using a Free API

For financial analysts, understanding a company's valuation requires more than just looking at its market capitalization. You need to understand its structural liquidity. When evaluating how easily a stock can be bought or sold without drastically impacting its price, analysts turn to liquidity datasets—specifically, the company's share float.

However, manually sourcing accurate float data from SEC filings is time-consuming. Using a free API to retrieve company share float data allows you to programmatically access this critical liquidity metric. This eliminates the need for manual filing review and enables structured dataset creation to support comparative analysis and exploratory modeling workflows.

The Core Concept: Float vs. Shares Outstanding

Before diving into the data, it is crucial to establish the semantic difference between two often-confused metrics:

• Shares Outstanding: This represents the total number of shares a company has ever issued. It includes every share in existence, whether held by the public, company insiders, or restricted entities.
• Share Float (Free Float): This is the subset of shares outstanding that are actually available for trading by the general public in the open market. It excludes restricted shares, closely held insider shares, and shares held by controlling investors.

In short, outstanding shares determine the company's total equity value, but the share float determines the stock's tradable supply.

Getting Started: Securing Your Free API Key

To pull this liquidity data programmatically, you need to access a dedicated endpoint. Financial Modeling Prep offers a free API tier that includes access to share float metrics. This free tier is best suited for testing workflows, building lightweight datasets, or conducting exploratory analysis before scaling to larger, production-grade systems.

1. Navigate to the Financial Modeling Prep pricing page.
2. Select the "Free" plan and sign up using your email address—no credit card is required.
3. Retrieve your API key from your dashboard.

You will use this key to authenticate your requests to the Company Share Float API.

Analyzing the Data: Comparing Float Across Companies

To demonstrate the utility of this API, let's look at a comparative use case. Given the rate limits of a free tier, this type of structural comparison is typically done via periodic data pulls rather than continuous monitoring. By pulling the share float data for three major technology companies—Apple (AAPL), Microsoft (MSFT), and Meta Platforms (META)—we can observe distinct differences in their equity structures.

When you query the endpoint for these symbols, the JSON response provides the Free Float percentage, the raw Float Shares, and the total Outstanding Shares, complete with a direct link to the SEC source document. This direct link is particularly useful for manual validation or deeper fundamental research, rather than full automated ingestion of filings.

Apple (AAPL) and Microsoft (MSFT): Near-Total Float

For mature, widely held legacy tech giants, the float is typically almost identical to the shares outstanding.

• Apple (AAPL) has roughly 14.69 billion outstanding shares, with 14.66 billion available in the float. This results in a massive Free Float of 99.77%.

• Microsoft (MSFT) shows a similar structure, with 7.42 billion outstanding shares and 7.41 billion in the float, yielding a Free Float of 99.85%.

For an analyst, this indicates very high structural liquidity. The vast majority of the equity is actively tradable on the open market.

Meta Platforms (META): Insider Holdings Impact Float

Conversely, companies with founders who retain significant control will show a noticeable gap between outstanding shares and the float.

• Meta (META) has roughly 2.52 billion outstanding shares, but only 2.18 billion are considered part of the float. This results in a Free Float of 86.62%.

This 13%+ discrepancy represents restricted shares heavily concentrated in the hands of insiders (such as Mark Zuckerberg). While META is still highly liquid, comparing its float ratio to AAPL and MSFT highlights a different corporate governance and ownership structure.

Capacity vs. Volume

When working with float data, analysts must maintain strict accuracy guardrails. Share float represents the capacity for liquidity (tradable shares), not the actual trading volume. Just because a company has 1 billion shares in its float does not mean 1 billion shares are traded daily. Trading volume is a measure of historical activity, whereas float is a measure of structural supply. Therefore, float data should be used to understand the constraints of a stock's supply, but it should not be used to make direct predictions about future daily liquidity or short-term price movements. In practice, float should be treated purely as a structural constraint, not a real-time trading signal..

Integrating Float into Broader Valuation Workflows

Understanding a company's free float is essential when calculating "float-adjusted market capitalization"—a metric preferred by many major index providers like the S&P 500, as it better reflects the market value of the shares actually available to investors.

To pair your share float analysis with broader equity valuations, you can learn how to monitor market capitalization changes using a free API to keep your portfolio models structurally accurate.

Frequently Asked Questions

How do I sign up for the free API?

To sign up, visit the documentation page, scroll down to the sign-up box, and insert your email address. No credit card is required.

Is the free plan really free forever?

Yes, the free plan is designed for personal use and allows for 250 requests per day. This gives you ample room to explore endpoints without an expiration date.

Do I need a credit card to get an API key?

No, the free tier is accessible without any payment information. You only need to provide a credit card if you decide to upgrade to a premium plan for higher rate limits or additional datasets.

What is the Company Share Float API used for?

The Share Float API is used by analysts to programmatically retrieve the number of a company's shares that are available for public trading, distinguishing them from total outstanding shares.

Does a low float mean a stock is highly volatile?

While a low float means there is a smaller supply of tradable shares—which can make the stock more sensitive to large buy or sell orders—float alone does not predict volatility. It simply defines the structural supply of the asset.

How often does share float data update?

Share float is typically updated following new corporate filings (like 10-Qs or 10-Ks) or significant corporate actions, as the number of restricted shares unlocking or outstanding shares changing must be reported to the SEC.

Do I need a paid plan to access the Share Float endpoint?

No, the Company Share Float endpoint is available on the free tier, allowing you to access this critical liquidity dataset without a premium subscription.

What is the difference between float and volume?

Float is the total pool of shares available to be traded by the public. Volume is the actual number of those shares that exchanged hands during a specific trading session. Float is supply; volume is activity.