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.

Much of the older history comes from quarterly reports: each figure is dated at the end of the quarter it describes, but it was only published weeks later. That is the right date for reading the history, and the wrong one for a backtest, which would see each figure before the market could. Pass point_in_time=true to date every figure from when it could first have been known: the first report the company filed for a period covering that date, or 180 days after that date where no such report is on record. A figure that was overtaken by a newer one before it became known is left out, so the series never steps back to older information. Figures captured on the day they were published keep their date. Add min_lag_days to require a longer minimum delay on the late-published figures.

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