Financial statements
Issuer financial statements
GET
/openapi/v3/parties/{ref}/financialsRefresh: 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 |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| statement | string | Optional | income / balance / cashflow. Empty = all |
| period | string | Optional | yearly / quarterly. Empty = all |
| known_as_of | string | Optional | YYYY-MM-DD. Point-in-time filter: only versions known on or before that date |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/parties/AAPL.US/financials" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data.statements[]: statement / period_type / fiscal_date / currency / reported_at / known_at / line_items (object, accounting concept → value). Sorted by fiscal_date descending.
Notes
known_as_ofis a conservative look-ahead filter, not restatement-accurate PIT. It correctly excludes periods not yet first-disclosed by that date, but the store does not keep restatement versions, so restated values may still appear under their original first-disclosure date. Whenknown_as_ofis passed, the response carries awarningsentry describing this limitation. Keep it in mind for strict PIT backtests.