Index market snapshot
Index snapshot: price, 24h change and returns
GET
/openapi/v1/indices/{index_ticker}/market-snapshotRefresh: 30 s
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| index_ticker | string | Required | Index ticker, e.g. ssimag7. Case-insensitive — /indices and /indices/{t}/constituents echo it back as ssiMAG7, but either form is accepted in the path |
Query Parameters
None.
Request Example
curl "https://openapi.sosovalue.com/openapi/v1/indices/ssimag7/market-snapshot" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Example
{
"price": 20.93,
"change_pct_24h": -0.0016,
"roi_7d": 0.0056,
"roi_1m": 0.062,
"roi_3m": 0.275,
"roi_1y": 0.15,
"ytd": -0.243
}Response Fields
| Field | Type | Description |
|---|---|---|
| price | Number | Current index price |
| change_pct_24h | Number | 24-hour change, as a decimal fraction — -0.0016 means −0.16%, not −0.0016% |
| roi_7d | Number | 7-day return, decimal fraction |
| roi_1m | Number | 1-month return, decimal fraction |
| roi_3m | Number | 3-month return, decimal fraction |
| roi_1y | Number | 1-year return, decimal fraction |
| ytd | Number | Year-to-date return, decimal fraction |
Fields with no value for the requested index are omitted from the response rather than returned as null — treat a missing key as "not available".