ETF holdings
ETF holdings
GET
/openapi/v3/instruments/{ref}/holdingsRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
Returns available ETF/fund constituents and weights. limit uses the standard list limit. Equity-holder records use the separate /holders endpoint below; these resources are not interchangeable.
data.holdings[] fields can include held_symbol, held_name, held_isin, weight, market_value_usd, as_of, sector, industry, country, region, and in_registry. in_registry tells you whether the constituent can be resolved to another instrument in this interface. Missing optional classification or market-value fields mean unavailable, not zero.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ref | string | Required | Instrument reference. A full_symbol such as AAPL.US or BTC-USDT-PERP.BINANCE is recommended; a stable id, symbol or FIGI also works |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/instruments/SPY.US/holdings" \ -H "x-soso-api-key: $SOSO_API_KEY"