Response schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": true,
"description": "Full fundamentals object for a common stock or equity ticker. Sections are omitted when the issuer does not report them.",
"properties": {
"Earnings": {
"additionalProperties": true,
"description": "Reported earnings, analyst trend and annual earnings.",
"properties": {
"Annual": {
"additionalProperties": true,
"description": "Annual earnings keyed by date. Each entry has date and epsActual.",
"type": "object"
},
"History": {
"additionalProperties": true,
"description": "Reported earnings keyed by fiscal period end date (YYYY-MM-DD). Each entry has reportDate, date, beforeAfterMarket, currency, epsActual, epsEstimate, epsDifference and surprisePercent.",
"type": "object"
},
"Trend": {
"additionalProperties": true,
"description": "Analyst estimates by period. In v1.1 this block is split into Quarterly and Annual sections instead of one flat date-keyed list, and each quarterly entry carries a human-readable quarter field (Q1, Q2, Q3, Q4). Entries include growth, earningsEstimateAvg, earningsEstimateLow, earningsEstimateHigh, revenueEstimateAvg, the EPS trend values and the EPS revision counts.",
"type": "object"
}
},
"type": "object"
},
"Financials": {
"additionalProperties": true,
"description": "Full financial statements.",
"properties": {
"Balance_Sheet": {
"additionalProperties": true,
"description": "Balance sheet.",
"properties": {
"currency_symbol": {
"description": "Reporting currency of the statement.",
"type": [
"string",
"null"
]
},
"quarterly": {
"additionalProperties": true,
"description": "Quarterly reports keyed by period end date (YYYY-MM-DD). Same entry shape as yearly.",
"type": "object"
},
"yearly": {
"additionalProperties": true,
"description": "Yearly reports keyed by period end date (YYYY-MM-DD). Each report carries its own date and filing_date plus the line items, for example totalAssets, totalLiab, totalStockholderEquity, cash, netDebt, longTermDebt, inventory and retainedEarnings. Numeric line items are delivered as strings.",
"type": "object"
}
},
"type": "object"
},
"Cash_Flow": {
"additionalProperties": true,
"description": "Cash flow statement.",
"properties": {
"currency_symbol": {
"description": "Reporting currency of the statement.",
"type": [
"string",
"null"
]
},
"quarterly": {
"additionalProperties": true,
"description": "Quarterly reports keyed by period end date (YYYY-MM-DD). Same entry shape as yearly.",
"type": "object"
},
"yearly": {
"additionalProperties": true,
"description": "Yearly reports keyed by period end date (YYYY-MM-DD). Each report carries its own date and filing_date plus the line items, for example totalCashFromOperatingActivities, capitalExpenditures, freeCashFlow, dividendsPaid, netIncome and changeInCash. Numeric line items are delivered as strings.",
"type": "object"
}
},
"type": "object"
},
"Income_Statement": {
"additionalProperties": true,
"description": "Income statement.",
"properties": {
"currency_symbol": {
"description": "Reporting currency of the statement.",
"type": [
"string",
"null"
]
},
"quarterly": {
"additionalProperties": true,
"description": "Quarterly reports keyed by period end date (YYYY-MM-DD). Same entry shape as yearly.",
"type": "object"
},
"yearly": {
"additionalProperties": true,
"description": "Yearly reports keyed by period end date (YYYY-MM-DD). Each report carries its own date and filing_date plus the line items, for example totalRevenue, costOfRevenue, grossProfit, operatingIncome, ebit, ebitda, netIncome and researchDevelopment. Numeric line items are delivered as strings.",
"type": "object"
}
},
"type": "object"
}
},
"type": "object"
},
"General": {
"additionalProperties": true,
"description": "Company profile block.",
"properties": {
"Address": {
"description": "The company address as a single string.",
"type": [
"string",
"null"
]
},
"AddressData": {
"additionalProperties": true,
"description": "The address split into Street, City, State, Country and ZIP.",
"type": "object"
},
"CIK": {
"description": "Central Index Key assigned by the SEC, US companies.",
"type": [
"string",
"null"
]
},
"CUSIP": {
"description": "CUSIP identifier, mainly for US companies.",
"type": [
"string",
"null"
]
},
"Code": {
"description": "The ticker code of the company.",
"type": [
"string",
"null"
]
},
"CountryISO": {
"description": "ISO country code.",
"type": [
"string",
"null"
]
},
"CountryName": {
"description": "Country where the company is registered.",
"type": [
"string",
"null"
]
},
"CurrencyCode": {
"description": "Currency code of the listing.",
"type": [
"string",
"null"
]
},
"CurrencyName": {
"description": "Full name of the listing currency.",
"type": [
"string",
"null"
]
},
"CurrencySymbol": {
"description": "Symbol of the listing currency.",
"type": [
"string",
"null"
]
},
"Description": {
"description": "A textual description of the company.",
"type": [
"string",
"null"
]
},
"EmployerIdNumber": {
"description": "Employer Identification Number (EIN), US companies.",
"type": [
"string",
"null"
]
},
"Exchange": {
"description": "The exchange the ticker is listed on.",
"type": [
"string",
"null"
]
},
"ExchangeMarket": {
"description": "Extra market label that may appear on non-US equities only.",
"type": [
"string",
"null"
]
},
"FiscalYearEnd": {
"description": "Month the fiscal year ends.",
"type": [
"string",
"null"
]
},
"FullTimeEmployees": {
"description": "Number of full-time employees.",
"type": [
"integer",
"null"
]
},
"GicGroup": {
"description": "GICS industry group classification.",
"type": [
"string",
"null"
]
},
"GicIndustry": {
"description": "GICS industry classification.",
"type": [
"string",
"null"
]
},
"GicSector": {
"description": "GICS sector classification.",
"type": [
"string",
"null"
]
},
"GicSubIndustry": {
"description": "GICS sub-industry classification.",
"type": [
"string",
"null"
]
},
"HomeCategory": {
"description": "Home category of the ticker, for example Domestic or ADR.",
"type": [
"string",
"null"
]
},
"IPODate": {
"description": "Date of the initial public offering.",
"format": "date",
"type": [
"string",
"null"
]
},
"ISIN": {
"description": "International Securities Identification Number.",
"type": [
"string",
"null"
]
},
"Industry": {
"description": "The industry of the company.",
"type": [
"string",
"null"
]
},
"InternationalDomestic": {
"description": "International or domestic classification.",
"type": [
"string",
"null"
]
},
"IsDelisted": {
"description": "Whether the ticker has been delisted.",
"type": [
"boolean",
"null"
]
},
"LEI": {
"description": "Legal Entity Identifier.",
"type": [
"string",
"null"
]
},
"Listings": {
"additionalProperties": true,
"description": "Other exchange listings for the ticker, keyed by index, each entry with Code, Exchange and Name.",
"type": "object"
},
"LogoURL": {
"description": "Path to the company logo image.",
"type": [
"string",
"null"
]
},
"Name": {
"description": "The company name.",
"type": [
"string",
"null"
]
},
"Officers": {
"additionalProperties": true,
"description": "Company executives, keyed by index, each entry with Name, Title and YearBorn.",
"type": "object"
},
"OpenFigi": {
"description": "The OpenFIGI identifier.",
"type": [
"string",
"null"
]
},
"Phone": {
"description": "Company phone number.",
"type": [
"string",
"null"
]
},
"PrimaryTicker": {
"description": "The primary ticker for the company.",
"type": [
"string",
"null"
]
},
"Sector": {
"description": "The sector of the company.",
"type": [
"string",
"null"
]
},
"Type": {
"description": "The instrument type, for example Common Stock.",
"type": [
"string",
"null"
]
},
"UpdatedAt": {
"description": "Date the record was last updated.",
"format": "date",
"type": [
"string",
"null"
]
},
"WebURL": {
"description": "Company website URL.",
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"Highlights": {
"additionalProperties": true,
"description": "Key metrics and analyst estimates.",
"properties": {
"BookValue": {
"description": "Book value per share.",
"type": [
"number",
"null"
]
},
"DilutedEpsTTM": {
"description": "Diluted EPS over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"DividendShare": {
"description": "Dividend per share.",
"type": [
"number",
"null"
]
},
"DividendYield": {
"description": "Dividend yield.",
"type": [
"number",
"null"
]
},
"EBITDA": {
"description": "Earnings before interest, taxes, depreciation and amortization.",
"type": [
"number",
"null"
]
},
"EPSEstimateCurrentQuarter": {
"description": "Estimated EPS for the current quarter.",
"type": [
"number",
"null"
]
},
"EPSEstimateCurrentYear": {
"description": "Estimated EPS for the current year.",
"type": [
"number",
"null"
]
},
"EPSEstimateNextQuarter": {
"description": "Estimated EPS for the next quarter.",
"type": [
"number",
"null"
]
},
"EPSEstimateNextYear": {
"description": "Estimated EPS for the next year.",
"type": [
"number",
"null"
]
},
"EarningsShare": {
"description": "Earnings per share (EPS).",
"type": [
"number",
"null"
]
},
"GrossProfitTTM": {
"description": "Gross profit over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"MarketCapitalization": {
"description": "Market capitalization.",
"type": [
"number",
"null"
]
},
"MarketCapitalizationMln": {
"description": "Market capitalization in millions.",
"type": [
"number",
"null"
]
},
"MostRecentQuarter": {
"description": "Date of the most recent reported quarter.",
"format": "date",
"type": [
"string",
"null"
]
},
"OperatingMarginTTM": {
"description": "Operating margin over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"PEGRatio": {
"description": "Price/earnings-to-growth ratio.",
"type": [
"number",
"null"
]
},
"PERatio": {
"description": "Price-to-earnings ratio.",
"type": [
"number",
"null"
]
},
"ProfitMargin": {
"description": "Profit margin.",
"type": [
"number",
"null"
]
},
"QuarterlyEarningsGrowthYOY": {
"description": "Quarterly earnings growth year over year.",
"type": [
"number",
"null"
]
},
"QuarterlyRevenueGrowthYOY": {
"description": "Quarterly revenue growth year over year.",
"type": [
"number",
"null"
]
},
"ReturnOnAssetsTTM": {
"description": "Return on assets over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"ReturnOnEquityTTM": {
"description": "Return on equity over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"RevenuePerShareTTM": {
"description": "Revenue per share over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"RevenueTTM": {
"description": "Revenue over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"WallStreetTargetPrice": {
"description": "Average analyst target price.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"Holders": {
"additionalProperties": true,
"description": "Institutional and fund ownership.",
"properties": {
"Funds": {
"additionalProperties": true,
"description": "Fund holders keyed by index string. Same entry shape as Institutions: name, date, totalShares, totalAssets, currentShares, change, change_p.",
"type": "object"
},
"Institutions": {
"additionalProperties": true,
"description": "Institutional holders keyed by index string (\"0\", \"1\", ...). Each entry has name, date (report date), totalShares (percent of total shares held), totalAssets (percent of the holder assets in this position), currentShares (share count), change and change_p.",
"type": "object"
}
},
"type": "object"
},
"InsiderTransactions": {
"additionalProperties": true,
"description": "Insider trading records keyed by index string. Each entry has date (report date), ownerCik, ownerName, transactionDate, transactionCode, transactionAmount (share count), transactionPrice, transactionAcquiredDisposed, postTransactionAmount and secLink (URL of the SEC filing).",
"type": "object"
},
"SharesStats": {
"additionalProperties": true,
"description": "Share statistics and ownership percentages.",
"properties": {
"PercentInsiders": {
"description": "Percentage of shares held by insiders.",
"type": [
"number",
"null"
]
},
"PercentInstitutions": {
"description": "Percentage of shares held by institutions.",
"type": [
"number",
"null"
]
},
"SharesFloat": {
"description": "Shares available for public trading.",
"type": [
"number",
"null"
]
},
"SharesOutstanding": {
"description": "Total shares outstanding.",
"type": [
"number",
"null"
]
},
"SharesShort": {
"description": "Number of shares sold short.",
"type": [
"number",
"null"
]
},
"SharesShortPriorMonth": {
"description": "Shares sold short in the prior month.",
"type": [
"number",
"null"
]
},
"ShortPercentFloat": {
"description": "Short interest as a percentage of the float.",
"type": [
"number",
"null"
]
},
"ShortPercentOutstanding": {
"description": "Short interest as a percentage of shares outstanding.",
"type": [
"number",
"null"
]
},
"ShortRatio": {
"description": "Short interest ratio.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"SplitsDividends": {
"additionalProperties": true,
"description": "Dividend and split summary.",
"properties": {
"DividendDate": {
"description": "The dividend payment date.",
"format": "date",
"type": [
"string",
"null"
]
},
"ExDividendDate": {
"description": "The ex-dividend date.",
"format": "date",
"type": [
"string",
"null"
]
},
"ForwardAnnualDividendRate": {
"description": "Forward annual dividend rate.",
"type": [
"number",
"null"
]
},
"ForwardAnnualDividendYield": {
"description": "Forward annual dividend yield.",
"type": [
"number",
"null"
]
},
"LastSplitDate": {
"description": "The date of the last stock split.",
"format": "date",
"type": [
"string",
"null"
]
},
"LastSplitFactor": {
"description": "The factor of the last stock split, for example 4:1.",
"type": [
"string",
"null"
]
},
"NumberDividendsByYear": {
"additionalProperties": true,
"description": "Count of dividends paid per year, keyed by index, each entry with Year and Count.",
"type": "object"
},
"PayoutRatio": {
"description": "Dividend payout ratio.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"Technicals": {
"additionalProperties": true,
"description": "Technical performance metrics.",
"properties": {
"200DayMA": {
"description": "200-day moving average.",
"type": [
"number",
"null"
]
},
"50DayMA": {
"description": "50-day moving average.",
"type": [
"number",
"null"
]
},
"52WeekHigh": {
"description": "Highest price over the last 52 weeks.",
"type": [
"number",
"null"
]
},
"52WeekLow": {
"description": "Lowest price over the last 52 weeks.",
"type": [
"number",
"null"
]
},
"Beta": {
"description": "Measure of stock volatility relative to the market.",
"type": [
"number",
"null"
]
},
"SharesShort": {
"description": "Number of shares sold short.",
"type": [
"number",
"null"
]
},
"SharesShortPriorMonth": {
"description": "Shares sold short in the prior month.",
"type": [
"number",
"null"
]
},
"ShortPercent": {
"description": "Short interest as a percentage.",
"type": [
"number",
"null"
]
},
"ShortRatio": {
"description": "Short interest ratio.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"Valuation": {
"additionalProperties": true,
"description": "Market valuation ratios.",
"properties": {
"EnterpriseValue": {
"description": "Enterprise value.",
"type": [
"number",
"null"
]
},
"EnterpriseValueEbitda": {
"description": "Enterprise value to EBITDA ratio.",
"type": [
"number",
"null"
]
},
"EnterpriseValueRevenue": {
"description": "Enterprise value to revenue ratio.",
"type": [
"number",
"null"
]
},
"ForwardPE": {
"description": "Forward price-to-earnings ratio.",
"type": [
"number",
"null"
]
},
"PriceBookMRQ": {
"description": "Price-to-book ratio for the most recent quarter.",
"type": [
"number",
"null"
]
},
"PriceSalesTTM": {
"description": "Price-to-sales ratio over the trailing twelve months.",
"type": [
"number",
"null"
]
},
"TrailingPE": {
"description": "Trailing price-to-earnings ratio.",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"outstandingShares": {
"additionalProperties": true,
"description": "Historical shares outstanding.",
"properties": {
"annual": {
"additionalProperties": true,
"description": "Yearly history keyed by index string. Each entry has date (period label), dateFormatted (period end date, YYYY-MM-DD), sharesMln (shares in millions, delivered as a string) and shares (integer share count).",
"type": "object"
},
"quarterly": {
"additionalProperties": true,
"description": "Quarterly history keyed by index string. Same entry shape as annual: date, dateFormatted, sharesMln, shares.",
"type": "object"
}
},
"type": "object"
}
},
"type": "object"
}
