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

akshare_one/__init__.py

@@ -71,7 +71,7 @@ def get_hist_data(
 
     Returns:
         pd.DataFrame:
-        - timestamp: 时间戳(UTC时区)
+        - timestamp: 时间戳
         - open: 开盘价
         - high: 最高价
         - low: 最低价
@@ -183,13 +183,13 @@ def get_cash_flow(symbol: str, source: Literal["sina"] = "sina") -> pd.DataFrame
 
 
 def get_financial_metrics(
-    symbol: str, source: Literal["eastmoney"] = "eastmoney"
+    symbol: str, source: Literal["eastmoney_direct"] = "eastmoney_direct"
 ) -> pd.DataFrame:
     """获取三大财务报表关键指标
 
     Args:
         symbol: 股票代码 (如 "600600")
-        source: 数据源 ('eastmoney')
+        source: 数据源 ('eastmoney_direct')
 
     Returns:
         pd.DataFrame: 财务关键指标数据

akshare_one/modules/cache.py

@@ -1,10 +1,27 @@
-from cachetools import TTLCache
+from cachetools import TTLCache, cached
+import os
 
 # 缓存配置
 CACHE_CONFIG = {
     "hist_data_cache": TTLCache(maxsize=1000, ttl=3600),  # 历史数据缓存1小时
     "realtime_cache": TTLCache(maxsize=500, ttl=60),  # 实时数据缓存1分钟
-    "news_cache": TTLCache(maxsize=500, ttl=3600),
+    "news_cache": TTLCache(maxsize=500, ttl=3600),  # 新闻数据缓存1小时
     "financial_cache": TTLCache(maxsize=500, ttl=86400),  # 财务数据缓存24小时
     "info_cache": TTLCache(maxsize=500, ttl=86400),  # 信息数据缓存24小时
 }
+
+
+def cache(cache_key, key=None):
+    cache_enabled = os.getenv("AKSHARE_ONE_CACHE_ENABLED", "true").lower() in (
+        "1",
+        "true",
+        "yes",
+        "on",
+    )
+
+    def decorator(func):
+        if cache_enabled:
+            return cached(CACHE_CONFIG[cache_key], key=key)(func)
+        return func
+
+    return decorator

akshare_one/modules/financial/factory.py

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

akshare_one/modules/financial/sina.py

@@ -1,8 +1,7 @@
-from cachetools import cached
 import pandas as pd
 import akshare as ak
 
-from akshare_one.modules.cache import CACHE_CONFIG
+from ..cache import cache
 from .base import FinancialDataProvider
 
 
@@ -19,9 +18,8 @@ class SinaFinancialReport(FinancialDataProvider):
             f"sh{symbol}" if not symbol.startswith(("sh", "sz", "bj")) else symbol
         )
 
-    @cached(
-        CACHE_CONFIG["financial_cache"],
-        key=lambda self, symbol=None: f"sina_balance_{self.symbol}",
+    @cache(
+        "financial_cache", key=lambda self, symbol=None: f"sina_balance_{self.symbol}"
     )
     def get_balance_sheet(self) -> pd.DataFrame:
         """获取资产负债表数据
@@ -35,9 +33,8 @@ class SinaFinancialReport(FinancialDataProvider):
         raw_df = ak.stock_financial_report_sina(stock=self.stock, symbol="资产负债表")
         return self._clean_balance_data(raw_df)
 
-    @cached(
-        CACHE_CONFIG["financial_cache"],
-        key=lambda self, symbol=None: f"sina_income_{self.symbol}",
+    @cache(
+        "financial_cache", key=lambda self, symbol=None: f"sina_income_{self.symbol}"
     )
     def get_income_statement(self) -> pd.DataFrame:
         """获取利润表数据
@@ -51,10 +48,7 @@ class SinaFinancialReport(FinancialDataProvider):
         raw_df = ak.stock_financial_report_sina(stock=self.stock, symbol="利润表")
         return self._clean_income_data(raw_df)
 
-    @cached(
-        CACHE_CONFIG["financial_cache"],
-        key=lambda self, symbol=None: f"sina_cash_{self.symbol}",
-    )
+    @cache("financial_cache", key=lambda self, symbol=None: f"sina_cash_{self.symbol}")
     def get_cash_flow(self) -> pd.DataFrame:
         """获取现金流量表数据
 

akshare_one/modules/historical/base.py

@@ -37,7 +37,7 @@ class HistoricalDataProvider(ABC):
 
         Returns:
             pd.DataFrame:
-            - timestamp (UTC)
+            - timestamp
             - open
             - high
             - low

akshare_one/modules/historical/eastmoney.py

@@ -1,15 +1,14 @@
-from cachetools import cached
 from .base import HistoricalDataProvider
 import akshare as ak
 import pandas as pd
-from ..cache import CACHE_CONFIG
+from ..cache import cache
 
 
 class EastMoneyHistorical(HistoricalDataProvider):
     """Adapter for EastMoney historical stock data API"""
 
-    @cached(
-        cache=CACHE_CONFIG["hist_data_cache"],
+    @cache(
+        "hist_data_cache",
         key=lambda self: f"eastmoney_hist_{self.symbol}_{self.interval}_{self.interval_multiplier}_{self.adjust}",
     )
     def get_hist_data(self) -> pd.DataFrame:
@@ -157,7 +156,7 @@ class EastMoneyHistorical(HistoricalDataProvider):
         return resampled.reset_index()
 
     def _clean_minute_data(self, raw_df: pd.DataFrame, period: str) -> pd.DataFrame:
-        """Cleans and standardizes minute/hour level data, converting timestamps to UTC"""
+        """Cleans and standardizes minute/hour level data"""
         column_map = {
             "1": {
                 "时间": "timestamp",
@@ -188,16 +187,14 @@ class EastMoneyHistorical(HistoricalDataProvider):
         df = raw_df.rename(columns=mapping)
 
         if "timestamp" in df.columns:
-            df["timestamp"] = (
-                pd.to_datetime(df["timestamp"])
-                .dt.tz_localize("Asia/Shanghai")
-                .dt.tz_convert("UTC")
+            df["timestamp"] = pd.to_datetime(df["timestamp"]).dt.tz_localize(
+                "Asia/Shanghai"
             )
 
         return self._select_standard_columns(df)
 
     def _clean_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
-        """Cleans and standardizes daily and higher-level data, converting timestamps to UTC"""
+        """Cleans and standardizes daily and higher-level data"""
         column_map = {
             "日期": "timestamp",
             "开盘": "open",
@@ -217,10 +214,8 @@ class EastMoneyHistorical(HistoricalDataProvider):
         df = raw_df.rename(columns=available_columns)
 
         if "timestamp" in df.columns:
-            df["timestamp"] = (
-                pd.to_datetime(df["timestamp"])
-                .dt.tz_localize("Asia/Shanghai")
-                .dt.tz_convert("UTC")
+            df["timestamp"] = pd.to_datetime(df["timestamp"]).dt.tz_localize(
+                "Asia/Shanghai"
             )
 
         if "volume" in df.columns:

akshare_one/modules/historical/eastmoney_direct.py

@@ -1,9 +1,8 @@
 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
+from ..cache import cache
+from akshare_one.eastmoney.client import EastMoneyClient
+from akshare_one.eastmoney.utils import parse_kline_data, resample_historical_data
 
 
 class EastMoneyDirectHistorical(HistoricalDataProvider):
@@ -13,8 +12,8 @@ class EastMoneyDirectHistorical(HistoricalDataProvider):
         super().__init__(*args, **kwargs)
         self.client = EastMoneyClient()
 
-    @cached(
-        cache=CACHE_CONFIG["hist_data_cache"],
+    @cache(
+        "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:

akshare_one/modules/historical/sina.py

@@ -195,7 +195,7 @@ class SinaHistorical(HistoricalDataProvider):
         return resampled.reset_index()
 
     def _clean_minute_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
-        """Cleans and standardizes minute/hour level data, converting timestamps to UTC"""
+        """Cleans and standardizes minute/hour level data"""
         column_map = {
             "date": "timestamp",
             "open": "open",
@@ -208,16 +208,14 @@ class SinaHistorical(HistoricalDataProvider):
         df = raw_df.rename(columns=column_map)
 
         if "timestamp" in df.columns:
-            df["timestamp"] = (
-                pd.to_datetime(df["timestamp"])
-                .dt.tz_localize("Asia/Shanghai")
-                .dt.tz_convert("UTC")
+            df["timestamp"] = pd.to_datetime(df["timestamp"]).dt.tz_localize(
+                "Asia/Shanghai"
             )
 
         return self._select_standard_columns(df)
 
     def _clean_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
-        """Cleans and standardizes daily and higher-level data, converting timestamps to UTC"""
+        """Cleans and standardizes daily and higher-level data"""
         column_map = {
             "date": "timestamp",
             "open": "open",
@@ -230,10 +228,8 @@ class SinaHistorical(HistoricalDataProvider):
         df = raw_df.rename(columns=column_map)
 
         if "timestamp" in df.columns:
-            df["timestamp"] = (
-                pd.to_datetime(df["timestamp"])
-                .dt.tz_localize("Asia/Shanghai")
-                .dt.tz_convert("UTC")
+            df["timestamp"] = pd.to_datetime(df["timestamp"]).dt.tz_localize(
+                "Asia/Shanghai"
             )
 
         if "volume" in df.columns:

akshare_one/modules/info/eastmoney.py

@@ -1,8 +1,7 @@
-from cachetools import cached
 import pandas as pd
 import akshare as ak
 
-from ..cache import CACHE_CONFIG
+from ..cache import cache
 from .base import InfoDataProvider
 
 
@@ -19,8 +18,8 @@ class EastmoneyInfo(InfoDataProvider):
         "上市时间": "listing_date",
     }
 
-    @cached(
-        CACHE_CONFIG["info_cache"],
+    @cache(
+        "info_cache",
         key=lambda self, symbol=None: f"eastmoney_{symbol}",
     )
     def get_basic_info(self) -> pd.DataFrame:

akshare_one/modules/insider/base.py

@@ -16,7 +16,7 @@ class InsiderDataProvider(ABC):
             - issuer: 股票名称
             - name: 变动人
             - title: 董监高职务
-            - transaction_date: 变动日期(UTC时区)
+            - transaction_date: 变动日期
             - transaction_shares: 变动股数
             - transaction_price_per_share: 成交均价
             - shares_owned_after_transaction: 变动后持股数

akshare_one/modules/insider/xueqiu.py

@@ -1,16 +1,15 @@
-from cachetools import cached
 import pandas as pd
 import akshare as ak
 from .base import InsiderDataProvider
 from ..utils import convert_xieqiu_symbol
-from ..cache import CACHE_CONFIG
+from ..cache import cache
 
 
 class XueQiuInsider(InsiderDataProvider):
     """Provider for XueQiu insider trading data"""
 
-    @cached(
-        cache=CACHE_CONFIG["financial_cache"],
+    @cache(
+        "financial_cache",
         key=lambda self, symbol=None: f"xueqiu_insider_{symbol if symbol else 'all'}",
     )
     def get_inner_trade_data(self) -> pd.DataFrame:
@@ -87,17 +86,13 @@ class XueQiuInsider(InsiderDataProvider):
 
         # Convert date format
         if "transaction_date" in df.columns:
-            df["transaction_date"] = (
-                pd.to_datetime(df["transaction_date"])
-                .dt.tz_localize("Asia/Shanghai")
-                .dt.tz_convert("UTC")
-            )
+            df["transaction_date"] = pd.to_datetime(
+                df["transaction_date"]
+            ).dt.tz_localize("Asia/Shanghai")
 
         if "filing_date" in df.columns:
-            df["filing_date"] = (
-                pd.to_datetime(df["filing_date"])
-                .dt.tz_localize("Asia/Shanghai")
-                .dt.tz_convert("UTC")
+            df["filing_date"] = pd.to_datetime(df["filing_date"]).dt.tz_localize(
+                "Asia/Shanghai"
             )
 
         # Convert numeric columns

akshare_one/modules/news/base.py

@@ -15,7 +15,7 @@ class NewsDataProvider(ABC):
             - keyword: 关键词
             - title: 新闻标题
             - content: 新闻内容
-            - publish_time: 发布时间 (UTC)
+            - publish_time: 发布时间
             - source: 文章来源
             - url: 新闻链接
         """

akshare_one/modules/news/eastmoney.py

@@ -1,14 +1,13 @@
-from cachetools import cached
 import pandas as pd
 import akshare as ak
 
-from ..cache import CACHE_CONFIG
+from ..cache import cache
 from .base import NewsDataProvider
 
 
 class EastMoneyNews(NewsDataProvider):
-    @cached(
-        CACHE_CONFIG["news_cache"],
+    @cache(
+        "news_cache",
         key=lambda self: f"eastmoney_news_{self.symbol}",
     )
     def get_news_data(self) -> pd.DataFrame:
@@ -29,11 +28,8 @@ class EastMoneyNews(NewsDataProvider):
 
         df = raw_df.rename(columns=column_mapping)
 
-        # Convert time to UTC
-        df["publish_time"] = (
-            pd.to_datetime(df["publish_time"])
-            .dt.tz_localize("Asia/Shanghai")
-            .dt.tz_convert("UTC")
+        df["publish_time"] = pd.to_datetime(df["publish_time"]).dt.tz_localize(
+            "Asia/Shanghai"
         )
 
         required_columns = [

akshare_one/modules/realtime/eastmoney.py

@@ -1,14 +1,13 @@
-from cachetools import cached
 import pandas as pd
 import akshare as ak
 
-from ..cache import CACHE_CONFIG
+from ..cache import cache
 from .base import RealtimeDataProvider
 
 
 class EastmoneyRealtime(RealtimeDataProvider):
-    @cached(
-        CACHE_CONFIG["realtime_cache"],
+    @cache(
+        "realtime_cache",
         key=lambda self, symbol=None: f"eastmoney_{symbol if symbol else 'all'}",
     )
     def get_current_data(self) -> pd.DataFrame:
@@ -36,10 +35,7 @@ class EastmoneyRealtime(RealtimeDataProvider):
 
         df = raw_df.rename(columns=column_mapping)
 
-        # Change time to UTC
-        df = df.assign(
-            timestamp=lambda x: pd.Timestamp.now(tz="Asia/Shanghai").tz_convert("UTC")
-        )
+        df = df.assign(timestamp=lambda x: pd.Timestamp.now(tz="Asia/Shanghai"))
 
         required_columns = [
             "symbol",

akshare_one/modules/realtime/eastmoney_direct.py

@@ -1,9 +1,8 @@
 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
+from ..cache import cache
+from akshare_one.eastmoney.client import EastMoneyClient
+from akshare_one.eastmoney.utils import parse_realtime_data
 
 
 class EastMoneyDirectRealtime(RealtimeDataProvider):
@@ -13,8 +12,8 @@ class EastMoneyDirectRealtime(RealtimeDataProvider):
         super().__init__(symbol)
         self.client = EastMoneyClient()
 
-    @cached(
-        cache=CACHE_CONFIG["realtime_cache"],
+    @cache(
+        "realtime_cache",
         key=lambda self: f"eastmoney_direct_realtime_{self.symbol}",
     )
     def get_current_data(self) -> pd.DataFrame:

akshare_one/modules/realtime/xueqiu.py

@@ -1,14 +1,13 @@
-from cachetools import cached
 import pandas as pd
 import akshare as ak
 from ..utils import convert_xieqiu_symbol
-from ..cache import CACHE_CONFIG
+from ..cache import cache
 from .base import RealtimeDataProvider
 
 
 class XueQiuRealtime(RealtimeDataProvider):
-    @cached(
-        cache=CACHE_CONFIG["realtime_cache"],
+    @cache(
+        "realtime_cache",
         key=lambda self, symbol=None: f"xueqiu_{symbol}",
     )
     def get_current_data(self) -> pd.DataFrame:
@@ -43,9 +42,7 @@ class XueQiuRealtime(RealtimeDataProvider):
             ),
             "timestamp": pd.to_datetime(
                 raw_df.loc[raw_df["item"] == "时间", "value"].values[0]
-            )
-            .tz_localize("Asia/Shanghai")
-            .tz_convert("UTC"),
+            ).tz_localize("Asia/Shanghai"),
             "volume": int(raw_df.loc[raw_df["item"] == "成交量", "value"].values[0])
             / 100,
             "amount": float(raw_df.loc[raw_df["item"] == "成交额", "value"].values[0]),

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare-one
-Version: 0.3.3
+Version: 0.3.4
 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
@@ -40,7 +40,9 @@ Dynamic: license-file
 | Stock news | `get_news_data` |
 | Financial data | `get_balance_sheet`/`get_income_statement`/`get_cash_flow` |
 | Internal transactions | `get_inner_trade_data` |
-| Technical indicators | See [indicators.py](akshare_one/indicators.py) |
+| Basic stock info | `get_basic_info` |
+| Financial metrics | `get_financial_metrics` |
+| Technical indicators | See [indicators.py](akshare-one/indicators.py) |
 
 ## 📦 Quick Installation
 
@@ -67,4 +69,6 @@ df_sma = get_sma(df, window=20)
 
 ## 📚 Documentation
 
-Detailed API reference: [docs/api.md](docs/api.md)
+Full API documentation is now available on GitHub Pages:
+
+https://zwldarren.github.io/akshare-one/

akshare_one-0.3.4.dist-info/RECORD

@@ -0,0 +1,36 @@
+akshare_one/__init__.py,sha256=iqMgeNlNfxGURekZdNOopLl1L1oufkyw3s48cRqNFxo,6514
+akshare_one/indicators.py,sha256=x3Amff9CG_GvQpA-sqGfFwEAIvaaXlBxDfzTxD05taQ,12533
+akshare_one/modules/cache.py,sha256=_3n35rt9xJfQzZSV6JZ6bGzf2VnqTmLfe49WXk4c9K8,867
+akshare_one/modules/utils.py,sha256=msHqsjWSRULbX-3Bnit1p26a4a7MOEuNfkPSaECXr4k,333
+akshare_one/modules/financial/base.py,sha256=TG3ncf3rXfgWCk4qUORN01uxT1SgLWiyjkt5Jb9eoxo,688
+akshare_one/modules/financial/factory.py,sha256=9xR_uKt7n8dndYUxEGDDL65LXnbm-edtTLdhF0Bfyro,1468
+akshare_one/modules/financial/sina.py,sha256=c6rSxCVNU6h-7XWSiqPHDN_XAhRdGHdqI9Haruy3mDs,12801
+akshare_one/modules/historical/base.py,sha256=kDy76OJUp-LIddsC23YAQdf4Q_YGCrnZ8AvU4xRzQsI,1286
+akshare_one/modules/historical/eastmoney.py,sha256=B1H67o1bj8RjaKhfRu0xSA0MoQTEXz_6gRUNg138gJU,8252
+akshare_one/modules/historical/eastmoney_direct.py,sha256=cBT5_tz6a4qEV5KMiyFBdOfEVTLlJfT2o4uNBIu137Y,2854
+akshare_one/modules/historical/factory.py,sha256=qfMod5HSV-itE-i1ludIp0w8Zq7Vjp2LPomajVd5Kjc,1548
+akshare_one/modules/historical/sina.py,sha256=sQoUnQlkxyI4i7Cuw5YwKT3IoNM8-K5wleusVM_tKJA,8761
+akshare_one/modules/indicators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+akshare_one/modules/indicators/base.py,sha256=DhFivpVIUIkdIv24U2WoOy1GCDySxsw0tD0-rBRe5Lc,4376
+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=pvWLcVoVWwgZS_4Bg-OtHQW5SPCZ9I1PAFbN4yqluq0,1610
+akshare_one/modules/info/factory.py,sha256=xvwPrgce0p9U4qAQBJM7FFw3zJks6m2hLHwHf0t1rfU,1308
+akshare_one/modules/insider/base.py,sha256=bJoyNSoa0o8py6GqjlMRIEV6DbOoc2OEOyE0vmjT_n4,966
+akshare_one/modules/insider/factory.py,sha256=32bueJA3E8yCZc0v5EAen_48RZ23yojYzpzaZyQ6WnA,1324
+akshare_one/modules/insider/xueqiu.py,sha256=7PfyRioZ6KHW82sbXYcc1yNF6QGPS-kPG7i91YoxNfU,3932
+akshare_one/modules/news/base.py,sha256=t8b_RBRDQ_HyqGHQWVzojbonNJmwp2p1ckpyYPaSmdY,575
+akshare_one/modules/news/eastmoney.py,sha256=kKNBmd-PRzMJVDauL_QIrFduB_E0vp96pLCuVsE3L-k,1245
+akshare_one/modules/news/factory.py,sha256=3FMkNBpYF7l-v2NHHR5TzbvklQNzJ-R_XzG8AlRjJcg,1308
+akshare_one/modules/realtime/base.py,sha256=eYicSs7E4qmcpQ-8TnbfmJvsK0VQoezVK7Zobqh5xPk,729
+akshare_one/modules/realtime/eastmoney.py,sha256=6acJeIdrvkW4ZqM9CALithlx85QSogrlPLSo-yKhQ8w,1582
+akshare_one/modules/realtime/eastmoney_direct.py,sha256=A2ScBRfIP6n_BxQ6muB26AEykIvTG7Mt3BDAZMyugkg,1236
+akshare_one/modules/realtime/factory.py,sha256=_7jBDgqWqkt5xTTT1SpZoUHM9IpMRpcUQeyyCglM5z0,1528
+akshare_one/modules/realtime/xueqiu.py,sha256=CHTN5VUwo24H-2EGKQkN8oqr3MWjDi-7DpvQEDyPlls,2196
+akshare_one-0.3.4.dist-info/licenses/LICENSE,sha256=3bqxoD7aU4QS7kpNtQmRd4MikxXe6Gtm_DrojyFHGAc,1087
+akshare_one-0.3.4.dist-info/METADATA,sha256=ShCNaVjkVQJa41srBtN-6gKBDCfHWompMxXBSzEdO5I,2272
+akshare_one-0.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+akshare_one-0.3.4.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
+akshare_one-0.3.4.dist-info/RECORD,,

akshare_one/modules/eastmoney/client.py

@@ -1,88 +0,0 @@
-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", "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()

akshare_one/modules/eastmoney/utils.py

@@ -1,104 +0,0 @@
-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/eastmoney.py

@@ -1,184 +0,0 @@
-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.3.dist-info/RECORD

@@ -1,39 +0,0 @@
-akshare_one/__init__.py,sha256=FskUp8Xpt9eN79AA2YZMLm53XGjYj2EYvuD0jkRLWsY,6504
-akshare_one/indicators.py,sha256=x3Amff9CG_GvQpA-sqGfFwEAIvaaXlBxDfzTxD05taQ,12533
-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=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
-akshare_one/modules/historical/factory.py,sha256=qfMod5HSV-itE-i1ludIp0w8Zq7Vjp2LPomajVd5Kjc,1548
-akshare_one/modules/historical/sina.py,sha256=CI7eiXG7xo-2J6TEyq0Lr25vogAedbSa3mMHI9REgIQ,8939
-akshare_one/modules/indicators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-akshare_one/modules/indicators/base.py,sha256=DhFivpVIUIkdIv24U2WoOy1GCDySxsw0tD0-rBRe5Lc,4376
-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
-akshare_one/modules/news/base.py,sha256=D5BDtRQ9vdi1Gj-ikbtjAaCAbimW6mCEhRo_NJTmqN4,581
-akshare_one/modules/news/eastmoney.py,sha256=2gPEnzQ347MJMXAUsxxu8MnizvCrfGPse9V83wfCsXE,1380
-akshare_one/modules/news/factory.py,sha256=3FMkNBpYF7l-v2NHHR5TzbvklQNzJ-R_XzG8AlRjJcg,1308
-akshare_one/modules/realtime/base.py,sha256=eYicSs7E4qmcpQ-8TnbfmJvsK0VQoezVK7Zobqh5xPk,729
-akshare_one/modules/realtime/eastmoney.py,sha256=IRAPokCm_-aOn16w5_dkbKVjdYcqL-y7GSHrSgOjT2E,1707
-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.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,,