Corporate actions
Unified corporate-action stream; filter with action_type
GET
/openapi/v3/instruments/{ref}/corporate-actionsRefresh: 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.The three endpoints are different views of the same data: /corporate-actions returns the unified event stream, while /dividends and /splits are convenient fixed projections with data.dividends / data.splits keys.
/corporate-actions accepts action_type=<code> to filter the unified stream. Do not use type for this purpose: type remains the instrument-disambiguation selector. Fetch action_type display names from /reference/enums rather than hardcoding labels.
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/AAPL.US/corporate-actions" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
| Field | Type | Description |
|---|---|---|
| action_type | String | Action type code (display names: Vocabularies) |
| event_date | String | Event date (pagination cursor) |
| ex_date | String | Ex-dividend / ex-rights date |
| declaration_date / record_date / payment_date | String | Declaration / record / payment dates |
| period | String | The period the dividend covers |
| cash_amount / cash_currency | Number / String | Cash distribution amount and currency |
| ratio_to / ratio_from | Number | Split ratio (e.g. a 4:1 split → ratio_to=4, ratio_from=1) |
Notes
- Pagination is time-based (see Pagination) with
event_dateas the cursor.