Latest or dated ETF snapshot

Single ETF snapshot at the latest cycle (default) or at a specific calendar date via ?date=YYYY-MM-DD. Returns the full payload: pricing (nav, price, premium/discount), fund characteristics (AUM, expense ratio, yields), top-10 holdings sample, sector weightings (both raw + canonical), asset-class and country exposure, and trailing returns. Returns 410 Gone when the symbol is flagged as delisted_candidate by the upstream cycle.

Since DATA-N4.4 the canonical snapshot is rebuilt purely from Tier S sources (regulated-exchange price + SEC NPORT-P holdings), with no commercial aggregator in the chain. Fields awaiting their replacement source are returned as null and tagged in the internal _sources.deferred map: nav/aum_usd/premium_discount_pct (DATA-N4.3), returns_* and fifty_two_week_high/fifty_two_week_low (DATA-N4.1), and expense_ratio_pct/yield_dividend_pct/yield_distribution_pct/inception_date (DATA-N4.2).

DATA-N4.8.1: when price is null but a NAV is available, an additive price_proxy block surfaces the NAV as an explicitly-stale proxy (basis = nav with an as_of SEC-filing date that can be months old and a note disclaiming a current quote). price itself stays null - the proxy is never presented as a live quote. The block is absent when price is present or when nav is also null.

Responses

🟢200OK

application/json

Latest or dated ETF snapshot payload.

Bodyapplication/json

Example

{
    "data": {
        "symbol": "SPY",
        "name": "string",
        "category": "string",
        "snapshot_date": "2026-05-19",
        "snapshot_taken_at": "string",
        "manifest_version": "string",
        "nav": 0,
        "price": 0,
        "price_proxy": {
            "value": 0,
            "basis": "nav",
            "as_of": "string",
            "method": "string",
            "note": "string"
        },
        "premium_discount_pct": 0,
        "fifty_two_week_high": 0,
        "fifty_two_week_low": 0,
        "aum_usd": 0,
        "expense_ratio_pct": 0,
        "yield_dividend_pct": 0,
        "yield_distribution_pct": 0,
        "inception_date": "string",
        "top_holdings": [
            {
                "symbol": "string",
                "name": "Apple Inc",
                "weight_pct": 7.21,
                "sector": "string",
                "asset_class": "string"
            }
        ],
        "sector_yahoo_raw": [
            {
                "label": "Information Technology",
                "weight_pct": 28.5
            }
        ],
        "sector_canonical": [
            {
                "sector": "technology",
                "weight_pct": 28.5
            }
        ],
        "asset_class_weightings": {
            "equity_pct": 0,
            "bond_pct": 0,
            "cash_pct": 0,
            "other_pct": 0
        },
        "country_weightings": [
            {
                "country_code": "US",
                "weight_pct": 99.5
            }
        ],
        "returns_1m": 0,
        "returns_ytd": 0,
        "returns_1y": 0,
        "returns_3y": 0,
        "returns_5y": 0,
        "returns_10y": 0,
        "data_source": "string",
        "license_attribution": "string",
        "_sources": {
            "property1": "string",
            "property2": "string"
        }
    },
    "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

Latest or dated ETF snapshot

Request

Request Code Samples

Responses