akshare-one 0.3.2__tar.gz → 0.3.3__tar.gz

{akshare_one-0.3.2 → akshare_one-0.3.3}/PKG-INFO

@@ -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.3/akshare_one/__init__.py

@@ -0,0 +1,214 @@
+"""Akshare One - Unified interface for Chinese market data
+
+Provides standardized access to various financial data sources with:
+- Consistent symbol formats
+- Unified data schemas
+- Cleaned and normalized outputs
+
+Example:
+    >>> from akshare_one import get_hist_data, get_realtime_data
+    >>> # 获取股票历史数据
+    >>> df = get_hist_data("600000", interval="day")
+    >>> print(df.head())
+    >>> # 获取股票实时数据
+    >>> df = get_realtime_data(symbol="600000")
+"""
+
+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-0.3.2 → akshare_one-0.3.3}/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-0.3.2 → akshare_one-0.3.3}/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-0.3.3/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-0.3.2 → akshare_one-0.3.3}/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