akshare-one 0.1.1__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_{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_{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_{symbol}")
+    @cached(
+        CACHE_CONFIG["financial_cache"], key=lambda self, symbol: f"sina_cash_{symbol}"
+    )
     def get_cash_flow(self, symbol: str) -> pd.DataFrame:
         """获取现金流量表数据
 
@@ -98,28 +106,8 @@ class SinaAdapter:
         raw_df = raw_df.rename(columns=column_mapping)
 
         # Select only required columns
-        required_columns = [
-            "report_date",
-            "report_period",
-            "period",
-            "currency",
-            "net_income",
-            "depreciation_and_amortization",
-            "share_based_compensation",
-            "net_cash_flow_from_operations",
-            "capital_expenditure",
-            "business_acquisitions_and_disposals",
-            "investment_acquisitions_and_disposals",
-            "net_cash_flow_from_investing",
-            "issuance_or_repayment_of_debt_securities",
-            "issuance_or_purchase_of_equity_shares",
-            "dividends_and_other_cash_distributions",
-            "net_cash_flow_from_financing",
-            "change_in_cash_and_equivalents",
-            "effect_of_exchange_rate_changes",
-            "ending_cash_balance",
-            "free_cash_flow",
-        ]
+        required_columns = ["report_date"]
+        required_columns.extend(column_mapping.values())
 
         # Filter columns
         available_columns = [col for col in required_columns if col in raw_df.columns]
@@ -227,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,
@@ -420,7 +416,7 @@ class SinaAdapter:
             "币种": "currency",
             "营业总收入": "revenue",
             "营业成本": "cost_of_revenue",
-            "营业利润": "gross_profit",
+            "营业利润": "operating_profit",
             "销售费用": "selling_general_and_administrative_expenses",
             "管理费用": "operating_expense",
             "研发费用": "research_and_development",
@@ -438,16 +434,14 @@ class SinaAdapter:
         # Select only required columns
         required_columns = [
             "report_date",
-            "report_period",
             "period",
             "currency",
             "revenue",
             "cost_of_revenue",
-            "gross_profit",
+            "operating_profit",
             "operating_expense",
             "selling_general_and_administrative_expenses",
             "research_and_development",
-            "operating_income",
             "interest_expense",
             "ebit",
             "income_tax_expense",

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/financial.py

@@ -13,39 +13,6 @@ def get_balance_sheet(symbol: str, source: str = "sina") -> "pd.DataFrame":
     Args:
         symbol: 股票代码 (如 "600600")
         source: 数据源 ("sina")
-
-    Returns:
-        pd.DataFrame:
-        - report_date: 报告日期
-        - report_period: 报告期
-        - period: 期间
-        - currency: 币种
-        - total_assets: 资产总计
-        - current_assets: 流动资产合计
-        - cash_and_equivalents: 货币资金
-        - inventory: 存货
-        - current_investments: 交易性金融资产
-        - trade_and_non_trade_receivables: 应收票据及应收账款
-        - non_current_assets: 非流动资产合计
-        - property_plant_and_equipment: 固定资产
-        - goodwill_and_intangible_assets: 商誉
-        - investments: 长期股权投资
-        - non_current_investments: 其他非流动金融资产
-        - outstanding_shares: 实收资本(或股本)
-        - tax_assets: 递延所得税资产
-        - total_liabilities: 负债合计
-        - current_liabilities: 流动负债合计
-        - current_debt: 短期借款
-        - trade_and_non_trade_payables: 应付票据及应付账款
-        - deferred_revenue: 合同负债
-        - deposit_liabilities: 吸收存款及同业存放
-        - non_current_liabilities: 非流动负债合计
-        - non_current_debt: 长期借款
-        - tax_liabilities: 递延所得税负债
-        - shareholders_equity: 所有者权益(或股东权益)合计
-        - retained_earnings: 未分配利润
-        - accumulated_other_comprehensive_income: 其他综合收益
-        - total_debt: 总债务(短期借款+长期借款)
     """
     if source == "sina":
         return SinaAdapter().get_balance_sheet(symbol=symbol)
@@ -57,29 +24,7 @@ def get_income_statement(symbol: str, source: str = "sina") -> "pd.DataFrame":
 
     Args:
         symbol: 股票代码 (如 "600600")
-        source: 数据源 (目前支持 "sina")
-
-    Returns:
-        pd.DataFrame:
-        - report_date: 报告日期
-        - report_period: 报告期
-        - period: 期间
-        - currency: 币种
-        - revenue: 营业总收入
-        - cost_of_revenue: 营业成本
-        - gross_profit: 营业利润
-        - operating_expense: 管理费用
-        - selling_general_and_administrative_expenses: 销售费用
-        - research_and_development: 研发费用
-        - operating_income: 营业利润
-        - interest_expense: 利息支出
-        - ebit: 利润总额
-        - income_tax_expense: 所得税费用
-        - net_income: 净利润
-        - net_income_common_stock: 归属于母公司所有者的净利润
-        - net_income_non_controlling_interests: 少数股东损益
-        - earnings_per_share: 基本每股收益
-        - earnings_per_share_diluted: 稀释每股收益
+        source: 数据源 ("sina")
     """
     if source == "sina":
         return SinaAdapter().get_income_statement(symbol=symbol)
@@ -91,30 +36,7 @@ def get_cash_flow(symbol: str, source: str = "sina") -> "pd.DataFrame":
 
     Args:
         symbol: 股票代码 (如 "600600")
-        source: 数据源 (目前支持 "sina")
-
-    Returns:
-        pd.DataFrame:
-        - report_date: 报告日期
-        - report_period: 报告期
-        - period: 期间
-        - currency: 币种
-        - net_income: 净利润
-        - depreciation_and_amortization: 固定资产折旧、油气资产折耗、生产性生物资产折旧
-        - share_based_compensation: 无形资产摊销
-        - net_cash_flow_from_operations: 经营活动产生的现金流量净额
-        - capital_expenditure: 购建固定资产、无形资产和其他长期资产支付的现金
-        - business_acquisitions_and_disposals: 取得子公司及其他营业单位支付的现金净额
-        - investment_acquisitions_and_disposals: 投资支付的现金
-        - net_cash_flow_from_investing: 投资活动产生的现金流量净额
-        - issuance_or_repayment_of_debt_securities: 取得借款收到的现金
-        - issuance_or_purchase_of_equity_shares: 吸收投资收到的现金
-        - dividends_and_other_cash_distributions: 分配股利、利润或偿付利息支付的现金
-        - net_cash_flow_from_financing: 筹资活动产生的现金流量净额
-        - change_in_cash_and_equivalents: 现金及现金等价物净增加额
-        - effect_of_exchange_rate_changes: 汇率变动对现金及现金等价物的影响
-        - ending_cash_balance: 期末现金及现金等价物余额
-        - free_cash_flow: 自由现金流
+        source: 数据源 ("sina")
     """
     if source == "sina":
         return SinaAdapter().get_cash_flow(symbol=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.1.dist-info → akshare_one-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare-one
-Version: 0.1.1
+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.1.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.1.dist-info/RECORD

@@ -1,15 +0,0 @@
-akshare_one/__init__.py,sha256=xWUyTnh1Tv-2mEPxDmk5giUPwhrsoAuZcyoW6mAbX4k,923
-akshare_one/financial.py,sha256=0vPm8LYzV-UIaPIk5GeEJuuCXYYXtWp5h1AYo-9ms38,5005
-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=jcpddoEJI7hEIRkxlZl7Ee1PAyDglhsOZGXFOgdnpGs,17412
-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.1.dist-info/licenses/LICENSE,sha256=Gg6A1GNSJCZWQ73aHJ7TXOa0i8RQ3FejZCTZ6Db07cU,1066
-akshare_one-0.1.1.dist-info/METADATA,sha256=swa_ZbqhM0HArMvQqVYFDwiW04XG6eSXFAg7y28mIXA,1865
-akshare_one-0.1.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-akshare_one-0.1.1.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
-akshare_one-0.1.1.dist-info/RECORD,,