Institutional and fund holders
Institutional and fund holders
GET
/openapi/v3/instruments/{ref}/holdersRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
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 |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | Optional | institution / fund_holder |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/instruments/AAPL.US/holders" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
| Field | Type | Description |
|---|---|---|
| holder_name | String | Holder name |
| relation_type | String | Holder type |
| as_of_date | String | Position date |
| shares | Number | Shares held |
| weight | Number | Portfolio weight — a decimal fraction (0.09711 = 9.71%), despite having no _pct suffix |
| change_pct | Number | Position change — a percentage as a number (1.9191 = 1.92%); divide by 100 for calculations (see Percentage Fields) |