FMP Stock Price API: Quotes, History & Examples

curl --fail --silent --show-error \
  --get "https://financialmodelingprep.com/stable/quote" \
  --data-urlencode "symbol=AAPL" \
  --header "apikey: $FMP_API_KEY"

import os, time, requests

def get_quote(symbol: str) -> dict:
    response = requests.get(
        "https://financialmodelingprep.com/stable/quote",
        params={"symbol": symbol.upper()},
        headers={"apikey": os.environ["FMP_API_KEY"]},
        timeout=8,
    )
    response.raise_for_status()
    rows = response.json()
    if not isinstance(rows, list) or not rows:
        raise ValueError(f"No FMP quote returned for {symbol}")

    quote = rows[0]
    price = float(quote["price"])
    event_time = int(quote["timestamp"])
    if price <= 0 or time.time() - event_time > 20 * 60:
        raise ValueError("Invalid or unexpectedly stale quote")

    return {
        "symbol": quote["symbol"],
        "price": price,
        "currency": quote.get("currency"),
        "volume": quote.get("volume"),
        "eventTime": event_time,
        "retrievedAt": int(time.time()),
        "source": "fmp",
    }

type Price = {
  symbol: string; price: number; volume?: number;
  eventTime: number; retrievedAt: number; source: "fmp";
};

export async function getQuote(symbol: string): Promise<Price> {
  const key = process.env.FMP_API_KEY;
  if (!key) throw new Error("FMP_API_KEY is missing");

  const url = new URL("https://financialmodelingprep.com/stable/quote");
  url.searchParams.set("symbol", symbol.toUpperCase());
  const response = await fetch(url, {
    headers: { apikey: key },
    signal: AbortSignal.timeout(8_000),
  });
  if (!response.ok) throw new Error(\`FMP returned \${response.status}\`);

  const rows: unknown = await response.json();
  if (!Array.isArray(rows) || !rows.length) {
    throw new Error(\`No quote returned for \${symbol}\`);
  }
  const q = rows[0] as Record<string, unknown>;
  if (!Number.isFinite(Number(q.price)) || !Number.isFinite(Number(q.timestamp))) {
    throw new Error("Invalid quote payload");
  }
  return {
    symbol: String(q.symbol),
    price: Number(q.price),
    volume: q.volume == null ? undefined : Number(q.volume),
    eventTime: Number(q.timestamp),
    retrievedAt: Math.floor(Date.now() / 1000),
    source: "fmp",
  };
}