akshare-one 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

akshare_one/insider.py

@@ -3,19 +3,16 @@
 包含上市公司内部交易相关功能
 """
 
-from typing import Optional
 import pandas as pd
 from .modules.insider.factory import InsiderDataFactory
 
 
-def get_inner_trade_data(
-    symbol: Optional[str] = None, source: str = "xueqiu"
-) -> "pd.DataFrame":
+def get_inner_trade_data(symbol: str, source: str = "xueqiu") -> "pd.DataFrame":
     """获取雪球内部交易数据
 
     Args:
         source: 数据源 (目前支持 "xueqiu")
-        symbol: 可选股票代码，如"600000"，不传则返回所有数据
+        symbol: 股票代码，如"600000"
 
     Returns:
         pd.DataFrame:

akshare_one/modules/eastmoney/client.py

@@ -0,0 +1,88 @@
+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()
+        self.session.headers.update(
+            {
+                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36",
+                "Referer": "https://quote.eastmoney.com/",
+                "Accept": "application/json, text/plain, */*",
+                "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+            }
+        )
+
+    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")):
+                market = "0"
+            elif symbol.startswith(("600", "601", "603", "605", "688")):
+                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()

akshare_one/modules/eastmoney/utils.py

@@ -0,0 +1,104 @@
+import pandas as pd
+from typing import Dict, Any
+
+
+def parse_kline_data(data: Dict[str, Any]) -> pd.DataFrame:
+    """
+    Parses K-line data from the API response into a pandas DataFrame.
+    """
+    klines = data.get("data", {}).get("klines", [])
+    if not klines:
+        return pd.DataFrame(
+            columns=["timestamp", "open", "high", "low", "close", "volume"]
+        )
+
+    records = []
+    for kline in klines:
+        parts = kline.split(",")
+        if len(parts) >= 6:
+            records.append(
+                {
+                    "timestamp": parts[0],
+                    "open": float(parts[1]),
+                    "close": float(parts[2]),
+                    "high": float(parts[3]),
+                    "low": float(parts[4]),
+                    "volume": int(parts[5]),
+                }
+            )
+
+    df = pd.DataFrame(records)
+    if not df.empty:
+        df["timestamp"] = pd.to_datetime(df["timestamp"])
+        df["timestamp"] = (
+            df["timestamp"].dt.tz_localize("Asia/Shanghai").dt.tz_convert("UTC")
+        )
+        df = df[["timestamp", "open", "high", "low", "close", "volume"]]
+    return df
+
+
+def parse_realtime_data(data: Dict[str, Any]) -> pd.DataFrame:
+    """
+    Parses real-time quote data from the API response into a pandas DataFrame.
+    """
+    stock_data = data.get("data")
+    if not stock_data:
+        return pd.DataFrame()
+
+    df = pd.DataFrame(
+        [
+            {
+                "symbol": stock_data.get("f57"),
+                "price": stock_data.get("f43"),
+                "change": stock_data.get("f169"),
+                "pct_change": stock_data.get("f170"),
+                "volume": stock_data.get("f47"),
+                "amount": stock_data.get("f48"),
+                "open": stock_data.get("f46"),
+                "high": stock_data.get("f44"),
+                "low": stock_data.get("f45"),
+                "prev_close": stock_data.get("f60"),
+            }
+        ]
+    )
+    df["timestamp"] = pd.Timestamp.now(tz="Asia/Shanghai").tz_convert("UTC")
+    return df
+
+
+def resample_historical_data(
+    df: pd.DataFrame, interval: str, multiplier: int
+) -> pd.DataFrame:
+    """
+    Resamples historical data to a specified frequency.
+    """
+    if df.empty or multiplier <= 1:
+        return df
+
+    df = df.set_index("timestamp")
+
+    freq_map = {
+        "day": f"{multiplier}D",
+        "week": f"{multiplier}W-MON",
+        "month": f"{multiplier}MS",
+        "year": f"{multiplier * 12}MS",
+    }
+    freq = freq_map.get(interval)
+
+    if not freq:
+        return df.reset_index()
+
+    resampled = (
+        df.resample(freq)
+        .agg(
+            {
+                "open": "first",
+                "high": "max",
+                "low": "min",
+                "close": "last",
+                "volume": "sum",
+            }
+        )
+        .dropna()
+    )
+
+    return resampled.reset_index()

akshare_one/modules/financial/base.py

@@ -2,25 +2,6 @@ from abc import ABC, abstractmethod
 import pandas as pd
 
 
-def validate_financial_data(func):
-    """Decorator to validate financial data returned by data providers"""
-
-    def wrapper(*args, **kwargs):
-        df = func(*args, **kwargs)
-
-        if not isinstance(df, pd.DataFrame):
-            raise ValueError("Returned data must be a pandas DataFrame")
-
-        # Validate report_date if present
-        if "report_date" in df.columns:
-            if not pd.api.types.is_datetime64_any_dtype(df["report_date"]):
-                raise ValueError("report_date must be datetime64 dtype")
-
-        return df
-
-    return wrapper
-
-
 class FinancialDataProvider(ABC):
     def __init__(self, symbol: str) -> None:
         self.symbol = symbol

akshare_one/modules/financial/sina.py

@@ -3,7 +3,7 @@ import pandas as pd
 import akshare as ak
 
 from akshare_one.modules.cache import CACHE_CONFIG
-from .base import FinancialDataProvider, validate_financial_data
+from .base import FinancialDataProvider
 
 
 class SinaFinancialReport(FinancialDataProvider):
@@ -13,7 +13,6 @@ class SinaFinancialReport(FinancialDataProvider):
             f"sh{symbol}" if not symbol.startswith(("sh", "sz", "bj")) else symbol
         )
 
-    @validate_financial_data
     @cached(
         CACHE_CONFIG["financial_cache"],
         key=lambda self, symbol=None: f"sina_balance_{self.symbol}",
@@ -30,7 +29,6 @@ class SinaFinancialReport(FinancialDataProvider):
         raw_df = ak.stock_financial_report_sina(stock=self.stock, symbol="资产负债表")
         return self._clean_balance_data(raw_df)
 
-    @validate_financial_data
     @cached(
         CACHE_CONFIG["financial_cache"],
         key=lambda self, symbol=None: f"sina_income_{self.symbol}",
@@ -47,7 +45,6 @@ class SinaFinancialReport(FinancialDataProvider):
         raw_df = ak.stock_financial_report_sina(stock=self.stock, symbol="利润表")
         return self._clean_income_data(raw_df)
 
-    @validate_financial_data
     @cached(
         CACHE_CONFIG["financial_cache"],
         key=lambda self, symbol=None: f"sina_cash_{self.symbol}",

akshare_one/modules/historical/base.py

@@ -2,31 +2,6 @@ from abc import ABC, abstractmethod
 import pandas as pd
 
 
-def validate_hist_data(func):
-    """Decorator to validate historical data returned by data providers"""
-
-    def wrapper(*args, **kwargs):
-        df = func(*args, **kwargs)
-
-        if not isinstance(df, pd.DataFrame):
-            raise ValueError("Returned data must be a pandas DataFrame")
-
-        required_columns = {"timestamp", "open", "high", "low", "close", "volume"}
-        missing_cols = required_columns - set(df.columns)
-        if missing_cols:
-            raise ValueError(f"Missing required columns: {missing_cols}")
-
-        if "timestamp" in df.columns:
-            if not pd.api.types.is_datetime64_any_dtype(df["timestamp"]):
-                raise ValueError("timestamp must be datetime64 dtype")
-            if df["timestamp"].dt.tz is None or str(df["timestamp"].dt.tz) != "UTC":
-                raise ValueError("timestamp must be in UTC timezone")
-
-        return df
-
-    return wrapper
-
-
 class HistoricalDataProvider(ABC):
     def __init__(
         self,

akshare_one/modules/historical/eastmoney.py

@@ -1,5 +1,5 @@
 from cachetools import cached
-from .base import HistoricalDataProvider, validate_hist_data
+from .base import HistoricalDataProvider
 import akshare as ak
 import pandas as pd
 from ..cache import CACHE_CONFIG
@@ -8,7 +8,6 @@ from ..cache import CACHE_CONFIG
 class EastMoneyHistorical(HistoricalDataProvider):
     """Adapter for EastMoney historical stock data API"""
 
-    @validate_hist_data
     @cached(
         cache=CACHE_CONFIG["hist_data_cache"],
         key=lambda self: f"eastmoney_hist_{self.symbol}_{self.interval}_{self.interval_multiplier}_{self.adjust}",

akshare_one/modules/historical/eastmoney_direct.py

@@ -0,0 +1,79 @@
+import pandas as pd
+from cachetools import cached
+from .base import HistoricalDataProvider
+from ..cache import CACHE_CONFIG
+from ..eastmoney.client import EastMoneyClient
+from ..eastmoney.utils import parse_kline_data, resample_historical_data
+
+
+class EastMoneyDirectHistorical(HistoricalDataProvider):
+    """Direct implementation for EastMoney historical stock data API"""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.client = EastMoneyClient()
+
+    @cached(
+        cache=CACHE_CONFIG["hist_data_cache"],
+        key=lambda self: f"eastmoney_direct_hist_{self.symbol}_{self.interval}_{self.interval_multiplier}_{self.adjust}",
+    )
+    def get_hist_data(self) -> pd.DataFrame:
+        """Fetches EastMoney historical market data directly from API"""
+        self.interval = self.interval.lower()
+        self._validate_interval_params()
+
+        try:
+            klt = self._get_kline_type()
+            fqt = self._get_adjust_type()
+            start_date = self.start_date.replace("-", "")
+            end_date = self.end_date.replace("-", "")
+
+            raw_data = self.client.fetch_historical_klines(
+                symbol=self.symbol,
+                klt=klt,
+                fqt=fqt,
+                start_date=start_date,
+                end_date=end_date,
+            )
+
+            if raw_data.get("rc") != 0:
+                raise ValueError(f"API returned error: {raw_data.get('msg')}")
+
+            df = parse_kline_data(raw_data)
+
+            df = resample_historical_data(df, self.interval, self.interval_multiplier)
+
+            return df
+
+        except Exception as e:
+            raise ValueError(f"Failed to fetch historical data for {self.symbol}: {e}")
+
+    def _get_kline_type(self) -> str:
+        """Get K-line type based on interval."""
+        kline_map = {
+            "minute": "1",
+            "hour": "60",
+            "day": "101",
+            "week": "102",
+            "month": "103",
+            "year": "103",
+        }
+
+        base_klt = kline_map.get(self.interval, "101")
+
+        if self.interval == "minute" and self.interval_multiplier in [5, 15, 30, 60]:
+            return str(self.interval_multiplier)
+
+        return base_klt
+
+    def _get_adjust_type(self) -> str:
+        """Get adjustment type."""
+        adjust_map = {"none": "0", "qfq": "1", "hfq": "2"}
+        return adjust_map.get(self.adjust, "0")
+
+    def _validate_interval_params(self) -> None:
+        """Validates the interval and multiplier."""
+        if self.interval not in self.get_supported_intervals():
+            raise ValueError(f"Unsupported interval: {self.interval}")
+        if self.interval in ["minute", "hour"] and self.interval_multiplier < 1:
+            raise ValueError("Interval multiplier must be >= 1 for minute/hour.")

akshare_one/modules/historical/factory.py

@@ -1,5 +1,6 @@
 from .base import HistoricalDataProvider
 from .eastmoney import EastMoneyHistorical
+from .eastmoney_direct import EastMoneyDirectHistorical
 from .sina import SinaHistorical
 
 
@@ -10,6 +11,7 @@ class HistoricalDataFactory:
 
     _providers = {
         "eastmoney": EastMoneyHistorical,
+        "eastmoney_direct": EastMoneyDirectHistorical,
         "sina": SinaHistorical,
     }
 

akshare_one/modules/historical/sina.py

@@ -1,5 +1,5 @@
 from cachetools import cached
-from .base import HistoricalDataProvider, validate_hist_data
+from .base import HistoricalDataProvider
 import akshare as ak
 import pandas as pd
 from ..cache import CACHE_CONFIG
@@ -8,7 +8,6 @@ from ..cache import CACHE_CONFIG
 class SinaHistorical(HistoricalDataProvider):
     """Adapter for Sina historical stock data API"""
 
-    @validate_hist_data
     @cached(
         cache=CACHE_CONFIG["hist_data_cache"],
         key=lambda self: f"sina_hist_{self.symbol}_{self.interval}_{self.interval_multiplier}_{self.adjust}",

akshare_one/modules/insider/base.py

@@ -1,63 +1,13 @@
 from abc import ABC, abstractmethod
 import pandas as pd
-from typing import Optional
-
-
-def validate_insider_data(func):
-    """Decorator to validate insider trading data returned by data providers"""
-
-    def wrapper(*args, **kwargs):
-        df = func(*args, **kwargs)
-
-        if not isinstance(df, pd.DataFrame):
-            raise ValueError("Returned data must be a pandas DataFrame")
-
-        # Required fields for insider trading data
-        required_fields = {
-            "symbol",
-            "issuer",
-            "name",
-            "transaction_date",
-            "transaction_shares",
-            "transaction_price_per_share",
-        }
-        if not required_fields.issubset(df.columns):
-            missing = required_fields - set(df.columns)
-            raise ValueError(f"Missing required fields: {missing}")
-
-        # Validate timestamp if present
-        if "transaction_date" in df.columns:
-            if not pd.api.types.is_datetime64_any_dtype(df["transaction_date"]):
-                raise ValueError("transaction_date must be datetime64 dtype")
-            if (
-                df["transaction_date"].dt.tz is None
-                or str(df["transaction_date"].dt.tz) != "UTC"
-            ):
-                raise ValueError("transaction_date must be in UTC timezone")
-
-        # Validate numeric fields
-        numeric_fields = {
-            "transaction_shares",
-            "transaction_price_per_share",
-            "transaction_value",
-            "shares_owned_before_transaction",
-            "shares_owned_after_transaction",
-        }
-        for field in numeric_fields & set(df.columns):
-            if not pd.api.types.is_numeric_dtype(df[field]):
-                raise ValueError(f"{field} must be numeric")
-
-        return df
-
-    return wrapper
 
 
 class InsiderDataProvider(ABC):
-    def __init__(self, symbol: Optional[str] = None) -> None:
+    def __init__(self, symbol: str) -> None:
         self.symbol = symbol
 
     @abstractmethod
-    def get_inner_trade_data(self, symbol: Optional[str] = None) -> pd.DataFrame:
+    def get_inner_trade_data(self) -> pd.DataFrame:
         """Fetches insider trade data
 
         Returns:

akshare_one/modules/insider/xueqiu.py

@@ -1,7 +1,7 @@
 from cachetools import cached
 import pandas as pd
 import akshare as ak
-from .base import InsiderDataProvider, validate_insider_data
+from .base import InsiderDataProvider
 from ..utils import convert_xieqiu_symbol
 from ..cache import CACHE_CONFIG
 
@@ -9,7 +9,6 @@ from ..cache import CACHE_CONFIG
 class XueQiuInsider(InsiderDataProvider):
     """Provider for XueQiu insider trading data"""
 
-    @validate_insider_data
     @cached(
         cache=CACHE_CONFIG["financial_cache"],
         key=lambda self, symbol=None: f"xueqiu_insider_{symbol if symbol else 'all'}",

akshare_one/modules/news/base.py

@@ -2,35 +2,6 @@ from abc import ABC, abstractmethod
 import pandas as pd
 
 
-def validate_news_data(func):
-    """Decorator to validate news data returned by data providers"""
-
-    def wrapper(*args, **kwargs):
-        df = func(*args, **kwargs)
-
-        if not isinstance(df, pd.DataFrame):
-            raise ValueError("Returned data must be a pandas DataFrame")
-
-        # Required fields
-        required_fields = {"title", "publish_time"}
-        if not required_fields & set(df.columns):
-            raise ValueError(f"Must contain all required fields: {required_fields}")
-
-        # Validate publish_time if present
-        if "publish_time" in df.columns:
-            if not pd.api.types.is_datetime64_any_dtype(df["publish_time"]):
-                raise ValueError("publish_time must be datetime64 dtype")
-            if (
-                df["publish_time"].dt.tz is None
-                or str(df["publish_time"].dt.tz) != "UTC"
-            ):
-                raise ValueError("publish_time must be in UTC timezone")
-
-        return df
-
-    return wrapper
-
-
 class NewsDataProvider(ABC):
     def __init__(self, symbol: str) -> None:
         self.symbol = symbol

akshare_one/modules/news/eastmoney.py

@@ -3,11 +3,10 @@ import pandas as pd
 import akshare as ak
 
 from ..cache import CACHE_CONFIG
-from .base import NewsDataProvider, validate_news_data
+from .base import NewsDataProvider
 
 
 class EastMoneyNews(NewsDataProvider):
-    @validate_news_data
     @cached(
         CACHE_CONFIG["news_cache"],
         key=lambda self: f"eastmoney_news_{self.symbol}",

akshare_one/modules/realtime/base.py

@@ -2,47 +2,6 @@ from abc import ABC, abstractmethod
 import pandas as pd
 
 
-def validate_realtime_data(func):
-    """Decorator to validate realtime data returned by data providers"""
-
-    def wrapper(*args, **kwargs):
-        df = func(*args, **kwargs)
-
-        if not isinstance(df, pd.DataFrame):
-            raise ValueError("Returned data must be a pandas DataFrame")
-
-        # At least one of these core fields must be present
-        core_fields = {"timestamp", "price", "volume"}
-        if not core_fields & set(df.columns):
-            raise ValueError(f"Must contain at least one of: {core_fields}")
-
-        # Validate timestamp if present
-        if "timestamp" in df.columns:
-            if not pd.api.types.is_datetime64_any_dtype(df["timestamp"]):
-                raise ValueError("timestamp must be datetime64 dtype")
-            if df["timestamp"].dt.tz is None or str(df["timestamp"].dt.tz) != "UTC":
-                raise ValueError("timestamp must be in UTC timezone")
-
-        # Validate numeric fields if present
-        numeric_fields = {
-            "price",
-            "change",
-            "pct_change",
-            "open",
-            "high",
-            "low",
-            "prev_close",
-            "amount",
-        }
-        for field in numeric_fields & set(df.columns):
-            if not pd.api.types.is_numeric_dtype(df[field]):
-                raise ValueError(f"{field} must be numeric")
-
-        return df
-
-    return wrapper
-
-
 class RealtimeDataProvider(ABC):
     def __init__(self, symbol: str) -> None:
         self.symbol = symbol

akshare_one/modules/realtime/eastmoney.py

@@ -3,11 +3,10 @@ import pandas as pd
 import akshare as ak
 
 from ..cache import CACHE_CONFIG
-from .base import RealtimeDataProvider, validate_realtime_data
+from .base import RealtimeDataProvider
 
 
 class EastmoneyRealtime(RealtimeDataProvider):
-    @validate_realtime_data
     @cached(
         CACHE_CONFIG["realtime_cache"],
         key=lambda self, symbol=None: f"eastmoney_{symbol if symbol else 'all'}",

akshare_one/modules/realtime/eastmoney_direct.py

@@ -0,0 +1,37 @@
+import pandas as pd
+from cachetools import cached
+from .base import RealtimeDataProvider
+from ..cache import CACHE_CONFIG
+from ..eastmoney.client import EastMoneyClient
+from ..eastmoney.utils import parse_realtime_data
+
+
+class EastMoneyDirectRealtime(RealtimeDataProvider):
+    """Direct implementation for EastMoney realtime stock data API"""
+
+    def __init__(self, symbol: str):
+        super().__init__(symbol)
+        self.client = EastMoneyClient()
+
+    @cached(
+        cache=CACHE_CONFIG["realtime_cache"],
+        key=lambda self: f"eastmoney_direct_realtime_{self.symbol}",
+    )
+    def get_current_data(self) -> pd.DataFrame:
+        """Get real-time stock data"""
+        try:
+            raw_data = self.client.fetch_realtime_quote(self.symbol)
+
+            if raw_data.get("rc") != 0:
+                raise ValueError(f"API returned error: {raw_data.get('msg')}")
+
+            df = parse_realtime_data(raw_data)
+
+            # Ensure the output matches the base class definition
+            if self.symbol:
+                df = df[df["symbol"] == self.symbol].reset_index(drop=True)
+
+            return df
+
+        except Exception as e:
+            raise ValueError(f"Failed to get real-time data for {self.symbol}: {e}")

akshare_one/modules/realtime/factory.py

@@ -1,6 +1,7 @@
 from .eastmoney import EastmoneyRealtime
 from .xueqiu import XueQiuRealtime
 from .base import RealtimeDataProvider
+from .eastmoney_direct import EastMoneyDirectRealtime
 
 
 class RealtimeDataFactory:
@@ -11,6 +12,7 @@ class RealtimeDataFactory:
     _providers = {
         "eastmoney": EastmoneyRealtime,
         "xueqiu": XueQiuRealtime,
+        "eastmoney_direct": EastMoneyDirectRealtime,
     }
 
     @classmethod

akshare_one/modules/realtime/xueqiu.py

@@ -3,11 +3,10 @@ import pandas as pd
 import akshare as ak
 from ..utils import convert_xieqiu_symbol
 from ..cache import CACHE_CONFIG
-from .base import RealtimeDataProvider, validate_realtime_data
+from .base import RealtimeDataProvider
 
 
 class XueQiuRealtime(RealtimeDataProvider):
-    @validate_realtime_data
     @cached(
         cache=CACHE_CONFIG["realtime_cache"],
         key=lambda self, symbol=None: f"xueqiu_{symbol}",

akshare_one/stock.py

@@ -28,7 +28,7 @@ def get_hist_data(
         start_date: 开始日期 (YYYY-MM-DD)
         end_date: 结束日期 (YYYY-MM-DD)
         adjust: 复权类型 ('none','qfq','hfq')
-        source: 数据源 ('eastmoney', 'sina')
+        source: 数据源 ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')
 
     Returns:
         pd.DataFrame:
@@ -58,7 +58,7 @@ def get_realtime_data(
 
     Args:
         symbol: 股票代码 (如 "600000")
-        source: 数据源 ('eastmoney', 'xueqiu')
+        source: 数据源 ('eastmoney', 'eastmoney_direct', 'xueqiu')
 
     Returns:
         pd.DataFrame:

{akshare_one-0.2.0.dist-info → akshare_one-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare-one
-Version: 0.2.0
+Version: 0.2.2
 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,35 +9,35 @@ Keywords: akshare,financial-data,stock-data,quant
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: akshare>=1.16.94
-Requires-Dist: cachetools>=5.5.2
+Requires-Dist: akshare>=1.16.98
+Requires-Dist: cachetools>=6.0.0
 Dynamic: license-file
 
 <div align="center">
   <h1>AKShare One</h1>
   <div>
-    <strong>English</strong> | <a href="README_zh.md">中文</a>
+    <a href="README_zh.md">中文</a> | <strong>English</strong>
   </div>
 </div>
 
-**AKShare One** is a standardized interface for Chinese financial market data, built as a wrapper around [AKShare](https://github.com/akfamily/akshare) to solve inconsistencies in input/output formats across different data sources.
+**AKShare One** is a data interface for obtaining Chinese A-shares, based on [AKShare](https://github.com/akfamily/akshare). It aims to simplify AKShare's usage and unify input/output formats from different data sources, making it easier to pass data to LLM.
 
 ## ✨ Features
 
 - 📊 Unified stock code formats across data sources
 - 🏗️ Standardized return data structures
-- 🛠️ Simplified API parameters
+- 🛠️ Simplified API parameter design
 - ⏱️ Automatic timestamp and adjustment handling
 
 ## 🚀 Core Features
 
-| Feature | Interface |
-|---------|-----------|
+| Function | Interface |
+|------|------|
 | Historical data | `get_hist_data` |
 | Real-time quotes | `get_realtime_data` |
 | Stock news | `get_news_data` |
 | Financial data | `get_balance_sheet`/`get_income_statement`/`get_cash_flow` |
-| Insider trading | `get_inner_trade_data` |
+| Internal transactions | `get_inner_trade_data` |
 
 ## 📦 Quick Installation
 

akshare_one-0.2.2.dist-info/RECORD

@@ -0,0 +1,33 @@
+akshare_one/__init__.py,sha256=M4eXCnBzGqa5FihT-q7DHaluTvidnqwVF7AgPgCikKU,878
+akshare_one/financial.py,sha256=XAsonRzGK8akKtW2Q7LUrew4OFRnRAfZm0nw0JY73Jc,1426
+akshare_one/insider.py,sha256=fM6wvlLSGm7a2NkQFvxEK2PkhN5WudrO-V0BboVz2Bo,1092
+akshare_one/news.py,sha256=yrYeCaKTgCGP-TSyOfOou9gMw8185qiWrg380fD9-f8,669
+akshare_one/stock.py,sha256=kldPmfggrgUH8pEcU8HGR5ofsxzYXJiUqj8GXCM5pBk,2266
+akshare_one/modules/cache.py,sha256=47A80Xtfr4gkKvEfBQrT8Dz8hNFR769rBa2gU6ew25s,373
+akshare_one/modules/utils.py,sha256=H4nrGf8m4_ezTiW5-OcNPxpV-neTYfffEfaOLDFLY9Y,323
+akshare_one/modules/eastmoney/client.py,sha256=_fOXtvAbs65WHY3s2Ge1bsCTpVDbfkNj9yaVErF6GoU,3104
+akshare_one/modules/eastmoney/utils.py,sha256=KzT0x6dF8y6wgc9Wzewr450NCee1i_dK2EhocBJQc5g,2896
+akshare_one/modules/financial/base.py,sha256=qj_XeujG7Tn2oO1niuIG4s7lMH3xg5zERDbcj75DUnU,536
+akshare_one/modules/financial/factory.py,sha256=GqzFp6LoHWj7t5VwtZJkLFxBuaAW_0b__bduBrmlcOg,1301
+akshare_one/modules/financial/sina.py,sha256=Hf6fVeN0gClS9GU2N9Hg6QJ1f8X4mecpEA6KWVgiwTc,10914
+akshare_one/modules/historical/base.py,sha256=UeKfMU_k8SgazXn27M1FVNaYJ5vBNgUB0jVBDpgXnz8,980
+akshare_one/modules/historical/eastmoney.py,sha256=2bYXobIwlrd5vG8pHlUZVE6edjQqn8AEGCVFGcWCCKk,8248
+akshare_one/modules/historical/eastmoney_direct.py,sha256=QRgGrY6NhAB2NAWCh_H3G0q2wKnSEnYQBRjMq-GjXGM,2814
+akshare_one/modules/historical/factory.py,sha256=K1JwhScNPvuP-wR33C5VnosJYXJ3u1RykJuaMU6-3ls,1500
+akshare_one/modules/historical/sina.py,sha256=R-5hBOP5zslDuC0qfzw5zNhQyWmbmkmqB2sI2WhKVgI,7249
+akshare_one/modules/insider/base.py,sha256=xOhBDzMtZd1DutsHaJWe931P17fgW7dlivo1vz5ZflI,949
+akshare_one/modules/insider/factory.py,sha256=om51vX-GTXknpptZGvmDD9m10FfgEVmy402xZ3bBsNM,1280
+akshare_one/modules/insider/xueqiu.py,sha256=2gmSrcer8qw2Jb80kYT3tHNJ3U88hxd0dJSfoh846EY,3971
+akshare_one/modules/news/base.py,sha256=yrBZf1q1QwJkCXygNmeLIEjvcqm1iti63tjb3s40L_4,559
+akshare_one/modules/news/eastmoney.py,sha256=efVT4plk03s8TbSfhAhRLWgMLlR5G_2G0xGZTQgSxmY,1333
+akshare_one/modules/news/factory.py,sha256=Em6c7m46K760iwIX3GZ15HdFu7pXT2w-n4QsjwHezjY,1264
+akshare_one/modules/realtime/base.py,sha256=XtD-4L1pCrMtfbwtZR7tP_BhWB_eMWtpQr89rAdX7P4,702
+akshare_one/modules/realtime/eastmoney.py,sha256=7IR35dwPr5xj0ErdBajYwyBivEoi55wd1Q5c0DEjUAI,1650
+akshare_one/modules/realtime/eastmoney_direct.py,sha256=yFH1fNcZRieyxFN5YzX7Gcw5-CR-dUEgUHSeR0NPD0g,1238
+akshare_one/modules/realtime/factory.py,sha256=qHdCDY6dA7ck4JgK3yUDqcne9WrruAA6XzbRT69kT2w,1480
+akshare_one/modules/realtime/xueqiu.py,sha256=LKu0fW0EMt3c2m1w2kqBbEt9s2TcHUeBFpbFtueJgbU,2241
+akshare_one-0.2.2.dist-info/licenses/LICENSE,sha256=Gg6A1GNSJCZWQ73aHJ7TXOa0i8RQ3FejZCTZ6Db07cU,1066
+akshare_one-0.2.2.dist-info/METADATA,sha256=vprtEz4JO60IGhEU4DoHpMmuuZ2WLAedIGLKjQVOCK8,1897
+akshare_one-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+akshare_one-0.2.2.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
+akshare_one-0.2.2.dist-info/RECORD,,

{akshare_one-0.2.0.dist-info → akshare_one-0.2.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

akshare_one-0.2.0.dist-info/RECORD

@@ -1,29 +0,0 @@
-akshare_one/__init__.py,sha256=M4eXCnBzGqa5FihT-q7DHaluTvidnqwVF7AgPgCikKU,878
-akshare_one/financial.py,sha256=XAsonRzGK8akKtW2Q7LUrew4OFRnRAfZm0nw0JY73Jc,1426
-akshare_one/insider.py,sha256=fnbVT--7jGCvULhsiKNqLmZggo1VmR-eNOr4iq5BI7I,1179
-akshare_one/news.py,sha256=yrYeCaKTgCGP-TSyOfOou9gMw8185qiWrg380fD9-f8,669
-akshare_one/stock.py,sha256=K8KOHxHszHoWmdhgO4sj-6zfIUSMS--0PdzgsAOGk88,2203
-akshare_one/modules/cache.py,sha256=47A80Xtfr4gkKvEfBQrT8Dz8hNFR769rBa2gU6ew25s,373
-akshare_one/modules/utils.py,sha256=H4nrGf8m4_ezTiW5-OcNPxpV-neTYfffEfaOLDFLY9Y,323
-akshare_one/modules/financial/base.py,sha256=JRZJhzl7kP16KEVOXP9mq1DjXW6rga2FJ8-sI5FH814,1107
-akshare_one/modules/financial/factory.py,sha256=GqzFp6LoHWj7t5VwtZJkLFxBuaAW_0b__bduBrmlcOg,1301
-akshare_one/modules/financial/sina.py,sha256=gHrbmykselWZC5tqR1Zkyc3oK0TcCCdCn_1z_8C2y_U,11026
-akshare_one/modules/historical/base.py,sha256=hIk-DKxaDXfx9y9VWx-b918ntv6pCeqxjHpAiS7A5ZQ,1895
-akshare_one/modules/historical/eastmoney.py,sha256=8lTZjbQ-P713vBvJxXTBmn6hPpNslWf5uAW8R6HJtyo,8292
-akshare_one/modules/historical/factory.py,sha256=adxNNo_-PT180QXRUNwkdiN5x0lDJpPCt6rNFZcJ0ps,1389
-akshare_one/modules/historical/sina.py,sha256=d-AWr4C72nvPYOC9IETqUXDoksofztWyoe9Ie9TC9Z0,7293
-akshare_one/modules/insider/base.py,sha256=_TDvHr6TZa0sTynE_ZL0njnms-cb5Wd8hfqR7pdfvrU,2728
-akshare_one/modules/insider/factory.py,sha256=om51vX-GTXknpptZGvmDD9m10FfgEVmy402xZ3bBsNM,1280
-akshare_one/modules/insider/xueqiu.py,sha256=8ZBRn8tW4r0aTEsoaQuYzcNQ-q2oQ64Cn7VG_Hs8hhE,4021
-akshare_one/modules/news/base.py,sha256=L55BLQionqTZGmrHZDpmNKuhcWQdIN8ZKR9jsMj1Bgo,1550
-akshare_one/modules/news/eastmoney.py,sha256=iuZgpvub9zKDJNtGIShFXBQRHIG10oEvdMiYFDvbsdI,1377
-akshare_one/modules/news/factory.py,sha256=Em6c7m46K760iwIX3GZ15HdFu7pXT2w-n4QsjwHezjY,1264
-akshare_one/modules/realtime/base.py,sha256=Yztkh9IhCr0Y-N8SH81APL9uNr4ZMd10B5KfcC6Ekcg,2093
-akshare_one/modules/realtime/eastmoney.py,sha256=PPfRC3LUIH0HWbjkgfHgoER5Aq8CtqGFbazjJdYFqcQ,1702
-akshare_one/modules/realtime/factory.py,sha256=SxDvJJvp6VutRqLUGYRnrUBtJEOE0N7vVh5Rw-vJ6NY,1373
-akshare_one/modules/realtime/xueqiu.py,sha256=WnSRktk4eyFV8_8c9SpCtL6UN08vdZdzFpCyhMyLRPM,2293
-akshare_one-0.2.0.dist-info/licenses/LICENSE,sha256=Gg6A1GNSJCZWQ73aHJ7TXOa0i8RQ3FejZCTZ6Db07cU,1066
-akshare_one-0.2.0.dist-info/METADATA,sha256=glFdSHMMfGgYlg1DIZvQ1r0xKnMCQHFgV215lM2pmbo,1865
-akshare_one-0.2.0.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-akshare_one-0.2.0.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
-akshare_one-0.2.0.dist-info/RECORD,,