Free Float

API TraderAPI QuantAPI Developer

Track how a company's share capital has changed over time. This endpoint returns the total shares outstanding alongside the portion of them that actually trades freely, so you can size a position against the shares genuinely available rather than against the whole issued capital.

One row is returned per change. Each row states the values that took effect on its date and held until the next row, so a quiet period produces no rows rather than repeated identical ones. The first row is dated at the start of your requested window and carries the values that were already in effect when it opened.

Share counts are restated into today's capital structure by default, so a figure from before a split is directly comparable with a current one. Pass split_adjusted=false to receive the counts as they stood on the day, which is what you need to reconcile against a historical filing. The free float percentage is a ratio of two share counts, so a split moves both sides equally and it is unaffected either way.

Available Data Points:

  • Date: The date these values took effect. (YYYY-MM-DD format).
  • Shares Outstanding: The total number of shares the company has issued.
  • Free Float Shares: The number of shares available for public trading, excluding closely held and otherwise restricted holdings.
  • Free Float Pct: Free float shares as a percentage of shares outstanding.

Try it out! You can test the API with the trial key TEST. Simply include it in your request headers; either here, or add the header "Ortex-Api-Key": "TEST" to your http request.

Trial key restrictions: Trial keys may be limited to a specific date range and set of regions. Requests outside the allowed regions or entirely outside the allowed date range are rejected; a date window that partially overlaps the allowed range is trimmed to it, reported in meta.restriction.

Get full access! Get a key at app.ortex.com/apis

Path Params
string
required

Exchange symbol (e.g. "nyse", "nasdaq"), MIC code (e.g. "xnys", "xnas") or two character ISO country code (e.g "us", "ca" for ALL country exchanges)

string
required

Ticker symbol

Query Params
string
enum
Defaults to json

Response format. "json" (default) or "csv".

Allowed:
date
required

Inclusive start of the returned date window. Format: YYYY-MM-DD.

integer

Page number within the paginated result set. Must be >= 1. Defaults to 1.

integer

Number of rows per page. The default and the maximum allowed depend on the API tier; values above the tier maximum are clamped down to it.

boolean
Defaults to true

Whether share counts are adjusted to today's terms (default) or returned as-was on the data date. Pass false for unadjusted (as-was) values.

date

Inclusive end of the returned date window (defaults to today). Format: YYYY-MM-DD.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/csv