List Yahoo Finance statement periods
List Yahoo Finance income, balance-sheet and cash-flow periods.
Headers
Get your API keyAPI key (`sfk_...`)
Ticker symbol, case-insensitive, e.g. `AAPL`, `^GSPC`, `EURUSD=X`, `BTC-USD`, `7203.T`.
min 1 chars · max 40 chars · pattern: ^[A-Za-z0-9^=.-]+$
Statement to return. Default: `income`.
one of: income, balance-sheet, cash-flow
Statement period. Default: `annual`.
one of: annual, quarterly, trailing
Endpoint-specific response payload.
Whether the entity was found. HTTP 200 for both outcomes; branch on this field.
one of: found, not_found
Ticker symbol the statement is for.
Statement returned: `income`, `balance-sheet` or `cash-flow`.
Period returned: `annual`, `quarterly` or `trailing`.
Metric ids in the order they were requested.
One entry per metric, each with its points.
Metric name, as Yahoo Finance uses it.
Values for this metric, oldest first.
Metric name, as Yahoo Finance uses it.
`12M`, `3M`, `TTM`, or null when not reported.
Period end, ISO 8601 UTC; null when there is no data.
Reporting currency code.
A primitive value from a statement.
Every metric point in one flat list.
Metric name, as Yahoo Finance uses it.
`12M`, `3M`, `TTM`, or null when not reported.
Period end, ISO 8601 UTC; null when there is no data.
Reporting currency code.
A primitive value from a statement.
Status of each optional part of the result.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/yahoo-finance/instruments/AAPL/financials?statement=income" \
-H "x-api-key: YOUR_API_KEY"Responses
Normalised Yahoo Finance financial statement periods.