{"openapi":"3.1.0","info":{"title":"Investor Tool Public Finance API","version":"1.0.0","description":"Public JSON access to the same financial data used by finance.mannhowie.com. No API key, login or database access required. Start with /api/companies or /api/watchlists. Use storedOnly=1 for repeatable stored reads. No arbitrary SQL or administrative access."},"servers":[{"url":"https://finance.mannhowie.com"}],"security":[],"x-mcp":{"url":"https://finance.mannhowie.com/api/mcp","transport":"streamable-http","authentication":"none","readOnly":true,"tools":[{"name":"list_companies","title":"List stored companies","description":"Find stored tickers by ticker or company name. Returns a bounded page with nextOffset. Reads stored data only; never imports or refreshes a company."},{"name":"list_watchlists","title":"List saved watchlists","description":"List visible saved watchlists and their ticker memberships. Use to identify a cohort before querying financial metrics. Reads saved data only; never refreshes memberships."},{"name":"query_financials","title":"Query selected financial metrics","description":"Read selected annual or quarterly financial facts for stored tickers, with period limits, dates, currency and units. Reads only requested financial columns and required FX; never loads price history or triggers imports/refreshes. Cash flows retain reported signs. Null and missing reasons mean unavailable, never zero."},{"name":"query_ratios","title":"Query website financial ratios","description":"Read the same current ratio-table values or annual ratio history as the website using its shared calculator, labels and formatting. Stored data only; no refreshes or writes. Includes formulas, denominator guards, period selection and estimate flags by default. Current values may use TTM or an annual fallback; CAGR and reinvestment rate use annual data. Missing cash/debt/annual SBC can use the website zero-input assumptions with missingInputs flags. Formula catalog: pe: marketCap / netIncome; evEbit: (marketCap + longTermDebt + currentDebt - cash) / operatingIncome; evRevenue: (marketCap + longTermDebt + currentDebt - cash) / revenue; fcfYield: (operatingCashFlow - abs(capitalExpenditure) - sbc) / marketCap; dividendYield: abs(dividendsPaid) / marketCap; revenue3yCagr: (annualRevenue / annualRevenueThreeFiscalYearsEarlier)^(1/3) - 1; ebit3yCagr: (annualOperatingIncome / annualOperatingIncomeThreeFiscalYearsEarlier)^(1/3) - 1; grossMargin: grossProfit / revenue; operatingMargin: operatingIncome / revenue; fcfConversion: (operatingCashFlow - abs(capitalExpenditure) - sbc) / operatingIncome; roic: (operatingIncome - taxProvision) / investedCapital; reinvestmentRate: (annualInvestedCapital - previousStoredAnnualInvestedCapital) / (annualOperatingIncome - annualTaxProvision); netDebtEbit: (longTermDebt + currentDebt - cash) / operatingIncome"},{"name":"get_shareholder_returns","title":"Calculate stored shareholder returns","description":"Read cash dividends and gross share repurchases for consecutive fiscal years and calculate per-company totals and contribution percentages in USD millions. Default ends at latest reported completed year; throughYears can include completed but unreported years. Missing values/years remain explicit. Exact combined totals and percentages are null unless all requested companies are complete; observed subtotals are partial, not estimates. Reads stored data only."}],"limits":{"tickers":20,"cells":2000,"concurrency":4,"resultBytes":128000,"requestBytes":32768}},"paths":{"/api/companies":{"get":{"operationId":"listStoredCompanies","summary":"Enumerate stored companies","description":"Public financial universe, excluding archived companies. No upstream calls. Page with offset and limit; total is the filtered count.","parameters":[{"name":"q","in":"query","required":false,"description":"Optional case-insensitive ticker or company name substring.","schema":{"type":"string","maxLength":100}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"offset","in":"query","required":false,"description":"Zero-based offset.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"companies":{"type":"array","items":{"$ref":"#/components/schemas/Company"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"nextOffset":{"type":["integer","null"]}},"required":[]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/watchlists":{"get":{"operationId":"listWatchlists","summary":"List visible saved watchlists and all members","description":"Returns saved public lists and their ticker memberships. Visibility and manual membership match the website.","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"watchlists":{"type":"array","items":{"$ref":"#/components/schemas/Watchlist"}}},"required":["watchlists"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/financials/{ticker}":{"get":{"operationId":"getFinancials","summary":"Query company financials, valuations and price history","description":"Use view=history for annual cash-flow metrics. view=summary annual rows contain date anchors only, without dividendsPaid or stockRepurchase. Raw cash outflows are signed; dividends is absolute dividendsPaid and netStockBuyback subtracts issuance (not gross repurchases). For compact annual cash returns use the statements endpoint with view=shareholder-returns.","parameters":[{"name":"ticker","in":"path","required":true,"description":"Yahoo symbol, e.g. AAPL, BHP.AX, 0700.HK or 2330.TW.","schema":{"type":"string","pattern":"^[A-Za-z0-9.^=-]{1,32}$"}},{"name":"currency","in":"query","required":false,"description":"USD or company reporting currency. Financial amounts are in millions; company.marketCap is in whole currency units. Prices have their own currency metadata.","schema":{"type":"string","enum":["usd","local"],"default":"usd"}},{"name":"storedOnly","in":"query","required":false,"description":"Use 1 for stored data only, without Yahoo imports or refreshes. Default 0 may refresh/import data server-side.","schema":{"type":"string","enum":["0","1"],"default":"0"}},{"name":"view","in":"query","required":false,"description":"summary keeps minimal annual/valuation anchors and omits share-price history; history returns available history.","schema":{"type":"string","enum":["summary","history"],"default":"history"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Financials"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Ticker not stored or not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Archived ticker","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/financials/{ticker}/statements":{"get":{"operationId":"getStoredStatements","summary":"Read annual and quarterly statements, prices and FX in original units","description":"Stored data only; never imports or refreshes. Statement amounts are whole field-metadata currency units (falling back to period currency); share counts are shares. Honor per-field retract/unavailable flags. Prices are monthly observations in each row currency, with shareBasis and ordinarySharesPerQuote describing the security basis. FX rates are USD per currency unit. The default full view does not convert or round. The optional shareholder-returns view uses absolute dividendsPaid and gross stockRepurchase, converts each field using its currency metadata and existing period-end FX policy, and scales to USD millions. It never subtracts issuance or substitutes net financing flow. Missing/retracted fields or FX produce null totals, with observed subtotals and missing reasons. Do not silently extend the window backward to replace missing years. Null fields mean unavailable. For general queries provide metrics, interval, limit and optional from/to dates. Series and shareholder-returns select only financial columns and required FX at the database boundary; neither reads price, description or security history. These are selected financial facts, not a database dump.","parameters":[{"name":"ticker","in":"path","required":true,"description":"Yahoo symbol, e.g. AAPL, BHP.AX, 0700.HK or 2330.TW.","schema":{"type":"string","pattern":"^[A-Za-z0-9.^=-]{1,32}$"}},{"name":"metrics","in":"query","required":false,"description":"Select financial fields: revenue, grossProfit, ebit, operatingIncome, netIncome, operatingCashFlow, capitalExpenditure, taxProvision, pretaxIncome, sbc, longTermDebt, currentDebt, cash, stockholdersEquity, dividendsPaid, stockRepurchase, stockIssuance, basicAverageShares, periodEndShares. Providing metrics selects the bounded series view and never reads price/security history. Cash flows retain reported signs; missing values stay null.","schema":{"type":"string","pattern":"^(revenue|grossProfit|ebit|operatingIncome|netIncome|operatingCashFlow|capitalExpenditure|taxProvision|pretaxIncome|sbc|longTermDebt|currentDebt|cash|stockholdersEquity|dividendsPaid|stockRepurchase|stockIssuance|basicAverageShares|periodEndShares)(,(revenue|grossProfit|ebit|operatingIncome|netIncome|operatingCashFlow|capitalExpenditure|taxProvision|pretaxIncome|sbc|longTermDebt|currentDebt|cash|stockholdersEquity|dividendsPaid|stockRepurchase|stockIssuance|basicAverageShares|periodEndShares))*$","maxLength":500}},{"name":"interval","in":"query","required":false,"description":"Series view: annual or quarterly financial statements. No TTM or share-price series.","schema":{"type":"string","enum":["annual","quarterly"],"default":"annual"}},{"name":"limit","in":"query","required":false,"description":"Series view: latest N stored records inside the requested date bounds, returned oldest first. Annual limit=5 selects five annual records; quarterly limit=20 selects up to twenty quarters. Gaps are not filled.","schema":{"type":"integer","minimum":1,"maximum":200,"default":20}},{"name":"from","in":"query","required":false,"description":"Series view: inclusive period-end lower bound, YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Series view: inclusive period-end upper bound; capped at today. Default today.","schema":{"type":"string","format":"date"}},{"name":"currency","in":"query","required":false,"description":"Series view: USD or the company reporting currency. Each field respects its metadata currency and period-end FX. Full view remains in original currencies.","schema":{"type":"string","enum":["usd","local"],"default":"usd"}},{"name":"unit","in":"query","required":false,"description":"Series view: currency amounts in millions or whole units. Share counts always remain shares; inspect units per field.","schema":{"type":"string","enum":["millions","whole"],"default":"millions"}},{"name":"view","in":"query","required":false,"description":"metrics selects series automatically. series requires metrics. full preserves the complete original-unit statement response. shareholder-returns returns only annual cash-return metrics and totals in USD millions; always stored-only.","schema":{"type":"string","enum":["full","shareholder-returns","series"],"default":"full"}},{"name":"years","in":"query","required":false,"description":"Only for shareholder-returns: consecutive fiscal years, not arbitrary latest non-null rows.","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}},{"name":"throughYear","in":"query","required":false,"description":"Only for shareholder-returns: explicit ending fiscal-year label. Default is latest reported completed fiscal year, which may lag the latest completed year. Set this when a completed year is not yet reported to surface the gap.","schema":{"type":"integer","minimum":1900,"maximum":2200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Statements"},{"$ref":"#/components/schemas/ShareholderReturns"},{"$ref":"#/components/schemas/StatementSeries"}]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Ticker not stored or not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Archived ticker","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/search":{"get":{"operationId":"searchTickers","summary":"Search Yahoo Finance for equity and ETF symbols","description":"Searches upstream Yahoo; results may not yet exist in stored data.","parameters":[{"name":"q","in":"query","required":true,"description":"Company name or symbol.","schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/watchlists/quotes":{"get":{"operationId":"getWatchlistQuotes","summary":"Get lightweight market-cap snapshots for up to 200 symbols","description":"Returns company identity and ttm.marketCap in USD millions. This is not a full live price quote; local currency market caps are null. Missing symbols can return placeholders.","parameters":[{"name":"tickers","in":"query","required":true,"description":"Comma-separated uppercase Yahoo symbols; 1–200 distinct symbols. Split larger universes into batches.","schema":{"type":"string","pattern":"^[A-Z0-9.^=-]{1,32}(,[A-Z0-9.^=-]{1,32}){0,199}$"}},{"name":"currency","in":"query","required":false,"description":"USD or company reporting currency. Financial amounts are in millions; company.marketCap is in whole currency units. Prices have their own currency metadata.","schema":{"type":"string","enum":["usd","local"],"default":"usd"}},{"name":"storedOnly","in":"query","required":false,"description":"Use 1 for stored data only, without Yahoo imports or refreshes. Default 0 may refresh/import data server-side.","schema":{"type":"string","enum":["0","1"],"default":"0"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteStocks"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/watchlists/start":{"get":{"operationId":"getWatchlistStart","summary":"Get watchlist snapshots and the largest company history","description":"Only the selectedTicker has complete financials; other stocks are placeholders. Query financials individually for comparisons.","parameters":[{"name":"tickers","in":"query","required":true,"description":"Comma-separated uppercase Yahoo symbols; 1–200 distinct symbols. Split larger universes into batches.","schema":{"type":"string","pattern":"^[A-Z0-9.^=-]{1,32}(,[A-Z0-9.^=-]{1,32}){0,199}$"}},{"name":"currency","in":"query","required":false,"description":"USD or company reporting currency. Financial amounts are in millions; company.marketCap is in whole currency units. Prices have their own currency metadata.","schema":{"type":"string","enum":["usd","local"],"default":"usd"}},{"name":"storedOnly","in":"query","required":false,"description":"Use 1 for stored data only, without Yahoo imports or refreshes. Default 0 may refresh/import data server-side.","schema":{"type":"string","enum":["0","1"],"default":"0"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchlistStart"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/benchmark":{"get":{"operationId":"getSp500Benchmark","summary":"Read S&P 500 price index history","description":"Cached ^GSPC close prices, not total returns; check asOf, stale and refreshFailed.","parameters":[{"name":"frequency","in":"query","required":false,"description":"Sampling frequency.","schema":{"type":"string","enum":["daily","monthly"],"default":"daily"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Benchmark"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"Company":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string"},"shortName":{"type":["string","null"]},"marketCapM":{"type":["number","null"],"description":"USD millions; null if unavailable."}},"required":["ticker","name"]},"Financials":{"type":"object","properties":{"company":{"type":"object","description":"Identity, business description, quote timestamp, currencies and marketCap in whole currency units.","additionalProperties":true},"metadata":{"type":"object","description":"Labels and units for financial metrics.","additionalProperties":true},"ttm":{"type":"object","properties":{"revenue":{"type":["number","null"]},"grossProfit":{"type":["number","null"]},"ebit":{"type":["number","null"]},"operatingIncome":{"type":["number","null"]},"netIncome":{"type":["number","null"]},"operatingCashFlow":{"type":["number","null"]},"capitalExpenditure":{"type":["number","null"]},"taxProvision":{"type":["number","null"]},"pretaxIncome":{"type":["number","null"]},"sbc":{"type":["number","null"]},"longTermDebt":{"type":["number","null"]},"currentDebt":{"type":["number","null"]},"cash":{"type":["number","null"]},"stockholdersEquity":{"type":["number","null"]},"dividendsPaid":{"type":["number","null"]},"stockRepurchase":{"type":["number","null"]},"stockIssuance":{"type":["number","null"]},"basicAverageShares":{"type":["number","null"]},"periodEndShares":{"type":["number","null"]},"fcf":{"type":["number","null"]},"capex":{"type":["number","null"]},"investedCapital":{"type":["number","null"]},"dividends":{"type":["number","null"]},"netStockBuyback":{"type":["number","null"]},"netCash":{"type":["number","null"]},"marketCap":{"type":["number","null"]}},"required":[],"description":"Trailing twelve month metrics in millions. Check ttmFilledFromAnnual and ttmFallbackYear for annual fallbacks."},"ratios":{"type":["object","null"],"additionalProperties":true,"description":"Valuation and profitability ratios; unavailable values are null."},"annual":{"type":"array","items":{"type":"object","properties":{"year":{"type":"string"},"periodEnd":{"type":"string"},"revenue":{"type":["number","null"]},"grossProfit":{"type":["number","null"]},"ebit":{"type":["number","null"]},"operatingIncome":{"type":["number","null"]},"netIncome":{"type":["number","null"]},"operatingCashFlow":{"type":["number","null"]},"capitalExpenditure":{"type":["number","null"]},"taxProvision":{"type":["number","null"]},"pretaxIncome":{"type":["number","null"]},"sbc":{"type":["number","null"]},"longTermDebt":{"type":["number","null"]},"currentDebt":{"type":["number","null"]},"cash":{"type":["number","null"]},"stockholdersEquity":{"type":["number","null"]},"dividendsPaid":{"type":["number","null"]},"stockRepurchase":{"type":["number","null"]},"stockIssuance":{"type":["number","null"]},"basicAverageShares":{"type":["number","null"]},"periodEndShares":{"type":["number","null"]},"fcf":{"type":["number","null"]},"capex":{"type":["number","null"]},"investedCapital":{"type":["number","null"]},"dividends":{"type":["number","null"]},"netStockBuyback":{"type":["number","null"]},"netCash":{"type":["number","null"]},"marketCap":{"type":["number","null"]}},"required":[]}},"annualRatios":{"type":"array","items":{"type":"object","additionalProperties":true}},"quarterlyMarketCap":{"type":"array","items":{"type":"object","additionalProperties":true}},"sharePriceHistory":{"type":"array","items":{"type":"object","additionalProperties":true}},"pricePerformance":{"type":"object","additionalProperties":true},"financialFreshness":{"type":"object","additionalProperties":true},"coverage":{"type":"object","additionalProperties":true},"currencyMode":{"type":"string"},"revision":{"type":"string"},"ttmFilledFromAnnual":{"type":"array","items":{"type":"string"}},"ttmFallbackYear":{"type":["string","number","null"]}},"required":["company","ttm"],"additionalProperties":true,"description":"Same financial presentation as the website. Summary view omits share-price history and keeps only minimal annual/valuation date anchors. Null means unavailable, never zero. Historical rows are ascending by date. Inspect metadata, coverage, currency and freshness before comparing."},"Period":{"type":"object","properties":{"date":{"type":"string","format":"date"},"currency":{"type":"string"},"periodStart":{"type":["string","null"]},"periodType":{"type":"string"},"metadata":{"type":"object","description":"Per-field currency overrides, authority and retract/unavailable flags. Honor these flags before using a value.","additionalProperties":{"type":"object","properties":{"currency":{"type":["string","null"]},"authority":{"type":["string","null"]},"retract":{"type":["boolean","null"]},"unavailable":{}},"required":[]}},"revenue":{"type":["number","null"]},"grossProfit":{"type":["number","null"]},"ebit":{"type":["number","null"]},"operatingIncome":{"type":["number","null"]},"netIncome":{"type":["number","null"]},"operatingCashFlow":{"type":["number","null"]},"capitalExpenditure":{"type":["number","null"]},"taxProvision":{"type":["number","null"]},"pretaxIncome":{"type":["number","null"]},"sbc":{"type":["number","null"]},"longTermDebt":{"type":["number","null"]},"currentDebt":{"type":["number","null"]},"cash":{"type":["number","null"]},"stockholdersEquity":{"type":["number","null"]},"dividendsPaid":{"type":["number","null"]},"stockRepurchase":{"type":["number","null"]},"stockIssuance":{"type":["number","null"]},"basicAverageShares":{"type":["number","null"]},"periodEndShares":{"type":["number","null"]}},"required":["date","currency"]},"ShareholderReturns":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":["string","null"]},"currency":{"const":"USD"},"unit":{"const":"millions"},"yearsRequested":{"type":"integer"},"throughYear":{"type":["integer","null"]},"latestReportedYear":{"type":["integer","null"]},"asOf":{"type":"string"},"windowBasis":{"type":"string"},"fxPolicy":{"type":"string"},"yearsAvailable":{"type":"integer"},"yearsComplete":{"type":"integer"},"dividends":{"type":["number","null"]},"buybacks":{"type":["number","null"]},"total":{"type":["number","null"]},"complete":{"type":"boolean"},"observed":{"type":"object","properties":{"dividends":{"type":["number","null"]},"buybacks":{"type":["number","null"]},"total":{"type":["number","null"]}},"required":["dividends","buybacks","total"]},"missingYears":{"type":"array","items":{"type":"integer"}},"annual":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"periodEnd":{"type":["string","null"]},"reportingCurrency":{"type":["string","null"]},"dividends":{"type":["number","null"]},"buybacks":{"type":["number","null"]},"total":{"type":["number","null"]},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"]}}},"required":["year","periodEnd","dividends","buybacks","total","missing"]}}},"required":["ticker","currency","unit","yearsRequested","yearsAvailable","complete","dividends","buybacks","total","observed","missingYears","annual"]},"StatementSeries":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string"},"interval":{"type":"string","enum":["annual","quarterly"]},"currency":{"type":"string"},"unit":{"type":"string","enum":["millions","whole"]},"metrics":{"type":"array","items":{"type":"string","enum":["revenue","grossProfit","ebit","operatingIncome","netIncome","operatingCashFlow","capitalExpenditure","taxProvision","pretaxIncome","sbc","longTermDebt","currentDebt","cash","stockholdersEquity","dividendsPaid","stockRepurchase","stockIssuance","basicAverageShares","periodEndShares"]}},"units":{"type":"object","additionalProperties":{"type":"string"}},"fxPolicy":{"type":"string"},"limit":{"type":"integer"},"from":{"type":["string","null"]},"to":{"type":"string"},"periods":{"type":"array","items":{"type":"object","properties":{"periodEnd":{"type":"string","format":"date"},"year":{"type":"string"},"periodType":{"type":"string"},"revenue":{"type":["number","null"]},"grossProfit":{"type":["number","null"]},"ebit":{"type":["number","null"]},"operatingIncome":{"type":["number","null"]},"netIncome":{"type":["number","null"]},"operatingCashFlow":{"type":["number","null"]},"capitalExpenditure":{"type":["number","null"]},"taxProvision":{"type":["number","null"]},"pretaxIncome":{"type":["number","null"]},"sbc":{"type":["number","null"]},"longTermDebt":{"type":["number","null"]},"currentDebt":{"type":["number","null"]},"cash":{"type":["number","null"]},"stockholdersEquity":{"type":["number","null"]},"dividendsPaid":{"type":["number","null"]},"stockRepurchase":{"type":["number","null"]},"stockIssuance":{"type":["number","null"]},"basicAverageShares":{"type":["number","null"]},"periodEndShares":{"type":["number","null"]},"missing":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"}},"required":["metric","reason"]}}},"required":["periodEnd","year","periodType","missing"],"additionalProperties":false}}},"required":["ticker","interval","currency","unit","metrics","units","periods"]},"Statements":{"type":"object","properties":{"ticker":{"type":"string"},"units":{"type":"string"},"annual":{"type":"array","items":{"$ref":"#/components/schemas/Period"}},"quarterly":{"type":"array","items":{"$ref":"#/components/schemas/Period"}},"prices":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"close":{"type":["number","null"]},"currency":{"type":"string"},"shareBasis":{"type":"string"},"ordinarySharesPerQuote":{"type":["number","null"]}},"required":[]}},"fxRates":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"monthEnd":{"type":"string"},"usdPerUnit":{"type":["number","null"]},"source":{"type":"string"}},"required":[]}}},"required":["ticker","units","annual","quarterly","prices","fxRates"]},"Watchlist":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"changedAt":{"type":["string","null"]},"members":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string"}},"required":["ticker"]}}},"required":["slug","name","members"]},"QuoteStocks":{"type":"object","properties":{"stocks":{"type":"array","items":{"type":"object","properties":{"company":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string"},"quoteAsAt":{}},"required":[]},"ttm":{"type":"object","properties":{"marketCap":{"type":["number","null"]}},"required":[]}},"required":[],"additionalProperties":true}}},"required":["stocks"]},"WatchlistStart":{"type":"object","properties":{"stocks":{"type":"array","items":{"type":"object","additionalProperties":true,"description":"Full Financials for selectedTicker; lightweight placeholders for other tickers."}},"selectedTicker":{"type":["string","null"]}},"required":["stocks","selectedTicker"]},"SearchResult":{"type":"object","properties":{"symbol":{"type":"string"},"name":{"type":"string"},"exchange":{"type":"string"},"type":{"type":"string"}},"required":["symbol","name"]},"Benchmark":{"type":"object","properties":{"symbol":{"type":"string"},"observedAt":{},"asOf":{},"frequency":{"type":"string","enum":["daily","monthly"]},"prices":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"close":{"type":["number","null"]}},"required":["date","close"]}},"source":{"type":"string"},"stale":{"type":"boolean"},"refreshFailed":{"type":"boolean"}},"required":["symbol","prices","frequency"]}}}}