ETF allocations
ETF allocation breakdowns
GET
/openapi/v3/instruments/{ref}/allocationsRefresh: 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 allocation buckets for a fund. Use dimension=sector, region, or asset_type to select one breakdown; omit it to return all available dimensions. Each data.allocations[] row contains dimension, bucket, weight, and as_of where available.
Holdings and allocations are source snapshots, not reconstructions from live quotes. Always display their as_of value when present.
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/allocations" \ -H "x-soso-api-key: $SOSO_API_KEY"