List Yahoo Finance fundamental metrics
List Yahoo Finance fundamental metric values for a symbol and period.
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^=.-]+$
Metric names such as `TotalRevenue`, `NetIncome` or `FreeCashFlow`, 1 to 100, comma-separated. Unknown names are refused.
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 metrics are for.
Period returned: `annual`, `quarterly` or `trailing`.
Metric names 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/fundamentals?metrics=TotalRevenue,FreeCashFlow" \
-H "x-api-key: YOUR_API_KEY"Responses
Normalised Yahoo Finance fundamental metric series.