market_data
Retrieve raw financial data such as historical prices, financial statements, quotes, company profiles, and transcripts for any ticker to power your own analysis.
Instructions
Raw financial data (historical prices, income statement, balance sheet, cash flow statement, company profile, quotes, analyst estimates, dividend/earnings calendars, statistics, market risk premium by country, CFTC Commitment of Traders report, executives and their compensation, company notes, employee count, share float, mergers and acquisitions, stock splits, insider trade statistics, analyst stock grades, earnings call transcripts). Use this ONLY for raw data needs — for pre-computed ratios, performance, risk, or model metrics use the dedicated tools instead. Requires tickers='AAPL' — use comma-separated values for multiple tickers. get_market_risk_premium (by country) and get_treasury_data (US Treasury rates) are market-wide and need no tickers. get_commitment_of_traders takes CFTC futures symbols, e.g. tickers='NG' (natural gas) or 'GC' (gold), not stocks. get_earnings_call_transcripts returns the full, never shortened text (often 40,000 to 60,000 characters) of one call of one ticker: the most recent, or the one of fiscal_period (e.g. '2025Q4', the company's own fiscal quarter); call it once per ticker and period. A period without a transcript is answered with the most recent periods that have one. Currency and crypto pairs may be written either way: EURUSD or EURUSD=X, BTCUSD or BTC-USD. To find which instruments exist, use the Finance Database server. The holdings, information and sector and country weightings of ETFs and funds are in the etf tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lag | No | Number of periods to lag when computing growth rates. | |
| limit | No | The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. | |
| growth | No | Return period-over-period growth rates instead of absolute values. | |
| latest | No | Whether to only retrieve the most recent transcript. When False, every transcript between the start_date and end_date is retrieved. | |
| period | No | Observation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method). Leave unset to use the default of the indicator you selected. Defaults are 'daily' for get_historical_data, get_treasury_data; '1hour' for get_intraday_data. | |
| tickers | No | Comma-separated ticker symbols, e.g. 'AAPL,MSFT,GOOGL'. | |
| end_date | No | End of the date range in YYYY-MM-DD format. | 2026-10-27 |
| fill_nan | No | For get_historical_data, get_treasury_data: Defines whether to forward fill NaN values. This defaults to True to prevent holes in the dataset. This is especially relevant for technical indicators. For get_intraday_data: Defines whether to forward fill NaN values. | |
| trailing | No | Trailing window size in number of periods. Sums the raw values over the trailing N periods (e.g. trailing=4 on quarterly data gives a trailing-4-quarter / TTM-style sum) instead of returning one value per period. | |
| indicator | Yes | Name of the specific metric to calculate, one of the listed values. Required — search_metrics finds the indicator (and its tool) for a metric by name. | |
| quarterly | No | Return quarterly data instead of annual when True. | |
| start_date | No | Start of the date range in YYYY-MM-DD format. | 2021-10-28 |
| show_errors | No | Whether to report retrieval errors. | |
| actual_dates | No | Defines whether to return the actual dates or the corresponding quarters. | |
| show_columns | No | Comma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage. | |
| fiscal_period | No | The company's fiscal quarter, e.g. '2025Q4' (its own fiscal year, which differs from the calendar year for e.g. Apple and Microsoft). Leave unset for the most recent. | |
| return_column | No | The column to use for the return calculation. Leave unset to use the default of the indicator you selected. Defaults are 'Adj Close' for get_historical_data; 'Close' for get_intraday_data. | |
| divide_ohlc_by | No | A value to divide the yields by. Treasury yields are published in percent, so this defaults to 100 to return decimals. | |
| enforce_source | No | For get_balance_sheet_statement, get_cash_flow_statement, get_income_statement, get_statistics_statement: Forces this specific call to use a given source, either "FinancialModelingPrep" or "YahooFinance". This takes precedence over the source set on the Toolkit itself, so one instance can pull historical data from the free Yahoo Finance source while still using a FinancialModelingPrep key for the... For get_historical_data: A string containing the historical source you wish to enforce. This can be either FinancialModelingPrep or YahooFinance. For get_treasury_data: Forces this specific call to use a given source, either "FinancialModelingPrep" or "YahooFinance". This takes precedence over the source set on the Toolkit itself. | |
| risk_free_rate | No | One maturity to return ('13w', '5y', '10y' or '30y'). The Toolkit's own risk free rate stays the maturity set on the Toolkit either way. | |
| benchmark_ticker | No | Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'. | SPY |
| include_dividends | No | Defines whether to include dividends in the return calculation. | |
| show_ticker_seperation | No | A boolean representing whether to show which tickers acquired data from FinancialModelingPrep and which tickers acquired data from YahooFinance. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |