aria-code 0.167.0__py3-none-win_amd64.whl

aria_code/datasources/sources/akshare_source.py

@@ -0,0 +1,269 @@
+"""
+datasources/sources/akshare_source.py — Akshare A股数据源
+==========================================================
+免费，无需 API key，覆盖 A股实时行情、历史数据、北向资金等。
+"""
+
+from __future__ import annotations
+
+import logging
+from datetime import date, timedelta
+from typing import Any, Dict, Optional
+
+from ..base import BaseDataSource, FundamentalsResult, HistoryResult, QuoteResult
+
+logger = logging.getLogger(__name__)
+
+
+class AkshareSource(BaseDataSource):
+
+    name         = "akshare"
+    markets      = ["a_share"]
+    requires_key = False
+
+    def _normalize_code(self, symbol: str) -> str:
+        """'sh600519' / '600519' / '600519.SH' → '600519'"""
+        s = symbol.upper().replace("SH", "").replace("SZ", "").replace("BJ", "")
+        s = s.replace(".", "").strip()
+        if s.startswith("6") or s.startswith("0") or s.startswith("3") or s.startswith("8"):
+            return s[:6]
+        return s
+
+    def _yf_symbol(self, code: str) -> str:
+        """600519 → 600519.SS，000858 → 000858.SZ，300xxx → 300xxx.SZ"""
+        if code.startswith("6") or code.startswith("9"):
+            return f"{code}.SS"
+        return f"{code}.SZ"
+
+    def quote(self, symbol: str) -> Optional[QuoteResult]:
+        """
+        三级降级:
+        1. akshare stock_zh_a_spot_em (全市场快照)
+        2. akshare stock_individual_info_em (单股)
+        3. yfinance .SS/.SZ (国际用户兜底)
+        4. 最近交易日收盘价 from history
+        """
+        import warnings
+        warnings.filterwarnings("ignore")
+        code = self._normalize_code(symbol)
+
+        # ── 方法1: 全市场快照 ────────────────────────────────────────────────
+        try:
+            import akshare as ak
+            df = ak.stock_zh_a_spot_em()
+            row = df[df["代码"] == code]
+            if not row.empty:
+                r = row.iloc[0]
+                price = float(r.get("最新价", 0) or 0)
+                if price > 0:
+                    return QuoteResult(
+                        symbol     = symbol,
+                        name       = str(r.get("名称", "")),
+                        price      = price,
+                        change     = float(r.get("涨跌额",   0) or 0),
+                        change_pct = float(r.get("涨跌幅",   0) or 0),
+                        volume     = float(r.get("成交量",   0) or 0),
+                        market_cap = float(r.get("总市值",   0) or 0),
+                        pe_ttm     = float(r.get("市盈率-动态", 0) or 0),
+                        pb         = float(r.get("市净率",   0) or 0),
+                        high_52w   = float(r.get("52周最高", 0) or 0),
+                        low_52w    = float(r.get("52周最低", 0) or 0),
+                        currency   = "CNY",
+                        market     = "a_share",
+                        source     = self.name,
+                    )
+        except Exception:
+            pass
+
+        # ── 方法2: 单股信息（EastMoney 单接口） ────────────────────────────
+        try:
+            import akshare as ak
+            df2 = ak.stock_individual_info_em(symbol=code)
+            if df2 is not None and not df2.empty:
+                info = dict(zip(df2["item"], df2["value"]))
+                price = float(str(info.get("最新", info.get("收盘", 0))).replace(",", "") or 0)
+                prev  = float(str(info.get("昨收", price)).replace(",", "") or price)
+                if price > 0:
+                    return QuoteResult(
+                        symbol     = symbol,
+                        name       = str(info.get("股票简称", "")),
+                        price      = price,
+                        change     = round(price - prev, 4),
+                        change_pct = round((price - prev) / prev * 100, 2) if prev else 0,
+                        currency   = "CNY",
+                        market     = "a_share",
+                        source     = self.name,
+                    )
+        except Exception:
+            pass
+
+        # ── 方法3: yfinance .SS/.SZ（海外访问兜底） ─────────────────────────
+        try:
+            import yfinance as yf
+            yf_sym = self._yf_symbol(code)
+            ticker = yf.Ticker(yf_sym)
+
+            price = None
+            prev  = None
+            info  = {}
+            try:
+                fi    = ticker.fast_info
+                price = getattr(fi, "last_price", None) or getattr(fi, "previous_close", None)
+                prev  = getattr(fi, "previous_close", None) or price
+            except Exception:
+                pass
+            if not price:
+                try:
+                    info  = ticker.info or {}
+                    price = info.get("currentPrice") or info.get("regularMarketPrice") or info.get("previousClose")
+                    prev  = info.get("previousClose") or price
+                except Exception:
+                    pass
+            if price and float(price) > 0:
+                if not info:
+                    try:
+                        info = ticker.info or {}
+                    except Exception:
+                        pass
+                chg   = float(price) - float(prev) if prev else 0
+                chg_p = chg / float(prev) * 100 if prev else 0
+                return QuoteResult(
+                    symbol     = symbol,
+                    name       = info.get("shortName") or info.get("longName") or symbol,
+                    price      = float(price),
+                    change     = chg,
+                    change_pct = chg_p,
+                    volume     = float(info.get("volume") or 0),
+                    market_cap = float(info.get("marketCap") or 0),
+                    pe_ttm     = float(info.get("trailingPE") or 0),
+                    pb         = float(info.get("priceToBook") or 0),
+                    currency   = "CNY",
+                    market     = "a_share",
+                    source     = f"{self.name}+yfinance",
+                )
+        except Exception:
+            pass
+
+        # ── 方法4: 最近历史收盘价 ────────────────────────────────────────────
+        try:
+            h = self.history(symbol, days=5)
+            if h and h.data is not None and not h.data.empty:
+                df = h.data
+                # Flexible column detection (akshare returns Chinese column names)
+                close_col = next(
+                    (c for c in df.columns if "收盘" in str(c) or "close" in str(c).lower()),
+                    df.columns[-1]
+                )
+                price = float(df[close_col].iloc[-1])
+                prev  = float(df[close_col].iloc[-2]) if len(df) > 1 else price
+                if price > 0:
+                    return QuoteResult(
+                        symbol     = symbol,
+                        price      = price,
+                        change     = round(price - prev, 4),
+                        change_pct = round((price - prev) / prev * 100, 2) if prev else 0,
+                        currency   = "CNY",
+                        market     = "a_share",
+                        source     = f"{self.name}(last_close)",
+                    )
+        except Exception as e:
+            logger.debug(f"[akshare] quote history fallback {symbol} 失败: {e}")
+
+        logger.debug(f"[akshare] quote {symbol}: 所有方法均失败")
+        return None
+
+    def history(self, symbol: str, days: int = 90, interval: str = "1d") -> Optional[HistoryResult]:
+        # ── 方法1: akshare stock_zh_a_hist ──────────────────────────────────
+        try:
+            import akshare as ak
+            code  = self._normalize_code(symbol)
+            end   = date.today().strftime("%Y%m%d")
+            start = (date.today() - timedelta(days=days + 10)).strftime("%Y%m%d")
+            df    = ak.stock_zh_a_hist(
+                symbol=code, period="daily",
+                start_date=start, end_date=end, adjust="qfq"
+            )
+            if df is not None and not df.empty:
+                return HistoryResult(symbol=symbol, data=df, source=self.name, interval=interval)
+        except Exception as e:
+            logger.debug(f"[akshare] history(akshare) {symbol} 失败: {e}")
+
+        # ── 方法2: yfinance .SS/.SZ (海外兜底) ──────────────────────────────
+        try:
+            import yfinance as yf
+            import pandas as pd
+            code   = self._normalize_code(symbol)
+            yf_sym = self._yf_symbol(code)
+            ticker = yf.Ticker(yf_sym)
+            period = f"{days}d" if days <= 730 else "2y"
+            df     = ticker.history(period=period, auto_adjust=True)
+            if df is not None and not df.empty:
+                df.index = pd.to_datetime(df.index)
+                return HistoryResult(symbol=symbol, data=df, source=f"{self.name}+yfinance", interval=interval)
+        except Exception as e:
+            logger.debug(f"[akshare] history(yfinance) {symbol} 失败: {e}")
+
+        return None
+
+    def fundamentals(self, symbol: str) -> Optional[FundamentalsResult]:
+        """A股基本面：优先 akshare，降级 yfinance .SS/.SZ"""
+        # ── 方法1: akshare 市场快照字段 ──────────────────────────────────────
+        try:
+            import akshare as ak
+            import math
+            code = self._normalize_code(symbol)
+            df   = ak.stock_zh_a_spot_em()
+            row  = df[df["代码"] == code]
+            if not row.empty:
+                r  = row.iloc[0]
+                def _ak(key: str) -> Optional[float]:
+                    v = r.get(key)
+                    if v is None:
+                        return None
+                    try:
+                        fv = float(v)
+                        return None if (math.isnan(fv) or fv == 0) else fv
+                    except (TypeError, ValueError):
+                        return None
+                pe  = _ak("市盈率-动态")
+                pb  = _ak("市净率")
+                mv  = _ak("总市值")
+                if pe or pb:
+                    return FundamentalsResult(
+                        symbol=symbol, pe_ttm=pe, pb=pb,
+                        total_mv=mv, source=self.name,
+                    )
+        except Exception:
+            pass
+
+        # ── 方法2: yfinance .SS/.SZ ───────────────────────────────────────────
+        try:
+            from .yfinance_source import YFinanceSource
+            code   = self._normalize_code(symbol)
+            yf_sym = self._yf_symbol(code)
+            fund   = YFinanceSource().fundamentals(yf_sym)
+            if fund:
+                fund.symbol = symbol
+                fund.source = f"{self.name}+yfinance"
+                return fund
+        except Exception as e:
+            logger.debug(f"[akshare] fundamentals yfinance fallback {symbol} 失败: {e}")
+
+        return None
+
+    def northbound_flow(self) -> Optional[Dict]:
+        """北向资金净流入（akshare 特有）"""
+        try:
+            import akshare as ak
+            df = ak.stock_hsgt_north_net_flow_in_em(symbol="北向资金")
+            if df is None or df.empty:
+                return None
+            latest = df.iloc[-1]
+            return {
+                "date":     str(latest.get("日期", "")),
+                "net_flow": float(latest.get("当日净流入", 0) or 0),
+                "source":   self.name,
+            }
+        except Exception as e:
+            logger.debug(f"[akshare] northbound_flow 失败: {e}")
+            return None

aria_code/datasources/sources/alpha_vantage_source.py

@@ -0,0 +1,203 @@
+"""
+datasources/sources/alpha_vantage_source.py — Alpha Vantage 免费层数据
+======================================================================
+免费 API key 从 https://www.alphavantage.co/support/#api-key 申请（秒得）。
+免费限制: 25 请求/天，5 请求/分钟。
+
+功能: 美股/ETF 行情、技术指标、外汇汇率、大宗商品、基本面数据。
+
+配置: ALPHA_VANTAGE_KEY 环境变量 或 ~/.aria/.env
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+import time
+import urllib.request
+from datetime import date, timedelta
+from pathlib import Path
+from typing import Dict, Optional
+
+from ..base import BaseDataSource, FundamentalsResult, HistoryResult, QuoteResult
+from aria_code.packages.aria_core.paths import aria_home
+
+logger = logging.getLogger(__name__)
+
+_BASE = "https://www.alphavantage.co/query"
+
+
+def _load_key() -> str:
+    key = os.getenv("ALPHA_VANTAGE_KEY", "") or os.getenv("ALPHAVANTAGE_KEY", "")
+    if not key:
+        for p in [Path.home() / ".aria" / ".env", aria_home() / ".env"]:
+            if p.exists():
+                for line in p.read_text(encoding="utf-8").splitlines():
+                    if line.startswith(("ALPHA_VANTAGE_KEY=", "ALPHAVANTAGE_KEY=")):
+                        key = line.split("=", 1)[1].strip()
+                        break
+            if key:
+                break
+    if not key:
+        # providers.json 中存储的键名是 "alphavantage"（无下划线）
+        try:
+            import json as _json
+            _p = aria_home() / "providers.json"
+            if _p.exists():
+                _raw = _json.loads(_p.read_text(encoding="utf-8"))
+                key = (
+                    _raw.get("data", {}).get("alphavantage", {}).get("api_key", "")
+                    or _raw.get("data", {}).get("alpha_vantage", {}).get("api_key", "")
+                )
+        except Exception:
+            pass
+    return key
+
+
+def _fetch(params: dict, timeout: int = 15) -> Optional[dict]:
+    import json
+    qs = "&".join(f"{k}={v}" for k, v in params.items())
+    url = f"{_BASE}?{qs}"
+    try:
+        req = urllib.request.Request(url, headers={"User-Agent": "aria-code/1.0"})
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            return json.loads(resp.read())
+    except Exception as e:
+        logger.debug(f"[alpha_vantage] fetch 失败: {e}")
+        return None
+
+
+class AlphaVantageSource(BaseDataSource):
+    """
+    Alpha Vantage 数据源。
+    免费 key 足够日常使用（25次/天）；付费 key 无频率限制。
+    """
+
+    name         = "alpha_vantage"
+    markets      = ["us", "hk", "forex", "commodity"]
+    requires_key = True
+
+    def __init__(self, config=None):
+        super().__init__(config)
+        self._key = _load_key()
+
+    def is_configured(self) -> bool:
+        return bool(self._key)
+
+    def quote(self, symbol: str) -> Optional[QuoteResult]:
+        data = _fetch({"function": "GLOBAL_QUOTE", "symbol": symbol, "apikey": self._key})
+        if not data:
+            return None
+        q = data.get("Global Quote", {})
+        if not q or "05. price" not in q:
+            return None
+        price  = float(q.get("05. price", 0))
+        change = float(q.get("09. change", 0))
+        pct    = float(q.get("10. change percent", "0%").replace("%", ""))
+        vol    = float(q.get("06. volume", 0))
+        return QuoteResult(
+            symbol     = symbol,
+            price      = price,
+            change     = change,
+            change_pct = pct,
+            volume     = vol,
+            market     = "us",
+            source     = self.name,
+            timestamp  = q.get("07. latest trading day", ""),
+        )
+
+    def history(
+        self,
+        symbol: str,
+        days: int = 365,
+        interval: str = "1d",
+    ) -> Optional[HistoryResult]:
+        try:
+            import pandas as pd
+            size   = "compact" if days <= 100 else "full"
+            func   = "TIME_SERIES_DAILY_ADJUSTED"
+            data   = _fetch({"function": func, "symbol": symbol,
+                             "outputsize": size, "apikey": self._key})
+            if not data:
+                return None
+            ts = data.get("Time Series (Daily)", {})
+            if not ts:
+                return None
+            cutoff = (date.today() - timedelta(days=days)).isoformat()
+            rows   = []
+            for d, v in ts.items():
+                if d < cutoff:
+                    continue
+                rows.append({
+                    "date":   d,
+                    "open":   float(v.get("1. open", 0)),
+                    "high":   float(v.get("2. high", 0)),
+                    "low":    float(v.get("3. low", 0)),
+                    "close":  float(v.get("5. adjusted close", v.get("4. close", 0))),
+                    "volume": float(v.get("6. volume", 0)),
+                })
+            if not rows:
+                return None
+            df = pd.DataFrame(rows)
+            df["date"] = pd.to_datetime(df["date"])
+            df = df.set_index("date").sort_index()
+            return HistoryResult(symbol=symbol, data=df, source=self.name, interval="1d")
+        except Exception as e:
+            logger.debug(f"[alpha_vantage] history {symbol} 失败: {e}")
+            return None
+
+    def fundamentals(self, symbol: str) -> Optional[FundamentalsResult]:
+        data = _fetch({"function": "OVERVIEW", "symbol": symbol, "apikey": self._key})
+        if not data or not data.get("Symbol"):
+            return None
+        def _f(k, mult: float = 1.0):
+            v = data.get(k, "None")
+            try:
+                fv = float(v) if v not in ("None", "-", "", "0") else None
+                return fv * mult if fv is not None else None
+            except ValueError:
+                return None
+        return FundamentalsResult(
+            symbol          = symbol,
+            pe_ttm          = _f("TrailingPE"),
+            pb              = _f("PriceToBookRatio"),
+            roe             = _f("ReturnOnEquityTTM", 100),
+            revenue_growth  = _f("RevenueGrowthQtrlyYOY"),
+            dividend_yield  = _f("DividendYield", 100),
+            source          = self.name,
+        )
+
+    def get_forex(self, from_currency: str, to_currency: str) -> Optional[Dict]:
+        """实时外汇汇率。"""
+        data = _fetch({"function": "CURRENCY_EXCHANGE_RATE",
+                       "from_currency": from_currency,
+                       "to_currency": to_currency,
+                       "apikey": self._key})
+        if not data:
+            return None
+        r = data.get("Realtime Currency Exchange Rate", {})
+        return {
+            "from": from_currency, "to": to_currency,
+            "rate": float(r.get("5. Exchange Rate", 0)),
+            "time": r.get("6. Last Refreshed", ""),
+        }
+
+    def get_commodity(self, symbol: str = "WTI") -> Optional[HistoryResult]:
+        """大宗商品历史价格（WTI/BRENT/GOLD/COPPER 等）。"""
+        _MAP = {"WTI": "WTI", "BRENT": "BRENT", "GOLD": "GOLD",
+                "COPPER": "COPPER", "ALUMINUM": "ALUMINUM", "WHEAT": "WHEAT"}
+        func = _MAP.get(symbol.upper(), symbol.upper())
+        data = _fetch({"function": func, "interval": "monthly", "apikey": self._key})
+        if not data:
+            return None
+        try:
+            import pandas as pd
+            rows = [{"date": r["date"], "close": float(r["value"])}
+                    for r in data.get("data", []) if r.get("value") not in (".", None)]
+            df = pd.DataFrame(rows)
+            df["date"] = pd.to_datetime(df["date"])
+            df = df.set_index("date").sort_index()
+            return HistoryResult(symbol=symbol, data=df, source=self.name, interval="1mo")
+        except Exception as e:
+            logger.debug(f"[alpha_vantage] commodity {symbol} 失败: {e}")
+            return None

aria_code/datasources/sources/edgar_source.py

@@ -0,0 +1,219 @@
+"""
+datasources/sources/edgar_source.py — SEC EDGAR 美国上市公司财务数据
+====================================================================
+完全免费，无需 API key。数据来源：https://data.sec.gov (SEC EDGAR API)
+覆盖：10-K / 10-Q 财报、公司基本信息、财务报表、内幕交易披露。
+
+用法:
+    src = EDGARSource()
+    facts = src.get_company_facts("AAPL")   # → 财务指标历史
+    filings = src.get_recent_filings("MSFT") # → 最近10-K/10-Q
+"""
+
+from __future__ import annotations
+
+import logging
+import time
+import urllib.request
+from typing import Any, Dict, List, Optional
+
+from ..base import BaseDataSource, FundamentalsResult, QuoteResult
+
+import os as _os
+
+logger = logging.getLogger(__name__)
+
+_EDGAR_API    = "https://data.sec.gov"
+_EDGAR_WWW    = "https://www.sec.gov"
+_HEADERS      = {
+    "User-Agent": _os.environ.get("EDGAR_USER_AGENT", "aria-code contact@example.com"),  # SEC requires self-identification
+    "Accept-Encoding": "gzip, deflate",
+}
+
+# 主要美股 ticker → CIK 缓存（常用的直接查，避免每次API调用）
+_TICKER_CIK_CACHE: Dict[str, str] = {}
+
+
+def _fetch_json(url: str, timeout: int = 15) -> Optional[Dict]:
+    try:
+        import gzip
+        import json
+        req = urllib.request.Request(url, headers=_HEADERS)
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            raw = resp.read()
+            if resp.headers.get("Content-Encoding") == "gzip":
+                raw = gzip.decompress(raw)
+            return json.loads(raw)
+    except Exception as e:
+        logger.debug(f"[edgar] fetch {url} 失败: {e}")
+        return None
+
+
+class EDGARSource(BaseDataSource):
+    """
+    SEC EDGAR 数据源 — 美国上市公司财报和披露文件。
+    """
+
+    name         = "edgar"
+    markets      = ["us"]
+    requires_key = False
+
+    def __init__(self, config=None):
+        super().__init__(config)
+        self._tickers: Optional[Dict] = None
+        self._cik_map: Dict[str, str] = {}
+
+    def is_configured(self) -> bool:
+        return True
+
+    def _load_ticker_map(self) -> None:
+        """加载 SEC 全量 ticker→CIK 映射（首次调用时下载一次）"""
+        if self._tickers is not None:
+            return
+        data = _fetch_json(f"{_EDGAR_WWW}/files/company_tickers.json")
+        if data:
+            for v in data.values():
+                ticker = v.get("ticker", "").upper()
+                cik    = str(v.get("cik_str", "")).zfill(10)
+                if ticker:
+                    self._cik_map[ticker] = cik
+        self._tickers = self._cik_map
+
+    def ticker_to_cik(self, symbol: str) -> Optional[str]:
+        self._load_ticker_map()
+        return self._cik_map.get(symbol.upper())
+
+    def get_company_facts(self, symbol: str) -> Optional[Dict[str, Any]]:
+        """
+        获取公司全部财务事实（XBRL 格式）。
+        返回包含 EPS/Revenue/NetIncome/Assets 等历史序列的字典。
+        """
+        cik = self.ticker_to_cik(symbol)
+        if not cik:
+            return {"error": f"未找到 {symbol} 的 CIK"}
+        data = _fetch_json(f"{_EDGAR_API}/api/xbrl/companyfacts/CIK{cik}.json")
+        if not data:
+            return None
+
+        us_gaap = data.get("facts", {}).get("us-gaap", {})
+        result  = {"symbol": symbol, "cik": cik, "metrics": {}}
+        wanted  = {
+            "Revenues": "revenue",
+            "RevenueFromContractWithCustomerExcludingAssessedTax": "revenue",
+            "NetIncomeLoss": "net_income",
+            "EarningsPerShareBasic": "eps_basic",
+            "EarningsPerShareDiluted": "eps_diluted",
+            "Assets": "total_assets",
+            "StockholdersEquity": "total_equity",
+            "OperatingIncomeLoss": "operating_income",
+            "CommonStockSharesOutstanding": "shares_outstanding",
+        }
+        for gaap_key, alias in wanted.items():
+            if gaap_key in us_gaap:
+                units = us_gaap[gaap_key].get("units", {})
+                unit_key = "USD" if "USD" in units else ("shares" if "shares" in units else next(iter(units), None))
+                if unit_key and unit_key in units:
+                    entries = [
+                        {"end": e["end"], "val": e["val"], "form": e.get("form", "")}
+                        for e in units[unit_key]
+                        if e.get("form") in ("10-K", "10-Q", "20-F")
+                    ]
+                    if entries:
+                        entries.sort(key=lambda x: x["end"], reverse=True)
+                        result["metrics"][alias] = entries[:20]
+        return result
+
+    def get_recent_filings(self, symbol: str, form_types: List[str] = None) -> List[Dict]:
+        """获取最近提交的财务报告（10-K、10-Q、8-K 等）。"""
+        cik = self.ticker_to_cik(symbol)
+        if not cik:
+            return [{"error": f"未找到 {symbol} 的 CIK"}]
+        form_types = form_types or ["10-K", "10-Q", "8-K"]
+        data = _fetch_json(f"{_EDGAR_API}/submissions/CIK{cik}.json")
+        if not data:
+            return []
+
+        recent   = data.get("filings", {}).get("recent", {})
+        forms    = recent.get("form", [])
+        dates    = recent.get("filingDate", [])
+        accnos   = recent.get("accessionNumber", [])
+        docs     = recent.get("primaryDocument", [])
+
+        results = []
+        for form, filing_date, accno, doc in zip(forms, dates, accnos, docs):
+            if form in form_types:
+                accno_clean = accno.replace("-", "")
+                url = f"https://www.sec.gov/Archives/edgar/data/{int(cik)}/{accno_clean}/{doc}"
+                results.append({
+                    "form": form,
+                    "date": filing_date,
+                    "accession": accno,
+                    "url": url,
+                    "cik": cik,
+                })
+            if len(results) >= 20:
+                break
+        return results
+
+    def get_insider_trades(self, symbol: str, days: int = 90) -> List[Dict]:
+        """获取内幕交易披露（Form 4）。"""
+        cik = self.ticker_to_cik(symbol)
+        if not cik:
+            return []
+        data = _fetch_json(f"{_EDGAR_API}/submissions/CIK{cik}.json")
+        if not data:
+            return []
+
+        recent = data.get("filings", {}).get("recent", {})
+        forms  = recent.get("form", [])
+        dates  = recent.get("filingDate", [])
+        results = []
+        from datetime import date as _date, timedelta as _td
+        cutoff = (_date.today() - _td(days=days)).isoformat()
+
+        for form, filing_date in zip(forms, dates):
+            if form == "4" and filing_date >= cutoff:
+                results.append({"form": "4", "date": filing_date, "type": "insider"})
+            if len(results) >= 30:
+                break
+        return results
+
+    def quote(self, symbol: str) -> Optional[QuoteResult]:
+        facts = self.get_company_facts(symbol)
+        if not facts or "metrics" in facts and not facts["metrics"]:
+            return None
+        m = facts.get("metrics", {})
+        rev = m.get("revenue", [{}])[0].get("val", 0) if m.get("revenue") else 0
+        return QuoteResult(
+            symbol  = symbol,
+            name    = f"EDGAR:{symbol}",
+            price   = 0.0,
+            market  = "us",
+            source  = self.name,
+            extra   = {"annual_revenue": rev},
+        )
+
+    def fundamentals(self, symbol: str) -> Optional[FundamentalsResult]:
+        facts = self.get_company_facts(symbol)
+        if not facts:
+            return None
+        m = facts.get("metrics", {})
+
+        def _latest(key: str) -> float:
+            entries = m.get(key, [])
+            return float(entries[0]["val"]) if entries else 0.0
+
+        net_income = _latest("net_income")
+        revenue    = _latest("revenue")
+        rev_yoy    = 0.0
+        if m.get("revenue") and len(m["revenue"]) >= 2:
+            cur  = float(m["revenue"][0]["val"])
+            prev = float(m["revenue"][1]["val"])
+            if prev:
+                rev_yoy = (cur - prev) / abs(prev) * 100
+
+        return FundamentalsResult(
+            symbol           = symbol,
+            revenue_growth   = rev_yoy,
+            source           = self.name,
+        )