面向 AI Agent 的最佳Financial Datasets 替代方案

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

def envelope(provider, endpoint, raw, rows):
    stable = json.dumps(raw, sort_keys=True, separators=(",", ":"))
    return {
        "provider": provider,
        "endpoint": endpoint,
        "retrievedAt": datetime.now(timezone.utc).isoformat(),
        "rawSha256": hashlib.sha256(stable.encode()).hexdigest(),
        "rows": rows,
        "raw": raw,
    }

def financial_datasets_income(ticker):
    endpoint = "https://api.financialdatasets.ai/financials/income-statements"
    response = requests.get(
        endpoint,
        headers={"X-API-KEY": os.environ["FINANCIAL_DATASETS_API_KEY"]},
        params={"ticker": ticker, "period": "annual", "limit": 4},
        timeout=30,
    )
    response.raise_for_status()
    raw = response.json()
    rows = [{
        "ticker": ticker,
        "reportPeriod": item.get("report_period"),
        "fiscalPeriod": item.get("fiscal_period"),
        "currency": item.get("currency"),
        "revenue": item.get("revenue"),
        "netIncome": item.get("net_income"),
    } for item in raw.get("income_statements", [])]
    return envelope("financial-datasets", endpoint, raw, rows)

def fmp_income(ticker):
    endpoint = "https://financialmodelingprep.com/stable/income-statement"
    response = requests.get(
        endpoint,
        headers={"apikey": os.environ["FMP_API_KEY"]},
        params={"symbol": ticker, "limit": 4},
        timeout=30,
    )
    response.raise_for_status()
    raw = response.json()
    rows = [{
        "ticker": item.get("symbol", ticker),
        "reportPeriod": item.get("date"),
        "fiscalPeriod": item.get("period"),
        "currency": item.get("reportedCurrency"),
        "revenue": item.get("revenue"),
        "netIncome": item.get("netIncome"),
    } for item in raw]
    return envelope("financial-modeling-prep", endpoint, raw, rows)