ETF geo revenue

GET/v1/funds/{symbol}/geographic-revenueWhole, less the withheld

Where the fund's holdings earn their revenue, by weight.

Parameters

symbolpathrequired
Ticker symbol, case-insensitive.

Response contract

Everything except the fields named as withheld, which are ours and not yours.

Withheld

weight_sum_rawholdings_missing_weight_basisover_disclosed_symbolsreason

These are ours: ingest bookkeeping and internal build stamps. They are removed at every level of the response, including inside arrays.

Response fields

The top level keys a live response actually returned, read off the API rather than written down here.

etfas_of_datemax_weightheld_weight_shareholding_countcovered_countnot_covered_countcoverage_pct_by_weightfiscal_year_minfiscal_year_maxcountriesregionsremainderdomicile

How this was verified

Called against 3 different subjects on the live API. Every field it returned, at every level, was compared with the contract above. Last checked August 18, 2026.

Request

curl "https://api.massari.ai/v1/funds/SPY/geographic-revenue" \
  -H "Authorization: Bearer $MASSARI_TOKEN"

Example response

{
  "etf": "SPY",
  "as_of_date": "2026-04-17T00:00:00.000Z",
  "max_weight": 0.08012,
  "held_weight_share": 0.97563,
  "holding_count": 503,
  "covered_count": 319,
  "not_covered_count": 184,
  "coverage_pct_by_weight": 78.439224427,
  "fiscal_year_min": 2024,
  "fiscal_year_max": 2026,
  "countries": [
    {
      "code": "US",
      "label": "United States",
      "pct": 34.852962612,
      "contributors": [
        {
          "symbol": "NVDA",
          "weight_pct": 8.011500206,
          "disclosed_pct": 69.28701756985801,
          "contribution_pct": 5.550929555,
          "accession": "0001045810-26-000021",
          "source_url": "/filings/NVDA/0001045810-26-000021?cit=JDE0OS42MTdC&section=segment_revenue"
        },
        {
          "symbol": "AMZN",
          "weight_pct": 4.024324958,
          "disclosed_pct": 68.2997081978006,
          "contribution_pct": 2.748602203,
          "accession": "0001018724-26-000004",
          "source_url": "/filings/AMZN/0001018724-26-000004?cit=JDQ4OS42NTdC&section=segment_revenue"
        }
      ]
    },
    {
      "code": "TW",
      "label": "Taiwan",
      "pct": 2.590880251,
      "contributors": [
        {
          "symbol": "NVDA",
          "weight_pct": 8.011500206,
          "disclosed_pct": 19.6097954042364,
          "contribution_pct": 1.571038799,
          "accession": "0001045810-26-000021",
          "source_url": "/filings/NVDA/0001045810-26-000021?cit=JDQyLjM0NUI&section=segment_revenue"
        },
        {
          "symbol": "AVGO",
          "weight_pct": 3.118159715,
          "disclosed_pct": 10.09751592655783,
          "contribution_pct": 0.314856674,
          "accession": "0001730168-25-000121",
          "source_url": "/filings/AVGO/0001730168-25-000121?cit=JDYuNDUxQg&section=segment_revenue"
        }
      ]
    }
  ],
  "regions": [
    {
      "code": "americas",
      "label": "Americas",
      "pct": 5.156057675,
      "contributors": [
        {
          "symbol": "AAPL",
          "weight_pct": 6.484544567,
          "disclosed_pct": 42.85673092865502,
          "contribution_pct": 2.779063817,
          "accession": "0000320193-25-000079",
          "source_url": "/filings/AAPL/0000320193-25-000079?cit=JDE3OC4zNTNC&section=segment_revenue"
        },
        {
          "symbol": "CSCO",
          "weight_pct": 0.539634848,
          "disclosed_pct": 59.40622021393017,
          "contribution_pct": 0.320576666,
          "accession": "0000858877-25-000111",
          "source_url": null
        }
      ],
      "member_iso2": [
        "US",
        "CA"
      ]
    },
    {
      "code": "europe",
      "label": "Europe",
      "pct": 3.613810858,
      "contributors": [
        {
          "symbol": "AAPL",
          "weight_pct": 6.484544567,
          "disclosed_pct": 26.680058919504713,
          "contribution_pct": 1.730080311,
          "accession": "0000320193-25-000079",
          "source_url": "/filings/AAPL/0000320193-25-000079?cit=JDExMS4wMzJC&section=segment_revenue"
        },
        {
          "symbol": "JNJ",
          "weight_pct": 0.953802858,
          "disclosed_pct": 22.862633104370815,
          "contribution_pct": 0.218064448,
          "accession": "0000200406-26-000016",
          "source_url": null
        }
      ],
      "member_iso2": [
        "GB",
        "IE"
      ]
    }
  ],
  "remainder": {
    "no_geography_pct": 11.938664951,
    "not_covered_pct": 19.123775573,
    "not_held_pct": 2.437
  },
  "domicile": [
    {
      "code": "US",
      "pct": 94.670660325
    },
    {
      "code": "IE",
      "pct": 1.362131341
    }
  ]
}

A real response from the live API, captured August 18, 2026. This one is CUT: long arrays, wide objects and long strings were trimmed to keep it readable, so treat it as a sample of the shape rather than all of it. Either way it is valid JSON.