Fundamentals Glossary: Common Stock

We’re pleased to present our first glossary for the Fundamental Data API — a detailed guide to all data fields returned when querying stock tickers. This standardized template applies across global exchanges, except for the isDelisted field and AnalystRatings section, which are only available for US-listed stocks.

General

Code — The ticker symbol of the stock.

Type — The classification of the equity, such as Common Stock or Preferred Stock.

Name — The full name of the company.

Exchange — The code representing the stock exchange, as used by eodhd.com (not necessarily the primary exchange).

CurrencyCode — The three-letter ISO 4217 currency code used for trading (e.g., USD, EUR).

CurrencyName — The full name of the trading currency.

CurrencySymbol — The currency symbol (e.g., $ for USD, £ for GBP).

CountryName — The name of the country where the exchange is located.

CountryISO — The ISO country code.

OpenFigi — The Open FIGI identifier.

ISIN — The International Securities Identification Number, which may be shared by the same company across multiple exchanges.

LEI — Legal Entity Identifier used for identifying entities in financial transactions.

PrimaryTicker — The primary ticker symbol for the company (e.g., AAPL.US for Apple Inc.).

CUSIP — The CUSIP number for US and Canadian stocks.

CIK — Central Index Key used primarily for US and Canadian securities.

FiscalYearEnd — The company’s fiscal year-end date.

EmployerIdNumber — The IRS-assigned unique identifier for US businesses.

IPODate — The date of the company’s initial public offering.

InternationalDomestic — Indicates whether the company is classified as domestic or international in relation to the US market.

Sector — The broader economic category the company operates in.

Industry — A more specific business category within the sector.

GicSector — GICS sector classification.

GicGroup — GICS group classification.

GicIndustry — GICS industry classification.

GicSubIndustry — GICS sub-industry classification.

HomeCategory — Classification for US tickers such as ADR, Canadian, Domestic, ETN, Warrant, etc.

IsDelisted — Indicates whether the ticker is delisted (true) or still active (false). Available only for US stocks.

DelistedDate — The date of last available trading data, applicable to US delisted stocks.

Description — A textual description of the company.

Address — Full company address.

AddressData — A structured format of the address with separated fields.

Listings — Information about other global listings of the same company.

Officers — A list of key company officers and executives.

Phone — Company contact phone number.

WebURL — Official website of the company.

LogoURL — A relative path to the company’s logo; must be appended to eodhistoricaldata.com.

FullTimeEmployees — The most recent known number of full-time employees.

UpdatedAt — Timestamp of the last update to the fundamentals data for the ticker. Sections such as Highlights, SharesStats, and Valuation are typically updated with this timestamp.

Highlights

MarketCapitalization: Represents the total market value of a company’s outstanding shares. It is determined by multiplying the current stock price by the total number of shares. A dedicated article is available explaining historical calculation methods.

MarketCapitalizationMln: The same figure as above, expressed in millions.

EBITDA: Earnings before interest, taxes, depreciation, and amortization, measured on a trailing twelve-month (TTM) basis.

PERatio: The price-to-earnings ratio based on TTM earnings.

PEGRatio: The price-to-earnings growth ratio based on a projected five-year growth rate.

WallStreetTargetPrice: The projected year-end target price based on top analyst estimates. For non-U.S. stocks traded on non-U.S. exchanges, the currency aligns with the country of origin (e.g., KAP.IL is shown in KZT, not USD, even though listed on the LSE).

BookValue: Book value per share, calculated by subtracting total liabilities from total assets and dividing by shares outstanding (MRQ).

DividendShare: Total dividend amount paid per share over the past year (TTM).

DividendYield: Annual dividend yield, calculated by dividing DividendShare by the current share price (TTM).

EarningsShare: Diluted earnings per share over the trailing twelve months.

EPSEstimateCurrentYear: Projected earnings per share for the current fiscal year.

EPSEstimateNextYear: Forecasted EPS for the upcoming year.

EPSEstimateNextQuarter: Forecasted EPS for the next quarter.

EPSEstimateCurrentQuarter: Projected EPS for the current quarter.

MostRecentQuarter: Denotes the latest quarter with reported financial data.

ProfitMargin: Net profit margin.

OperatingMarginTTM: Operating margin calculated as (operatingIncome / totalRevenue) × 100, based on TTM.

ReturnOnAssetsTTM: Return on assets, calculated as net income divided by total assets (TTM).

ReturnOnEquityTTM: Return on equity, calculated as net income divided by total stockholder equity (TTM).

RevenueTTM: Total revenue generated over the trailing twelve months.

RevenuePerShareTTM: Revenue per share, calculated as total revenue divided by outstanding common stock shares (TTM).

QuarterlyRevenueGrowthYOY: Year-over-year revenue growth, comparing the same quarter across two consecutive years.

GrossProfitTTM: Gross profit calculated as total revenue minus cost of revenue over the past twelve months.

DilutedEpsTTM: Diluted earnings per share for the trailing twelve months.

QuarterlyEarningsGrowthYOY: YOY growth in quarterly earnings, comparing the same fiscal quarter in two consecutive years.

Valuation

TrailingPE: Price-to-earnings ratio using trailing twelve months of earnings.

ForwardPE: Price-to-earnings ratio using forward-looking (estimated) earnings.

PriceSalesTTM: Price-to-sales ratio based on TTM revenue.

PriceBookMRQ: Price-to-book ratio based on the most recent quarter.

EnterpriseValue: The company’s total valuation, calculated as MarketCapitalization plus total debt and minority interest, minus cash and cash equivalents. The currency reflects the reporting currency of the company.

EnterpriseValueRevenue: Enterprise value to revenue ratio.

EnterpriseValueEbitda: Enterprise value to EBITDA ratio.

Shares Stats

SharesOutstanding: The total number of shares currently issued and held by shareholders. For companies with multiple share classes, this field reflects the outstanding shares of the specific ticker, whereas other locations in the API (e.g., outstandingShares) include all share classes.

SharesFloat: Number of shares available for public trading.

PercentInsiders: Percentage of shares held by company insiders.

PercentInstitutions: Percentage of shares held by institutional investors.

Technicals

Beta: The 5-year levered beta calculated using the primary indices of the country.

52WeekHigh: The highest adjusted daily “High” price over the past 12 months, factoring in adjustment values.

52WeekLow: The lowest adjusted daily “Low” price over the past 12 months, factoring in adjustment values.

50DayMA: The 50-day simple moving average (SMA) of the stock’s price.

200DayMA: The 200-day simple moving average (SMA) of the stock’s price.

SharesShort: Total number of shares currently sold short.

SharesShortPriorMonth: Number of shares sold short in the previous month.

ShortRatio: The short interest ratio, calculated as shares sold short divided by the 30-day average daily trading volume.

ShortPercent: Percentage of outstanding shares that are currently sold short.

Splits & Dividends

ForwardAnnualDividendRate: The projected annual dividend payout per share, expressed in currency (calculated as share price × ForwardAnnualDividendYield).

ForwardAnnualDividendYield: The projected dividend yield over the next year (dividends divided by current stock price).

PayoutRatio: The dividend payout ratio (TTM), calculated by dividing the sum of the past four quarters’ dividendsPaid by the sum of the last four quarters’ netIncomeApplicableToCommonShares (or netIncome, if the former is unavailable).

DividendDate: The most recent dividend distribution date.

ExDividendDate: The most recent ex-dividend date.

LastSplitFactor: The most recent stock split ratio.

LastSplitDate: The most recent stock split date.

NumberDividendsByYear: Annual dividend frequency; subfields specify the count per year.

Analyst Ratings

Rating: A consensus rating score from 1 (Strong Sell) to 5 (Strong Buy).

TargetPrice: The average analyst target price for the stock, projected one year forward.

StrongBuy: Number of analysts rating the stock as a Strong Buy.

Buy: Number of analysts rating the stock as a Buy.

Hold: Number of analysts giving a Hold rating.

Sell: Number of analysts issuing a Sell recommendation.

StrongSell: Number of analysts rating the stock as a Strong Sell.

Holders

Institutions or Funds: The type of shareholder; either an institutional investor or a fund.

name: Name of the institutional investor or fund.

date: Reporting date for the holdings.

totalShares: Percentage of total outstanding shares held by the institution.

totalAssets: Share of the institution’s total assets represented by its holding in this security.

currentShares: Number of shares currently held.

change: The change in shareholding compared to the previous reported quarter.

change_p: Percentage change in shareholding compared to the previous quarter.

InsiderTransactions

date: The date of the insider transaction record.

ownerCik: The Central Index Key (CIK) code of the insider or reporting owner, if available.

ownerName: Name of the insider or reporting individual/entity involved in the transaction.

transactionDate: The actual date on which the insider transaction took place (same as the date field).

transactionCode: Indicates the nature of the transaction — S for sale, P for purchase.

transactionAmount: The number of shares involved in the transaction.

transactionPrice: The price per share at which the insider transaction occurred.

transactionAcquiredDisposed: Indicates whether the shares were acquired (A) or disposed (D).

postTransactionAmount: Total number of shares held by the insider after the transaction.

secLink: Direct link to the official SEC filing related to the transaction.

outstandingShares

annual or quarterly: Indicates whether the data point corresponds to an annual or quarterly reporting period.

date: Represents either the fiscal year or the fiscal quarter the data pertains to.

dateFormatted: The formatted date marking the end of the respective reporting period.

sharesMln: The weighted average number of diluted shares outstanding, expressed in millions, and adjusted for stock splits.

shares: The total weighted average diluted shares outstanding for the period, also adjusted for any stock splits.

Earnings

History

This section provides historical quarterly earnings data.

• reportDate: The official reporting date of the earnings. For U.S. stocks, this refers specifically to the 8-K filing date, not the 10-K or 10-Q. For major companies like AAPL, this is often the day before the earnings call; for smaller firms, such as SCCO, there may be a longer gap.
• date: The end date of the reported fiscal period.
• beforeAfterMarket: Indicates when the earnings were released — BeforeMarket (before market open), AfterMarket (after market close), or null if unknown.
• epsActual: The actual non-GAAP earnings per share (EPS) reported by the company.
• epsEstimate: The EPS estimate made by analysts prior to the earnings release.
• epsDifference: The difference between actual and estimated EPS (epsActual - epsEstimate).
• surprisePercent: The earnings surprise as a percentage, calculated as (epsActual - epsEstimate) / epsEstimate.

Trend

This section covers historical EPS and revenue forecasts.

• YYYY-MM-DD: End date of the forecasted period.
• period: Denotes the forecasted timeframe — +1y (next year), 0y (current year), +1q (next quarter), 0q (current quarter).
• growth / earningsEstimateGrowth: Projected EPS growth, calculated as (earningsEstimateAvg - earningsEstimateYearAgoEps) / earningsEstimateYearAgoEps.
• earningsEstimateAvg: Average earnings per share estimate from analysts.
• earningsEstimateLow / High: The lowest and highest EPS estimates from analysts.
• earningsEstimateYearAgoEps: The EPS estimate for the same period one year ago.
• earningsEstimateNumberOfAnalysts: Total number of analysts contributing EPS forecasts.

Revenue Estimates:

• revenueEstimateAvg: Average revenue forecast from analysts.
• revenueEstimateLow / High: The lowest and highest revenue projections.
• revenueEstimateYearAgoEps: Revenue estimate from the same period a year prior.
• revenueEstimateNumberOfAnalysts: Count of analysts who submitted revenue forecasts.
• revenueEstimateGrowth: Projected year-over-year revenue growth.

EPS Trend Over Time:

• epsTrendCurrent / 7 / 30 / 60 / 90 days ago: The evolution of the EPS forecast from now to 90 days ago.
• epsRevisionsUpLast7days / 30days: Number of upward revisions in the last 7 or 30 days.
• epsRevisionsDownLast7days / 30days: Number of downward revisions in the last 7 or 30 days.

Annual

Provides yearly EPS data. Note: for the current fiscal year, the EPS is the sum of reported quarters to date.

• date: Corresponds to the reporting year or the latest available quarter.
• epsActual: Total EPS from the four reported quarters of the fiscal year.

Financials

Balance_Sheet

currency_symbol: straightforward field indicating the currency used.

quarterly or yearly: indicates whether the report refers to a quarterly or annual period.

date: the specific reporting date.

filing_date: the date when the financial report was submitted.

totalAssets: the aggregate value of all assets owned by the company.

intangibleAssets: long-term, non-physical assets that increase in value over time, such as intellectual property, brand equity, customer relationships, and goodwill.

earningAssets: assets that produce income, including investments like stocks, bonds, rental properties, and interest-bearing accounts.

otherCurrentAssets: current assets not individually classified, which are expected to be converted into cash within a business cycle.

totalLiab: the sum of all liabilities and debts owed by the company. Calculated as totalCurrentLiabilities + nonCurrentLiabilitiesTotal.

totalStockholderEquity: the residual equity after liabilities are subtracted from assets. totalStockholderEquity = totalAssets — totalLiab.

deferredLongTermLiab: long-term deferred tax liabilities that arise from timing differences in income recognition between financial reporting and tax accounting.

otherCurrentLiab: minor liabilities due within 12 months, grouped together.

commonStock: equivalent to capitalStock.

capitalStock: the total number of authorized common and preferred shares a company can issue, as defined in its charter.

retainedEarnings: synonymous with retainedEarningsTotalEquity; it represents accumulated profit after expenses, taxes, and dividends.

otherLiab: liability items on the balance sheet that do not fall into other specified categories.

goodWill: an intangible asset from acquisitions, reflecting brand value, customer loyalty, proprietary technology, and other elements contributing to a premium purchase price.

otherAssets: interchangeable with nonCurrentAssetsOther.

cash: for U.S. tickers, this is interchangeable with cashAndEquivalents; may differ by exchange.

cashAndEquivalents: for U.S. tickers, used interchangeably with cash; includes both cash and short-term liquid investments. May vary for other exchanges.

totalCurrentLiabilities: liabilities due within the next 12 months. Can be calculated as:

• accountsPayable + shortLongTermDebt + otherCurrentLiab + (lease liabilities and taxes if available), or
• shortTermDebt + shortLongTermDebtTotal + otherCurrentLiab, or
• totalCurrentLiabilities = totalLiab — nonCurrentLiabilitiesTotal.

currentDeferredRevenue: the short-term portion of deferred revenue liabilities.

netDebt: total debt minus cash. Calculated as: shortTermDebt + longTermDebtTotal — cash.

shortTermDebt: debts due within one year, including loans, leases, and credit balances.

shortLongTermDebt: the current portion of long-term debt.

shortLongTermDebtTotal: company-specific total combining longTermDebt, shortTermDebt, and shortLongTermDebt.

otherStockholderEquity: sometimes corresponds to accumulatedOtherComprehensiveIncome.

propertyPlantEquipment: equivalent to propertyPlantAndEquipmentNet.

totalCurrentAssets: total of all current assets. Formula:
cashAndEquivalents + shortTermInvestments + netReceivables + inventory + otherCurrentAssets.

longTermInvestments: long-term marketable securities.

netTangibleAssets: total physical assets minus liabilities and intangible assets.

shortTermInvestments: short-duration, marketable securities.

netReceivables: accounts receivable minus the estimated uncollectible portion.

longTermDebt: debt with repayment terms exceeding one year.

inventory: raw materials and finished goods held for sale or production.

accountsPayable: outstanding payments due to suppliers and vendors.

totalPermanentEquity: sum of paid-in capital and retained earnings minus distributions.

noncontrollingInterestInConsolidatedEntity: reflects minority interest holdings in consolidated entities.

temporaryEquityRedeemableNoncontrollingInterests: minority equity holdings that are redeemable and grant limited control.

accumulatedOtherComprehensiveIncome: may be the same as otherStockholderEquity.

additionalPaidInCapital: the amount paid for shares above their par value.

commonStockTotalEquity: represents total equity from common shareholders, including capital, retained earnings, and premiums.

preferredStockTotalEquity: total capital contributed by holders of preferred shares.

retainedEarningsTotalEquity: same as retainedEarnings.

treasuryStock: company-owned stock that is not publicly traded.

accumulatedAmortization: cumulative amortization charged against intangible assets.

nonCurrrentAssetsOther: alternate for otherAssets; long-term assets not classified elsewhere.

deferredLongTermAssetCharges: long-term prepaid expenses capitalized as assets.

nonCurrentAssetsTotal: long-lived assets with a useful life of over one year.

capitalLeaseObligations: long-term lease obligations under capital lease agreements.

longTermDebtTotal: may include just longTermDebt or both longTermDebt and capitalLeaseObligations.

nonCurrentLiabilitiesOther: other long-term liabilities not separately listed.

nonCurrentLiabilitiesTotal: all liabilities not due within the next 12 months. Equals totalLiab — totalCurrentLiabilities.

negativeGoodwill: also known as a bargain purchase; occurs when net assets acquired exceed the purchase price.

warrants: securities that grant the right to buy or sell an equity at a specific price before expiration.

preferredStockRedeemable: preferred stock that the issuer can repurchase and retire at a set price.

capitalSurpluse: surplus generated from stock issued above par value.

liabilitiesAndStockholdersEquity: should equal totalAssets. Formula:
totalLiab + totalStockholderEquity.

cashAndShortTermInvestments: sum of cash and liquid investments.

propertyPlantAndEquipmentGross: gross amount of property, plant, and equipment before depreciation.

propertyPlantAndEquipmentNet: net value of property, plant, and equipment; same as propertyPlantEquipment.

accumulatedDepreciation: total depreciation recorded on assets up to the reporting date.

netWorkingCapital: formula: (totalCurrentAssets — cash) — (totalCurrentLiabilities — shortLongTermDebtTotal).

netInvestedCapital: the net spending on capital assets after subtracting depreciation.

commonStockSharesOutstanding: weighted average diluted shares outstanding, used for EPS calculations, excluding treasury shares.

Income_Statement

quarterly or yearly: denotes the reporting frequency of the statement — either quarterly or annually.

date: the last day of the reporting period covered.

filing_date: the official date when the financial report was submitted.

currency_symbol: identifies the currency in which the financial data is reported.

researchDevelopment: expenses related to research and development activities.

effectOfAccountingCharges: includes charges such as depreciation, amortization, bad debt provisions, and other expenses linked to normal business operations.

incomeBeforeTax: income figure reported before taxes are deducted. Calculated as:
incomeBeforeTax = operatingIncome – nonOperatingIncomeNetOther.

minorityInterest: reflects the share of profit attributable to minority shareholders in subsidiaries controlled by the parent company.

netIncome: final profit after all expenses. Common calculation methods include:
netIncome = incomeBeforeTax – incomeTaxExpense – minorityInterest
or
netIncome = operatingIncome – interestExpense – incomeTaxExpense
or
netIncome = operatingIncome – incomeTaxExpense.

sellingGeneralAdministrative: total SG&A costs, including both selling and administrative expenses.

sellingAndMarketingExpenses: sometimes included in SG&A or reported separately if available.

grossProfit: calculated as grossProfit = totalRevenue – costOfRevenue.

reconciledDepreciation: for US tickers, equivalent to depreciationAndAmortization.

ebit: earnings before interest and taxes. Usually equals:
ebit = totalRevenue – costOfRevenue – totalOperatingExpenses
or
ebit = operatingIncome + netInterestIncome + totalOtherIncomeExpenseNet.

ebitda: earnings before interest, taxes, depreciation, and amortization. Calculated as:
ebitda = ebit + depreciationAndAmortization.

depreciationAndAmortization: combined value of depreciation and amortization; interchangeable with reconciledDepreciation for US tickers.

nonOperatingIncomeNetOther: net income from non-operating activities.

operatingIncome: profit from core business activities. May be:
operatingIncome = totalRevenue – totalOperatingExpenses
or
operatingIncome = totalRevenue – totalOperatingExpenses – costOfRevenue.

otherOperatingExpenses: general total of reported operating expenses.

interestExpense: expense incurred from borrowed funds.

taxProvision: total income tax cost for the reporting period.

interestIncome: earnings derived from interest activities, primarily relevant in financial institutions.

netInterestIncome: net value of interest income after deducting interest expenses.

extraordinaryItems: no longer in use under IFRS standards.

nonRecurring: one-time gains or losses not expected to reoccur.

otherItems: any additional income or expense items.

incomeTaxExpense: taxes owed on reported income.

totalRevenue: top-line revenue figure. Possible formulas:
totalRevenue = operatingIncome + totalOperatingExpenses
or (for banks)
totalRevenue = interestIncome + totalOtherIncomeExpenseNet.

totalOperatingExpenses: total of all operating costs. Common components:
researchDevelopment + sellingGeneralAdministrative + sellingAndMarketingExpenses + depreciationAndAmortization
(actual structure may vary by company).

costOfRevenue: also referred to as cost of goods sold. Often:
costOfRevenue = totalOperatingExpenses – sellingGeneralAdministrative.

totalOtherIncomeExpenseNet: the combined value of nonOperatingIncomeNetOther and netInterestIncome.

discontinuedOperations: income or loss from business segments that have been sold or closed.

netIncomeFromContinuingOps: net profit from ongoing operations only.

netIncomeApplicableToCommonShares: portion of net income allocated to common shareholders when multiple share classes exist.

preferredStockAndOtherAdjustments: total value of preferred dividends and other adjustments needed to determine income attributable to common shareholders.

Cash_Flow

quarterly or yearly: indicates whether the figures are reported on a quarterly or annual basis.

date: marks the end date of the financial period covered.

filing_date: the official submission date of the cash flow report.

currency_symbol: shows the currency in which the financial data is reported.

investments: reflects investment-related cash flows.

changeToLiabilities: change in a company’s liabilities over the reporting period.

totalCashflowsFromInvestingActivities: total cash used in or generated from investment activities.

netBorrowings: the net value of debt issued minus repayments made during the period.

totalCashFromFinancingActivities: total cash provided by or used in financing activities.

changeToOperatingActivities: adjustments to operational activities, not the same as total operational cash flow.

netIncome: identical to the net income field in the income statement.

changeInCash: net change in cash position over the period.
changeInCash = endPeriodCashFlow – beginPeriodCashFlow.
Equivalent to cashAndCashEquivalentsChanges when cash = cashAndEquivalents.

beginPeriodCashFlow: cash held at the start of the reporting period.

endPeriodCashFlow: cash held at the end of the reporting period.

totalCashFromOperatingActivities: net cash generated from regular business operations.

issuanceOfCapitalStock: proceeds from issuing new shares of stock to investors.

depreciation: depreciation and amortization, same as reconciledDepreciation and depreciationAndAmortization in the income statement.

otherCashflowsFromInvestingActivities: uncategorized cash flows from investment activities.

dividendsPaid: total amount of dividends paid out to shareholders during the period.

changeToInventory: net change in inventory levels over the period.

changeToAccountReceivables: increase or decrease in accounts receivable during the reporting timeframe.

salePurchaseOfStock: cash received from selling stocks or spent on repurchasing shares.

otherCashflowsFromFinancingActivities: financing-related cash flows not specifically categorized.

changeToNetincome: the variation in net income from the previous period.

capitalExpenditures: money spent on acquiring or maintaining physical assets like property and equipment.

changeReceivables: change in customer payments due during the period.

cashFlowsOtherOperating: operating activity cash flows not assigned to a specific subcategory.

exchangeRateChanges: impact on cash due to currency exchange rate fluctuations.

cashAndCashEquivalentsChanges: difference in the cashAndCashEquivalents value between the start and end of the period. Same as changeInCash when cash = cashAndEquivalents.

changeInWorkingCapital: the difference in working capital between two periods.
changeInWorkingCapital = changeToAccountReceivables + changeToInventory + changeToLiabilities + changeToOperatingActivities.

stockBasedCompensation: equity-based compensation granted to employees as part of their remuneration.

otherNonCashItems: expenses recorded without actual cash movement, such as depreciation, amortization, deferred taxes, and stock-based compensation.

freeCashFlow: the remaining cash after deducting capital expenditures from operating cash flow.
freeCashFlow = totalCashFromOperatingActivities – capitalExpenditures.

Check out our ETF Fundamentals Glossary here.

Please note that this article is for informational purposes only and should not be taken as financial advice. We do not bear responsibility for any trading decisions made based on the content of this article. Readers are advised to conduct their own research or consult with a qualified financial professional before making any investment decisions.

For those eager to delve deeper into such insightful articles and broaden their understanding of different strategies in financial markets, we invite you to follow our account and subscribe for email notifications.

Stay tuned for more valuable articles that aim to enhance your data science skills