Holders-of-CUSIP Δ over the last N retained quarters
Holder-level delta for one CUSIP across the N most-recent retained quarters (default 2, max 4 by memory bound). Computes added / removed / changed holders comparing earliest vs latest stem in the window. Intermediate stems contribute to consensus_trend (per-stem holder_count + total value + total shares) for sparkline rendering. quarters_used echoes the effective N. Out-of-range (1 or 5+) is REJECTED with 400 - no silent clamping. Internally uses streaming diff to bound memory ~one shard regardless of N.
Path parameters
9-character canonical CUSIP.
9-character canonical CUSIP.
Query parameters
Number of retained quarters to compare (range 2-4 inclusive). Out-of-range = 400; no silent clamping.
Number of retained quarters to compare (range 2-4 inclusive). Out-of-range = 400; no silent clamping.
Response
Multi-quarter delta-holders + consensus trend for one CUSIP.
Example response
{
"data": {
"quarters": [
{
"stem": "01dec2025-28feb2026",
"period_end": "2026-02-28",
"fetched_at": "2026-05-18T03:15:00Z"
}
]
},
"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",
"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"
]
}
}