FMP 股票市场 API

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"

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(),
        },
    }

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