tRPC Fund Composition API

• Base endpoint: POST /v1/trpc
• Namespace: fundComposition.*
• Auth: public (rate-limited, Tier 2)
• Display data only: composition never feeds pricing or execution.

​

Procedures

• fundComposition.getByTicker
  • Purpose: the symbol page’s “Fund composition” panel for ETFs
  • Input:
    • required ticker: underlying fund ticker (e.g. AGG); normalized to uppercase
  • Source: Massive ETF Global constituents (latest processed_date snapshot; upstream weight fractions are converted to percent)
  • Response: null when the ticker has no constituent data (plain stocks, uncovered funds) or the entitlement is unavailable, so clients render nothing rather than an empty panel. Otherwise:
    • asOf: provider snapshot date (effective/processed date), or null when unreported
    • source: provider slug, currently always etf-global
    • coveragePct: sum of the returned holdings’ weights — how much of the fund the response covers. Diversified funds can be small; clients must not renormalize weights to 100%.
    • holdings: up to ten rows, heaviest first:
      • name: display name (provider all-caps names are title-cased server-side)
      • symbol: underlying ticker for listed securities, else null (bonds, cash sleeves)
      • weightPct: percent of the whole fund (0.42 = 0.42%)
• fundComposition.getExposures
  • Purpose: the symbol page’s “Exposure” panel (Sectors / Countries tabs) plus the fund presentation of Key metrics and About (profile facts)
  • Input: required ticker
  • Source: Massive ETF Global profiles (sector_exposure and geographic_exposure arrive as fraction dicts and are converted to percent rows; country labels are ISO codes localized client-side)
  • Response: null when the ticker has no ETF Global profile or the entitlement is unavailable. Otherwise:
    • asOf: provider snapshot date, or null
    • source: provider slug, currently always etf-global
    • aumUsd: assets under management in USD, or null
    • expenseRatioPct: total expense ratio in percent points (0.09 = 0.09%), or null
    • sectors / countries: [{ label, weightPct }] provider-reported percentages sorted descending; either list may be empty (the facts below still populate)
    • facts: fund-level profile facts, or null:
      • fundName: full fund name (“SPDR S&P 500 ETF Trust”)
      • issuer, benchmark, assetClass, category, focus: provider display strings, each nullable
      • productType: lowercase etf/etn
      • managementClassification: lowercase active/passive
      • leverageFactor: multiplier (3 = 3x, negative = inverse), null when unleveraged
      • inceptionDate: yyyy-mm-dd
      • distributionFrequency: provider schedule code (M, Q, …)
      • numHoldings, avgDailyVolumeShares: nullable numbers
      • netExpenseRatioPct: net of fee waivers, percent points
      • ttmDividendYieldPct: trailing-12-month distribution yield in percent points, derived from Massive dividends and the snapshot price (funds are absent from the ratios endpoint); null when distributions or price are unavailable
• fundComposition.getDistributions
  • Purpose: backward-compatible fund namespace for dividend history; new symbol-page clients use tradFiMarketData.getDividends for both stocks and funds
  • Input: required ticker
  • Source: delegates to the instrument-neutral Massive dividend-history read documented under tradFiMarketData.getDividends
  • Response: null when there is no market-data source or the ticker has no payable cash distributions. Otherwise:
    • annual: ascending calendar years, at most the current year plus the nine before it: { year, totalPerShareUsd, partial } where partial marks the in-progress current year
    • avgYield5yPct: average annual yield in percent points over the last five complete calendar years (each year’s distributions over its year-end monthly close, from Massive aggregate bars); null when price history or distributions are unavailable
    • recent: the last payments, newest first, capped at ten: { exDate, payDate|null, amountPerShareUsd }