{"openapi":"3.1.0","info":{"title":"DeepScreen Public Reference API","version":"1.0.0","description":"Educational reference content only. No live quotes, reported company financials, recommendations, account access or trading. Directory coverage does not imply financial-data availability. GET requests only; no authentication. Send no credentials or personal information. No query parameters or pagination; each response contains a small, complete reference list.","contact":{"name":"DeepScreen","url":"https://deepscreen.online/contact","email":"deepscreen.online@outlook.com"}},"servers":[{"url":"https://deepscreen.online"}],"security":[],"externalDocs":{"description":"Usage and limitations","url":"https://deepscreen.online/developers"},"paths":{"/api/v1/exchanges":{"get":{"operationId":"getExchanges","summary":"Read DeepScreen exchanges","description":"Public read-only reference content. No query parameters. Cache for up to one hour and handle non-200 responses without inventing missing data.","responses":{"200":{"description":"Complete reference list, not a live financial feed","content":{"application/json":{"schema":{"type":"object","required":["version","resource","documentation","limitations","data"],"additionalProperties":false,"properties":{"version":{"const":"1.0.0","type":"string"},"resource":{"const":"exchanges","type":"string"},"documentation":{"type":"string","format":"uri"},"limitations":{"type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","country","currency","url"],"additionalProperties":false,"properties":{"code":{"type":"string","enum":["NSE","BSE","NYSE","NASDAQ","LSE"]},"name":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}},"example":{"version":"1.0.0","resource":"exchanges","documentation":"https://deepscreen.online/developers","limitations":"Educational reference content only. No live quotes, reported company financials, recommendations, account access or trading. Directory coverage does not imply financial-data availability.","data":[{"code":"NSE","name":"National Stock Exchange of India","country":"India","currency":"INR","url":"https://deepscreen.online/exchange/NSE"},{"code":"BSE","name":"Bombay Stock Exchange","country":"India","currency":"INR","url":"https://deepscreen.online/exchange/BSE"},{"code":"NYSE","name":"New York Stock Exchange","country":"United States","currency":"USD","url":"https://deepscreen.online/exchange/NYSE"},{"code":"NASDAQ","name":"Nasdaq Stock Market","country":"United States","currency":"USD","url":"https://deepscreen.online/exchange/NASDAQ"},{"code":"LSE","name":"London Stock Exchange","country":"United Kingdom","currency":"GBP","url":"https://deepscreen.online/exchange/LSE"}]}}}},"400":{"description":"Query parameters are not supported","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"}}}}}},"405":{"description":"Method not allowed. Use GET."},"default":{"description":"Hosting or network error; retry later with backoff. Response may not be JSON."}}}},"/api/v1/metrics":{"get":{"operationId":"getMetrics","summary":"Read DeepScreen metrics","description":"Public read-only reference content. No query parameters. Cache for up to one hour and handle non-200 responses without inventing missing data.","responses":{"200":{"description":"Complete reference list, not a live financial feed","content":{"application/json":{"schema":{"type":"object","required":["version","resource","documentation","limitations","data"],"additionalProperties":false,"properties":{"version":{"const":"1.0.0","type":"string"},"resource":{"const":"metrics","type":"string"},"documentation":{"type":"string","format":"uri"},"limitations":{"type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","abbreviation","formula","definition","cautions","url"],"additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"abbreviation":{"type":"string"},"formula":{"type":"string"},"definition":{"type":"string"},"cautions":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri"}}}}}},"example":{"version":"1.0.0","resource":"metrics","documentation":"https://deepscreen.online/developers","limitations":"Educational reference content only. No live quotes, reported company financials, recommendations, account access or trading. Directory coverage does not imply financial-data availability.","data":[{"id":"pe-ratio","name":"Price-to-Earnings Ratio","abbreviation":"P/E","formula":"Share price ÷ earnings per share","definition":"P/E shows how much investors pay for one unit of annual earnings. Compare it with close sector peers and the company's own history, not with the whole market.","cautions":["P/E is not meaningful for loss-making companies.","Cyclical companies can look cheapest near peak earnings."],"url":"https://deepscreen.online/learn/pe-ratio-explained"},{"id":"peg-ratio","name":"Price/Earnings-to-Growth Ratio","abbreviation":"PEG","formula":"P/E ratio ÷ earnings growth rate","definition":"PEG relates a company's earnings multiple to its growth rate. A reading near 1 is often considered balanced, but growth quality and durability matter more than a single threshold.","cautions":["Forecast growth can be wrong.","Negative or unusually volatile growth makes PEG unreliable."],"url":"https://deepscreen.online/learn/peg-ratio"},{"id":"price-to-sales-ratio","name":"Price-to-Sales Ratio","abbreviation":"P/S","formula":"Market capitalisation ÷ annual revenue","definition":"P/S values a company against revenue and is useful when earnings are small or negative. It must be read with margins because sales without profit can destroy value.","cautions":["Revenue quality and recurring sales differ.","P/S ignores debt and profitability."],"url":"https://deepscreen.online/learn/price-to-sales-ratio"},{"id":"price-to-book-ratio","name":"Price-to-Book Ratio","abbreviation":"P/B","formula":"Share price ÷ book value per share","definition":"P/B compares market value with accounting net assets. It is most useful for banks and asset-heavy companies and less useful for software or brands whose assets are not fully recorded.","cautions":["Book values can contain impaired or low-quality assets.","Cross-sector comparisons are misleading."],"url":"https://deepscreen.online/learn/price-to-book-ratio"},{"id":"ev-to-revenue","name":"Enterprise Value to Revenue","abbreviation":"EV/Revenue","formula":"Enterprise value ÷ annual revenue","definition":"EV/Revenue values operations while accounting for debt and cash. It helps compare companies with different financing, especially before profits become stable.","cautions":["It ignores current profitability.","Sector economics determine a sensible range."],"url":"https://deepscreen.online/learn/ev-to-revenue"},{"id":"ev-to-ebitda","name":"Enterprise Value to EBITDA","abbreviation":"EV/EBITDA","formula":"Enterprise value ÷ EBITDA","definition":"EV/EBITDA compares enterprise value with EBITDA, an operating-profit measure before interest, tax, depreciation and amortisation. The multiple is conventionally interpreted only when EBITDA and enterprise value produce a positive ratio.","cautions":["A negative or zero EV/EBITDA is not a cheap valuation signal; it is normally not meaningful because EBITDA is non-positive or enterprise value is negative.","EBITDA is not free cash flow, and capital-intensive companies may need large recurring investment."],"url":"https://deepscreen.online/learn/ev-to-ebitda"},{"id":"return-on-equity","name":"Return on Equity","abbreviation":"ROE","formula":"Net income ÷ average shareholder equity","definition":"ROE measures profit generated from shareholder capital. High ROE is strongest when it is consistent and not created by excessive debt.","cautions":["Buybacks and leverage can inflate ROE.","Negative equity makes the ratio misleading."],"url":"https://deepscreen.online/learn/return-on-equity"},{"id":"return-on-assets","name":"Return on Assets","abbreviation":"ROA","formula":"Net income ÷ average total assets","definition":"ROA measures how efficiently a company turns assets into profit. Asset-light and asset-heavy sectors naturally have different normal ranges.","cautions":["Asset age and accounting policy affect the denominator.","Banks require sector-specific interpretation."],"url":"https://deepscreen.online/learn/return-on-assets"},{"id":"return-on-capital-employed","name":"Return on Capital Employed","abbreviation":"ROCE","formula":"Operating profit ÷ capital employed","definition":"ROCE measures operating returns from both equity and debt capital. It is a useful quality signal for comparing companies with different leverage.","cautions":["One-off profits can distort a year.","Definitions of capital employed vary by data source."],"url":"https://deepscreen.online/learn/return-on-capital-employed"},{"id":"debt-to-equity-ratio","name":"Debt-to-Equity Ratio","abbreviation":"D/E","formula":"Total debt or liabilities ÷ shareholder equity","definition":"Debt-to-equity measures financial leverage. A lower value usually means a more conservative balance sheet, but normal leverage varies sharply by industry.","cautions":["Banks use leverage as part of their business model.","Lease accounting can change reported debt."],"url":"https://deepscreen.online/learn/debt-to-equity-ratio"},{"id":"long-term-debt-to-equity","name":"Long-Term Debt to Equity","abbreviation":"LT D/E","formula":"Long-term debt ÷ shareholder equity","definition":"Long-term debt to equity isolates structural borrowing and helps show how much enduring leverage supports the business.","cautions":["It excludes short-term obligations.","Maturity schedules and interest rates still matter."],"url":"https://deepscreen.online/learn/long-term-debt-to-equity"},{"id":"dividend-payout-ratio","name":"Dividend Payout Ratio","abbreviation":"Payout","formula":"Dividends ÷ net income","definition":"The payout ratio shows how much profit is distributed as dividends. A sustainable payout leaves enough cash to maintain the business and fund growth.","cautions":["Earnings can be more volatile than cash flow.","REITs and similar structures use different benchmarks."],"url":"https://deepscreen.online/learn/dividend-payout-ratio"},{"id":"operating-leverage","name":"Operating Leverage","abbreviation":"Operating leverage","formula":"% change in operating profit ÷ % change in revenue","definition":"Operating leverage shows how strongly operating profit responds to sales. High fixed costs can amplify both growth and downturns.","cautions":["The ratio changes across the business cycle.","A short measurement period can exaggerate the result."],"url":"https://deepscreen.online/learn/operating-leverage"},{"id":"piotroski-f-score","name":"Piotroski F-Score","abbreviation":"Piotroski F-Score","formula":"Nine binary profitability, leverage, liquidity and efficiency tests, summed from 0 to 9","definition":"The Piotroski F-Score is a nine-point financial-strength checklist. Higher scores indicate more positive accounting signals, while lower scores call for closer investigation.","cautions":["It is a screening signal, not a valuation model.","Missing statement fields should be reported as insufficient data, never estimated."],"url":"https://deepscreen.online/learn/piotroski-f-score"},{"id":"altman-z-score","name":"Altman Z-Score","abbreviation":"Altman Z-Score","formula":"1.2×working capital/assets + 1.4×retained earnings/assets + 3.3×EBIT/assets + 0.6×equity/liabilities + 1.0×sales/assets","definition":"The Altman Z-Score combines five balance-sheet and income-statement measures to estimate financial-distress risk. Higher readings generally indicate a wider safety margin.","cautions":["Thresholds vary by company type and model version.","It should not be applied when required inputs are missing."],"url":"https://deepscreen.online/learn/altman-z-score"},{"id":"beneish-m-score","name":"Beneish M-Score","abbreviation":"Beneish M-Score","formula":"Weighted combination of eight year-over-year accounting indices","definition":"The Beneish M-Score screens for patterns associated with possible earnings manipulation. A concerning score is a prompt for deeper filing review, not proof of misconduct.","cautions":["The model can produce false positives.","Banks, insurers and missing historical inputs require special care."],"url":"https://deepscreen.online/learn/beneish-m-score"}]}}}},"400":{"description":"Query parameters are not supported","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"}}}}}},"405":{"description":"Method not allowed. Use GET."},"default":{"description":"Hosting or network error; retry later with backoff. Response may not be JSON."}}}},"/api/v1/answers":{"get":{"operationId":"getAnswers","summary":"Read DeepScreen answers","description":"Public read-only reference content. No query parameters. Cache for up to one hour and handle non-200 responses without inventing missing data.","responses":{"200":{"description":"Complete reference list, not a live financial feed","content":{"application/json":{"schema":{"type":"object","required":["version","resource","documentation","limitations","reviewedAt","data"],"additionalProperties":false,"properties":{"version":{"const":"1.0.0","type":"string"},"resource":{"const":"answers","type":"string"},"documentation":{"type":"string","format":"uri"},"limitations":{"type":"string"},"reviewedAt":{"type":"string","format":"date"},"data":{"type":"array","items":{"type":"object","required":["id","question","answer","url","referenceUrl"],"additionalProperties":false,"properties":{"id":{"type":"string"},"question":{"type":"string"},"answer":{"type":"string"},"url":{"type":"string","format":"uri"},"referenceUrl":{"type":"string","format":"uri"}}}}}},"example":{"version":"1.0.0","resource":"answers","documentation":"https://deepscreen.online/developers","limitations":"Educational reference content only. No live quotes, reported company financials, recommendations, account access or trading. Directory coverage does not imply financial-data availability.","reviewedAt":"2026-09-18","data":[{"id":"what-is-deepscreen","question":"What is DeepScreen?","answer":"DeepScreen is a research platform for supported listings across NSE, BSE, NYSE, Nasdaq and LSE. It combines searchable company research with educational explanations and a documented methodology.","url":"https://deepscreen.online/answers#what-is-deepscreen","referenceUrl":"https://deepscreen.online/methodology"},{"id":"markets","question":"Which markets does DeepScreen cover?","answer":"DeepScreen covers supported listings on NSE and BSE in India, NYSE and Nasdaq in the United States, and LSE in the United Kingdom.","url":"https://deepscreen.online/answers#markets","referenceUrl":"https://deepscreen.online/"},{"id":"free-access","question":"Can I use DeepScreen for free?","answer":"Company search and educational guides are available without a paid subscription. Check the pricing page for current plan details and feature availability.","url":"https://deepscreen.online/answers#free-access","referenceUrl":"https://deepscreen.online/pricing"},{"id":"investment-advice","question":"Does DeepScreen provide investment advice?","answer":"No. DeepScreen provides research tools and educational explanations. Model output is not personalized advice, a forecast or a guarantee of returns.","url":"https://deepscreen.online/answers#investment-advice","referenceUrl":"https://deepscreen.online/terms"},{"id":"research","question":"How do I start fundamental research?","answer":"Start with the business model and primary disclosures, then compare consistent periods for earnings, cash flow, debt and valuation. Record assumptions and unresolved questions before drawing conclusions.","url":"https://deepscreen.online/answers#research","referenceUrl":"https://deepscreen.online/research-checklist"},{"id":"agent-access","question":"Can an AI assistant access DeepScreen resources?","answer":"Public educational resources can be linked and quoted with their limitations. Use the answers page, methodology and research checklist as the authoritative context for explanations.","url":"https://deepscreen.online/answers#agent-access","referenceUrl":"https://deepscreen.online/developers"},{"id":"pe-ratio","question":"What is a P/E ratio?","answer":"P/E is share price divided by earnings per share. It compares a company's market price with a unit of annual earnings and should be interpreted with growth, cyclicality, profitability and sector context.","url":"https://deepscreen.online/answers#pe-ratio","referenceUrl":"https://deepscreen.online/learn/pe-ratio-explained"},{"id":"how-score","question":"How does DeepScreen score a stock?","answer":"DeepScreen combines valuation, growth, capital efficiency, leverage and shareholder-distribution factors into its documented 13-factor analytical model. The methodology explains the inputs, weighting and limitations.","url":"https://deepscreen.online/answers#how-score","referenceUrl":"https://deepscreen.online/methodology"},{"id":"missing-data","question":"What happens when financial data is unavailable?","answer":"A missing provider figure should not be replaced with an invented value. DeepScreen distinguishes unavailable or insufficient provider data from analytical model outputs.","url":"https://deepscreen.online/answers#missing-data","referenceUrl":"https://deepscreen.online/data-sources"},{"id":"compare-stocks","question":"How can I compare two companies?","answer":"Compare consistent measures such as earnings, cash flow, debt, valuation and returns across comparable periods and business models, then verify material figures against company disclosures.","url":"https://deepscreen.online/answers#compare-stocks","referenceUrl":"https://deepscreen.online/compare/hdfc-bank-vs-icici-bank"},{"id":"options","question":"Where can I learn about options strategies?","answer":"DeepScreen's options area explains strategy construction, payoff, breakeven and risk, alongside a calculator for modelling assumptions and outcomes.","url":"https://deepscreen.online/answers#options","referenceUrl":"https://deepscreen.online/options"},{"id":"calendar","question":"Where can I find market and economic events?","answer":"DeepScreen provides an economic calendar for macro releases and market events, plus company-related calendar tools where available. Time-sensitive entries should be checked on the current calendar page.","url":"https://deepscreen.online/answers#calendar","referenceUrl":"https://deepscreen.online/calendar"},{"id":"ipo","question":"Where can I find IPO information?","answer":"DeepScreen's IPO page provides the tracked pipeline and available offering details. Current status and dates should be verified against the relevant issuer or exchange disclosure.","url":"https://deepscreen.online/answers#ipo","referenceUrl":"https://deepscreen.online/ipo"}]}}}},"400":{"description":"Query parameters are not supported","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"}}}}}},"405":{"description":"Method not allowed. Use GET."},"default":{"description":"Hosting or network error; retry later with backoff. Response may not be JSON."}}}}}}