akshare-one 0.3.2__py3-none-any.whl → 0.3.3__py3-none-any.whl

akshare_one/__init__.py

@@ -14,18 +14,201 @@ Example:
     >>> df = get_realtime_data(symbol="600000")
 """
 
-from .stock import get_hist_data, get_realtime_data
-from .news import get_news_data
-from .insider import get_inner_trade_data
-from .financial import get_balance_sheet, get_income_statement, get_cash_flow
-
-
-__all__ = [
-    "get_hist_data",
-    "get_realtime_data",
-    "get_news_data",
-    "get_inner_trade_data",
-    "get_balance_sheet",
-    "get_income_statement",
-    "get_cash_flow",
-]
+from typing import Optional, Literal
+import pandas as pd
+from .modules.financial.factory import FinancialDataFactory
+from .modules.historical.factory import HistoricalDataFactory
+from .modules.realtime.factory import RealtimeDataFactory
+from .modules.info.factory import InfoDataFactory
+from .modules.news.factory import NewsDataFactory
+from .modules.insider.factory import InsiderDataFactory
+
+
+def get_basic_info(
+    symbol: str, source: Literal["eastmoney"] = "eastmoney"
+) -> pd.DataFrame:
+    """获取股票基础信息
+
+    Args:
+        symbol: 股票代码 (e.g. '600000')
+        source: 数据源 ('eastmoney')
+
+    Returns:
+        pd.DataFrame:
+        - price: 最新价
+        - symbol: 股票代码
+        - name: 股票简称
+        - total_shares: 总股本
+        - float_shares: 流通股
+        - total_market_cap: 总市值
+        - float_market_cap: 流通市值
+        - industry: 行业
+        - listing_date: 上市时间
+    """
+    provider = InfoDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_basic_info()
+
+
+def get_hist_data(
+    symbol: str,
+    interval: Literal["minute", "hour", "day", "week", "month", "year"] = "day",
+    interval_multiplier: int = 1,
+    start_date: str = "1970-01-01",
+    end_date: str = "2030-12-31",
+    adjust: Literal["none", "qfq", "hfq"] = "none",
+    source: Literal["eastmoney", "eastmoney_direct", "sina"] = "eastmoney",
+) -> pd.DataFrame:
+    """Get historical market data
+
+    Args:
+        symbol: 股票代码 (e.g. '600000')
+        interval: 时间间隔 ('minute','hour','day','week','month','year')
+        interval_multiplier: 时间间隔倍数 (e.g. 5 for 5 minutes)
+        start_date: 开始日期 (YYYY-MM-DD)
+        end_date: 结束日期 (YYYY-MM-DD)
+        adjust: 复权类型 ('none','qfq','hfq')
+        source: 数据源 ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')
+
+    Returns:
+        pd.DataFrame:
+        - timestamp: 时间戳(UTC时区)
+        - open: 开盘价
+        - high: 最高价
+        - low: 最低价
+        - close: 收盘价
+        - volume: 成交量
+    """
+    kwargs = {
+        "symbol": symbol,
+        "interval": interval,
+        "interval_multiplier": interval_multiplier,
+        "start_date": start_date,
+        "end_date": end_date,
+        "adjust": adjust,
+    }
+    provider = HistoricalDataFactory.get_provider(source, **kwargs)
+    return provider.get_hist_data()
+
+
+def get_realtime_data(
+    symbol: Optional[str] = None,
+    source: Literal["eastmoney", "eastmoney_direct", "xueqiu"] = "xueqiu",
+) -> pd.DataFrame:
+    """Get real-time market quotes
+
+    Args:
+        symbol: 股票代码 (如 "600000")
+        source: 数据源 ('eastmoney', 'eastmoney_direct', 'xueqiu')
+
+    Returns:
+        pd.DataFrame:
+        - symbol: 股票代码
+        - price: 最新价
+        - change: 涨跌额
+        - pct_change: 涨跌幅(%)
+        - timestamp: 时间戳
+        - volume: 成交量(手)
+        - amount: 成交额(元)
+        - open: 今开
+        - high: 最高
+        - low: 最低
+        - prev_close: 昨收
+    """
+    provider = RealtimeDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_current_data()
+
+
+def get_news_data(
+    symbol: str, source: Literal["eastmoney"] = "eastmoney"
+) -> pd.DataFrame:
+    """获取个股新闻数据
+
+    Args:
+        symbol: 股票代码 (如 "300059")
+        source: 数据源 ('eastmoney')
+
+    Returns:
+        pd.DataFrame:
+        - keyword: 关键词
+        - title: 新闻标题
+        - content: 新闻内容
+        - publish_time: 发布时间
+        - source: 文章来源
+        - url: 新闻链接
+    """
+    provider = NewsDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_news_data()
+
+
+def get_balance_sheet(symbol: str, source: Literal["sina"] = "sina") -> pd.DataFrame:
+    """获取资产负债表数据
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ("sina")
+
+    Returns:
+        pd.DataFrame: 资产负债表数据
+    """
+    provider = FinancialDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_balance_sheet()
+
+
+def get_income_statement(symbol: str, source: Literal["sina"] = "sina") -> pd.DataFrame:
+    """获取利润表数据
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ("sina")
+
+    Returns:
+        pd.DataFrame: 利润表数据
+    """
+    provider = FinancialDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_income_statement()
+
+
+def get_cash_flow(symbol: str, source: Literal["sina"] = "sina") -> pd.DataFrame:
+    """获取现金流量表数据
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ("sina")
+
+    Returns:
+        pd.DataFrame: 现金流量表数据
+    """
+    provider = FinancialDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_cash_flow()
+
+
+def get_financial_metrics(
+    symbol: str, source: Literal["eastmoney"] = "eastmoney"
+) -> pd.DataFrame:
+    """获取三大财务报表关键指标
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ('eastmoney')
+
+    Returns:
+        pd.DataFrame: 财务关键指标数据
+    """
+    provider = FinancialDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_financial_metrics()
+
+
+def get_inner_trade_data(
+    symbol: str, source: Literal["xueqiu"] = "xueqiu"
+) -> pd.DataFrame:
+    """获取雪球内部交易数据
+
+    Args:
+        symbol: 股票代码，如"600000"
+        source: 数据源 (目前支持 "xueqiu")
+
+    Returns:
+        pd.DataFrame: 内部交易数据
+    """
+    provider = InsiderDataFactory.get_provider(source, symbol=symbol)
+    return provider.get_inner_trade_data()

akshare_one/modules/cache.py

@@ -6,4 +6,5 @@ CACHE_CONFIG = {
     "realtime_cache": TTLCache(maxsize=500, ttl=60),  # 实时数据缓存1分钟
     "news_cache": TTLCache(maxsize=500, ttl=3600),
     "financial_cache": TTLCache(maxsize=500, ttl=86400),  # 财务数据缓存24小时
+    "info_cache": TTLCache(maxsize=500, ttl=86400),  # 信息数据缓存24小时
 }

akshare_one/modules/financial/base.py

@@ -20,3 +20,8 @@ class FinancialDataProvider(ABC):
     def get_cash_flow(self) -> pd.DataFrame:
         """Fetches cash flow data"""
         pass
+
+    @abstractmethod
+    def get_financial_metrics(self) -> pd.DataFrame:
+        """Fetch financial metrics"""
+        pass

akshare_one/modules/financial/eastmoney.py

@@ -0,0 +1,184 @@
+from cachetools import cached
+import pandas as pd
+import requests
+
+from akshare_one.modules.cache import CACHE_CONFIG
+from .base import FinancialDataProvider
+
+
+class EastMoneyFinancialReport(FinancialDataProvider):
+    _balance_sheet_rename_map = {
+        "REPORT_DATE": "report_date",
+        "TOTAL_ASSETS": "total_assets",
+        "FIXED_ASSET": "fixed_assets_net",
+        "MONETARYFUNDS": "cash_and_equivalents",
+        "ACCOUNTS_RECE": "accounts_receivable",
+        "INVENTORY": "inventory",
+        "TOTAL_LIABILITIES": "total_liabilities",
+        "ACCOUNTS_PAYABLE": "trade_and_non_trade_payables",
+        "ADVANCE_RECEIVABLES": "deferred_revenue",
+        "TOTAL_EQUITY": "shareholders_equity",
+    }
+
+    _income_statement_rename_map = {
+        "REPORT_DATE": "report_date",
+        "TOTAL_OPERATE_INCOME": "revenue",
+        "TOTAL_OPERATE_COST": "total_operating_costs",
+        "OPERATE_PROFIT": "operating_profit",
+        "PARENT_NETPROFIT": "net_income_common_stock",
+    }
+
+    _cash_flow_rename_map = {
+        "REPORT_DATE": "report_date",
+        "NETCASH_OPERATE": "net_cash_flow_from_operations",
+        "NETCASH_INVEST": "net_cash_flow_from_investing",
+        "NETCASH_FINANCE": "net_cash_flow_from_financing",
+        "CCE_ADD": "change_in_cash_and_equivalents",
+    }
+
+    def __init__(self, symbol):
+        super().__init__(symbol)
+
+    def get_income_statement(self):
+        pass
+
+    def get_balance_sheet(self):
+        pass
+
+    def get_cash_flow(self):
+        pass
+
+    @cached(
+        CACHE_CONFIG["financial_cache"],
+        key=lambda self, symbol=None: f"financial_metrics_{self.symbol}",
+    )
+    def get_financial_metrics(self) -> pd.DataFrame:
+        """获取三大财务报表关键指标"""
+        balance_sheet = self._fetch_balance_sheet()
+        income_statement = self._fetch_income_statement()
+        cash_flow = self._fetch_cash_flow()
+
+        if balance_sheet.empty and income_statement.empty and cash_flow.empty:
+            return pd.DataFrame()
+
+        merged = pd.merge(
+            balance_sheet, income_statement, on="report_date", how="outer"
+        )
+        merged = pd.merge(merged, cash_flow, on="report_date", how="outer")
+
+        # Convert report_date to datetime and format as YYYY-MM-DD
+        merged["report_date"] = pd.to_datetime(merged["report_date"]).dt.strftime(
+            "%Y-%m-%d"
+        )
+
+        # Sort by report_date in descending order (most recent first)
+        merged = merged.sort_values("report_date", ascending=False).reset_index(
+            drop=True
+        )
+
+        return merged
+
+    def _fetch_balance_sheet(self) -> pd.DataFrame:
+        """
+        Get stock balance sheet data from East Money API
+        """
+        try:
+            # API endpoint and parameters
+            api_url = "https://datacenter-web.eastmoney.com/api/data/v1/get"
+            params = {
+                "reportName": "RPT_DMSK_FN_BALANCE",
+                "filter": f'(SECURITY_CODE="{self.symbol}")',
+                "pageNumber": "1",
+                "pageSize": "1000",
+                "sortColumns": "REPORT_DATE",
+                "sortTypes": "-1",
+                "columns": ",".join(self._balance_sheet_rename_map.keys()),
+            }
+
+            # Fetch data from API
+            response = requests.get(api_url, params=params)
+            response.raise_for_status()
+            data = response.json()
+
+            # Extract the actual data
+            if data.get("result") and data["result"].get("data"):
+                df = pd.DataFrame(data["result"]["data"])
+                df.rename(columns=self._balance_sheet_rename_map, inplace=True)
+                return df
+            else:
+                print("No balance sheet data found in API response")
+                return pd.DataFrame()
+
+        except Exception as e:
+            print(f"Error occurred: {str(e)}")
+            return pd.DataFrame()
+
+    def _fetch_income_statement(self) -> pd.DataFrame:
+        """
+        Get stock income statement data from East Money API
+        """
+        try:
+            # API endpoint and parameters
+            api_url = "https://datacenter-web.eastmoney.com/api/data/v1/get"
+            params = {
+                "reportName": "RPT_DMSK_FN_INCOME",
+                "filter": f'(SECURITY_CODE="{self.symbol}")',
+                "pageNumber": "1",
+                "pageSize": "1000",
+                "sortColumns": "REPORT_DATE",
+                "sortTypes": "-1",
+                "columns": ",".join(self._income_statement_rename_map.keys()),
+            }
+
+            # Fetch data from API
+            response = requests.get(api_url, params=params)
+            response.raise_for_status()
+            data = response.json()
+
+            # Extract the actual data
+            if data.get("result") and data["result"].get("data"):
+                df = pd.DataFrame(data["result"]["data"])
+                df.rename(columns=self._income_statement_rename_map, inplace=True)
+                return df
+            else:
+                print("No income statement data found in API response")
+                return pd.DataFrame()
+
+        except Exception as e:
+            print(f"Error occurred: {str(e)}")
+            return pd.DataFrame()
+
+    def _fetch_cash_flow(self) -> pd.DataFrame:
+        """
+        Get stock cash flow statement data from East Money API
+        """
+        try:
+            # API endpoint and parameters
+            api_url = "https://datacenter-web.eastmoney.com/api/data/v1/get"
+            params = {
+                "reportName": "RPT_DMSK_FN_CASHFLOW",
+                "filter": f'(SECURITY_CODE="{self.symbol}")',
+                "pageNumber": "1",
+                "pageSize": "1000",
+                "sortColumns": "REPORT_DATE",
+                "sortTypes": "-1",
+                "columns": ",".join(self._cash_flow_rename_map.keys()),
+            }
+
+            # Fetch data from API
+            response = requests.get(api_url, params=params)
+            response.raise_for_status()
+            data = response.json()
+
+            # Extract the actual data
+            if data.get("result") and data["result"].get("data"):
+                df = pd.DataFrame(data["result"]["data"])
+                df.rename(columns=self._cash_flow_rename_map, inplace=True)
+                return df
+            else:
+                print("No cash flow statement data found in API response")
+                return pd.DataFrame()
+
+        except Exception as e:
+            print(f"Error occurred: {str(e)}")
+            return pd.DataFrame()

akshare_one/modules/financial/factory.py

@@ -1,3 +1,4 @@
+from .eastmoney import EastMoneyFinancialReport
 from .sina import SinaFinancialReport
 from .base import FinancialDataProvider
 
@@ -9,6 +10,7 @@ class FinancialDataFactory:
 
     _providers = {
         "sina": SinaFinancialReport,
+        "eastmoney": EastMoneyFinancialReport,
     }
 
     @classmethod

akshare_one/modules/financial/sina.py

@@ -7,6 +7,12 @@ from .base import FinancialDataProvider
 
 
 class SinaFinancialReport(FinancialDataProvider):
+    """Financial data provider for Sina finance reports.
+
+    Provides standardized access to balance sheet, income statement,
+    and cash flow data from Sina finance API.
+    """
+
     def __init__(self, symbol: str) -> None:
         super().__init__(symbol)
         self.stock = (
@@ -77,40 +83,41 @@ class SinaFinancialReport(FinancialDataProvider):
                 raw_df["report_date"], format="%Y%m%d"
             )
 
-        if "更新日期" in raw_df.columns:
-            raw_df = raw_df.rename(columns={"更新日期": "update_time"})
-            raw_df["update_time"] = pd.to_datetime(raw_df["update_time"])
-
-        # Standardize column names
+        # Define column mappings and required columns
         column_mapping = {
-            "类型": "report_type",
             "币种": "currency",
-            "净利润": "net_income",
-            "固定资产折旧、油气资产折耗、生产性生物资产折旧": "depreciation_and_amortization",
-            "无形资产摊销": "share_based_compensation",
             "经营活动产生的现金流量净额": "net_cash_flow_from_operations",
             "购建固定资产、无形资产和其他长期资产支付的现金": "capital_expenditure",
             "取得子公司及其他营业单位支付的现金净额": "business_acquisitions_and_disposals",
-            "投资支付的现金": "investment_acquisitions_and_disposals",
             "投资活动产生的现金流量净额": "net_cash_flow_from_investing",
             "取得借款收到的现金": "issuance_or_repayment_of_debt_securities",
             "吸收投资收到的现金": "issuance_or_purchase_of_equity_shares",
-            "分配股利、利润或偿付利息支付的现金": "dividends_and_other_cash_distributions",
             "筹资活动产生的现金流量净额": "net_cash_flow_from_financing",
             "现金及现金等价物净增加额": "change_in_cash_and_equivalents",
             "汇率变动对现金及现金等价物的影响": "effect_of_exchange_rate_changes",
             "期末现金及现金等价物余额": "ending_cash_balance",
-            "自由现金流": "free_cash_flow",
+            "销售商品、提供劳务收到的现金": "cash_from_sales",
+            "收到的税费返还": "tax_refunds_received",
+            "支付给职工以及为职工支付的现金": "cash_paid_to_employees",
+            "支付的各项税费": "taxes_paid",
+            "经营活动现金流入小计": "total_cash_inflow_from_operations",
+            "经营活动现金流出小计": "total_cash_outflow_from_operations",
+            "收回投资所收到的现金": "cash_from_investment_recovery",
+            "取得投资收益收到的现金": "cash_from_investment_income",
+            "处置固定资产、无形资产收回的现金": "cash_from_asset_sales",
+            "投资活动现金流入小计": "total_cash_inflow_from_investing",
+            "投资活动现金流出小计": "total_cash_outflow_from_investing",
+            "分配股利、利润或偿付利息所支付的现金": "cash_paid_for_dividends_and_interest",
+            "偿还债务支付的现金": "cash_paid_for_debt_repayment",
+            "筹资活动现金流入小计": "total_cash_inflow_from_financing",
+            "筹资活动现金流出小计": "total_cash_outflow_from_financing",
+            "期初现金及现金等价物余额": "beginning_cash_balance",
+            "现金的期末余额": "ending_cash",
+            "现金等价物的期末余额": "ending_cash_equivalents",
         }
-        raw_df = raw_df.rename(columns=column_mapping)
-
-        # Select only required columns
-        required_columns = ["report_date"]
-        required_columns.extend(column_mapping.values())
 
-        # Filter columns
-        available_columns = [col for col in required_columns if col in raw_df.columns]
-        return raw_df[available_columns]
+        required_columns = ["report_date"] + list(column_mapping.values())
+        return raw_df.rename(columns=column_mapping).reindex(columns=required_columns)
 
     def _clean_balance_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
         """清理和标准化资产负债表数据
@@ -128,47 +135,48 @@ class SinaFinancialReport(FinancialDataProvider):
                 raw_df["report_date"], format="%Y%m%d"
             )
 
-        if "更新日期" in raw_df.columns:
-            raw_df = raw_df.rename(columns={"更新日期": "update_time"})
-            raw_df["update_time"] = pd.to_datetime(raw_df["update_time"])
-
-        # Standardize column names
-        column_mapping = {
-            "类型": "report_type",
-            "币种": "currency",
-            "资产总计": "total_assets",
-            "流动资产合计": "current_assets",
-            "货币资金": "cash_and_equivalents",
-            "存货": "inventory",
-            "交易性金融资产": "current_investments",
-            "应收票据及应收账款": "trade_and_non_trade_receivables",
-            "非流动资产合计": "non_current_assets",
-            "固定资产": "property_plant_and_equipment",
-            "商誉": "goodwill_and_intangible_assets",
-            "长期股权投资": "investments",
-            "其他非流动金融资产": "non_current_investments",
-            "实收资本(或股本)": "outstanding_shares",
-            "递延所得税资产": "tax_assets",
-            "负债合计": "total_liabilities",
-            "流动负债合计": "current_liabilities",
-            "短期借款": "current_debt",
-            "应付票据及应付账款": "trade_and_non_trade_payables",
-            "合同负债": "deferred_revenue",
-            "吸收存款及同业存放": "deposit_liabilities",
-            "非流动负债合计": "non_current_liabilities",
-            "长期借款": "non_current_debt",
-            "递延所得税负债": "tax_liabilities",
-            "所有者权益(或股东权益)合计": "shareholders_equity",
-            "未分配利润": "retained_earnings",
-            "其他综合收益": "accumulated_other_comprehensive_income",
-        }
-        raw_df = raw_df.rename(columns=column_mapping)
+        # Define and apply column mappings in one optimized operation
+        raw_df = raw_df.rename(
+            columns={
+                "币种": "currency",
+                "资产总计": "total_assets",
+                "流动资产合计": "current_assets",
+                "货币资金": "cash_and_equivalents",
+                "存货": "inventory",
+                "交易性金融资产": "current_investments",
+                "应收票据及应收账款": "trade_and_non_trade_receivables",
+                "非流动资产合计": "non_current_assets",
+                "固定资产": "property_plant_and_equipment",
+                "商誉": "goodwill_and_intangible_assets",
+                "长期股权投资": "investments",
+                "其他非流动金融资产": "non_current_investments",
+                "实收资本(或股本)": "outstanding_shares",
+                "递延所得税资产": "tax_assets",
+                "负债合计": "total_liabilities",
+                "流动负债合计": "current_liabilities",
+                "短期借款": "current_debt",
+                "应付票据及应付账款": "trade_and_non_trade_payables",
+                "合同负债": "deferred_revenue",
+                "吸收存款及同业存放": "deposit_liabilities",
+                "非流动负债合计": "non_current_liabilities",
+                "长期借款": "non_current_debt",
+                "递延所得税负债": "tax_liabilities",
+                "所有者权益(或股东权益)合计": "shareholders_equity",
+                "未分配利润": "retained_earnings",
+                "其他综合收益": "accumulated_other_comprehensive_income",
+                "应收账款": "accounts_receivable",
+                "预付款项": "prepayments",
+                "其他应收款": "other_receivables",
+                "固定资产净值": "fixed_assets_net",
+                "在建工程": "construction_in_progress",
+                "资本公积": "capital_reserve",
+                "少数股东权益": "minority_interest",
+            }
+        )
 
         # Select only required columns
         required_columns = [
             "report_date",
-            "report_period",
-            "period",
             "currency",
             "total_assets",
             "current_assets",
@@ -195,16 +203,49 @@ class SinaFinancialReport(FinancialDataProvider):
             "shareholders_equity",
             "retained_earnings",
             "accumulated_other_comprehensive_income",
+            "accounts_receivable",
+            "prepayments",
+            "other_receivables",
+            "fixed_assets_net",
+            "construction_in_progress",
+            "capital_reserve",
+            "current_ratio",
+            "debt_to_assets",
+            "minority_interest",
         ]
 
-        # Calculate total_debt
-        if "current_debt" in raw_df.columns and "non_current_debt" in raw_df.columns:
-            raw_df["total_debt"] = raw_df["current_debt"] + raw_df["non_current_debt"]
-            required_columns.append("total_debt")
+        # Calculate financial ratios using vectorized operations
+        cols = ["current_debt", "non_current_debt"]
+        raw_df[cols] = raw_df[cols].apply(pd.to_numeric, errors="coerce")
+        raw_df["total_debt"] = raw_df[cols].fillna(0).sum(axis=1)
+
+        # Pre-calculate denominator conditions
+        valid_current_liab = raw_df["current_liabilities"].ne(0)
+        valid_total_assets = raw_df["total_assets"].ne(0)
+
+        # Calculate ratios in one operation
+        ratios = pd.DataFrame(
+            {
+                "current_ratio": raw_df["current_assets"]
+                / raw_df["current_liabilities"],
+                "cash_ratio": raw_df["cash_and_equivalents"]
+                / raw_df["current_liabilities"],
+                "debt_to_assets": raw_df["total_debt"] / raw_df["total_assets"],
+            }
+        )
 
-        # Filter columns
-        available_columns = [col for col in required_columns if col in raw_df.columns]
-        return raw_df[available_columns]
+        # Apply conditions
+        cond = pd.DataFrame(
+            {
+                "current_ratio": valid_current_liab,
+                "cash_ratio": valid_current_liab,
+                "debt_to_assets": valid_total_assets,
+            },
+            index=ratios.index,
+        )
+        raw_df = raw_df.join(ratios.where(cond))
+
+        return raw_df.reindex(columns=required_columns)
 
     def _clean_income_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
         """清理和标准化利润表数据
@@ -222,15 +263,12 @@ class SinaFinancialReport(FinancialDataProvider):
                 raw_df["report_date"], format="%Y%m%d"
             )
 
-        if "更新日期" in raw_df.columns:
-            raw_df = raw_df.rename(columns={"更新日期": "update_time"})
-            raw_df["update_time"] = pd.to_datetime(raw_df["update_time"])
-
-        # Standardize column names
+        # Define column mappings and required columns
         column_mapping = {
-            "类型": "report_type",
             "币种": "currency",
             "营业总收入": "revenue",
+            "营业收入": "operating_revenue",
+            "营业总成本": "total_operating_costs",
             "营业成本": "cost_of_revenue",
             "营业利润": "operating_profit",
             "销售费用": "selling_general_and_administrative_expenses",
@@ -244,30 +282,17 @@ class SinaFinancialReport(FinancialDataProvider):
             "少数股东损益": "net_income_non_controlling_interests",
             "基本每股收益": "earnings_per_share",
             "稀释每股收益": "earnings_per_share_diluted",
+            "投资收益": "investment_income",
+            "公允价值变动收益": "fair_value_adjustments",
+            "资产减值损失": "asset_impairment_loss",
+            "财务费用": "financial_expenses",
+            "营业税金及附加": "taxes_and_surcharges",
+            "其他综合收益": "other_comprehensive_income",
+            "综合收益总额": "total_comprehensive_income",
         }
-        raw_df = raw_df.rename(columns=column_mapping)
 
-        # Select only required columns
-        required_columns = [
-            "report_date",
-            "period",
-            "currency",
-            "revenue",
-            "cost_of_revenue",
-            "operating_profit",
-            "operating_expense",
-            "selling_general_and_administrative_expenses",
-            "research_and_development",
-            "interest_expense",
-            "ebit",
-            "income_tax_expense",
-            "net_income",
-            "net_income_common_stock",
-            "net_income_non_controlling_interests",
-            "earnings_per_share",
-            "earnings_per_share_diluted",
-        ]
+        required_columns = ["report_date"] + list(column_mapping.values())
+        return raw_df.rename(columns=column_mapping).reindex(columns=required_columns)
 
-        # Filter columns
-        available_columns = [col for col in required_columns if col in raw_df.columns]
-        return raw_df[available_columns]
+    def get_financial_metrics(self):
+        pass

akshare_one/modules/info/base.py

@@ -0,0 +1,25 @@
+from abc import ABC, abstractmethod
+import pandas as pd
+
+
+class InfoDataProvider(ABC):
+    def __init__(self, symbol: str) -> None:
+        self.symbol = symbol
+
+    @abstractmethod
+    def get_basic_info(self) -> pd.DataFrame:
+        """Fetches stock basic info data
+
+        Returns:
+            pd.DataFrame:
+            - price: 最新价
+            - symbol: 股票代码
+            - name: 股票简称
+            - total_shares: 总股本
+            - float_shares: 流通股
+            - total_market_cap: 总市值
+            - float_market_cap: 流通市值
+            - industry: 行业
+            - listing_date: 上市时间
+        """
+        pass

akshare_one/modules/info/eastmoney.py

@@ -0,0 +1,52 @@
+from cachetools import cached
+import pandas as pd
+import akshare as ak
+
+from ..cache import CACHE_CONFIG
+from .base import InfoDataProvider
+
+
+class EastmoneyInfo(InfoDataProvider):
+    _basic_info_rename_map = {
+        "最新": "price",
+        "股票代码": "symbol",
+        "股票简称": "name",
+        "总股本": "total_shares",
+        "流通股": "float_shares",
+        "总市值": "total_market_cap",
+        "流通市值": "float_market_cap",
+        "行业": "industry",
+        "上市时间": "listing_date",
+    }
+
+    @cached(
+        CACHE_CONFIG["info_cache"],
+        key=lambda self, symbol=None: f"eastmoney_{symbol}",
+    )
+    def get_basic_info(self) -> pd.DataFrame:
+        """获取东方财富个股信息"""
+        info_df = ak.stock_individual_info_em(symbol=self.symbol)
+        info_df = info_df.set_index("item").T
+        info_df.reset_index(drop=True, inplace=True)
+        info_df.rename(columns=self._basic_info_rename_map, inplace=True)
+
+        if "symbol" in info_df.columns:
+            info_df["symbol"] = info_df["symbol"].astype(str)
+
+        if "listing_date" in info_df.columns:
+            info_df["listing_date"] = pd.to_datetime(
+                info_df["listing_date"], format="%Y%m%d"
+            )
+
+        numeric_cols = [
+            "price",
+            "total_shares",
+            "float_shares",
+            "total_market_cap",
+            "float_market_cap",
+        ]
+        for col in numeric_cols:
+            if col in info_df.columns:
+                info_df[col] = pd.to_numeric(info_df[col], errors="coerce")
+
+        return info_df

akshare_one/modules/info/factory.py

@@ -0,0 +1,44 @@
+from .eastmoney import EastmoneyInfo
+from .base import InfoDataProvider
+
+
+class InfoDataFactory:
+    """
+    Factory class for creating info data providers
+    """
+
+    _providers = {
+        "eastmoney": EastmoneyInfo,
+    }
+
+    @classmethod
+    def get_provider(cls, provider_name: str, **kwargs) -> InfoDataProvider:
+        """
+        Get a info data provider by name
+
+        Args:
+            provider_name: Name of the provider (e.g., 'eastmoney')
+            **kwargs: Additional arguments to pass to the provider's constructor
+
+        Returns:
+            InfoDataProvider: An instance of the requested provider
+
+        Raises:
+            ValueError: If the requested provider is not found
+        """
+        provider_class = cls._providers.get(provider_name.lower())
+        if not provider_class:
+            raise ValueError(f"Unknown info data provider: {provider_name}")
+
+        return provider_class(**kwargs)
+
+    @classmethod
+    def register_provider(cls, name: str, provider_class: type):
+        """
+        Register a new info data provider
+
+        Args:
+            name: Name to associate with this provider
+            provider_class: The provider class to register
+        """
+        cls._providers[name.lower()] = provider_class

{akshare_one-0.3.2.dist-info → akshare_one-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare-one
-Version: 0.3.2
+Version: 0.3.3
 Summary: Standardized interface for Chinese financial market data, built on AKShare with unified data formats and simplified APIs
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/zwldarren/akshare-one
@@ -9,8 +9,8 @@ Keywords: akshare,financial-data,stock-data,quant
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: akshare>=1.17.15
-Requires-Dist: cachetools>=6.1.0
+Requires-Dist: akshare>=1.17.20
+Requires-Dist: cachetools>=5.5.2
 Provides-Extra: talib
 Requires-Dist: ta-lib>=0.6.4; extra == "talib"
 Dynamic: license-file

{akshare_one-0.3.2.dist-info → akshare_one-0.3.3.dist-info}/RECORD

@@ -1,16 +1,13 @@
-akshare_one/__init__.py,sha256=W8FpPEXHDYu6JKPuAXylA3fpFt_axj3vNQC_kevjmY8,909
-akshare_one/financial.py,sha256=uCTFpcoeCxDo1iwewGPq9_TppwoHXBJFT4QlMgFOgRQ,1472
+akshare_one/__init__.py,sha256=FskUp8Xpt9eN79AA2YZMLm53XGjYj2EYvuD0jkRLWsY,6504
 akshare_one/indicators.py,sha256=x3Amff9CG_GvQpA-sqGfFwEAIvaaXlBxDfzTxD05taQ,12533
-akshare_one/insider.py,sha256=ugr7TXjZvHkaQ-3cNmXeo9LCUqfmcbIwQx-gs-RItAA,1125
-akshare_one/news.py,sha256=Pqap-23VCosG9vf70eEeFAC4O0emS-CORHjwkuDuoUA,696
-akshare_one/stock.py,sha256=VFMNn3Sqa2P9dKZueOa8ekqbxo4jc08iXS94B8eClMo,2344
-akshare_one/modules/cache.py,sha256=LBOfMQE9-Mr49GRS7d0dATGdMZCZcQWiY41p4GUI2DA,382
+akshare_one/modules/cache.py,sha256=t8zaB9mvvskivBpuS2SjiR1q07CzRNJb2xtkjyZgBPk,465
 akshare_one/modules/utils.py,sha256=msHqsjWSRULbX-3Bnit1p26a4a7MOEuNfkPSaECXr4k,333
 akshare_one/modules/eastmoney/client.py,sha256=npxW6H8tfehDBAVAsUBOD0T4zpn7OnXfM-t2ZWr02hs,3206
 akshare_one/modules/eastmoney/utils.py,sha256=0hs1kE51kZs3A9cOK448w5K8YKHaKZi0WWgtGZHVPGc,3000
-akshare_one/modules/financial/base.py,sha256=D-leZAXdKe5srbB4rrxdjNc8TWk2bflt7qtL_KBddY0,558
-akshare_one/modules/financial/factory.py,sha256=Lv66xSmmQyE8jZZvnYcgl_oZ0VUmBISN2yegsN38_oM,1345
-akshare_one/modules/financial/sina.py,sha256=xKR8RqePfi_vFBntet7e5xjvYHolVrXfOJHRK4x54b4,11187
+akshare_one/modules/financial/base.py,sha256=TG3ncf3rXfgWCk4qUORN01uxT1SgLWiyjkt5Jb9eoxo,688
+akshare_one/modules/financial/eastmoney.py,sha256=xVKJLT8kS8eZ_eQHkSMNDcMIi9CHwCIGwvuqj1cYBWw,6762
+akshare_one/modules/financial/factory.py,sha256=UV6_ebqXGkmlfcfb39aX5hBjXyBLi29WbZ4AqxaPcXU,1442
+akshare_one/modules/financial/sina.py,sha256=cclYraGz1O01fwYmY55VJCbyoT3kURCQTNENYNL7xRs,12948
 akshare_one/modules/historical/base.py,sha256=4jdHW99-5U1mzv0WPopIkxeh20yYUDrNFzn7xazfwZU,1292
 akshare_one/modules/historical/eastmoney.py,sha256=VbOaf0zXxuGmmm60x4FMh-9T5N9mYTUGmG1suMFUPfU,8489
 akshare_one/modules/historical/eastmoney_direct.py,sha256=EF5AhViBwdNywqZnJYacRrdw4Up0gbuUr7RgssK7rpw,2893
@@ -21,6 +18,9 @@ akshare_one/modules/indicators/base.py,sha256=DhFivpVIUIkdIv24U2WoOy1GCDySxsw0tD
 akshare_one/modules/indicators/factory.py,sha256=pKx57oej_L0Lz3kkXwzVievKpOYph0T_Y7fzSwO3Zd4,1021
 akshare_one/modules/indicators/simple.py,sha256=vAqE3v9HYpW-Sy6KsG9oV5fppWchQTxtz1M_508sQtY,9342
 akshare_one/modules/indicators/talib.py,sha256=w0KpV-BXVxU0LmWs_EbXJUFgo9dbMeUQijjJMkjtWtU,10773
+akshare_one/modules/info/base.py,sha256=Kof-e1I2usx1VOc1d05kyL-8B_QEDOsbry4R3dV0zZE,697
+akshare_one/modules/info/eastmoney.py,sha256=Ou4BTw_PC1tJcEpoRTqrR-hqjgcDjWHuX6InbYiCXLU,1663
+akshare_one/modules/info/factory.py,sha256=xvwPrgce0p9U4qAQBJM7FFw3zJks6m2hLHwHf0t1rfU,1308
 akshare_one/modules/insider/base.py,sha256=NE45w-B9sQ2AoUSSKNPU9U6wPHK4fiLV5Zgj_byrBMQ,977
 akshare_one/modules/insider/factory.py,sha256=32bueJA3E8yCZc0v5EAen_48RZ23yojYzpzaZyQ6WnA,1324
 akshare_one/modules/insider/xueqiu.py,sha256=6WKEvdE-8cjVQjTsJIkgnqhaQUS5sXZCyxKPLMLyers,4109
@@ -32,8 +32,8 @@ akshare_one/modules/realtime/eastmoney.py,sha256=IRAPokCm_-aOn16w5_dkbKVjdYcqL-y
 akshare_one/modules/realtime/eastmoney_direct.py,sha256=HiHrhsTcDTswMg4b7JSUXHLtf-oYziWxLGXLhFJ2pYo,1275
 akshare_one/modules/realtime/factory.py,sha256=_7jBDgqWqkt5xTTT1SpZoUHM9IpMRpcUQeyyCglM5z0,1528
 akshare_one/modules/realtime/xueqiu.py,sha256=j_cjJZD0fTva_jgXKeQAJSFVHKJHb5zMu3Crf_8zLs0,2301
-akshare_one-0.3.2.dist-info/licenses/LICENSE,sha256=3bqxoD7aU4QS7kpNtQmRd4MikxXe6Gtm_DrojyFHGAc,1087
-akshare_one-0.3.2.dist-info/METADATA,sha256=1qV4rAqnvSDrYHQHbtho8lJgXhzCvbbSdfvup6zk400,2132
-akshare_one-0.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-akshare_one-0.3.2.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
-akshare_one-0.3.2.dist-info/RECORD,,
+akshare_one-0.3.3.dist-info/licenses/LICENSE,sha256=3bqxoD7aU4QS7kpNtQmRd4MikxXe6Gtm_DrojyFHGAc,1087
+akshare_one-0.3.3.dist-info/METADATA,sha256=a2RtfPXBTGrbQu4dlHfJs_NuvHyWKnOEX4pTXhtaWKk,2132
+akshare_one-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+akshare_one-0.3.3.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
+akshare_one-0.3.3.dist-info/RECORD,,

akshare_one/financial.py

@@ -1,46 +0,0 @@
-"""财务报表数据模块
-
-包含资产负债表、利润表和现金流量表相关功能
-"""
-
-import pandas as pd
-from akshare_one.modules.financial.factory import FinancialDataFactory
-
-
-def get_balance_sheet(symbol: str, source: str = "sina") -> "pd.DataFrame":
-    """获取资产负债表数据
-
-    Args:
-        symbol: 股票代码 (如 "600600")
-        source: 数据源 ("sina")
-    """
-    if source == "sina":
-        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
-        return provider.get_balance_sheet()
-    raise ValueError(f"Unsupported data source: {source}")
-
-
-def get_income_statement(symbol: str, source: str = "sina") -> "pd.DataFrame":
-    """获取利润表数据
-
-    Args:
-        symbol: 股票代码 (如 "600600")
-        source: 数据源 ("sina")
-    """
-    if source == "sina":
-        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
-        return provider.get_income_statement()
-    raise ValueError(f"Unsupported data source: {source}")
-
-
-def get_cash_flow(symbol: str, source: str = "sina") -> "pd.DataFrame":
-    """获取现金流量表数据
-
-    Args:
-        symbol: 股票代码 (如 "600600")
-        source: 数据源 ("sina")
-    """
-    if source == "sina":
-        provider = FinancialDataFactory.get_provider(source, symbol=symbol)
-        return provider.get_cash_flow()
-    raise ValueError(f"Unsupported data source: {source}")

akshare_one/insider.py

@@ -1,33 +0,0 @@
-"""内部交易数据模块
-
-包含上市公司内部交易相关功能
-"""
-
-import pandas as pd
-from .modules.insider.factory import InsiderDataFactory
-
-
-def get_inner_trade_data(symbol: str, source: str = "xueqiu") -> "pd.DataFrame":
-    """获取雪球内部交易数据
-
-    Args:
-        source: 数据源 (目前支持 "xueqiu")
-        symbol: 股票代码，如"600000"
-
-    Returns:
-        pd.DataFrame:
-        - symbol: 股票代码
-        - issuer: 股票名称
-        - name: 变动人
-        - title: 董监高职务
-        - transaction_date: 变动日期(UTC时区)
-        - transaction_shares: 变动股数
-        - transaction_price_per_share: 成交均价
-        - shares_owned_after_transaction: 变动后持股数
-        - relationship: 与董监高关系
-        - is_board_director: 是否为董事会成员
-        - transaction_value: 交易金额(变动股数*成交均价)
-        - shares_owned_before_transaction: 变动前持股数
-    """
-    provider = InsiderDataFactory.get_provider(source, symbol=symbol)
-    return provider.get_inner_trade_data()

akshare_one/news.py

@@ -1,27 +0,0 @@
-"""新闻数据模块
-
-包含股票新闻相关功能
-"""
-
-import pandas as pd
-from .modules.news.factory import NewsDataFactory
-
-
-def get_news_data(symbol: str, source: str = "eastmoney") -> "pd.DataFrame":
-    """获取个股新闻数据
-
-    Args:
-        symbol: 股票代码 (如 "300059")
-        source: 数据源 ('eastmoney')
-
-    Returns:
-        pd.DataFrame:
-        - keyword: 关键词
-        - title: 新闻标题
-        - content: 新闻内容
-        - publish_time: 发布时间
-        - source: 文章来源
-        - url: 新闻链接
-    """
-    provider = NewsDataFactory.get_provider(source, symbol=symbol)
-    return provider.get_news_data()

akshare_one/stock.py

@@ -1,78 +0,0 @@
-"""股票市场数据模块
-
-包含股票历史数据和实时数据相关功能
-"""
-
-from typing import Optional
-import pandas as pd
-
-from akshare_one.modules.historical.factory import HistoricalDataFactory
-from akshare_one.modules.realtime.factory import RealtimeDataFactory
-
-
-def get_hist_data(
-    symbol: str,
-    interval: str = "day",
-    interval_multiplier: int = 1,
-    start_date: str = "1970-01-01",
-    end_date: str = "2030-12-31",
-    adjust: str = "none",
-    source: str = "eastmoney",
-) -> "pd.DataFrame":
-    """Get historical market data
-
-    Args:
-        symbol: 股票代码 (e.g. '600000')
-        interval: 时间间隔 ('minute','hour','day','week','month','year')
-        interval_multiplier: 时间间隔倍数 (e.g. 5 for 5 minutes)
-        start_date: 开始日期 (YYYY-MM-DD)
-        end_date: 结束日期 (YYYY-MM-DD)
-        adjust: 复权类型 ('none','qfq','hfq')
-        source: 数据源 ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')
-
-    Returns:
-        pd.DataFrame:
-        - timestamp: 时间戳(UTC时区)
-        - open: 开盘价
-        - high: 最高价
-        - low: 最低价
-        - close: 收盘价
-        - volume: 成交量
-    """
-    kwargs = {
-        "symbol": symbol,
-        "interval": interval,
-        "interval_multiplier": interval_multiplier,
-        "start_date": start_date,
-        "end_date": end_date,
-        "adjust": adjust,
-    }
-    provider = HistoricalDataFactory.get_provider(source, **kwargs)
-    return provider.get_hist_data()
-
-
-def get_realtime_data(
-    symbol: Optional[str] = None, source: str = "xueqiu"
-) -> "pd.DataFrame":
-    """Get real-time market quotes
-
-    Args:
-        symbol: 股票代码 (如 "600000")
-        source: 数据源 ('eastmoney', 'eastmoney_direct', 'xueqiu')
-
-    Returns:
-        pd.DataFrame:
-        - symbol: 股票代码
-        - price: 最新价
-        - change: 涨跌额
-        - pct_change: 涨跌幅(%)
-        - timestamp: 时间戳
-        - volume: 成交量(手)
-        - amount: 成交额(元)
-        - open: 今开
-        - high: 最高
-        - low: 最低
-        - prev_close: 昨收
-    """
-    provider = RealtimeDataFactory.get_provider(source, symbol=symbol)
-    return provider.get_current_data()