Holders summary (major + top-N each category)
Path parameters
Security ticker symbol.
Security ticker symbol.
Response
Combined snapshot: major-holders pct + top 3 institutional + top 3 funds + top 3 insiders.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"data_age_days": 8.532,
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
],
"period": "2026-Q1",
"notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
}
}Changes
Changed in 3 of the 22 revisions of this API.20
- ○
added the optional property
meta/data_age_daysto the response with the200statusresponse-optional-property-added
- ○
added the optional property
meta/notesto the response with the200statusresponse-optional-property-added
- ○
added the optional property
meta/periodto the response with the200statusresponse-optional-property-added
- ○
- ○
added the optional property
data/breakdownto the response with the200statusresponse-optional-property-added
- ○
added the optional property
data/symbolto the response with the200statusresponse-optional-property-added
- ○
added the optional property
data/top_fundsto the response with the200statusresponse-optional-property-added
- ○
added the optional property
data/top_insidersto the response with the200statusresponse-optional-property-added
- ○
added the optional property
data/top_institutionalto the response with the200statusresponse-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
- ○
added the optional property
codeto the response with the401statusresponse-optional-property-added
- ○
added the optional property
codeto the response with the429statusresponse-optional-property-added
- ○
added the optional property
codeto the response with the503statusresponse-optional-property-added
- ○
added the optional property
hintto the response with the401statusresponse-optional-property-added
- ○
added the optional property
hintto the response with the429statusresponse-optional-property-added
- ○
added the optional property
hintto the response with the503statusresponse-optional-property-added
- ○
added the optional property
planto the response with the401statusresponse-optional-property-added
- ○
added the optional property
planto the response with the429statusresponse-optional-property-added
- ○
added the optional property
planto the response with the503statusresponse-optional-property-added
- ○
added the optional property
reasonto the response with the401statusresponse-optional-property-added
- ○
added the optional property
reasonto the response with the429statusresponse-optional-property-added
- ○
added the optional property
reasonto the response with the503statusresponse-optional-property-added
- ○