API Glossary: All Data Fields Explained
Complete reference of all data fields in the Leeway Stock API. From fundamental data to ETF holdings to macroeconomic indicators – every field explained precisely. Perfect for developers, analysts and traders.
The Leeway Stock API provides access to comprehensive market data from more than 50 exchanges worldwide, including XETRA, Frankfurt Stock Exchange, Euronext Paris/Amsterdam, as well as NYSE and NASDAQ. Available data includes fundamental data (annual/quarterly, up to 40 years), historical quotes (up to 100 years), intraday data and more.
Coverage includes stocks, ETFs, indices, funds, currencies and cryptos. All data is provided in JSON format via a REST API. The base package includes 100,000 requests/day, the free account includes 50 daily requests.
Why This Glossary Matters
📊 Developers
Understand exactly what data each field provides. Write error-free code for trading bots, dashboards and analysis tools.
📈 Analysts
Choose the right metrics for your analyses. Every field – from P/E to EBITDA – is precisely defined.
⚡ Traders
Build better strategies with complete data understanding. Optimally use prices, fundamentals and macro data.
Fundamental Data
Balance sheet data, metrics & valuation ratios – up to 40 years of history
General
Code- The stock ticker symbol.
Type- The type of equity, such as Common Stock or Preferred Stock.
Name- The company name.
Exchange- the exchange code identifier for the stock exchange where this ticker is listed (this is NOT to be interpreted as "primary exchange").
CurrencyCode- The three-letter ISO 4217 currency code used for trading this stock (e.g., USD, EUR, GBP).
CurrencyName- The full name of the trading currency.
CurrencySymbol- The standard currency symbol (e.g., $ for USD, £ for GBP, € for EUR).
CountryName- The country where the stock exchange is located.
CountryISO- The ISO country code.
OpenFigi- The Open Financial Instrument Global Identifier (FIGI) code.
ISIN- International Securities Identification Number. This identifier may be shared between different ticker symbols for the same company traded on different exchanges.
LEI- Legal Entity Identifier. A unique 20-character code used to identify legal entities that participate in financial transactions.
PrimaryTicker- The primary ticker symbol for this company. For example, AAPL.US would be the primary ticker for APC.XETRA.
CUSIP- Committee on Uniform Securities Identification Procedures number, used for US and Canadian stocks.
CIK- Central Index Key, a unique identifier assigned by the SEC to US and Canadian companies.
FiscalYearEnd- The month and day when the company's fiscal year ends (e.g., "12-31" for December 31).
EmployerIdNumber- The Employer Identification Number (EIN) assigned by the IRS to identify business entities for tax purposes.
IPODate- The date when the company first went public through an Initial Public Offering.
InternationalDomestic- Indicates whether the company is domestic or international relative to the US market.
Sector- The broad economic sector the company operates in.
Industry- The specific industry classification for the company.
GicSector- Global Industry Classification Standard (GICS) sector classification.
GicGroup- Global Industry Classification Standard (GICS) industry group classification.
GicIndustry- Global Industry Classification Standard (GICS) industry classification.
GicSubIndustry- Global Industry Classification Standard (GICS) sub-industry classification.
HomeCategory- Classification category for US stock tickers, such as ADR, Canadian, Domestic, CEF, ETD, ETN, or Warrant, with variations like Primary, Secondary, or Preferred.
IsDelisted- Indicates whether the stock has been delisted (true) or is still actively traded (false). Only available for US stocks.
DelistedDate- The last date when trading data is available for delisted stocks. Only shown for US stocks that have been delisted.
Description- A brief description of the company and its business activities.
Address- The company's headquarters address.
AddressData- The company address broken down into structured fields (street, city, state, country, etc.).
Listings- All stock exchange listings for this company worldwide, with details for each listing.
Officers- List of company officers and executives, including their titles and roles.
Phone- The company's main phone number.
WebURL- The company's official website URL.
LogoURL- The relative URL path to obtain the company logo. Combine with the base API URL (https://api.leeway.tech/api/v1/public) to get the full logo URL.
FullTimeEmployees- The most recent known number of full-time employees at the company.
UpdatedAt- The date when the fundamentals data for this ticker was last updated. For active tickers, the Highlights, SharesStats, and Valuation sections may reference this as their last update date.
Highlights
MarketCapitalization- The total market value of all outstanding shares, calculated by multiplying the current stock price by the total number of shares outstanding.
MarketCapitalizationMln- Market capitalization expressed in millions.
EBITDA- Earnings Before Interest, Taxes, Depreciation, and Amortization for the trailing twelve months (TTM).
PERatio- Price-to-Earnings ratio, calculated using trailing twelve months (TTM) earnings.
PEGRatio- Price-to-Earnings Growth ratio, based on 5-year expected earnings growth.
WallStreetTargetPrice- The average year-end price target from top security analysts. For non-US stocks, the currency matches the company's home country currency, not necessarily the trading currency.
BookValue- Book value per share, calculated as (total assets minus total liabilities) divided by shares outstanding, based on the most recent quarter (MRQ).
DividendShare- The total amount of dividends paid per share over the trailing twelve months (TTM).
DividendYield- Annual dividend yield percentage, calculated as (DividendShare divided by current price) for the trailing twelve months (TTM).
EarningsShare- Diluted earnings per share for the trailing twelve months (TTM).
EPSEstimateCurrentYear- Analyst estimate for earnings per share in the current fiscal year.
EPSEstimateNextYear- Analyst estimate for earnings per share in the next fiscal year.
EPSEstimateNextQuarter- Analyst estimate for earnings per share in the next quarter.
EPSEstimateCurrentQuarter- Analyst estimate for earnings per share in the current quarter.
MostRecentQuarter- The most recent quarter for which financial data is available.
ProfitMargin- Net profit margin, showing what percentage of revenue becomes profit.
OperatingMarginTTM- Operating margin percentage, calculated as (operating income / total revenue) × 100 for the trailing twelve months (TTM).
ReturnOnAssetsTTM- Return on assets (ROA), calculated as net income divided by total assets for the trailing twelve months (TTM).
ReturnOnEquityTTM- Return on equity (ROE), calculated as net income divided by total stockholder equity for the trailing twelve months (TTM).
RevenueTTM- Total revenue generated by the company over the trailing twelve months (TTM).
RevenuePerShareTTM- Revenue per share, calculated as total revenue divided by common stock shares outstanding for the trailing twelve months (TTM).
QuarterlyRevenueGrowthYOY- Year-over-year quarterly revenue growth, comparing the same quarter from consecutive years (e.g., Q4 Year 2 vs. Q4 Year 1).
GrossProfitTTM- Gross profit for the trailing twelve months (TTM), calculated as total revenue minus cost of revenue.
DilutedEpsTTM- Diluted earnings per share for the trailing twelve months (TTM).
QuarterlyEarningsGrowthYOY- Year-over-year quarterly earnings growth, comparing the same quarter from consecutive years (e.g., Q4 Year 2 vs. Q4 Year 1).
Valuation
TrailingPE- Price-to-Earnings ratio based on trailing twelve months (TTM) earnings.
ForwardPE- Price-to-Earnings ratio calculated using estimated future earnings per share.
PriceSalesTTM- Price-to-Sales ratio for the trailing twelve months (TTM).
PriceBookMRQ- Price-to-Book ratio based on the most recent quarter (MRQ) data.
EnterpriseValue- Enterprise value, calculated as market capitalization plus total debt and minority interest, minus cash and equivalents. Currency matches the company's financial reporting currency.
EnterpriseValueRevenue- Enterprise value divided by revenue, showing how many years of revenue it would take to pay for the company.
EnterpriseValueEbitda- Enterprise value divided by EBITDA, a common valuation metric for comparing companies.
SharesStats
SharesOutstanding- The current number of shares issued and held by stockholders. For companies with multiple share classes, this shows only the shares for this specific ticker, while other fields may show all share classes combined.
SharesFloat- The number of shares available for public trading, excluding restricted or closely held shares.
PercentInsiders- The percentage of shares owned by company insiders (executives, directors, etc.).
PercentInstitutions- The percentage of shares owned by institutional investors (mutual funds, pension funds, etc.).
Technicals
Beta- The 5-year levered beta, measuring stock volatility relative to the country's main market indices. A beta of 1 means the stock moves with the market.
52WeekHigh- The highest price reached during the past 52 weeks, adjusted for stock splits and dividends.
52WeekLow- The lowest price reached during the past 52 weeks, adjusted for stock splits and dividends.
50DayMA- The 50-day simple moving average of the stock price.
200DayMA- The 200-day simple moving average of the stock price.
SharesShort- The current number of shares sold short by investors.
SharesShortPriorMonth- The number of shares sold short one month ago.
ShortRatio- The short interest ratio, calculated as shorted shares divided by the average daily trading volume over the past 30 days.
ShortPercent- The percentage of shares outstanding that are sold short. Multiply by 100 to get the percentage (e.g., 0.00150 = 0.15%).
SplitsDividends
ForwardAnnualDividendRate- The expected annual dividend payment per share in currency terms, calculated as price multiplied by forward annual dividend yield.
ForwardAnnualDividendYield- The expected annual dividend yield percentage, calculated as expected dividends divided by current price.
PayoutRatio- The percentage of net income paid out as dividends to common shareholders over the trailing twelve months (TTM). Calculated from the sum of the last 4 quarters of dividends divided by net income.
DividendDate- The most recent date when a dividend was paid to shareholders.
ExDividendDate- The most recent ex-dividend date, which is the date when the stock begins trading without the dividend.
LastSplitFactor- The ratio of the most recent stock split (e.g., "2:1" means 2 new shares for every 1 old share).
LastSplitDate- The date of the most recent stock split.
NumberDividendsByYear- The number of dividend payments made each year, broken down by year in sub-fields.
AnalystRatings
Rating- Analyst consensus rating on a scale of 1 to 5, where 1 = Strong Sell and 5 = Strong Buy.
TargetPrice- The average analyst price target for the stock one year from today.
StrongBuy- The number of analysts who rate this security as Strong Buy.
Buy- The number of analysts who rate this security as Buy.
Hold- The number of analysts who rate this security as Hold.
Sell- The number of analysts who rate this security as Sell.
StrongSell- The number of analysts who rate this security as Strong Sell.
Holders
Institutions or Funds- The type of holder, either an institution or a fund.
name- The name of the institution or fund holding the shares.
date- The date of the reported holding position.
totalShares- The percentage of the ticker's outstanding shares held by this institution or fund.
totalAssets- The percentage of the institution's total assets represented by these shares.
currentShares- The current number of shares held.
change- The change in the number of shares held compared to the previous quarter.
change_p- The percentage change in shares held compared to the previous quarter.
InsiderTransactions
date- The date of the insider transaction.
ownerCik- The Central Index Key (CIK) code of the transaction owner, if available.
ownerName- The name of the person who executed the transaction.
transactionDate- The date when the transaction occurred (same as date field).
transactionCode- Transaction type code: "S" for sale, "P" for purchase.
transactionAmount- The number of shares involved in the transaction.
transactionPrice- The price per share at which the transaction was executed.
transactionAcquiredDisposed- Indicates whether shares were acquired ("A") or disposed ("D").
postTransactionAmount- The total number of shares the person holds after this transaction.
secLink- Link to the SEC filing document for this transaction.
ESGScores
Disclaimer- Legal disclaimer regarding the ESG scores and ratings.
RatingDate- The date when the ESG rating was assigned or last updated.
ActivitiesInvolvement- Information about the company's involvement in specific activities or industries.
Activity- The type of activity or industry, such as: adult, alcoholic, animalTesting, catholic, controversialWeapons, smallArms, furLeather, gambling, gmo, militaryContract, nuclear, pesticides, palmOil, coal, or tobacco.
Involvement- Indicates whether the company is involved ("Yes") or not involved ("No") in the specified activity.
outstandingShares
annual or quarterly- Indicates whether the data is annual or quarterly.
date- The specific year (for annual) or quarter (for quarterly) of the reporting period.
dateFormatted- The formatted end date of the reporting period.
sharesMln- Weighted average diluted shares outstanding in millions, adjusted for stock splits.
shares- Weighted average diluted shares outstanding, adjusted for stock splits.
Earnings
History- Historical quarterly earnings data.
reportDate- The date when the earnings report was filed. For US stocks, this is the 8K report date (not the 10K/10Q filing date, which can be found in the Financials section). For large companies, this may be just before the earnings call, while smaller companies may have a longer gap between reports.
date- The end date of the reported earnings period.
beforeAfterMarket- Indicates when earnings were reported: "BeforeMarket" (before market open), "AfterMarket" (after market close), or null (unknown).
epsActual- The actual non-GAAP earnings per share reported by the company.
epsEstimate- The analyst consensus estimate for earnings per share before the earnings release.
epsDifference- The difference between actual and estimated EPS (actual minus estimate).
surprisePercent- The percentage surprise, calculated as (actual EPS minus estimated EPS) divided by estimated EPS.
Trend- Historical earnings predictions and estimates over time.
YYYY-MM-DD- The end date of the period in YYYY-MM-DD format.
period- The time period for the prediction: +1y (next year), 0y (current year), +1q (next quarter), or 0q (current quarter).
growth- Estimated expected EPS growth percentage, calculated as (average estimate minus year-ago estimate) divided by year-ago estimate.
earningsEstimateAvg- The average earnings per share estimate from Wall Street analysts.
earningsEstimateLow- The lowest earnings per share estimate from analysts.
earningsEstimateHigh- The highest earnings per share estimate from analysts.
earningsEstimateYearAgoEps- The earnings per share estimate from one year ago (not adjusted for time).
earningsEstimateNumberOfAnalysts- The number of analysts providing earnings estimates for this ticker.
earningsEstimateGrowth- Estimated expected EPS growth percentage, same as the growth field.
revenueEstimateAvg- The average revenue estimate from Wall Street analysts.
revenueEstimateLow- The lowest revenue estimate from analysts.
revenueEstimateHigh- The highest revenue estimate from analysts.
revenueEstimateYearAgoEps- The revenue estimate from one year ago.
revenueEstimateNumberOfAnalysts- The number of analysts providing revenue estimates for this ticker.
revenueEstimateGrowth- Estimated expected revenue growth percentage.
epsTrendCurrent- The current earnings per share estimate.
epsTrend7daysAgo- The earnings per share estimate from 7 days ago.
epsTrend30daysAgo- The earnings per share estimate from 30 days ago.
epsTrend60daysAgo- The earnings per share estimate from 60 days ago.
epsTrend90daysAgo- The earnings per share estimate from 90 days ago.
epsRevisionsUpLast7days- The number of upward EPS estimate revisions in the past 7 days.
epsRevisionsUpLast30days- The number of upward EPS estimate revisions in the past 30 days.
epsRevisionsDownLast7days- The number of downward EPS estimate revisions in the past 7 days.
epsRevisionsDownLast30days- The number of downward EPS estimate revisions in the past 30 days.
Annual- Annual earnings history. Note: For the current fiscal year, the annual figure is the sum of available quarterly earnings, so the date also indicates the latest quarter available.
date- The year of the annual earnings period.
epsActual- The sum of the four quarterly EPS values for the calendar year.
Financials
currency_symbol- The currency symbol used in the financial report.
quarterly or yearly- Indicates whether the data is quarterly or annual.
date- The end date of the reporting period.
filing_date- The date when the financial report was filed with regulatory authorities.
totalAssets- The total value of all assets owned by the company.
intangibleAssets- Assets without physical form that provide long-term value. Examples include intellectual property, brand recognition, customer relationships, and goodwill.
earningAssets- Income-producing investments held by the company, such as stocks, bonds, rental properties, certificates of deposit, and other interest or dividend-earning accounts.
otherCurrentAssets- Other valuable assets that can be converted to cash within one business cycle (typically one year).
totalLiab- The total amount of debts and obligations owed to external parties, calculated as current liabilities plus non-current liabilities.
totalStockholderEquity- The residual value of assets after all liabilities are paid, calculated as total assets minus total liabilities.
deferredLongTermLiab- deferred tax liability is a type of long-term liability incurred when a company postpones paying taxes on certain types of accounting income. The amount of the liability is the difference between a company's taxable income and its accounting or book income.
otherCurrentLiab- the current liabilities (due within 12 months) that are insignificant separately, but are clumped together on the company's liabilities.
commonStock- same as capitalStock.
capitalStock- the total amount of common and preferred shares that a company is authorized to issue, according to its corporate charter. Capital stock can only be issued by the company and is the maximum number of shares that can ever be outstanding.
retainedEarnings- same as retainedEarningsTotalEquity. The amount of profit a company has left over after paying all its direct costs, indirect costs, income taxes and its dividends to shareholders.
otherLiab- all balance sheet liability accounts not covered specifically in other areas of the supervisory activity.
goodWill- an intangible asset that is associated with the purchase of one company by another. It represents value that can give the acquiring company a competitive advantage. The value of a company's name, brand reputation, loyal customer base, solid customer service, good employee relations, and proprietary technology represent aspects of goodwill. This value is why one company may pay a premium for another.
otherAssets- same as nonCurrrentAssetsOther.
cash- the fields cash and cashAndEquivalents are interchangeable for US tickers, the latter being a later addition to the template. For other exchanges, this may differ in some cases, and "cash" will only have the cash figure.
cashAndEquivalents- the fields cash and cashAndEquivalents are interchangeable for US tickers, the latter being a later addition to the template. For other exchanges, this may differ in some cases, and "cashAndEquivalents" will have the figure corresponding to cash and its equivalents from the financial report.
totalCurrentLiabilities- the current liabilities (due within 12 months). accountsPayable + shortLongTermDebt + otherCurrentLiab + (Current portion of operating lease liabilities – not yet available) + (Income taxes payable – not available). OR: shortTermDebt + shortLongTermDebtTotal + otherCurrentLiab. OR: totalCurrentLiabilities = totalLiab – nonCurrentLiabilitiesTotal.
currentDeferredRevenue- the deferred revenue liability, current to the period. It can be used in place of deferred liability.
netDebt- a metric that shows how much debt a company has on its balance sheet compared to its liquid assets. netDebt = shortTermDebt + longTermDebtTotal – cash.
shortTermDebt- Short-term debt refers to any debt that is due within one year or less. This may include loans, credit card balances, and other obligations that are expected to be paid off within the next 12 months. For some companies, this number represents the current capital lease obligations.
shortLongTermDebt- the Short/Current Long-Term Debt (current portion of the long term debt).
shortLongTermDebtTotal- may differ between companies: longTermDebt/longTermDebtTotal + shortTermDebt / + shortLongTermDebt / = shortLongTermDebtTotal.
otherStockholderEquity- may correspond to accumulatedOtherComprehensiveIncome with some companies, or may differ for others.
propertyPlantEquipment- same as propertyPlantAndEquipmentNet.
totalCurrentAssets- the sum of all current assets. totalCurrentAssets = cashAndEquivalents + shortTermInvestments + netReceivables +inventory + otherCurrentAssets.
longTermInvestments- marketable securities.
netTangibleAssets- the total physical assets of a company minus all intangible assets and liabilities.
shortTermInvestments- marketable securities.
netReceivables- the total money owed to a company by its customers minus the money owed that will likely never be paid.
longTermDebt- any debt that is due in more than one year.
inventory- raw materials used to produce goods as well as the goods that are available for sale.
accountsPayable- amounts due to vendors or suppliers for goods or services received that have not yet been paid for.
totalPermanentEquity- the sum of paid in capital and net income less any distributions.
noncontrollingInterestInConsolidatedEntity- minority interest in the balance sheet.
temporaryEquityRedeemableNoncontrollingInterests- an ownership stake in a corporation, with the investors owning a minority interest and having less influence over how the company is managed.
accumulatedOtherComprehensiveIncome- same as otherStockholderEquity.
additionalPaidInCapital- the difference between the par value of a stock and the price that investors actually pay for it.
commonStockTotalEquity- the total amount of all investments in a company made by common equity investors, including the total value of all shares of common stock, plus retained earnings and additional paid-in capital.
preferredStockTotalEquity- the total amount of all investments in a company made by preferred equity investors.
retainedEarningsTotalEquity- same as retainedEarnings.
treasuryStock- the portion of a company's shares that are held by its treasury and not available to the public.
accumulatedAmortization- the cumulative amount of all amortization expenses that has been charged against an intangible asset.
nonCurrrentAssetsOther- same as otherAssets. noncurrent assets are long-term and have a useful life of more than a year.
deferredLongTermAssetCharges- long-term prepaid expenses that are carried as an asset on a balance sheet until used/consumed.
nonCurrentAssetsTotal- noncurrent assets are long-term and have a useful life of more than a year.
capitalLeaseObligations- long-term (non-current) amount of hire charges or rent owed by the lessee to the lessor for taking capital assets on hire under a capital lease.
longTermDebtTotal- may be same as longTermDebt for some companies, or longTermDebt + capitalLeaseObligations for others.
nonCurrentLiabilitiesOther- a part of non-current liabilities that is not directly classifiable.
nonCurrentLiabilitiesTotal- the debts that a business owes, but isn't due to pay for at least 12 months. nonCurrentLiabilitiesTotal = totalLiab – totalCurrentLiabilities.
negativeGoodwill- negative goodwill, also known as bargain purchase gain, occurs when the fair value of the net assets acquired in a merger or acquisition exceeds the purchase price.
warrants- the amount of derivatives that give the right, but not the obligation, to buy or sell a security – most commonly an equity – at a certain price before expiration.
preferredStockRedeemable- a type of preferred stock that allows the issuer to buy back the stock at a certain price and retire it, thereby converting the stock to treasury stock.
capitalSurpluse- the surplus resulting after common stock is sold for more than its par value.
liabilitiesAndStockholdersEquity- same as totalAssets: liabilitiesAndStockholdersEquity = totalLiab + totalStockholderEquity.
cashAndShortTermInvestments- cash and short term investments.
propertyPlantAndEquipmentGross- gross PPE,
propertyPlantAndEquipmentNet- net PPE, same as propertyPlantEquipment.
accumulatedDepreciation- the total amount an asset has been depreciated up until a single point.
netWorkingCapital- (totalCurrentAssets – cash) – (totalCurrentLiabilities – shortLongTermDebtTotal).
netInvestedCapital- the total amount of money that a company spends on capital assets, minus the cost of the depreciation of those assets.
commonStockSharesOutstanding- the shares of common stock that have been issued minus any shares of common stock known as treasury stock. This is the weighted average diluted number (the total number of shares if the convertible securities of a company were exercised) used for EPS calculations.
quarterly or yearly- self-explanatory.
date- the date of the end of the corresponding period.
filing_date- the date the report was filed.
currency_symbol- self-explanatory, the currency of the figures of the report.
researchDevelopment- R&D expenses.
effectOfAccountingCharges- charges that include items such as depreciation, amortization, bad debt, and other expenses that are associated with the normal operations of a business.
incomeBeforeTax- self-explanatory. incomeBeforeTax = operatingIncome – nonOperatingIncomeNetOther.
minorityInterest- a minority interest refers to a stake in a company that is otherwise controlled by a parent company. On the income statement, minority interest is recorded as a share of the minority shareholders' profit.
netIncome- self-explanatory. netIncome = incomeBeforeTax – incomeTaxExpense – minorityInterest OR netIncome = operatingIncome – interestExpense – incomeTaxExpense OR netIncome = operatingIncome – incomeTaxExpense, depending on how it was reported.
sellingGeneralAdministrative- selling, general, and administrative expenses (SG&A) – all general and administrative expenses (G&A) as well as the direct and indirect selling expenses of a business.
sellingAndMarketingExpenses- may be a component of sellingGeneralAdministrative, not reported in that case; or a field of its own, reported separately.
grossProfit- self-explanatory: the gross profit. grossProfit = totalRevenue – costOfRevenue.
reconciledDepreciation- same as depreciationAndAmortization for US tickers.
ebit- ebit = totalRevenue – costOfRevenue – totalOperatingExpenses. In most cases this should be the same as operatingIncome, if the companies report it as such. In other cases, it may be operatingIncome + netInterestIncome + totalOtherIncomeExpenseNet.
ebitda- earnings before interest, taxes, depreciation, amortization; ebit + depreciationAndAmortization.
depreciationAndAmortization- depreciation and amortization, same as reconciledDepreciation for US tickers.
nonOperatingIncomeNetOther- income (loss) not attributable to operating income.
operatingIncome- self-explanatory. operatingIncome = totalRevenue – totalOperatingExpenses OR operatingIncome = totalRevenue – totalOperatingExpenses – costOfRevenue, depending on how it was reported. In most cases this should be the same as ebit.
otherOperatingExpenses- the total expenses / cost and expenses field.
interestExpense- the cost incurred by an entity for borrowed funds.
taxProvision- the reporting period's total income tax expense.
interestIncome- income incurred from interest-related operations, a banking sphere field.
netInterestIncome- net interest income incurred from interest-related operations, a banking sphere field.
extraordinaryItems- obsolete: International Financial Reporting Standards (IFRS) does not recognize the concept of an extraordinary item, which has led to the practice of classifying extraordinary items as separate from nonrecurring items to become obsolete.
nonRecurring- income received which is not anticipated to continue in future months.
otherItems- other possible income.
incomeTaxExpense- the expenses incurred by tax paying.
totalRevenue- self-explanatory, a reported figure. totalRevenue = operatingIncome + totalOperatingExpenses. For banks, totalRevenue can be calculated as interestIncome + totalOtherIncomeExpenseNet.
totalOperatingExpenses- companies apply their own logic to calculating expenses. It may be: researchDevelopment + sellingGeneralAdministrative + sellingAndMarketingExpenses + depreciationAndAmortization (some tickers include D&A, some do not); it may be different. Check the companies' original report to see how exactly they calculate their expenses.
costOfRevenue- otherwise known as "cost of goods sold", a reported figure. costOfRevenue = totalOperatingExpenses – sellingGeneralAdministrative.
totalOtherIncomeExpenseNet- nonOperatingIncomeNetOther + netInterestIncome.
discontinuedOperations- net income (loss) from discontinued operations, not a subcomponent of extraordinaryItems or nonRecurring.
netIncomeFromContinuingOps- self-explanatory.
netIncomeApplicableToCommonShares- the portion of net income that should be used in calculations where only the common shares are applicable, if a company has more than one class of shares.
preferredStockAndOtherAdjustments- the aggregate value of preferred stock dividends and other adjustments necessary to derive net income apportioned to common stockholders.
quarterly or yearly- self-explanatory.
date- the date of the end of the corresponding period.
filing_date- the date the report was filed.
currency_symbol- self-explanatory, the currency of the figures of the report.
investments- self-explanatory.
changeToLiabilities- the increase or decrease in liabilities from one period to the next.
totalCashflowsFromInvestingActivities- self-explanatory.
netBorrowings- total debt borrowed during the year minus total debt repaid in the year.
totalCashFromFinancingActivities- self-explanatory.
changeToOperatingActivities- a change (positive or negative) to operating activities, not to be confused with totalCashFromOperatingActivities.
netIncome- see the same field on the income statement.
changeInCash- changeInCash = endPeriodCashFlow – beginPeriodCashFlow. Same as cashAndCashEquivalentsChanges for tickers where cash = cashAndEquivalents.
beginPeriodCashFlow- how much cash was available at the start of the period.
endPeriodCashFlow- how much cash was available at the end of the period.
totalCashFromOperatingActivities- cash from operations, not to be confused with changeToOperatingActivities.
issuanceOfCapitalStock- the amount of income from the process through which a company offers and sells its shares of stock to investors in order to raise capital.
depreciation- depreciation and amortization, same as reconciledDepreciation and depreciationAndAmortization from the income statement.
otherCashflowsFromInvestingActivities- a non-classified part of investing activities cash flow.
dividendsPaid- the sum of all cash dividends paid during the period.
changeToInventory- the difference between additions to and withdrawals from inventories.
changeToAccountReceivables- increase or decrease in the account receivables during the period.
salePurchaseOfStock- cash flow generated from the sale of securities, such as stocks and bonds (positive), or repurchases of stock (negative).
otherCashflowsFromFinancingActivities- a non-classified part of financing activities cash flow.
changeToNetincome- increase or decrease of the net income during the period.
capitalExpenditures- funds used by a company to acquire, upgrade, and maintain physical assets such as property, plants, buildings, technology, or equipment.
changeReceivables- increase or decrease in the cash that customers owe the company.
cashFlowsOtherOperating- a non-classified part of operating activities cash flow.
exchangeRateChanges- changes in the value of a company's cash balance due to fluctuations in foreign currency exchange rates.
cashAndCashEquivalentsChanges- the change in the cashAndCashEquivalents field during the period. Same as changeInCash for tickers where cash = cashAndEquivalents.
changeInWorkingCapital- The excess of current assets over current liabilities is referred to as the company's working capital; the difference between the working capital for two given reporting periods is called the change in working capital. changeInWorkingCapital = changeToAccountReceivables + changeToInventory + changeToLiabilities + changeToOperatingActivities.
stockBasedCompensation- a kind of compensation given by companies to their employees in the form of equity shares besides the regular cash or salary and bonuses they receive.
otherNonCashItems- expenses listed on an income statement, such as capital depreciation, investment gains, or losses, that do not involve a cash payment. Examples of non-cash items include depreciation, amortization, deferred income tax, stock based compensation that is provided to employees.
freeCashFlow- the money a company has left over after paying its operating expenses (OpEx) and capital expenditures (CapEx). totalCashFromOperatingActivities – capitalExpenditures = freeCashFlow.
Funds & ETFs
Holdings, Ratings & ETF Master Data
General
Code- The ETF or fund ticker symbol.
Type- The type of security, such as Common Stock, ETF, Fund, or Index. For this section, it will be ETF.
Name- The name of the ETF or fund.
Exchange- The exchange code identifier for the stock exchange where this ticker is listed (this is NOT to be interpreted as "primary exchange").
CurrencyCode- The three-letter ISO 4217 currency code used for trading (e.g., USD, EUR, GBP).
CurrencyName- The full name of the trading currency.
CurrencySymbol- The standard currency symbol (e.g., $ for USD, £ for GBP, € for EUR).
CountryName- The country where the stock exchange is located.
CountryISO- The ISO country code.
OpenFigi- The Open Financial Instrument Global Identifier (FIGI) code.
Description- A description of the ETF or fund and its investment strategy.
Category- The Morningstar category classification for the ETF or fund.
UpdatedAt- The date when the fundamentals data for this ticker was last updated.
Technicals
Beta- The 5-year levered beta, measuring volatility relative to the country's main market indices.
52WeekHigh- The highest price reached during the past 52 weeks.
52WeekLow- The lowest price reached during the past 52 weeks.
50DayMA- The 50-day simple moving average of the price.
200DayMA- The 200-day simple moving average of the price.
ETF_Data
ISIN- International Securities Identification Number. This identifier may be shared between different ticker symbols for the same security traded on different exchanges.
Company_Name- The name of the ETF issuer or fund management company.
Company_URL- The website URL of the ETF issuer.
ETF_URL- The direct link to the ETF's page on the issuer's website.
Domicile- The country where the ETF is legally formed and regulated.
Index_Name- The benchmark index that the ETF tracks, as classified by Morningstar.
Yield- The current trailing twelve months (TTM) dividend yield.
Dividend_Paying_Frequency- How often the ETF pays dividends (e.g., monthly, quarterly, annually).
Inception_Date- The date when the ETF first began trading.
Max_Annual_Mgmt_Charge- The maximum annual management fee charged to investors, based on the value of their investment. Expressed as a decimal (e.g., 0.2000 = 0.2%).
Ongoing_Charge- The Ongoing Charges Figure (OCF), representing the total annual cost of holding the investment. This broader metric includes management fees and other operating expenses, commonly used in Europe for UCITS funds. Expressed as a decimal (e.g., 0.2000 = 0.2%).
Date_Ongoing_Charge- The date when the ongoing charge was set or last changed, if available.
NetExpenseRatio- The North American equivalent of the Ongoing Charge, representing the fund's total annual operating expense ratio. These fees are deducted from dividend and capital gains distributions. To convert to percentage, multiply by 100 (e.g., 0.00150 = 0.15%).
AnnualHoldingsTurnover- The percentage rate at which the ETF or fund replaces its holdings each year, indicating how actively the portfolio is managed.
TotalAssets- Total assets under management, representing the size of this share class.
Average_Mkt_Cap_Mil- The average market capitalization of the ETF's holdings, expressed in millions.
Market_Capitalisation
Mega- The percentage of holdings in "mega" or "giant" capitalization companies.
Big- The percentage of holdings in "big" or "large" capitalization companies.
Medium- The percentage of holdings in "medium" capitalization companies.
Small- The percentage of holdings in "small" capitalization companies.
Micro- The percentage of holdings in "micro" capitalization companies.
Asset_Allocation
Long_%- The percentage of long positions in this asset type.
Short_%- The percentage of short positions in this asset type.
Net_Assets_%- The net percentage of assets allocated to this type (long minus short).
Cash- Cash and currency investments.
NotClassified- Investments that cannot be classified into other categories.
Stock non-US- Non-US equity investments.
Other- Other non-stock investment types.
Stock US- US equity investments.
Bond- Fixed income investments (bonds).
World_Regions
Equity_%- The percentage allocation to this region for this specific ETF.
Relative_to_Category- The average percentage allocation to this region across all ETFs in the same category.
Regions- Geographic regions: North America, United Kingdom, Europe Developed, Europe Emerging, Africa/Middle East, Japan, Australasia, Asia Developed, Asia Emerging, Latin America.
Sector_Weights
Equity_%- The percentage allocation to this sector for this specific ETF.
Relative_to_Category- The average percentage allocation to this sector across all ETFs in the same category.
Sectors- Economic sectors: Basic Materials, Consumer Cyclicals, Financial Services, Real Estate, Communication Services, Energy, Industrials, Technology, Consumer Defensive, Healthcare, Utilities.
Fixed_Income
EffectiveDuration- A duration calculation for bonds with embedded options, measuring sensitivity to interest rate changes.
Fund_%- The duration in years for this specific ETF.
Relative_to_Category- The average duration in years across all ETFs in the same category.
ModifiedDuration- A measure of how much a bond's price will change in response to a change in interest rates.
EffectiveMaturity- The weighted average time until bonds reach maturity, accounting for early redemption through calls or refunding.
CreditQuality- Credit quality classification for bonds in the ETF's holdings (e.g., AAA, AA, A, BBB). Note: This field structure may vary and should be interpreted with caution.
Coupon- The annual interest rate paid on bonds, expressed as a percentage of the face value, paid from issue date until maturity.
Price- The recent average price of bonds in the ETF's portfolio.
YieldToMaturity- The total expected rate of return if bonds are held until maturity, including all interest payments and principal repayment.
Holdings_Count
Holdings_Count- The total number of individual securities held in the ETF's portfolio.
Top_10_Holdings
AAPL.US- The full ticker symbol of the holding (example format shown).
Code- The ticker symbol of the holding.
Exchange- The exchange code suffix (e.g., .US, .XETRA).
Name- The name of the company or issuer.
Sector- The economic sector of the holding company.
Industry- The industry classification of the holding company.
Country- The country where the exchange is located.
Region- The geographic region of the country.
Assets_%- The percentage of the ETF's total assets allocated to this holding.
Holdings
Holdings- The complete list of all securities held in the ETF's portfolio, if available.
Valuations_Growth
Valuations_Rates_Portfolio- Valuation metrics specific to this ETF's portfolio.
Price/Prospective Earnings- The average price-to-prospective earnings ratio of the ETF's holdings.
Price/Book- The average price-to-book ratio of the ETF's holdings.
Price/Sales- The average price-to-sales ratio of the ETF's holdings.
Price/Cash Flow- The average price-to-cash flow ratio of the ETF's holdings.
Dividend-Yield Factor- The average dividend yield of the ETF's holdings.
Valuations_Rates_To_Category- The average valuation ratios across all ETFs in the same category.
Growth_Rates_Portfolio- Growth metrics specific to this ETF's portfolio.
Long-Term Projected Earnings Growth- The average long-term projected earnings growth rate of the ETF's holdings.
Historical Earnings Growth- The average historical earnings growth rate of the ETF's holdings.
Sales Growth- The average sales growth rate of the ETF's holdings.
Cash-Flow Growth- The average cash flow growth rate of the ETF's holdings.
Book-Value Growth- The average book value growth rate of the ETF's holdings.
Growth_Rates_To_Category- The average growth rates across all ETFs in the same category.
MorningStar
Ratio- The Morningstar star rating (1-5 stars), representing the fund's risk-adjusted return relative to its category.
Category_Benchmark- The benchmark index used for this ETF category. Note: This is the category benchmark, not necessarily the index tracked by this specific ETF.
Sustainability_Ratio- The Morningstar sustainability rating, indicating how well the fund manages ESG (Environmental, Social, Governance) risks.
Performance
1y_Volatility- The 1-year daily volatility of the ETF, annualized to show expected price fluctuation.
3y_Volatility- The 3-year standard deviation volatility of the ETF, measuring price variability over three years.
3y_ExpReturn- The expected 3-year return for the ETF. If unavailable, use the trailing Returns_3Y figure as an approximation.
3y_SharpRatio- The Sharpe ratio calculated over 3 years, measuring risk-adjusted return (higher is better).
Returns_YTD- Year-to-date return, calculated as ((Ending Price – Beginning Price + Dividends) / Beginning Price), annualized over 3 years. Note: These figures include management fees and may differ from returns calculated using price data alone.
Returns_1Y- The 1-year trailing total return, including dividends and distributions.
Returns_3Y- The 3-year trailing total return, including dividends and distributions.
Returns_5Y- The 5-year trailing total return, including dividends and distributions.
Returns_10Y- The 10-year trailing total return, including dividends and distributions.
Cryptocurrencies
Market Cap, Supply Metrics & Blockchain Links
Cryptocurrency Fundamentals
Market Capitalization- the total market value of a cryptocurrency's circulating supply. It is calculated by multiplying the current price by the circulating supply.
Market Capitalization Diluted- the total market value of a cryptocurrency if all coins were in circulation (using max supply instead of circulating supply). This represents the theoretical maximum market cap.
Circulating Supply- the number of coins or tokens that are publicly available and circulating in the market. This excludes coins that are locked, reserved, or not yet released.
Total Supply- the total number of coins or tokens that have been created, including those that are locked, reserved, or not yet in circulation. This is the current total supply at any given time.
Max Supply- the maximum number of coins or tokens that will ever exist for a cryptocurrency. Some cryptocurrencies have a fixed maximum supply (like Bitcoin with 21 million), while others may have no maximum limit.
Market Capitalization Dominance- the percentage of the total cryptocurrency market capitalization that a specific cryptocurrency represents. It shows how much of the overall crypto market value is held by this particular coin.
Technical Documentation Link- the URL to the official technical documentation, whitepaper, or technical specifications of the cryptocurrency project.
Explorer- the URL to the blockchain explorer where you can view transactions, addresses, blocks, and other on-chain data for this cryptocurrency.
Source Code- the URL to the source code repository (e.g., GitHub) where the cryptocurrency's codebase is publicly available for review and contribution.
Message Board- the URL to the official community forum, discussion board, or social media channel where users and developers discuss the cryptocurrency.
Low All Time- the lowest price that the cryptocurrency has ever reached since its inception or since tracking began.
High All Time- the highest price that the cryptocurrency has ever reached since its inception or since tracking began.
Quick Start: First Steps with the API
1. Get API Token
Sign up for free and get your API token immediately in the Account area.
2. Search by Name/ISIN
Example Apple: https://api.leeway.tech/api/v1/public/general/isin/apple?apitoken=YOUR_TOKEN
4. Retrieve Fundamental Data
For Deutsche Telekom: https://api.leeway.tech/api/v1/public/fundamentals/DTE.XETRA?apitoken=YOUR_TOKEN
2. Find Exchange
All exchanges: https://api.leeway.tech/api/v1/public/general/exchanges?apitoken=YOUR_TOKEN
3. Find Symbol
All XETRA symbols: https://api.leeway.tech/api/v1/public/general/symbols/XETRA?apitoken=YOUR_TOKEN
5. Retrieve Historical Prices
For Deutsche Telekom on XETRA: https://api.leeway.tech/api/v1/public/historicalquotes/DTE.XETRA?apitoken=YOUR_TOKEN
Dividends
Payment Dates, Values & Currencies
Dividends
date- Ex-dividend date – the date on or after which a stock is traded without the right to receive the upcoming dividend. Format: YYYY-MM-DD.
declarationDate- Declaration date – when the dividend was announced by the company. Format: YYYY-MM-DD or null.
recordDate- Record date – the cutoff date to determine which shareholders are eligible to receive the dividend. Format: YYYY-MM-DD or null.
paymentDate- Payment date – when the dividend is actually paid out to shareholders. Format: YYYY-MM-DD or null.
value- Adjusted dividend value per share (adjusted for stock splits and other corporate actions).
unadjustedValue- Unadjusted dividend value per share – the original dividend amount as declared, before any adjustments.
currency- Currency code of the dividend payment (e.g., USD, EUR, GBP).
Stock Splits
Split Dates & Ratios for Historical Price Adjustments
Stock Splits
date- Effective date of the split. Format: YYYY-MM-DD.
split- Split ratio in format "new/old" (e.g., "2.000000/1.000000" for a 2-for-1 split).
IPOs
Initial Public Offerings: Dates, Prices & Status
IPO Data
code- Ticker symbol in standard format (e.g., AAPL.US).
name- Company name.
exchange- Listing exchange.
currency- Trading currency.
start_date- Expected/effective first trading date (if known). Format: YYYY-MM-DD.
filing_date- Initial filing date. Format: YYYY-MM-DD.
amended_date- Latest amended filing date. Format: YYYY-MM-DD.
price_from- Lower end of indicated price range (0 if not provided).
price_to- Upper end of indicated price range (0 if not provided).
offer_price- Final priced offer (0 if not priced yet).
shares- Shares offered (0 if not provided).
deal_type- Lifecycle state such as Filed, Expected, Amended, Priced.
Macroeconomic Data
GDP, Inflation, Unemployment & 30+ more indicators
Macroeconomic Indicators
real_interest_rate- Real interest rate (%).
population_total- Population, total.
population_growth_annual- Population growth (annual %).
inflation_consumer_prices_annual- Inflation, consumer prices (annual %).
consumer_price_index- Consumer Price Index (2010 = 100).
gdp_current_usd- GDP (current US$).
gdp_per_capita_usd- GDP per capita (current US$).
gdp_growth_annual- GDP growth (annual %).
debt_percent_gdp- Debt in percent of GDP (annual %).
net_trades_goods_services- Net trades in goods and services (current US$).
inflation_gdp_deflator_annual- Inflation, GDP deflator (annual %).
agriculture_value_added_percent_gdp- Agriculture, value added (% of GDP).
industry_value_added_percent_gdp- Industry, value added (% of GDP).
services_value_added_percent_gdp- Services, etc., value added (% of GDP).
exports_of_goods_services_percent_gdp- Exports of goods and services (% of GDP).
imports_of_goods_services_percent_gdp- Imports of goods and services (% of GDP).
gross_capital_formation_percent_gdp- Gross capital formation (% of GDP).
net_migration- Net migration (absolute value).
gni_usd- GNI, Atlas method (current US$).
gni_per_capita_usd- GNI per capita, Atlas method (current US$).
gni_ppp_usd- GNI, PPP (current international $).
gni_per_capita_ppp_usd- GNI per capita, PPP (current international $).
income_share_lowest_twenty- Income share held by lowest 20% (in %).
life_expectancy- Life expectancy at birth, total (years).
fertility_rate- Fertility rate, total (births per woman).
prevalence_hiv_total- Prevalence of HIV, total (% of population ages 15-49).
co2_emissions_tons_per_capita- CO2 emissions (metric tons per capita).
surface_area_km- Surface area (sq. km).
poverty_poverty_lines_percent_population- Poverty headcount ratio at national poverty lines (% of population).
revenue_excluding_grants_percent_gdp- Revenue, excluding grants (% of GDP).
cash_surplus_deficit_percent_gdp- Cash surplus/deficit (% of GDP).
startup_procedures_register- Start-up procedures to register a business (number).
market_cap_domestic_companies_percent_gdp- Market capitalization of listed domestic companies (% of GDP).
mobile_subscriptions_per_hundred- Mobile cellular subscriptions (per 100 people).
internet_users_per_hundred- Internet users (per 100 people).
high_technology_exports_percent_total- High-technology exports (% of manufactured exports).
merchandise_trade_percent_gdp- Merchandise trade (% of GDP).
total_debt_service_percent_gni- Total debt service (% of GNI).
unemployment_total_percent- Unemployment total (% of labor force).
Frequently Asked Questions about the API Glossary
How do I best use this glossary?
Use the table of contents above to jump directly to relevant categories. Each data field comes with a precise explanation. Bookmark this page for quick access during development.
Which data fields are most important?
It depends on your use case. For trading: OHLC data, volume, adjustedClose. For fundamental analysis: revenue, netIncome, totalAssets, PE ratio. For screening: marketCap, dividendYield, ROE. For macro analysis: GDP, inflation, unemployment.
What's the difference between annual and quarterly data?
Annual data is extracted from annual reports (10-K) and offers up to 40 years of history. Quarterly data (10-Q) is more current but less historically deep. Both are available in the fundamental data API.
What does adjustedClose mean and when should I use it?
adjustedClose is the closing price adjusted for dividends and splits. Use it for historical analysis, backtests and performance calculations. The normal "close" shows the actual trading price on that day. Learn more in the documentation.
What does it mean when a field is null or empty?
Null or empty fields mean that data for this security is not available – e.g. because the company doesn't report this metric or it's an ETF/index for which fundamental data isn't relevant.
Where do I find code examples for the API?
Code examples and endpoints can be found in the complete API documentation. For a quick start visit the API main page.
