{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/":{"get":{"summary":"Root","description":"Root endpoint - minimal response.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/get-income-statement/":{"get":{"summary":"Get Income Statement Endpoint","operationId":"get_income_statement_endpoint_get_income_statement__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","title":"Tickers"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-cash-flow/":{"get":{"summary":"Get Cash Flow Endpoint","operationId":"get_cash_flow_endpoint_get_cash_flow__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","title":"Tickers"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-quarterly-income-statement/":{"get":{"summary":"Get Quarterly Income Statement Endpoint","operationId":"get_quarterly_income_statement_endpoint_get_quarterly_income_statement__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","title":"Tickers"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-quarterly-cash-flow/":{"get":{"summary":"Get Quarterly Cash Flow Endpoint","operationId":"get_quarterly_cash_flow_endpoint_get_quarterly_cash_flow__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","title":"Tickers"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-balance-sheet/":{"get":{"summary":"Get Balance Sheet Endpoint","operationId":"get_balance_sheet_endpoint_get_balance_sheet__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","title":"Tickers"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-adj-close/":{"get":{"summary":"Get Adj Close Endpoint","operationId":"get_adj_close_endpoint_get_adj_close__get","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","title":"Tickers"}},{"name":"start_date","in":"query","required":true,"schema":{"type":"string","title":"Start Date"}},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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","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')","title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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.","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')","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')","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')","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":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-detailed-info/":{"get":{"summary":"Get Detailed Info Endpoint","description":"Retrieves comprehensive company information and data points from Yahoo Finance.\n\nNote: This endpoint may take 30 seconds to 3 minutes to respond due to the extensive data being fetched.\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\nResponse time: Expect 30 seconds to 3 minutes depending on the number of tickers and data availability.","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')","title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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","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')","title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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","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')","title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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","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')","title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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","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')","title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/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","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')","title":"Tickers"},"description":"Comma-separated list of Yahoo Finance ticker symbols (e.g., 'AAPL,MSFT,GOOG')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}}}