Financial Modeling Prep API

FMP provides deep fundamental data — financial statements, ratios, insider trades — alongside market quotes. Popular for screening and valuation work.

Key endpoints

Endpoint	Description
GET /quote	Real-time quote
GET /income-statement	Income statements (annual/quarterly)
GET /balance-sheet-statement	Balance sheets
GET /cash-flow-statement	Cash flow statements
GET /ratios	Financial ratios (P/E, ROE, etc.)
GET /key-metrics	Key metrics per share
GET /insider-trading	Insider transactions
GET /stock-dividend	Dividend history
GET /analyst-estimates	Consensus estimates
GET /etf-holder	ETF holdings

Python example: income statement

import httpx

API_KEY = "your_fmp_key"
BASE = "https://financialmodelingprep.com/stable"

def get_income_statement(symbol: str, period: str = "annual", limit: int = 5) -> list[dict]:
    """Annual or quarterly income statements."""
    resp = httpx.get(
        f"{BASE}/income-statement",
        params={"symbol": symbol, "period": period, "limit": limit, "apikey": API_KEY},
        timeout=15,
    )
    resp.raise_for_status()
    return resp.json()

# Example
stmts = get_income_statement("AAPL", period="annual", limit=3)
for s in stmts:
    print(f"{s['date']}: revenue ${s['revenue']:,}, net income ${s['netIncome']:,}")

Python example: key ratios

def get_ratios(symbol: str, limit: int = 5) -> list[dict]:
    """Financial ratios (P/E, ROE, debt/equity, etc.)."""
    resp = httpx.get(f"{BASE}/ratios", params={"symbol": symbol, "limit": limit, "apikey": API_KEY}, timeout=15)
    resp.raise_for_status()
    return resp.json()

# Example
ratios = get_ratios("AAPL", limit=1)
r = ratios[0]
print(f"P/E: {r['peRatio']:.1f}, ROE: {r['returnOnEquity']:.1%}, Div yield: {r['dividendYield']:.1%}")

Python example: dividend history

def get_dividends(symbol: str, limit: int = 10) -> list[dict]:
    """Dividend payment history. Useful for dividend investors."""
    resp = httpx.get(f"{BASE}/stock-dividend", params={"symbol": symbol, "limit": limit, "apikey": API_KEY}, timeout=15)
    resp.raise_for_status()
    return resp.json()

# Example
divs = get_dividends("AAPL", limit=4)
for d in divs:
    print(f"{d['date']}: ${d['dividend']} (yield: {d.get('yield', 'N/A')})")

Python example: insider trading

def get_insider_trades(symbol: str, limit: int = 10) -> list[dict]:
    """Recent insider transactions."""
    resp = httpx.get(f"{BASE}/insider-trading", params={"symbol": symbol, "limit": limit, "apikey": API_KEY}, timeout=15)
    resp.raise_for_status()
    return resp.json()

Notes:

• Use /stable base URL; /api/v3 is legacy
• Auth supports an apikey request header or query parameter
• 100+ endpoints: statements, ratios, insider trades, ETF holdings, economic calendar
• WebSocket: wss://websockets.financialmodelingprep.com — login with API key, then subscribe