FMP Stock Market API
Data, Limits & Production CodeFMP 股票市场 API
数据、限制与生产代码

TL;DR

Before choosing FMP, compare it with seven alternatives in the free stock API comparison.

选择 FMP 前，可在免费股票 API 对比中把它与另外七种方案并列评估。

Who this FMP API review is for这份 FMP API 评估适合谁

Start with the current Stable API contract先从当前 Stable API 契约开始

FMP's current Quickstart documents https://financialmodelingprep.com/stable/ as the base URL. It lists API-key authentication, more than 100 endpoints, and common 403, 429, and 500 responses. Put the base URL, authentication mode, timeout, and plan limits in configuration instead of scattering them across notebooks and prompts.

FMP 当前 Quickstart 将 https://financialmodelingprep.com/stable/ 作为 Base URL，并说明 API Key 认证、100 多个 Endpoint，以及常见的 403、429、500。应把 Base URL、认证方式、Timeout 与套餐限制放进配置，而不是散落在 Notebook 与 Prompt 中。

FMP stock market API coverage mapFMP 股票市场 API 数据覆盖图

The useful unit is not “an endpoint.” It is a dataset with an identity, field contract, update cycle, adjustment policy, geography, history window, and permitted use.

Free tier, paid limits, and licensing reality免费层、付费限制与许可现实

FMP's public pricing page currently separates personal and commercial use and lists different call rates, history, coverage, bandwidth, and datasets by plan. Prices and packages can change, so this page does not hard-code a procurement quote. Capture the values on the day you evaluate and attach the applicable agreement.

FMP 当前公开 Pricing 页面区分 Personal 与 Commercial Use，并按套餐列出不同的调用频率、历史范围、地区覆盖、带宽与数据集。价格与包装会变化，所以本文不把价格写成长期采购报价；评估当天应保存实际数值和适用协议。

Code: call the FMP Stable API with cURL代码：用 cURL 调用 FMP Stable API

Use an environment variable and avoid exposing the key in shell history or screenshots. FMP documents both header and query-parameter authorization; a header keeps secrets out of the URL.

curl --fail-with-body \
  --connect-timeout 5 \
  --max-time 30 \
  -H "apikey: ${FMP_API_KEY}" \
  "https://financialmodelingprep.com/stable/historical-price-eod/full?symbol=AAPL"

使用环境变量，并避免在 Shell History 或截图中暴露 Key。FMP 文档支持 Header 与 Query Parameter 认证；使用 Header 可以避免 Secret 进入 URL。

Python: retry, normalize, and preserve evidencePython：重试、标准化并保存证据

A production adapter should return a provider-neutral record and an evidence envelope. The example retries only transient failures, respects a deadline, records retrieval time, and keeps the raw response hash without placing the API key in logs.

import hashlib, json, os, random, time
from datetime import datetime, timezone
import requests

BASE_URL = "https://financialmodelingprep.com/stable"
API_KEY = os.environ["FMP_API_KEY"]

def get_eod(symbol: str, attempts: int = 4) -> dict:
    url = f"{BASE_URL}/historical-price-eod/full"
    headers = {"apikey": API_KEY}
    params = {"symbol": symbol}

    for attempt in range(attempts):
        response = requests.get(
            url, headers=headers, params=params, timeout=(5, 25)
        )
        if response.status_code == 403:
            raise RuntimeError("FMP authentication or entitlement rejected")
        if response.status_code not in {429, 500, 502, 503, 504}:
            response.raise_for_status()
            break
        if attempt == attempts - 1:
            response.raise_for_status()
        time.sleep(min(8, 0.5 * (2 ** attempt)) + random.random() / 4)

    raw = response.content
    rows = response.json()
    normalized = [{
        "symbol": symbol,
        "date": row["date"],
        "open": row["open"],
        "high": row["high"],
        "low": row["low"],
        "close": row["close"],
        "volume": row["volume"],
        "provider": "fmp",
        "dataset": "historical_price_eod_full",
    } for row in rows]

    return {
        "records": normalized,
        "evidence": {
            "retrieved_at": datetime.now(timezone.utc).isoformat(),
            "request": {"endpoint": "/historical-price-eod/full", "symbol": symbol},
            "status": response.status_code,
            "sha256": hashlib.sha256(raw).hexdigest(),
        },
    }

Adjusted prices, timestamps, and point-in-time truth复权价格、时间戳与 Point-in-time 真相

FMP exposes full, non-split-adjusted, and dividend-adjusted historical price endpoints. These series answer different questions. Record the endpoint and adjustment mode with every dataset; never silently join adjusted closes to unadjusted highs and lows.

FMP 提供 Full、Non-split-adjusted 与 Dividend-adjusted 历史价格 Endpoint，它们回答不同问题。每个数据集都要记录 Endpoint 与复权模式，不能把复权 Close 与未复权 High/Low 静默拼接。

• Store event time, provider source time, retrieval time, and processing time separately.
• Test pre-market, regular, after-hours, weekend, holiday, and daylight-saving boundaries.
• Detect duplicates, reversed ranges, negative volume, missing sessions, and impossible OHLC relationships.
• Pin a dataset version or raw-response hash so an agent answer can be reproduced.

• 分别保存事件时间、供应商来源时间、检索时间和处理时间。
• 测试盘前、常规交易、盘后、周末、节假日与夏令时边界。
• 检测重复、区间反转、负成交量、缺失交易日与不可能的 OHLC 关系。
• 保存 Dataset Version 或原始响应 Hash，使 Agent 答案可复现。

A data-quality acceptance contract数据质量验收契约

dataset: fmp_historical_eod
symbols: 100
window: 2025-01-01..2026-06-30
contract:
  required_fields: [symbol, date, open, high, low, close, volume]
  adjustment_mode: documented
  currency_and_exchange: resolved
  duplicate_keys: 0
  impossible_ohlc_rows: 0
  missing_expected_sessions_pct: "<= 0.25"
  stale_quote_rate_pct: "<= 0.50"
  p95_latency_ms: "<= 2500"
  unsafe_secret_logs: 0
evidence:
  raw_hash: required
  retrieved_at: required
  provider_endpoint: required
  validation_result: required

Set thresholds from your workload and market calendar; the numbers above are examples, not universal guarantees. Release only after replaying a frozen symbol/date set and reconciling a sample against an authoritative source.

阈值应根据工作负载与交易日历确定；上面的数字只是示例，不是通用保证。上线前必须重放冻结的 Symbol/Date 样本，并抽样与权威来源核对。

Production architecture for FMP dataFMP 数据的生产架构

Troubleshooting FMP API failures排查 FMP API 故障

Compare FMP with one shared workload用一个统一任务比较 FMP

Do not compare providers with different symbols, dates, plans, caches, and acceptance rules. Replay the same frozen workload and score accepted datasets.

Migration checklist for endpoint or provider changesEndpoint 或供应商变更的迁移清单

• Inventory every endpoint, caller, key location, quota, cache key, schema, adjustment assumption, and downstream consumer.
• Freeze representative responses and expected normalized records before changing the adapter.
• Run old and new paths in read-only shadow mode; compare values, dates, missing rates, latency, and cost.
• Canary one low-risk dataset, preserve rollback, and block writes or agent conclusions when evidence is incomplete.
• Update runbooks, dashboards, licensing records, secret rotation, and data-retention controls before cutover.

• 盘点所有 Endpoint、Caller、Key 位置、Quota、Cache Key、Schema、复权假设与下游消费者。
• 修改 Adapter 前冻结代表性响应与预期标准化记录。
• 以只读 Shadow 模式并行运行新旧路径，对比数值、日期、缺失率、延迟与成本。
• 先对一个低风险 Dataset 做 Canary，保留回滚；证据不完整时阻止写入或 Agent 结论。
• 切换前更新 Runbook、Dashboard、许可记录、Secret Rotation 与数据保留控制。

QVeris pattern: discover, inspect, call, then validateQVeris 模式：发现、检查、调用，然后验证

QVeris fits when an existing agent needs a capability layer rather than a hard-coded provider endpoint. The agent can discover a financial capability by intent, inspect parameters and operational signals, call the selected capability, then feed only validated evidence into reasoning.

当现有 Agent 需要能力层，而不是硬编码供应商 Endpoint 时，QVeris 更合适。Agent 可按意图发现金融能力，检查参数与运行信号，调用所选能力，再把通过验证的证据交给模型推理。

FMP stock market API FAQFMP 股票市场 API 常见问题

Official sources and update policy官方资料与更新策略

Endpoint, pricing, freshness, and licensing claims were checked against official sources on July 31, 2026. Recheck the current plan and agreement before procurement or release.

Endpoint、价格、更新频率与许可信息于 2026 年 7 月 31 日根据官方资料核验。采购或上线前应重新检查当前套餐与协议。