Investor Tool Public Finance API

Query the website’s financial data with public HTTP GET requests. No login, API key or database credentials required.

Base URL: https://finance.mannhowie.com · JSON directory · OpenAPI 3.1 · Agent guide

Start with stored companies or watchlist memberships, then query financials per ticker. Use storedOnly=1 for stored reads. Financial presentation values are in millions of display currency; company.marketCap is in whole units. Raw statements use whole original currency units and shares. Null means unavailable. Check dates, coverage and currency before comparing. Upstream Yahoo data may be delayed or unavailable.

Read-only MCP for AI clients

Connect a remote MCP client to https://finance.mannhowie.com/api/mcp using Streamable HTTP and authentication None. This is a protocol endpoint; opening it in a browser may return 405 because persistent SSE sessions are not used.

All tools read stored data. None can import, refresh, write, execute arbitrary SQL or call arbitrary URLs. No database credentials or frontend access are required. Client/account/workspace setup is still required.

Example query_financials arguments: {"tickers":["AAPL","MSFT"],"metrics":["dividendsPaid","stockRepurchase"],"interval":"annual","limit":5,"currency":"usd"}. For website ratios use query_ratios with tickers, optional ratios, period=current|annual, currency and includeDefinitions (default true). Results contain shared formulas, unrounded and formatted values, fallback periods and estimate flags. Tool schemas are discovered by the MCP client. Financial facts retain signs and unavailable values remain null.

Select metrics and annual or quarterly interval

Request only the financial fields and periods you need using metrics, interval, limit and optional from/to period-end dates. Amounts default to USD millions; unit=whole returns whole currency units and currency=local uses the company reporting currency. Share counts remain shares. Cash outflows retain their reported sign and missing data remains null. These queries do not load prices, descriptions or security history.

Dividends and gross buybacks: compact data

Use these small responses for annual cash returns. The default financial history contains unrelated metadata, and view=summary has no annual cash-flow metrics.

Download the ten-company JSON snapshot (22 November 2026). This dated example includes missing-data flags and observed chart segments; it is not a live feed or a complete five-year dataset.

Live API requests for the same dated fiscal windows:

If direct URL opening fails in a web reader, follow these links. Retrieve the JSON first and embed it in the visualisation: the preview runtime may restrict its own scripts or network requests. Missing values must remain missing; exact combined percentages require complete data for every company.

GET /api/companies

Enumerate stored companies

Public financial universe, excluding archived companies. No upstream calls. Page with offset and limit; total is the filtered count.

Try example
ParameterContractDescription
q{"type":"string","maxLength":100}Optional case-insensitive ticker or company name substring.
limit{"type":"integer","minimum":1,"maximum":200,"default":100}Page size.
offset{"type":"integer","minimum":0,"default":0}Zero-based offset.

GET /api/watchlists

List visible saved watchlists and all members

Returns saved public lists and their ticker memberships. Visibility and manual membership match the website.

Try example
ParameterContractDescription

GET /api/financials/{ticker}

Query company financials, valuations and price history

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.

Try example
ParameterContractDescription
ticker (required){"type":"string","pattern":"^[A-Za-z0-9.^=-]{1,32}$"}Yahoo symbol, e.g. AAPL, BHP.AX, 0700.HK or 2330.TW.
currency{"type":"string","enum":["usd","local"],"default":"usd"}USD or company reporting currency. Financial amounts are in millions; company.marketCap is in whole currency units. Prices have their own currency metadata.
storedOnly{"type":"string","enum":["0","1"],"default":"0"}Use 1 for stored data only, without Yahoo imports or refreshes. Default 0 may refresh/import data server-side.
view{"type":"string","enum":["summary","history"],"default":"history"}summary keeps minimal annual/valuation anchors and omits share-price history; history returns available history.

GET /api/financials/{ticker}/statements

Read annual and quarterly statements, prices and FX in original units

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.

Try example
ParameterContractDescription
ticker (required){"type":"string","pattern":"^[A-Za-z0-9.^=-]{1,32}$"}Yahoo symbol, e.g. AAPL, BHP.AX, 0700.HK or 2330.TW.
metrics{"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}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.
interval{"type":"string","enum":["annual","quarterly"],"default":"annual"}Series view: annual or quarterly financial statements. No TTM or share-price series.
limit{"type":"integer","minimum":1,"maximum":200,"default":20}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.
from{"type":"string","format":"date"}Series view: inclusive period-end lower bound, YYYY-MM-DD.
to{"type":"string","format":"date"}Series view: inclusive period-end upper bound; capped at today. Default today.
currency{"type":"string","enum":["usd","local"],"default":"usd"}Series view: USD or the company reporting currency. Each field respects its metadata currency and period-end FX. Full view remains in original currencies.
unit{"type":"string","enum":["millions","whole"],"default":"millions"}Series view: currency amounts in millions or whole units. Share counts always remain shares; inspect units per field.
view{"type":"string","enum":["full","shareholder-returns","series"],"default":"full"}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.
years{"type":"integer","minimum":1,"maximum":10,"default":5}Only for shareholder-returns: consecutive fiscal years, not arbitrary latest non-null rows.
throughYear{"type":"integer","minimum":1900,"maximum":2200}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.

GET /api/search

Search Yahoo Finance for equity and ETF symbols

Searches upstream Yahoo; results may not yet exist in stored data.

Try example
ParameterContractDescription
q (required){"type":"string","minLength":2,"maxLength":100}Company name or symbol.

GET /api/watchlists/quotes

Get lightweight market-cap snapshots for up to 200 symbols

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.

Try example
ParameterContractDescription
tickers (required){"type":"string","pattern":"^[A-Z0-9.^=-]{1,32}(,[A-Z0-9.^=-]{1,32}){0,199}$"}Comma-separated uppercase Yahoo symbols; 1–200 distinct symbols. Split larger universes into batches.
currency{"type":"string","enum":["usd","local"],"default":"usd"}USD or company reporting currency. Financial amounts are in millions; company.marketCap is in whole currency units. Prices have their own currency metadata.
storedOnly{"type":"string","enum":["0","1"],"default":"0"}Use 1 for stored data only, without Yahoo imports or refreshes. Default 0 may refresh/import data server-side.

GET /api/watchlists/start

Get watchlist snapshots and the largest company history

Only the selectedTicker has complete financials; other stocks are placeholders. Query financials individually for comparisons.

Try example
ParameterContractDescription
tickers (required){"type":"string","pattern":"^[A-Z0-9.^=-]{1,32}(,[A-Z0-9.^=-]{1,32}){0,199}$"}Comma-separated uppercase Yahoo symbols; 1–200 distinct symbols. Split larger universes into batches.
currency{"type":"string","enum":["usd","local"],"default":"usd"}USD or company reporting currency. Financial amounts are in millions; company.marketCap is in whole currency units. Prices have their own currency metadata.
storedOnly{"type":"string","enum":["0","1"],"default":"0"}Use 1 for stored data only, without Yahoo imports or refreshes. Default 0 may refresh/import data server-side.

GET /api/benchmark

Read S&P 500 price index history

Cached ^GSPC close prices, not total returns; check asOf, stale and refreshFailed.

Try example
ParameterContractDescription
frequency{"type":"string","enum":["daily","monthly"],"default":"daily"}Sampling frequency.

Interactive OpenAPI explorer

The reference above works without JavaScript. The optional Swagger explorer loads from jsDelivr.