Adjustment factors
Adjustment factors, to audit adjusted prices
GET
/openapi/v3/instruments/{ref}/adjustment-factorsRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
Applicability: equities and ETFs where records are available. Dividends, splits and price adjustment do not exist for perpetual futures — calling these endpoints for a perp returns an empty list (
code: 0 + empty data array). This is not "no records yet"; the concept does not apply.For callers who need to adjust prices themselves or audit the adjustment methodology (a common need in quantitative backtesting). Computed at read time.
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 |
|---|---|---|---|
| mode | string | Optional | back (default) = back-adjustment: latest bar keeps its as-traded price, earlier bars are rescaled — 前复权 / forward = forward-adjustment: earliest bars keep as-traded prices, later bars are rescaled — 后复权 |
| adjust_scope | string | Optional | split_dividend (default) includes share-count events and cash dividends; split includes share-count events only. Use the same value as the candle request you are auditing |
| from / to | — | Optional | Only trims the output (by ex_date); cumulative factors are always computed over the full event history |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/instruments/AAPL.US/adjustment-factors" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data.events[]:
| Field | Type | Description |
|---|---|---|
| ex_date / action_type | String | Ex-date / action type |
| factor | Number | The event's price factor |
| split_factor | Number | Share-count component (volume is scaled by its reciprocal) |
| cum_factor | Number | Cumulative factor per mode |
| ratio_to / ratio_from / cash_amount / cash_currency / rights_price / prev_close / ex_close | — | Computation inputs and validation prices |
| dual_confirmed | Boolean | Present when the event ratio was corroborated by at least two sources |
| skipped / skip_reason | Boolean / String | Events whose factor could not be computed: treated as 1 and reported in warnings |