Shares Outstanding & Public Float API: from SEC cover pages over time

Shares outstanding and public float over time for any company, from the cover page of every 10-K and 10-Q, with dates and source filings.

Get free API key Read the docs

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/shares-outstanding?ticker=TSLA"

import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/shares-outstanding",
    params={'ticker': 'TSLA'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
)
print(r.json())

Overview

Every 10-K and 10-Q cover page states the number of shares outstanding as of a recent date, and every 10-K states the public float. Both are tagged in XBRL. The API collects every reported value for a company, with the as of date, form and accession number.

Use it for market cap, float based screens, dilution tracking and checking share counts against other data sources.

What you get

Built for developers who would rather not parse EDGAR.

Full history

Every cover page value the company reported, newest first.

Public float

The aggregate market value held by non-affiliates from each 10-K.

Source on every point

Form, accession number and filing date with each value.

Endpoints

Authenticate with Authorization: Bearer YOUR_KEY. Responses are JSON.

GET/v1/shares-outstandingDocs →

Shares outstanding and public float over time.

Parameters: ticker | cik

Response fields

The main fields in every result. The raw filing data is always one level down.

Field	Meaning
`outstandingShares[]`	value, asOf, form, accessionNo, filedAt for each report.
`publicFloat[]`	Public float in dollars with the same context.

Use cases

Compute market cap from primary data
Track share count growth and buybacks
Float based screens for small caps

Datasets behind this API

The SEC forms this API reads, with live filing counts.

10-KAnnual reports

Every Form 10-K annual report filed on EDGAR since 1993, searchable by company, date and text, with sections and XBRL financials as JSON.

10-QQuarterly reports

Every Form 10-Q quarterly report on EDGAR since 1993: unaudited financials, MD&A and risk factor updates, searchable and parsed as JSON.

FAQ

Where does the number come from?

The dei:EntityCommonStockSharesOutstanding fact on the cover page of 10-K and 10-Q filings.

Why are there two values for the same date?

An amended filing (10-K/A) repeats the original cover value. Both are listed with their accession numbers.

Try the Outstanding Shares & Float free

500 API calls a month on the free plan. No sales call.

Get free API key →