Yahoo Finance

Get Yahoo Finance key statistics

Get Yahoo Finance key statistics, summary detail and valuation ratios.

GET/v1/yahoo-finance/instruments/{symbol}/statistics
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
symbolstringrequiredpath

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^=.-]+$

Response fields
18

Endpoint-specific response payload.

datalookupStatus
string

Whether the entity was found. HTTP 200 for both outcomes; branch on this field.

one of: found, not_found

datasymbol
string

Ticker symbol the sections belong to.

datasources
object

Status of each optional part of the result.

datadefaultKeyStatistics
objectnullable

Valuation, share count, float, short interest, ownership, beta and fiscal-period statistics. Null when it is not available.

datasummaryDetail
objectnullable

Market cap, previous close, day and 52-week ranges, dividend and yield, volume, bid and ask. Null when it is not available.

datafinancialData
objectnullable

Analyst price targets and rating, cash, debt, revenue, margins, returns and growth. Null when it is not available.

The nine valuation ratios, each with its raw `metric` id and a readable `label`.

datavaluation[]metric
string

Metric name, as Yahoo Finance uses it.

datavaluation[]periodType
stringnullable

`12M`, `3M`, `TTM`, or null when not reported.

datavaluation[]asOfDate
stringnullable

Period end, ISO 8601 UTC; null when there is no data.

datavaluation[]currency
stringnullable

Reporting currency code.

datavaluation[]value

A primitive value from a statement.

datavaluation[]label
stringnullable

Ratio name: marketCap, enterpriseValue, trailingPE, forwardPE, pegRatio, priceToSales, priceToBook, enterpriseValueToRevenue or enterpriseValueToEbitda.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/yahoo-finance/instruments/AAPL/statistics" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yahoo Finance key statistics.