ETF holdings from the SEC NPORT-P quarterly filing

Full fund-holdings snapshot from the SEC's NPORT-P quarterly filing for one ETF underlier. Replaces the prior commercial fund-profile holdings field (Tier C, disabled in DATA-N1) with the SEC Tier S equivalent. NPORT-P carries the FULL holdings list (NOT top-10), CUSIP/ISIN/LEI, asset-cat + issuer-cat (for sector derivation), and invCountry (for country weightings). Public NPORT-P refreshes only ONCE per fiscal quarter (the SEC's month-3-of-quarter rule), so freshness is typically 3-5 months. Compare rep_pd_date against today to gauge staleness. Returns 404 holdings_unavailable when the ETF is a commodity-pool / grantor-trust structure (USO/UNG/GLD/SLV) that files 10-K/10-Q instead of NPORT-P.

Responses

🟢200OK

application/json

SEC NPORT-P holdings payload.

Bodyapplication/json

Example

{
    "data": {
        "ticker": "SPY",
        "cik": 884394,
        "fund_name": "string",
        "accession": "0001410368-26-020131",
        "filing_date": "string",
        "rep_pd_date": "string",
        "holdings_count": 503,
        "total_val_usd": 0,
        "net_assets": 0,
        "total_assets": 0,
        "total_liabilities": 0,
        "monthly_returns": [
            0
        ],
        "holdings": [
            {
                "name": "string",
                "title": "string",
                "cusip": "string",
                "isin": "string",
                "lei": "string",
                "balance": 0,
                "val_usd": 0,
                "pct_val": 0,
                "asset_cat": "string",
                "issuer_cat": "string",
                "country": "string",
                "currency": "string"
            }
        ],
        "data_source": "sec_nport",
        "license_attribution": "U.S. Public Domain (federal data, 17 USC §105)"
    },
    "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": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴503Service Unavailable

ETF holdings from the SEC NPORT-P quarterly filing

Request

Request Code Samples

Responses