akshare-one 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

akshare_one/adapters/__init__.py

@@ -4,4 +4,4 @@ from .sina import SinaAdapter
 from .xueqiu import XueQiuAdapter
 from .cache.cache import CACHE_CONFIG
 
-__all__ = ['EastMoneyAdapter', 'SinaAdapter', 'XueQiuAdapter', 'CACHE_CONFIG']
+__all__ = ["EastMoneyAdapter", "SinaAdapter", "XueQiuAdapter", "CACHE_CONFIG"]

akshare_one/adapters/cache/cache.py

@@ -2,8 +2,8 @@ from cachetools import TTLCache
 
 # 缓存配置
 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),
-    'financial_cache': TTLCache(maxsize=500, ttl=86400),  # 财务数据缓存24小时
+    "hist_data_cache": TTLCache(maxsize=1000, ttl=3600),  # 历史数据缓存1小时
+    "realtime_cache": TTLCache(maxsize=500, ttl=60),  # 实时数据缓存1分钟
+    "news_cache": TTLCache(maxsize=500, ttl=3600),
+    "financial_cache": TTLCache(maxsize=500, ttl=86400),  # 财务数据缓存24小时
 }

akshare_one/adapters/eastmoney.py

@@ -16,7 +16,15 @@ class EastMoneyAdapter:
         interval_multiplier,
         start_date,
         end_date,
-        adjust: ("eastmoney", symbol, interval, interval_multiplier, start_date, end_date, adjust),
+        adjust: (
+            "eastmoney",
+            symbol,
+            interval,
+            interval_multiplier,
+            start_date,
+            end_date,
+            adjust,
+        ),
     )
     def get_hist_data(
         self,
@@ -137,7 +145,10 @@ class EastMoneyAdapter:
         # Standardize the data format
         return self._clean_data(raw_df)
 
-    @cached(CACHE_CONFIG["realtime_cache"], key=lambda self, symbol=None: f"eastmoney_{symbol if symbol else 'all'}")
+    @cached(
+        CACHE_CONFIG["realtime_cache"],
+        key=lambda self, symbol=None: f"eastmoney_{symbol if symbol else 'all'}",
+    )
     def get_realtime_data(self, symbol: Optional[str] = None) -> pd.DataFrame:
         """获取沪深京A股实时行情数据"""
         raw_df = ak.stock_zh_a_spot_em()

akshare_one/adapters/sina.py

@@ -12,7 +12,10 @@ class SinaAdapter:
     - Historical market data
     """
 
-    @cached(CACHE_CONFIG["financial_cache"], key=lambda self, symbol: f"sina_balance_{symbol}")
+    @cached(
+        CACHE_CONFIG["financial_cache"],
+        key=lambda self, symbol: f"sina_balance_{symbol}",
+    )
     def get_balance_sheet(self, symbol: str) -> pd.DataFrame:
         """获取资产负债表数据
 
@@ -26,7 +29,10 @@ class SinaAdapter:
         raw_df = ak.stock_financial_report_sina(stock=stock, symbol="资产负债表")
         return self._clean_balance_data(raw_df)
 
-    @cached(CACHE_CONFIG["financial_cache"], key=lambda self, symbol: f"sina_income_{symbol}")
+    @cached(
+        CACHE_CONFIG["financial_cache"],
+        key=lambda self, symbol: f"sina_income_{symbol}",
+    )
     def get_income_statement(self, symbol: str) -> pd.DataFrame:
         """获取利润表数据
 
@@ -40,7 +46,9 @@ class SinaAdapter:
         raw_df = ak.stock_financial_report_sina(stock=stock, symbol="利润表")
         return self._clean_income_data(raw_df)
 
-    @cached(CACHE_CONFIG["financial_cache"], key=lambda self, symbol: f"sina_cash_{symbol}")
+    @cached(
+        CACHE_CONFIG["financial_cache"], key=lambda self, symbol: f"sina_cash_{symbol}"
+    )
     def get_cash_flow(self, symbol: str) -> pd.DataFrame:
         """获取现金流量表数据
 
@@ -207,7 +215,15 @@ class SinaAdapter:
         interval_multiplier,
         start_date,
         end_date,
-        adjust: ("sina", symbol, interval, interval_multiplier, start_date, end_date, adjust),
+        adjust: (
+            "sina",
+            symbol,
+            interval,
+            interval_multiplier,
+            start_date,
+            end_date,
+            adjust,
+        ),
     )
     def get_hist_data(
         self,

akshare_one/adapters/xueqiu.py

@@ -8,7 +8,65 @@ from .cache.cache import CACHE_CONFIG
 class XueQiuAdapter:
     """Adapter for XueQiu insider trading data API"""
 
-    @cached(CACHE_CONFIG["hist_data_cache"], key=lambda self, symbol=None: f"inner_trade_{symbol if symbol else 'all'}")
+    @cached(
+        cache=CACHE_CONFIG,
+        key=lambda self, symbol=None: f"xueqiu_{symbol}",
+    )
+    def get_realtime_data(self, symbol: str) -> pd.DataFrame:
+        """获取雪球实时行情数据
+
+        Args:
+            symbol: 股票代码 ("600000")
+
+        Returns:
+            - symbol: 股票代码
+            - price: 最新价
+            - change: 涨跌额
+            - pct_change: 涨跌幅(%)
+            - timestamp: 时间戳
+            - volume: 成交量(手)
+            - amount: 成交额(元)
+            - open: 今开
+            - high: 最高
+            - low: 最低
+            - prev_close: 昨收
+
+        Raises:
+            ValueError: 如果symbol格式不正确或API返回错误
+        """
+
+        raw_df = ak.stock_individual_spot_xq(symbol=self._convert_symbol(symbol))
+
+        # Transform to match EastMoney format
+        data = {
+            "symbol": symbol,
+            "price": float(raw_df.loc[raw_df["item"] == "现价", "value"].values[0]),
+            "change": float(raw_df.loc[raw_df["item"] == "涨跌", "value"].values[0]),
+            "pct_change": float(
+                raw_df.loc[raw_df["item"] == "涨幅", "value"].values[0]
+            ),
+            "timestamp": pd.to_datetime(
+                raw_df.loc[raw_df["item"] == "时间", "value"].values[0]
+            )
+            .tz_localize("Asia/Shanghai")
+            .tz_convert("UTC"),
+            "volume": int(raw_df.loc[raw_df["item"] == "成交量", "value"].values[0])
+            / 100,
+            "amount": float(raw_df.loc[raw_df["item"] == "成交额", "value"].values[0]),
+            "open": float(raw_df.loc[raw_df["item"] == "今开", "value"].values[0]),
+            "high": float(raw_df.loc[raw_df["item"] == "最高", "value"].values[0]),
+            "low": float(raw_df.loc[raw_df["item"] == "最低", "value"].values[0]),
+            "prev_close": float(
+                raw_df.loc[raw_df["item"] == "昨收", "value"].values[0]
+            ),
+        }
+
+        return pd.DataFrame([data])
+
+    @cached(
+        CACHE_CONFIG["hist_data_cache"],
+        key=lambda self, symbol=None: f"inner_trade_{symbol if symbol else 'all'}",
+    )
     def get_inner_trade_data(self, symbol: Optional[str] = None) -> pd.DataFrame:
         """获取雪球内部交易数据
 
@@ -30,9 +88,9 @@ class XueQiuAdapter:
         raw_df = ak.stock_inner_trade_xq()
         if symbol:
             raw_df = raw_df[raw_df["股票代码"] == symbol]
-        return self._clean_data(raw_df)
+        return self._clean_insider_data(raw_df)
 
-    def _clean_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
+    def _clean_insider_data(self, raw_df: pd.DataFrame) -> pd.DataFrame:
         """清理和标准化内部交易数据
 
         Args:
@@ -104,3 +162,14 @@ class XueQiuAdapter:
                 df[col] = pd.to_numeric(df[col], errors="coerce")
 
         return df
+
+    def _convert_symbol(self, symbol: str) -> str:
+        """
+        Convert Symbol (600000) to XueQiu Symbol (SH600000)
+        """
+        if symbol.startswith("6"):
+            return f"SH{symbol}"
+        elif symbol.startswith("0") or symbol.startswith("3"):
+            return f"SZ{symbol}"
+        else:  # TODO: add more cases
+            return symbol

akshare_one/insider.py

@@ -8,7 +8,9 @@ import pandas as pd
 from .adapters import XueQiuAdapter
 
 
-def get_inner_trade_data(source: str = "xueqiu", symbol: Optional[str] = None) -> "pd.DataFrame":
+def get_inner_trade_data(
+    source: str = "xueqiu", symbol: Optional[str] = None
+) -> "pd.DataFrame":
     """获取雪球内部交易数据
 
     Args:

akshare_one/stock.py

@@ -5,6 +5,8 @@
 
 from typing import Optional
 import pandas as pd
+
+from akshare_one.adapters.xueqiu import XueQiuAdapter
 from .adapters import EastMoneyAdapter, SinaAdapter
 
 
@@ -59,13 +61,13 @@ def get_hist_data(
 
 
 def get_realtime_data(
-    source: str = "eastmoney", symbol: Optional[str] = None
+    source: str = "xueqiu", symbol: Optional[str] = None
 ) -> "pd.DataFrame":
     """Get real-time market quotes
 
     Args:
         symbol: 股票代码 (如 "600000")
-        source: 数据源 ('eastmoney')
+        source: 数据源 ('eastmoney', 'xueqiu')
 
     Returns:
         pd.DataFrame:
@@ -81,6 +83,10 @@ def get_realtime_data(
         - low: 最低
         - prev_close: 昨收
     """
-    if source == "eastmoney":
+    if source == "eastmoney" or symbol is None:
         return EastMoneyAdapter().get_realtime_data(symbol=symbol)
+    elif source == "xueqiu":
+        if not symbol:
+            raise ValueError("XueQiu source requires a symbol parameter")
+        return XueQiuAdapter().get_realtime_data(symbol=symbol)
     raise ValueError(f"Unsupported data source: {source}")

{akshare_one-0.1.2.dist-info → akshare_one-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare-one
-Version: 0.1.2
+Version: 0.1.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,7 +9,7 @@ Keywords: akshare,financial-data,stock-data,quant
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: akshare>=1.16.64
+Requires-Dist: akshare>=1.16.91
 Requires-Dist: cachetools>=5.5.2
 Dynamic: license-file
 

akshare_one-0.1.3.dist-info/RECORD

@@ -0,0 +1,15 @@
+akshare_one/__init__.py,sha256=xWUyTnh1Tv-2mEPxDmk5giUPwhrsoAuZcyoW6mAbX4k,923
+akshare_one/financial.py,sha256=fCi6FPtPc28id7nQf8b3i2bh5vSCpZTmnPQ9kKr2n8Y,1215
+akshare_one/insider.py,sha256=Vz1yIvVlk_FVLhqFHdR-CCH5prfO12_CVzyAnrKgH4g,1199
+akshare_one/news.py,sha256=qUeX_1SnViDXBAb4Gcl28ow1qvMugEEPL75JgJhLbCA,707
+akshare_one/stock.py,sha256=w2gSjtbtcwyJ-qFpo0BJO7gxVrDur6Sun8en-A6LMb4,2727
+akshare_one/adapters/__init__.py,sha256=0AVeL7uukxjmkBn4xmq_IGKrZo3LfAWRWYKagSMgD5s,252
+akshare_one/adapters/eastmoney.py,sha256=nRs61bR_C12gOnqNBpo5-_Vqamt70-lMPr6vlxwPwuo,11780
+akshare_one/adapters/sina.py,sha256=wD67NLtqDwNzmPuxnqhrRFCyTkhSuiXXuP4a8t1BsBU,16789
+akshare_one/adapters/xueqiu.py,sha256=u_r3UtlykIZLa86flcqlc4xT8swFN_xLVkRbceNSciA,6073
+akshare_one/adapters/cache/cache.py,sha256=47A80Xtfr4gkKvEfBQrT8Dz8hNFR769rBa2gU6ew25s,373
+akshare_one-0.1.3.dist-info/licenses/LICENSE,sha256=Gg6A1GNSJCZWQ73aHJ7TXOa0i8RQ3FejZCTZ6Db07cU,1066
+akshare_one-0.1.3.dist-info/METADATA,sha256=jEtaMyAF4HllS5DZFdwcYIzT1C6eRkNOvBbfTqvTJX8,1865
+akshare_one-0.1.3.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+akshare_one-0.1.3.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
+akshare_one-0.1.3.dist-info/RECORD,,

{akshare_one-0.1.2.dist-info → akshare_one-0.1.3.dist-info}/WHEEL

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

akshare_one-0.1.2.dist-info/RECORD

@@ -1,15 +0,0 @@
-akshare_one/__init__.py,sha256=xWUyTnh1Tv-2mEPxDmk5giUPwhrsoAuZcyoW6mAbX4k,923
-akshare_one/financial.py,sha256=fCi6FPtPc28id7nQf8b3i2bh5vSCpZTmnPQ9kKr2n8Y,1215
-akshare_one/insider.py,sha256=hy1eM0Fa2J4uHU3vl-VDm4uB8zYTSUTbonnxOxbBuGc,1193
-akshare_one/news.py,sha256=qUeX_1SnViDXBAb4Gcl28ow1qvMugEEPL75JgJhLbCA,707
-akshare_one/stock.py,sha256=T6AEJlOYpVdAesOEU1lVI5tYrDwcs3Zw8KSwFv44WjQ,2457
-akshare_one/adapters/__init__.py,sha256=JrpGJ80drrU9Imc3L_gZ5Z90zyMd3PiJ5dG86VAEnmA,252
-akshare_one/adapters/eastmoney.py,sha256=QN6Tx1IrC7xrQjwm_F4dqpafHGMCy1zHvkMzcVuEWpg,11662
-akshare_one/adapters/sina.py,sha256=M0KNTE8eE3NhBEZ5NcHsI9teK8DQWgwIYr5hfs2YzSc,16634
-akshare_one/adapters/xueqiu.py,sha256=bwRNTDnXrXJxp4cFG0Uj5LVLBvCxFyxKOHAJS1nnKaM,3624
-akshare_one/adapters/cache/cache.py,sha256=GhADIdLuh_IFpPXrkhTLv-joTcuh_vC12kRdqT-cpvI,378
-akshare_one-0.1.2.dist-info/licenses/LICENSE,sha256=Gg6A1GNSJCZWQ73aHJ7TXOa0i8RQ3FejZCTZ6Db07cU,1066
-akshare_one-0.1.2.dist-info/METADATA,sha256=K8g-_H6i3YsyEP5J04czM4dtp5cfMScNOm2YmdB2EpQ,1865
-akshare_one-0.1.2.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-akshare_one-0.1.2.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
-akshare_one-0.1.2.dist-info/RECORD,,