v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

Funds & ETFs

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.

get/api/v1/etf/{symbol}/snapshot

Path parameters

symbolstring required

ETF ticker.

Example:SPY

ETF ticker.

Query parameters

datestring nullable

Optional snapshot date (YYYY-MM-DD). Defaults to the latest cycle.

Response

Latest or dated ETF snapshot payload.

Example response

{
  "data": {
    "symbol": "SPY",
    "snapshot_date": "2026-05-19",
    "snapshot_taken_at": "2026-05-19T22:31:42Z",
    "manifest_version": "1715898600",
    "price_proxy": {
      "value": 152.34,
      "basis": "nav",
      "as_of": "2026-02-28",
      "method": "monthly_derived",
      "note": "NAV used as a stale price proxy; not a current quote"
    },
    "top_holdings": [
      {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "weight_pct": 7.21,
        "sector": "technology",
        "asset_class": "equity"
      }
    ],
    "sector_yahoo_raw": [
      {
        "label": "Information Technology",
        "weight_pct": 28.5
      }
    ],
    "sector_canonical": [
      {
        "sector": "technology",
        "weight_pct": 28.5
      }
    ],
    "asset_class_weightings": {
      "equity_pct": 99.8,
      "cash_pct": 0.2
    },
    "country_weightings": [
      {
        "country_code": "US",
        "weight_pct": 99.5
      }
    ],
    "data_source": "cboe_quotes+sec_nport"
  },
  "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"
    ]
  }
}