fmp_fetch
Fetch financial data from any registered FMP endpoint, including income statements, balance sheets, stock prices, earnings calls, and SEC filings.
Instructions
Fetch data from any registered FMP endpoint.
This is the primary data fetching tool. Use fmp_list_endpoints to discover available endpoints, and fmp_describe to see required parameters.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filing type filter (for sec_filings endpoint, e.g., "10-K", "10-Q"). | |
| year | No | Fiscal year (for earnings_transcript endpoint). | |
| limit | No | Maximum number of records to return. | |
| query | No | Search query (for search endpoint). | |
| output | No | Output mode: inline records or CSV file path. | inline |
| period | No | Reporting period for financial statements ("annual" or "quarter"). | |
| symbol | No | Stock symbol (e.g., "AAPL", "MSFT"). Required for most endpoints. | |
| columns | No | Optional columns filter as JSON array or comma-separated string. | |
| quarter | No | Quarter 1-4 (for earnings_transcript endpoint). | |
| to_date | No | End date for price/rate data (YYYY-MM-DD format). | |
| endpoint | Yes | Name of the FMP endpoint. Common endpoints: - income_statement: Income statement data. `date` is period-end/as-of date. - balance_sheet: Balance sheet data. `date` is period-end/as-of date. - cash_flow: Cash flow statement data. `date` is period-end/as-of date. - key_metrics: Financial ratios and metrics. `date` is period-end/as-of date; `marketCap` is period-aligned, not current. - key_metrics_ttm: TTM metrics; FMP does not surface a period-end column. - historical_price_eod: Raw end-of-day prices and FX pair closes. For historical FX, use symbols such as USDTWD with from_date/to_date, then label basis as management_guidance_fx_assumption when guidance provides the FX rate or fmp_historical_fx_exact_date / fmp_historical_fx_previous_close when using FMP daily closes. - historical_price_adjusted: Adjusted stock prices - dividends: Dividend history - analyst_estimates: Analyst EPS/revenue estimates - price_target: Analyst price targets - earnings_transcript: Earnings call transcripts - sec_filings: SEC filing metadata | |
| from_date | No | Start date for price/rate data (YYYY-MM-DD format). | |
| use_cache | No | Whether to use cached data (default: True). Set False for fresh data. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||