Earnings actuals
Earnings actuals
GET
/openapi/v3/parties/{ref}/earningsRefresh: 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: US equities only. Perpetual futures have no issuer. This group hangs off the issuer (
/parties), not the stock. For the rationale see the resource model.Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ref | string | Required | Issuer reference. A full_symbol such as AAPL.US is recommended; a stable party_id also works |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/parties/AAPL.US/earnings" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
| Field | Type | Description |
|---|---|---|
| fiscal_date | String | Fiscal period |
| report_date | String | Disclosure date |
| eps_actual / eps_estimate | Number | Actual / expected EPS |
| surprise_pct | Number | Earnings surprise — a percentage as a number (1.5957 = 1.60%); divide by 100 for calculations (see Percentage Fields) |
| before_after_market | String | Disclosed pre-market / after-hours |
| currency | String | Currency |