akshare-one 0.3.7__py3-none-any.whl → 0.3.9__py3-none-any.whl

akshare_one/__init__.py

@@ -1,214 +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: 时间戳
-        - 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"] = "eastmoney_direct",
-) -> 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_direct"] = "eastmoney_direct"
-) -> pd.DataFrame:
-    """获取三大财务报表关键指标
-
-    Args:
-        symbol: 股票代码 (如 "600600")
-        source: 数据源 ('eastmoney_direct')
-
-    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 - 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: 时间戳
+        - 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"] = "eastmoney_direct",
+) -> 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_direct"] = "eastmoney_direct"
+) -> pd.DataFrame:
+    """获取三大财务报表关键指标
+
+    Args:
+        symbol: 股票代码 (如 "600600")
+        source: 数据源 ('eastmoney_direct')
+
+    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/eastmoney/client.py

@@ -1,80 +1,80 @@
-import requests
-from typing import Dict, Any
-
-
-class EastMoneyClient:
-    """
-    A client for interacting directly with EastMoney's data APIs.
-    This class handles session management, request signing, and API calls.
-    """
-
-    def __init__(self):
-        self.session = requests.Session()
-
-    def _get_security_id(self, symbol: str) -> str:
-        """
-        Converts a stock symbol to EastMoney's internal secid format.
-        e.g., '600519' -> '1.600519', '000001' -> '0.000001'
-        """
-        symbol = symbol.upper()
-        if symbol.startswith("SZ"):
-            market = "0"
-            code = symbol[2:]
-        elif symbol.startswith("SH"):
-            market = "1"
-            code = symbol[2:]
-        elif symbol.startswith("HK"):
-            market = "116"
-            code = symbol[2:]
-        elif len(symbol) == 6:
-            if symbol.startswith(("000", "001", "002", "003", "300", "200")):
-                market = "0"
-            elif symbol.startswith(("600", "601", "603", "605", "688", "900")):
-                market = "1"
-            else:
-                market = "0"  # Default to SZ for ambiguity
-            code = symbol
-        elif len(symbol) == 5:  # HK Market
-            market = "116"
-            code = symbol
-        else:
-            market = "0"
-            code = symbol
-        return f"{market}.{code}"
-
-    def fetch_historical_klines(
-        self, symbol: str, klt: str, fqt: str, start_date: str, end_date: str
-    ) -> Dict[str, Any]:
-        """
-        Fetches historical K-line (candlestick) data.
-        """
-        url = "https://push2his.eastmoney.com/api/qt/stock/kline/get"
-        secid = self._get_security_id(symbol)
-        params = {
-            "fields1": "f1,f2,f3,f4,f5,f6",
-            "fields2": "f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61",
-            "klt": klt,
-            "fqt": fqt,
-            "secid": secid,
-            "beg": start_date,
-            "end": end_date,
-        }
-        response = self.session.get(url, params=params)
-        response.raise_for_status()
-        return response.json()
-
-    def fetch_realtime_quote(self, symbol: str) -> Dict[str, Any]:
-        """
-        Fetches real-time quote data for a single stock.
-        """
-        url = "https://push2.eastmoney.com/api/qt/stock/get"
-        secid = self._get_security_id(symbol)
-        params = {
-            "invt": "2",
-            "fltt": "2",
-            "fields": "f43,f57,f58,f169,f170,f46,f60,f44,f51,f168,f47,f164,f163,f116,f60,f45,f52,f50,f48,f167,f117,f71,f161,f49,f530",
-            "secid": secid,
-        }
-        response = self.session.get(url, params=params)
-        response.raise_for_status()
-        return response.json()
+import requests
+from typing import Dict, Any
+
+
+class EastMoneyClient:
+    """
+    A client for interacting directly with EastMoney's data APIs.
+    This class handles session management, request signing, and API calls.
+    """
+
+    def __init__(self) -> None:
+        self.session = requests.Session()
+
+    def _get_security_id(self, symbol: str) -> str:
+        """
+        Converts a stock symbol to EastMoney's internal secid format.
+        e.g., '600519' -> '1.600519', '000001' -> '0.000001'
+        """
+        symbol = symbol.upper()
+        if symbol.startswith("SZ"):
+            market = "0"
+            code = symbol[2:]
+        elif symbol.startswith("SH"):
+            market = "1"
+            code = symbol[2:]
+        elif symbol.startswith("HK"):
+            market = "116"
+            code = symbol[2:]
+        elif len(symbol) == 6:
+            if symbol.startswith(("000", "001", "002", "003", "300", "200")):
+                market = "0"
+            elif symbol.startswith(("600", "601", "603", "605", "688", "900")):
+                market = "1"
+            else:
+                market = "0"  # Default to SZ for ambiguity
+            code = symbol
+        elif len(symbol) == 5:  # HK Market
+            market = "116"
+            code = symbol
+        else:
+            market = "0"
+            code = symbol
+        return f"{market}.{code}"
+
+    def fetch_historical_klines(
+        self, symbol: str, klt: str, fqt: str, start_date: str, end_date: str
+    ) -> Dict[str, Any]:
+        """
+        Fetches historical K-line (candlestick) data.
+        """
+        url = "https://push2his.eastmoney.com/api/qt/stock/kline/get"
+        secid = self._get_security_id(symbol)
+        params = {
+            "fields1": "f1,f2,f3,f4,f5,f6",
+            "fields2": "f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61",
+            "klt": klt,
+            "fqt": fqt,
+            "secid": secid,
+            "beg": start_date,
+            "end": end_date,
+        }
+        response = self.session.get(url, params=params)
+        response.raise_for_status()
+        return response.json()  # type: ignore
+
+    def fetch_realtime_quote(self, symbol: str) -> Dict[str, Any]:
+        """
+        Fetches real-time quote data for a single stock.
+        """
+        url = "https://push2.eastmoney.com/api/qt/stock/get"
+        secid = self._get_security_id(symbol)
+        params = {
+            "invt": "2",
+            "fltt": "2",
+            "fields": "f43,f57,f58,f169,f170,f46,f60,f44,f51,f168,f47,f164,f163,f116,f60,f45,f52,f50,f48,f167,f117,f71,f161,f49,f530",
+            "secid": secid,
+        }
+        response = self.session.get(url, params=params)
+        response.raise_for_status()
+        return response.json()  # type: ignore