面向 AI Agent 的最佳财报 API

curl --get "https://financialmodelingprep.com/stable/earnings-calendar" \
  --header "apikey: YOUR_API_KEY" \
  --data-urlencode "from=2026-07-27" \
  --data-urlencode "to=2026-07-31"

import hashlib
import json
import os
from datetime import datetime, timezone
from decimal import Decimal, InvalidOperation
import requests

BASE = "https://financialmodelingprep.com/stable"
HEADERS = {"apikey": os.environ["FMP_API_KEY"]}

response = requests.get(
    f"{BASE}/earnings-calendar",
    headers=HEADERS,
    params={"from": "2026-07-27", "to": "2026-07-31"},
    timeout=30,
)
response.raise_for_status()
records = response.json()

def number(value):
    if value is None or value == "":
        return None
    try:
        return Decimal(str(value))
    except InvalidOperation:
        return None

def surprise(actual, estimate):
    actual, estimate = number(actual), number(estimate)
    if actual is None or estimate is None or estimate == 0:
        return {"difference": None, "percent": None}
    return {
        "difference": str(actual - estimate),
        "percent": str((actual - estimate) / abs(estimate) * 100),
    }

normalized = []
for row in records:
    actual = row.get("epsActual")
    estimate = row.get("epsEstimated") or row.get("epsEstimate")
    raw = json.dumps(row, sort_keys=True, separators=(",", ":"))
    normalized.append({
        "symbol": row.get("symbol"),
        "reportDate": row.get("date"),
        "fiscalDateEnding": row.get("fiscalDateEnding"),
        "epsActual": actual,
        "epsEstimate": estimate,
        "revenueActual": row.get("revenueActual"),
        "revenueEstimate": row.get("revenueEstimated"),
        "surprise": surprise(actual, estimate),
        "provider": "financial-modeling-prep",
        "retrievedAt": datetime.now(timezone.utc).isoformat(),
        "rawSha256": hashlib.sha256(raw.encode()).hexdigest(),
        "raw": row,
    })