GET /v1/dilution/share-float-history
Historical shares outstanding and public float series materialized from filings. Ordered by as_of_date desc. Verification block on every row.
Use this endpoint from server-side applications, SDKs, or agent workflows.
requestIdtraceparentverificationprovenance
Query parameters
| Param | Type | Description |
|---|
ticker | string | Issuer ticker. |
as_of_date_from / as_of_date_to | ISO date | Bounds on as_of_date. |
cursor | int | From prior page’s nextCursor. |
limit | int (1–50, default 10) | Page size. |
view | enum | Response shape. |
Example request
curl -X GET \
-H "x-api-key: $SECAPI_API_KEY" \
-H "secapi-version: 2026-03-19" \
"https://api.secapi.ai/v1/dilution/share-float-history?ticker=ACME&limit=4"
Example response
{
"object": "list",
"data": [
{
"object": "dilution_share_float_history",
"id": "dil_sfh_acme_2026q1",
"ticker": "ACME",
"asOfDate": "2026-02-12",
"sharesOutstanding": 32480000,
"publicFloat": 27410000,
"sourceForm": "424B5",
"sourceAccession": "0001234567-26-001234",
"computedAt": "2026-02-13T01:00:00.000Z",
"verification": {
"sourceSpan": "424b5#cover#char[180..260]",
"extractionTraceId": "lf_2026q1_acme_sfh_extract",
"confidence": 0.96,
"crossValidations": [
{ "name": "shares_outstanding_xbrl_match", "passed": true }
],
"modelVersion": "dilution-v1.4",
"verifiedAt": "2026-02-13T01:00:00.000Z"
}
}
],
"hasMore": false,
"nextCursor": null,
"requestId": "req_example_123",
"traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}
Give this prompt to your agent
Copy this SEC API prompt for your agent.
Errors and partial results
- Treat non-2xx responses as API errors and log the response body for debugging
- preserve
requestId and traceparent