# Financial Modeling Prep

> Get stock quotes, company profiles, financial statements, ratios, historical prices, and market news with the Financial Modeling Prep API.

Lets an agent pull stock-market and company-fundamentals data from Financial Modeling Prep (FMP): real-time quotes, company profiles, the three financial statements, key metrics and ratios, historical daily prices, symbol search, and market news.

## What it can do

| Method | What it does |
| --- | --- |
| `fmp_quote` | Real-time quote(s) for one ticker or a comma-separated list. |
| `fmp_profile` | Company profile - sector, industry, description, CEO, market cap. |
| `fmp_income_statement` | Income statement by period (annual/quarter). |
| `fmp_balance_sheet` | Balance sheet statement by period. |
| `fmp_cash_flow` | Cash flow statement by period. |
| `fmp_key_metrics` | Per-period valuation and efficiency metrics. |
| `fmp_ratios` | Liquidity, profitability, leverage and valuation ratios. |
| `fmp_historical_price` | Daily OHLCV history, optionally bounded by date. |
| `fmp_search` | Search symbols / companies by name or ticker. |
| `fmp_stock_news` | Recent market news, optionally filtered by tickers. |
| `fmp_request` | Generic passthrough to any endpoint for full coverage. |

## How to get your key

The API authenticates with an `apikey` query parameter on every request.

1. Sign in at [Financial Modeling Prep](https://site.financialmodelingprep.com/).
2. Open the [Developer Docs](https://site.financialmodelingprep.com/developer/docs) and go to your **Dashboard**.
3. Copy your API key (a free tier is available).
4. Paste it into FlyMyAI.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `FMP_API_KEY` | Financial Modeling Prep -> Developer Docs -> Dashboard |

## Troubleshooting

- **`401 Unauthorized` / `Invalid API KEY`** - the key is wrong or missing. Re-copy it from your dashboard.
- **`403 Forbidden` / endpoint not in your plan** - the endpoint requires a paid tier. Upgrade or use a covered endpoint.
- **`429 Too Many Requests`** - you hit your plan's rate or daily limit. Wait for the reset or upgrade.
- **Empty result for a ticker** - check the symbol (use the exchange-listed ticker, e.g. `AAPL`); some symbols need an exchange suffix.

## Links

- [Financial Modeling Prep dashboard / API key](https://site.financialmodelingprep.com/developer/docs)
- [Financial Modeling Prep API documentation](https://site.financialmodelingprep.com/developer/docs)
