{"openapi":"3.1.0","info":{"title":"Yahoo Finance Data API","description":"Open, no-auth access to Yahoo Finance data via yfinance: historical prices (OHLCV and adjusted close), annual and quarterly financial statements (income, balance sheet, cash flow), detailed company info, market data, dividends, splits and corporate actions, in JSON and Excel-friendly formats.\n\nGETTING STARTED: every endpoint takes ?tickers= with one or more comma-separated Yahoo Finance symbols. Symbols follow the Yahoo Finance convention, so non-US listings carry an exchange suffix: RELIANCE.NS (India NSE), .BO (BSE), .L (London), .HK (Hong Kong), .T (Tokyo). Indices look like ^NSEI and FX like EURUSD=X. Broker, scheme or company names such as 'IRBINVITFUND' do not resolve. Dates are YYYY-MM-DD.\n\nENDPOINTS THAT ALSO NEED DATES: /v1/get-adj-close/, /v1/get-all-prices/ additionally require &start_date=YYYY-MM-DD&end_date=YYYY-MM-DD. Every other endpoint takes tickers alone.\n\nRESPONSE TYPES: the MCP-exposed endpoints all return JSON, including the /excel/ financial-statement endpoints (structured {dates, data}). A separate, non-MCP set of plain statement endpoints (/v1/get-income-statement/ etc.) returns pipe-delimited ('|') CSV TEXT instead. Each endpoint's own description states its response shape and flags per-ticker latency.\n\nREQUEST LIMITS: up to 25 tickers per request on every endpoint, and sending more returns a clear 400 asking you to split the batch. Calls are lightly paced at roughly 1 second per ticker, and a ticker with no data returns a short per-ticker note rather than failing the whole request. Your live per-IP budget rides on the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers of every response - read those instead of hard-coding a number. GET / returns the same limits as JSON.\n\nERRORS: every 4xx and 5xx returns {error: {code, message}, help: {docs, openapi, catalog}}. Where the endpoint is known and the request shape is what failed - a 422 or a wrong method - the body also carries `example`, a complete working URL for that same endpoint, built from the parameter examples in this spec. GET / returns the full endpoint index as JSON.\n\nMore Tigzig tools: https://api.tigzig.com/.well-known/api-catalog","version":"1.8.1"},"paths":{"/":{"get":{"summary":"Root","description":"What this API is, where the docs are, and your current request limits.\n\nReturns the base URL, links to the docs and the OpenAPI spec, the MCP endpoint, and\na limits block with your per-IP budget and the maximum tickers per request.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/get-income-statement/":{"get":{"summary":"Get Income Statement Endpoint","description":"Annual income statement (P&L) for one or more Yahoo Finance tickers.\n\nRESPONSE IS TEXT, NOT JSON. Returns a pipe-delimited ('|') CSV string. The first\ncolumn is `Ticker`, the second is the line-item name, and each remaining column is\na fiscal-period end date. Multiple tickers are returned as consecutive blocks in\none string. A ticker with no data yields the line\n`No income statement data available for <TICKER>`.\n\nLATENCY: roughly 1 second per ticker (up to 25 per request). Tickers with no data\ncome back with a short note, not a failure of the whole request; sending more than\n25 returns a clear message to split the batch.\n\nParams: `tickers` - comma-separated symbols (e.g. `AAPL,MSFT`). Use the Yahoo\nsymbol convention (`RELIANCE.NS`, `^NSEI`).","operationId":"get_income_statement_endpoint_v1_get_income_statement__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-cash-flow/":{"get":{"summary":"Get Cash Flow Endpoint","description":"Annual cash-flow statement for one or more Yahoo Finance tickers.\n\nRESPONSE IS TEXT, NOT JSON. Returns a pipe-delimited ('|') CSV string. First column\n`Ticker`, second the line-item name, remaining columns are fiscal-period end dates.\nMultiple tickers come back as consecutive blocks in one string. A ticker with no\ndata yields `No cash flow data available for <TICKER>`.\n\nLATENCY: roughly 1 second per ticker (up to 25 per request). Tickers with no data\ncome back with a short note, not a failure of the whole request; sending more than\n25 returns a clear message to split the batch.\n\nParams: `tickers` - comma-separated symbols (e.g. `AAPL,MSFT`).","operationId":"get_cash_flow_endpoint_v1_get_cash_flow__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-quarterly-income-statement/":{"get":{"summary":"Get Quarterly Income Statement Endpoint","description":"QUARTERLY income statement (P&L) for one or more Yahoo Finance tickers.\n\nSame shape as the annual endpoint, but columns are quarter-end dates instead of\nfiscal years. RESPONSE IS TEXT, NOT JSON: a pipe-delimited ('|') CSV string with\n`Ticker` as the first column. Multiple tickers are consecutive blocks in one string.\n\nLATENCY: roughly 1 second per ticker (up to 25 per request). Tickers with no data\ncome back with a short note, not a failure of the whole request; sending more than\n25 returns a clear message to split the batch.\n\nParams: `tickers` - comma-separated symbols (e.g. `AAPL,MSFT`).","operationId":"get_quarterly_income_statement_endpoint_v1_get_quarterly_income_statement__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-quarterly-cash-flow/":{"get":{"summary":"Get Quarterly Cash Flow Endpoint","description":"QUARTERLY cash-flow statement for one or more Yahoo Finance tickers.\n\nSame shape as the annual endpoint, but columns are quarter-end dates. RESPONSE IS\nTEXT, NOT JSON: a pipe-delimited ('|') CSV string with `Ticker` as the first column.\nMultiple tickers are consecutive blocks in one string.\n\nLATENCY: roughly 1 second per ticker (up to 25 per request). Tickers with no data\ncome back with a short note, not a failure of the whole request; sending more than\n25 returns a clear message to split the batch.\n\nParams: `tickers` - comma-separated symbols (e.g. `AAPL,MSFT`).","operationId":"get_quarterly_cash_flow_endpoint_v1_get_quarterly_cash_flow__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-balance-sheet/":{"get":{"summary":"Get Balance Sheet Endpoint","description":"Annual balance sheet for one or more Yahoo Finance tickers.\n\nRESPONSE IS TEXT, NOT JSON. Returns a pipe-delimited ('|') CSV string. First column\n`Ticker`, second the line-item name, remaining columns are fiscal-period end dates.\nMultiple tickers come back as consecutive blocks in one string. A ticker with no\ndata yields `No balance sheet data available for <TICKER>`.\n\nLATENCY: roughly 1 second per ticker (up to 25 per request). Tickers with no data\ncome back with a short note, not a failure of the whole request; sending more than\n25 returns a clear message to split the batch.\n\nParams: `tickers` - comma-separated symbols (e.g. `AAPL,MSFT`).","operationId":"get_balance_sheet_endpoint_v1_get_balance_sheet__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-adj-close/":{"get":{"summary":"Get Adj Close Endpoint","description":"Adjusted closing prices for one or more tickers over a date range.\n\nUnlike the statement endpoints, this one DOES return JSON: an object keyed by date\n(`\"YYYY-MM-DD\"`), whose value is an object of `{ticker: adjusted_close}`. A ticker\nwith no price on a given date is `null` (a real trading gap, e.g. a market holiday\nin one country but not another); a ticker absent from the whole fetch is the string\n`\"Data not available\"`. Handle BOTH cases when parsing.\n\nDates are NOT sparse-filled across tickers - when comparing markets with different\nholidays, align on the date keys rather than assuming equal-length series.\n\nParams:\n  `tickers`    - comma-separated symbols (e.g. `AAPL,MSFT`)\n  `start_date` - `YYYY-MM-DD` (required)\n  `end_date`   - `YYYY-MM-DD` (required)\nDates must be YYYY-MM-DD. Anything else returns HTTP 400 with an error naming the\nparameter at fault. An end_date before start_date is also a 400.","operationId":"get_adj_close_endpoint_v1_get_adj_close__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."},{"name":"start_date","in":"query","required":true,"schema":{"type":"string","description":"Start date, YYYY-MM-DD (e.g. '2025-01-02').","examples":["2025-01-02"],"title":"Start Date"},"description":"Start date, YYYY-MM-DD (e.g. '2025-01-02')."},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","description":"End date, YYYY-MM-DD (e.g. '2025-01-31').","examples":["2025-01-31"],"title":"End Date"},"description":"End date, YYYY-MM-DD (e.g. '2025-01-31')."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-market-data/":{"get":{"summary":"Get Market Data","description":"Fetches key market data metrics for specified stock tickers from Yahoo Finance.\n\nThis endpoint provides three essential market metrics for each ticker:\n- market_cap: The total market value of all outstanding shares in USD\n- free_float: The number of shares available for public trading (excluding restricted shares)\n- total_shares_outstanding: The total number of shares issued by the company\n\nThese metrics help assess company size, liquidity, and ownership structure.\n\nExample query: get_market_data?tickers=AAPL,MSFT,GOOG\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_market_data","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Object keyed by ticker. Each value has market_cap, free_float and total_shares_outstanding. A ticker with no data returns the same keys with null values.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"},"example":{"AAPL":{"market_cap":4901757779968,"free_float":14662387495,"total_shares_outstanding":14687356000}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-all-prices/":{"get":{"summary":"Get All Prices Endpoint","description":"Fetches comprehensive historical price data for specified Yahoo Finance tickers.\n\nThis endpoint retrieves complete historical price data including:\n- Open prices\n- High prices\n- Low prices\n- Close prices\n- Trading volumes\n- Dividend payments\n- Stock splits\n\nData is returned in a JSON format organized by date, with each date containing\ndata for all requested tickers. For each ticker, all available price metrics\nare provided. This gives a complete picture of price movement and trading activity\nover the specified time period.\n\nThe data can be used for:\n- Technical analysis and charting\n- Performance tracking\n- Dividend history analysis\n- Trading volume analysis\n- Volatility calculations\n\nExample query: get-all-prices?tickers=AAPL,MSFT&start_date=2023-01-01&end_date=2023-01-31\n\nTSV format example: get-all-prices?tickers=AAPL&start_date=2023-01-01&end_date=2023-01-31&format=tsv\nTSV response returns a compact tab-delimited string inside JSON, optimized for LLM/Excel consumption.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_all_prices","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"},{"name":"start_date","in":"query","required":true,"schema":{"type":"string","description":"Start date in YYYY-MM-DD format (e.g., '2023-01-01')","examples":["2025-01-02"],"title":"Start Date"},"description":"Start date in YYYY-MM-DD format (e.g., '2023-01-01')"},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","description":"End date in YYYY-MM-DD format (e.g., '2023-12-31')","examples":["2025-01-31"],"title":"End Date"},"description":"End date in YYYY-MM-DD format (e.g., '2023-12-31')"},{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"Response format: 'json' (default) returns nested JSON, 'tsv' returns compact tab-delimited string optimized for LLM context windows (~70% fewer tokens)","default":"json","title":"Format"},"description":"Response format: 'json' (default) returns nested JSON, 'tsv' returns compact tab-delimited string optimized for LLM context windows (~70% fewer tokens)"}],"responses":{"200":{"description":"TWO shapes selected by `format`. Default (JSON): object keyed by date, each date keyed by ticker, each ticker an OHLCV bar with keys Open, High, Low, Close, Volume, Dividends, 'Stock Splits'. With format=tsv: an envelope {data, rows, tickers, period, format, columns, zero_cols_dropped} where `data` is a compact tab-delimited string (columns O,H,L,C,V).","content":{"application/json":{"schema":{},"examples":{"json (default)":{"value":{"2024-01-02":{"AAPL":{"Open":185.06,"High":186.33,"Low":181.83,"Close":183.56,"Volume":82488700,"Dividends":0.0,"Stock Splits":0.0}}}},"tsv (format=tsv)":{"value":{"data":"Date\tO\tH\tL\tC\tV\n2024-01-02\t185.06\t186.33\t181.83\t183.56\t82488700","rows":1,"tickers":"AAPL","period":"2024-01-02 to 2024-01-05","format":"tsv","columns":["O","H","L","C","V"],"zero_cols_dropped":["Stock Splits","Dividends"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-detailed-info/":{"get":{"summary":"Get Detailed Info Endpoint","description":"Retrieves comprehensive company information and data points from Yahoo Finance.\n\nNote: Returns roughly 1 second per ticker (up to 25 per request). Tickers with no data come back with a short note, not a failure of the whole request.\n\nThis endpoint returns approximately 200 structured data points organized across 11 key categories:\n\n1. Company Information - Basic details about the company, sector, industry, etc.\n2. Stock Price & Market Activity - Current and historical price information\n3. Valuation & Ratios - P/E ratio, PEG, price-to-book, etc.\n4. Dividend Information - Yield, payment history, ex-dividend dates\n5. Earnings & Financials - EPS, revenue, profit margins, etc.\n6. Share Statistics - Float, outstanding shares, short interest\n7. Analyst Price Targets - Consensus targets, recommendations\n8. Technical Indicators - Moving averages, relative strength\n9. Earnings Call / Fiscal Calendar - Upcoming events and dates\n10. Other - Miscellaneous financial metrics and data\n11. Key Executives - Information about company leadership\n\nThe data is structured with 'main_info' containing all general data points and 'officers' \ncontaining information about key executives.\n\nExample query: get_detailed_info?tickers=AAPL,MSFT,GOOG\n\nMax 25 tickers per request.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_detailed_info","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Object keyed by ticker. Each value has a `main_info` object carrying the full Yahoo Finance company-info record (address, sector, industry, officers, valuation and risk metrics, and ~100 more fields that vary by ticker and over time). Treat the field set as open and read by key.","content":{"application/json":{"schema":{},"example":{"AAPL":{"main_info":{"sector":"Technology","industry":"Consumer Electronics","fullTimeEmployees":166000,"marketCap":4901757779968,"country":"United States","website":"https://www.apple.com","__note__":"~100 more fields; set varies by ticker"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/excel/get-income-statement/":{"get":{"summary":"Get Income Statement Excel Endpoint","description":"Retrieves annual income statements for specified Yahoo Finance tickers in a structured JSON format.\n\nThis endpoint pulls complete annual income statement data from Yahoo Finance with all available line items, including:\n- Total Revenue\n- Cost of Revenue\n- Gross Profit\n- Operating Expenses\n- Operating Income\n- Net Income\n- EPS metrics\n- And many more financial metrics\n\nData is returned in a well-structured JSON format optimized for analysis and presentation:\n- 'dates': An array of reporting period dates\n- 'data': An array of objects, each containing a financial metric and its values across reporting periods\n\nThe structured format makes it easy to:\n- Compare performance across different years\n- Analyze financial trends\n- Calculate financial ratios\n- Generate reports or visualizations\n\nExample query: excel/get-income-statement?tickers=AAPL,MSFT\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_income_statement_excel","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `dates` (fiscal-year-end dates, newest first) and `data` (one row per line item: a `metric` name plus one value per date; missing values are null). A ticker with no data returns {\"<TICKER>\": {\"error\": \"...\"}} instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatementResponse"},"example":{"AAPL":{"dates":["2025-09-30","2024-09-30"],"data":[{"metric":"Total Revenue","2025-09-30":416161000000.0,"2024-09-30":416161000000.0}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/excel/get-balance-sheet/":{"get":{"summary":"Get Balance Sheet Excel Endpoint","description":"Retrieves annual balance sheets for specified Yahoo Finance tickers in a structured JSON format.\n\nThis endpoint pulls complete annual balance sheet data from Yahoo Finance with all available line items, including:\n- Assets (Current Assets, Long-term Assets)\n- Liabilities (Current Liabilities, Long-term Debt)\n- Shareholders' Equity\n- Cash and Equivalents\n- Inventory\n- Accounts Receivable/Payable\n- And many more balance sheet items\n\nData is returned in a well-structured JSON format optimized for analysis and presentation:\n- 'dates': An array of reporting period dates\n- 'data': An array of objects, each containing a financial metric and its values across reporting periods\n\nThe structured format makes it easy to:\n- Assess financial position at different points in time\n- Calculate financial ratios (quick ratio, debt-to-equity, etc.)\n- Evaluate liquidity and solvency\n- Track changes in company financial structure\n\nExample query: excel/get-balance-sheet?tickers=AAPL,MSFT\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_balance_sheet_excel","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `dates` (fiscal-year-end dates, newest first) and `data` (one row per line item: a `metric` name plus one value per date; missing values are null). A ticker with no data returns {\"<TICKER>\": {\"error\": \"...\"}} instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatementResponse"},"example":{"AAPL":{"dates":["2025-09-30","2024-09-30"],"data":[{"metric":"Total Assets","2025-09-30":344085000000.0,"2024-09-30":344085000000.0}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/excel/get-cash-flow/":{"get":{"summary":"Get Cash Flow Excel Endpoint","description":"Retrieves annual cash flow statements for specified Yahoo Finance tickers in a structured JSON format.\n\nThis endpoint pulls complete annual cash flow data from Yahoo Finance with all available line items, including:\n- Operating Cash Flow\n- Investing Cash Flow\n- Financing Cash Flow\n- Capital Expenditures\n- Dividends Paid\n- Stock Repurchases\n- Free Cash Flow\n- And many more cash flow metrics\n\nData is returned in a well-structured JSON format optimized for analysis and presentation:\n- 'dates': An array of reporting period dates\n- 'data': An array of objects, each containing a financial metric and its values across reporting periods\n\nThe structured format makes it easy to:\n- Analyze cash generation and usage over time\n- Assess operational efficiency\n- Evaluate investment and financing activities\n- Determine sustainability of dividends and share repurchases\n\nExample query: excel/get-cash-flow?tickers=AAPL,MSFT\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_cash_flow_excel","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `dates` (fiscal-year-end dates, newest first) and `data` (one row per line item: a `metric` name plus one value per date; missing values are null). A ticker with no data returns {\"<TICKER>\": {\"error\": \"...\"}} instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatementResponse"},"example":{"AAPL":{"dates":["2025-09-30","2024-09-30"],"data":[{"metric":"Operating Cash Flow","2025-09-30":118254000000.0,"2024-09-30":118254000000.0}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/excel/get-quarterly-income-statement/":{"get":{"summary":"Get Quarterly Income Statement Excel Endpoint","description":"Retrieves quarterly income statements for specified Yahoo Finance tickers in a structured JSON format.\n\nThis endpoint pulls complete quarterly income statement data from Yahoo Finance with all available line items, including:\n- Total Revenue\n- Cost of Revenue\n- Gross Profit\n- Operating Expenses\n- Operating Income\n- Net Income\n- EPS metrics\n- And many more financial metrics\n\nData is returned in a well-structured JSON format optimized for analysis and presentation:\n- 'dates': An array of quarterly reporting period dates\n- 'data': An array of objects, each containing a financial metric and its values across quarters\n\nThe structured format makes it easy to:\n- Identify seasonal patterns in business performance\n- Track quarter-over-quarter growth rates\n- Analyze short-term business trends\n- Compare quarterly results to analyst expectations\n- Detect turning points in business performance more quickly than annual data\n\nExample query: excel/get-quarterly-income-statement?tickers=AAPL,MSFT\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_quarterly_income_statement_excel","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `dates` (quarter-end dates, newest first) and `data` (one row per line item: a `metric` name plus one value per date; missing values are null). A ticker with no data returns {\"<TICKER>\": {\"error\": \"...\"}} instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatementResponse"},"example":{"AAPL":{"dates":["2025-09-30","2024-09-30"],"data":[{"metric":"Total Revenue","2025-09-30":102466000000.0,"2024-09-30":102466000000.0}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/excel/get-quarterly-cash-flow/":{"get":{"summary":"Get Quarterly Cash Flow Excel Endpoint","description":"Retrieves quarterly cash flow statements for specified Yahoo Finance tickers in a structured JSON format.\n\nThis endpoint pulls complete quarterly cash flow data from Yahoo Finance with all available line items, including:\n- Operating Cash Flow\n- Investing Cash Flow\n- Financing Cash Flow\n- Capital Expenditures\n- Dividends Paid\n- Stock Repurchases\n- Free Cash Flow\n- And many more cash flow metrics\n\nData is returned in a well-structured JSON format optimized for analysis and presentation:\n- 'dates': An array of quarterly reporting period dates\n- 'data': An array of objects, each containing a financial metric and its values across quarters\n\nThe structured format makes it easy to:\n- Identify seasonal patterns in cash generation\n- Track quarter-over-quarter cash flow trends\n- Analyze short-term liquidity changes\n- Compare quarterly cash flow to analyst expectations\n- Detect changes in capital allocation more quickly than annual data\n\nExample query: excel/get-quarterly-cash-flow?tickers=AAPL,MSFT\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_quarterly_cash_flow_excel","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `dates` (quarter-end dates, newest first) and `data` (one row per line item: a `metric` name plus one value per date; missing values are null). A ticker with no data returns {\"<TICKER>\": {\"error\": \"...\"}} instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatementResponse"},"example":{"AAPL":{"dates":["2025-09-30","2024-09-30"],"data":[{"metric":"Operating Cash Flow","2025-09-30":27865000000.0,"2024-09-30":27865000000.0}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/excel/get-quarterly-balance-sheet/":{"get":{"summary":"Get Quarterly Balance Sheet Excel Endpoint","description":"QUARTERLY balance sheet for one or more Yahoo Finance tickers, structured JSON.\n\nSame {dates, data} shape as the annual /excel/get-balance-sheet endpoint, but the\ncolumns are quarter-end dates. LATENCY: roughly 1 second per ticker (up to 25 per request).\nA ticker with no data (or a commodity / crypto / index) returns {\"error\": \"...\"}.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_quarterly_balance_sheet_excel","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT').","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT')."}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `dates` (quarter-end dates, newest first) and `data` (one row per line item: a `metric` name plus one value per date; missing values are null). A ticker with no data returns {\"<TICKER>\": {\"error\": \"...\"}} instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatementResponse"},"example":{"AAPL":{"dates":["2025-09-30","2024-09-30"],"data":[{"metric":"Total Assets","2025-09-30":331000000000.0,"2024-09-30":331000000000.0}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-analyst-price-targets/":{"get":{"summary":"Get Analyst Price Targets Endpoint","description":"Analyst price targets (current / high / low / mean / median) for one or more tickers.\n\nValues are in the stock's quote currency. A ticker with no analyst coverage - or a\ncommodity, crypto or index - returns {\"error\": \"...\"} for that ticker.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_analyst_price_targets","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT').","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT')."}],"responses":{"200":{"description":"Object keyed by ticker. Each value has the analyst price-target current / high / low / mean / median (in the stock's quote currency). A ticker with no analyst coverage - or a commodity, crypto or index - returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalystTargetsResponse"},"example":{"AAPL":{"current":213.25,"high":300.0,"low":175.0,"mean":241.5,"median":245.0}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-recommendations/":{"get":{"summary":"Get Recommendations Endpoint","description":"Analyst recommendation trend for one or more tickers: monthly tallies of\nstrongBuy / buy / hold / sell / strongSell (current month and the prior three).\n\nA ticker with no coverage returns {\"error\": \"...\"} for that ticker.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_analyst_recommendations","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT').","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT')."}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `data`, a list of monthly analyst rating tallies (most recent first): period ('0m' = current month, '-1m' = last month, ...) and counts strongBuy / buy / hold / sell / strongSell. A ticker with no coverage returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{},"example":{"AAPL":{"data":[{"period":"0m","strongBuy":6,"buy":23,"hold":14,"sell":2,"strongSell":2},{"period":"-1m","strongBuy":6,"buy":22,"hold":16,"sell":1,"strongSell":2}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-calendar/":{"get":{"summary":"Get Calendar Endpoint","description":"Upcoming corporate calendar for one or more tickers: next earnings date(s),\nex-dividend and dividend dates, and the consensus earnings / revenue estimate\n({high, low, average}) for the next report.\n\nMissing fields are null; a ticker with none returns {\"error\": \"...\"}.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_calendar","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT').","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT')."}],"responses":{"200":{"description":"Object keyed by ticker. Each value has the upcoming earnings_dates (list, ISO YYYY-MM-DD), ex_dividend_date, dividend_date, and the consensus earnings_estimate and revenue_estimate ({high, low, average}) for the next report. Missing fields are null; a ticker with none returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{},"example":{"AAPL":{"earnings_dates":["2026-07-30"],"ex_dividend_date":"2026-05-12","dividend_date":"2026-05-15","earnings_estimate":{"high":1.99,"low":1.83,"average":1.89},"revenue_estimate":{"high":90500000000,"low":88200000000,"average":89300000000}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-estimates/":{"get":{"summary":"Get Estimates Endpoint","description":"Forward analyst estimates for one or more tickers, EARNINGS and REVENUE together\nin one response. Each is a list of period rows (0q current quarter, +1q next quarter,\n0y current year, +1y next year) with avg / low / high, numberOfAnalysts, growth, and\nthe year-ago comparison.\n\nA ticker with no coverage returns {\"error\": \"...\"} for that ticker.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_estimates","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT').","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT')."}],"responses":{"200":{"description":"Object keyed by ticker. Each value has `earnings` and `revenue`, each a list of forward-period estimate rows: period ('0q' current quarter, '+1q' next quarter, '0y' current year, '+1y' next year), avg / low / high, numberOfAnalysts, growth (decimal), and yearAgoEps / yearAgoRevenue. A ticker with no coverage returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{},"example":{"AAPL":{"earnings":[{"period":"0q","avg":1.894,"low":1.83,"high":1.99,"yearAgoEps":1.57,"numberOfAnalysts":31,"growth":0.2063,"currency":"USD"}],"revenue":[{"period":"0q","avg":89300000000,"low":88200000000,"high":90500000000,"numberOfAnalysts":28,"yearAgoRevenue":85777000000,"growth":0.041}]}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-major-holders/":{"get":{"summary":"Get Major Holders Endpoint","description":"Ownership breakdown for one or more tickers: percent held by insiders and by\ninstitutions (decimals, e.g. 0.66 = 66%), the institutional float percentage, and\nthe number of institutional holders.\n\nA ticker with no ownership data returns {\"error\": \"...\"} for that ticker.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_major_holders","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT').","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT')."}],"responses":{"200":{"description":"Object keyed by ticker. Each value has insiders_percent_held, institutions_percent_held, institutions_float_percent_held (decimals, e.g. 0.66 = 66%) and institutions_count. A ticker with no ownership data returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MajorHoldersResponse"},"example":{"AAPL":{"insiders_percent_held":0.0163,"institutions_percent_held":0.662,"institutions_float_percent_held":0.673,"institutions_count":7104}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-dividends/":{"get":{"summary":"Get Dividends Endpoint","description":"Full dividend payment history for one or more tickers, straight from Yahoo Finance.\n\nReturns a date -> amount-per-share map per ticker (e.g. {\"2026-05-11\": 0.27}), covering\neverything Yahoo holds (decades for large caps). Amounts are in the ticker's own currency\nand are reported exactly as Yahoo publishes them: nothing is summed, annualised, adjusted\nor converted, so no yield or payout ratio is derived here.\n\nWorks for stocks, ETFs and non-US listings (e.g. VUSA.L, RELIANCE.NS). A ticker that has\nnever paid a dividend returns {\"error\": \"...\"} for that ticker while the others still\nreturn data. Max 25 tickers per request.\n\nFor dividends and splits together in one call, use get_actions.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_dividends","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Object keyed by ticker. Each value is a date -> dividend-amount map ('YYYY-MM-DD' -> amount per share, in the ticker's own currency), covering the full history Yahoo Finance holds. Values are passed through verbatim; nothing is summed, annualised or adjusted. A ticker that has never paid a dividend returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{},"example":{"AAPL":{"2025-08-11":0.26,"2025-11-10":0.26,"2026-02-09":0.26,"2026-05-11":0.27}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-splits/":{"get":{"summary":"Get Splits Endpoint","description":"Full stock-split history for one or more tickers, straight from Yahoo Finance.\n\nReturns a date -> ratio map per ticker (e.g. {\"2020-08-31\": 4.0} = a 4-for-1 split on that\ndate), covering everything Yahoo holds. Ratios are reported exactly as Yahoo publishes\nthem; no price adjustment is applied here.\n\nA ticker that has never split returns {\"error\": \"...\"} for that ticker while the others\nstill return data. Max 25 tickers per request.\n\nFor dividends and splits together in one call, use get_actions.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_splits","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Object keyed by ticker. Each value is a date -> split-ratio map ('YYYY-MM-DD' -> ratio, e.g. 4.0 means a 4-for-1 split), covering the full history Yahoo Finance holds. A ticker that has never split returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{},"example":{"AAPL":{"2014-06-09":7.0,"2020-08-31":4.0}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/get-actions/":{"get":{"summary":"Get Actions Endpoint","description":"Corporate actions (dividends AND splits together) for one or more tickers, straight\nfrom Yahoo Finance.\n\nReturns a date -> action-row map per ticker, e.g.\n{\"2026-05-11\": {\"Dividends\": 0.27, \"Stock Splits\": 0.0}}. Values are passed through\nexactly as Yahoo publishes them, with no derived or adjusted figures.\n\nTHE COLUMN SET VARIES BY TICKER: a stock with both has 'Dividends' and 'Stock Splits',\nan ETF that has never split may have only 'Dividends' (e.g. VUSA.L), and a company that\nhas never paid a dividend may have only 'Stock Splits' (e.g. TSLA). Read by key rather\nthan assuming both are present.\n\nA ticker with no corporate actions at all returns {\"error\": \"...\"} for that ticker while\nthe others still return data. Max 25 tickers per request. For one or the other on its\nown, use get_dividends or get_splits.\n\nPart of Tigzig: free interactive tools, open-source repos, APIs and MCP servers for\nanalytics and live data across global and Indian markets, macro indicators and\nfilings. Catalog: https://api.tigzig.com/.well-known/api-catalog\nGuide: https://www.tigzig.com/llms.txt","operationId":"get_actions","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request.","examples":["AAPL,MSFT"],"title":"Tickers"},"description":"Comma-separated Yahoo Finance ticker symbols (e.g. 'AAPL,MSFT'). Max 25 per request."}],"responses":{"200":{"description":"Corporate actions (dividends and splits together). Object keyed by ticker; each value is a date -> action-row map. THE COLUMN SET VARIES BY TICKER and is passed through exactly as Yahoo Finance returns it: a stock with both has 'Dividends' and 'Stock Splits', an ETF that has never split may have only 'Dividends', and a company that has never paid a dividend may have only 'Stock Splits'. Read by key rather than assuming both are present. A ticker with no corporate actions returns {\"<TICKER>\": {\"error\": \"...\"}}.","content":{"application/json":{"schema":{},"example":{"AAPL":{"2025-11-10":{"Dividends":0.26,"Stock Splits":0.0},"2026-05-11":{"Dividends":0.27,"Stock Splits":0.0}},"VUSA.L":{"2026-06-18":{"Dividends":0.244174}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AnalystTargetsResponse":{"additionalProperties":{"$ref":"#/components/schemas/AnalystTargetsValue"},"type":"object","title":"AnalystTargetsResponse","description":"Keyed by ticker; each value is an AnalystTargetsValue. A ticker with no\nanalyst coverage (commodity / crypto / index) returns {\"error\": \"...\"}."},"AnalystTargetsValue":{"properties":{"current":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current"},"high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"High"},"low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Low"},"mean":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean"},"median":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median"}},"type":"object","title":"AnalystTargetsValue"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MajorHoldersResponse":{"additionalProperties":{"$ref":"#/components/schemas/MajorHoldersValue"},"type":"object","title":"MajorHoldersResponse","description":"Keyed by ticker; each value is a MajorHoldersValue. A ticker with no\nownership data returns {\"error\": \"...\"}."},"MajorHoldersValue":{"properties":{"insiders_percent_held":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Insiders Percent Held"},"institutions_percent_held":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Institutions Percent Held"},"institutions_float_percent_held":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Institutions Float Percent Held"},"institutions_count":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Institutions Count"}},"type":"object","title":"MajorHoldersValue"},"MarketDataResponse":{"additionalProperties":{"$ref":"#/components/schemas/MarketDataValue"},"type":"object","title":"MarketDataResponse","description":"JSON object keyed by ticker symbol; each value is a MarketDataValue."},"MarketDataValue":{"properties":{"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Market Cap"},"free_float":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Free Float"},"total_shares_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Shares Outstanding"}},"type":"object","title":"MarketDataValue"},"StatementResponse":{"additionalProperties":{"$ref":"#/components/schemas/StatementValue"},"type":"object","title":"StatementResponse","description":"JSON object keyed by ticker; each value is a StatementValue. A ticker with\nno data returns {\"<TICKER>\": {\"error\": \"<message>\"}} instead of dates/data."},"StatementValue":{"properties":{"dates":{"items":{"type":"string"},"type":"array","title":"Dates"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"}},"type":"object","required":["dates","data"],"title":"StatementValue"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}