Docs / API reference
GET /v1/shares/{ticker}
Common shares outstanding and public float from the SEC XBRL cover-page tags. Shares outstanding updates every 10-Q/10-K; public float is reported on the 10-K cover, so it refreshes about yearly. The two inputs for market-cap and free-float math — multiply shares by a price from your own feed.
Parameters
| Param | In | Values |
|---|---|---|
ticker | path | US stock ticker or CIK |
history | query | true to include the full reported series, not just the latest |
Request
curl "https://api.edgrapi.com/v1/shares/AAPL" -H "X-API-Key: edgr_..."Response
{
"ticker": "AAPL", "cik": "0000320193", "company": "Apple Inc.",
"shares_outstanding": { "value": 14594180000, "as_of": "2026-07-17",
"filed": "2026-07-31", "form": "10-Q" },
"public_float": { "value": 3253431000000, "as_of": "2025-03-28",
"filed": "2025-10-31", "form": "10-K" },
"currency": "USD", "source": "SEC EDGAR companyfacts (cover-page XBRL)"
}