Aggregate institutional ownership stats for one CUSIP
Changed onSummary metrics computed across all 13F holders of one security: holder count, total reported value (sum across managers, $thousands), total share count. One-shot answer to 'how big is institutional ownership of $TICKER?'. Pair with /holders-of/{cusip} for the per-manager breakdown. Optional ?quarter=<stem> selects a historical snapshot from the multi-quarter retention manifest; without the param the canonical latest-quarter pointer is used (backward compatible).
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v1/sec/13f/consensus/{cusip}
- Auth: API key in header x-api-key
Path parameters
9-character canonical CUSIP.
Query parameters
Optional retention-manifest stem (e.g. 01dec2025-28feb2026 or 2023q4). When omitted, returns the canonical latest snapshot. When supplied, must be present in the enumerated manifest from /13f/quarters.
Response
Aggregate institutional ownership for one CUSIP.
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"
],
"stale_since": "2026-09-08T12:00:00Z",
"period": "2026-Q1",
"notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
}
}Changes
- info
added the non-success response with the status
- info
- info
added the optional property
/to the response with the status
- info