Financial Fields

This page defines common fields that appear in quote, fundamentals, search, and history responses. The API Reference remains the exact source for endpoint-specific schemas.

Quote Fields

Field	Meaning
symbol	Yahoo Finance-style ticker symbol.
shortName / longName	Display names for the instrument or issuer.
quoteType	Instrument type such as equity, ETF, index, cryptocurrency, or currency.
marketState	Current session state for the instrument's market.
regularMarketPrice	Current or latest regular-session price.
regularMarketChange	Absolute price change for the regular session.
regularMarketChangePercent	Percent price change for the regular session.
regularMarketTime	Timestamp for the latest regular-market quote.
regularMarketVolume	Reported regular-session trading volume.
bid / ask	Current bid and ask prices when available.
fiftyTwoWeekHigh / fiftyTwoWeekLow	Highest and lowest prices over the trailing 52-week period.

Valuation Fields

Field	Meaning
marketCap	Equity market value when available.
trailingPE	Price-to-earnings ratio using trailing earnings.
forwardPE	Price-to-earnings ratio using forward earnings estimates.
priceToBook	Price divided by book value per share.
enterpriseValue	Market capitalization plus debt and other adjustments, less cash, when available.
enterpriseToRevenue	Enterprise value divided by revenue.
enterpriseToEbitda	Enterprise value divided by EBITDA.

Price Range Fields

Field	Meaning
regularMarketDayHigh / regularMarketDayLow	Day high and low for the regular session.
regularMarketOpen	Opening price for the regular session.
regularMarketPreviousClose	Previous regular-session close.
postMarketPrice / preMarketPrice	Extended-hours prices when available.
fiftyTwoWeekRange	Human-readable 52-week range where returned.

Formatted Values

Some fundamentals endpoints return fields as objects with raw and formatted forms:

{
  "raw": 198.53,
  "fmt": "198.53"
}

Use raw for calculations and fmt for display. Do not parse fmt for financial math.

Practical Rules

• Check field existence before using optional financial metrics.
• Use raw numeric values for calculations.
• Keep display formatting separate from stored values.
• Treat valuation fields as point-in-time snapshots, not audited time-series data unless you are using a time-series endpoint.