Hedge Fund Intelligence

Holders-of-CUSIP Δ over the last N retained quarters

Changed on

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.

get/api/v1/sec/13f/holders-of/{cusip}/changes

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/sec/13f/holders-of/{cusip}/changes
  • Auth: API key in header x-api-key

Path parameters

cusipstring required

9-character canonical CUSIP.

Query parameters

quartersinteger

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",
    "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