FMP Stock Price API: Quotes, History & Examples FMP 股票价格 API：报价、历史数据与代码示例

The shortest correct implementation最短的正确实现路径

Pick the endpoint from the job, not the name根据任务选端点，不要只看名字

“Stock price” can mean a latest snapshot, a compact watchlist refresh, daily candles or minute bars. Those are different payloads with different cost and freshness profiles.

“股票价格”可能指最新快照、关注列表的轻量刷新、日线或分钟线。它们的字段、调用成本和时效要求都不同。

“Real time” is not a single guarantee“实时”并不是一个统一承诺

Exchange entitlement, endpoint, plan and market session determine whether a value is real time, delayed, after-market or end of day. Your UI should never infer freshness from the word “quote.”

交易所授权、端点、套餐和交易时段共同决定数据是实时、延迟、盘后还是日终。界面不能因为接口叫 “quote” 就假设它一定实时。

Call the FMP quote API safely安全调用 FMP Quote API

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",
  };
}

Normalize a price into evidence把价格标准化为可验证证据

Do not pass the provider payload through your entire application. Create a small internal contract and retain the raw response for debugging or audit where policy permits.

不要让供应商的原始响应贯穿整个应用。建立一个小而稳定的内部契约，并在政策允许时保留原始响应以便排错或审计。

Choose adjustment before you calculate计算之前先确定复权口径

FMP documents full and light end-of-day history, plus non-split-adjusted and dividend-adjusted variants. The right series depends on the question.

FMP 提供完整与轻量日终历史，同时有不做拆股复权和股息复权的版本。应根据分析问题选择序列。

Production controls that matter真正重要的生产控制

Validation checklist上线前验证清单

• API key is absent from browser bundles, URLs, analytics and application logs.API Key 未出现在浏览器包、URL、分析系统或应用日志中。
• A valid symbol returns a non-empty array and the expected symbol.有效代码返回非空数组，且代码与请求一致。
• An invalid symbol, expired key, timeout and 429 all follow tested error paths.无效代码、过期密钥、超时与 429 都有经过测试的错误路径。
• Freshness thresholds account for weekends, holidays and extended sessions.新鲜度阈值考虑周末、节假日与盘前盘后。
• Historical tests cover a known split or dividend and document adjustment behavior.历史测试覆盖一个已知拆股或分红事件，并记录复权行为。
• Displayed or redistributed data complies with the applicable FMP license.展示或再分发数据符合适用的 FMP 许可条款。

Common failure modes常见失败模式

Use a capability layer when the workflow must choose当工作流需要“选择能力”时，再引入能力层

A direct FMP call is appropriate when the provider and schema are fixed. QVeris becomes useful when an agent must discover an available capability, inspect its current input contract, invoke it consistently, preserve evidence or fall back across providers.

当供应商和数据结构固定时，直接调用 FMP 很合适。当 Agent 需要发现可用能力、检查当前输入契约、统一调用、保存证据或跨供应商降级时，QVeris 才更有价值。

Read the QVeris documentation →查看 QVeris 文档 →

Match the plan to frequency and history根据频率与历史深度选择套餐

FMP pricing changes. As verified on July 30, 2026, the published plans list: Free at 250 calls/day; Starter at $22/month billed annually and 300 calls/minute; Premium at $59/month and 750 calls/minute; Ultimate at $149/month and 3,000 calls/minute. Intraday depth, global coverage, batch access and bandwidth also vary.

FMP 定价会变化。截至 2026 年 7 月 30 日，公开套餐为：免费版每天 250 次；Starter 按年付折算每月 22 美元、每分钟 300 次；Premium 每月 59 美元、每分钟 750 次；Ultimate 每月 149 美元、每分钟 3,000 次。盘中历史深度、全球覆盖、批量权限和带宽也不同。

Check current FMP pricing and licensing →查看 FMP 最新定价与许可 →

FMP stock price API questionsFMP 股票价格 API 常见问题

Verify against the live documentation以最新官方文档为准

• FMP Stable Stock Quote API
• FMP Batch Quote API
• FMP Historical Price EOD Full API
• FMP 1-Minute Intraday Chart API
• FMP Pricing and Licensing

Continue from price data从价格数据继续深入