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

akshare_one/adapters/eastmoney.py

@@ -31,7 +31,7 @@ class EastMoneyAdapter:
 
         Args:
             symbol: Unified symbol format (e.g. '600000')
-            interval: Time granularity ('second','minute','hour','day','week','month','year')
+            interval: Time granularity ('minute','hour','day','week','month','year')
             interval_multiplier: Interval multiplier (e.g. 5 for 5 minutes)
             start_date: Start date in YYYY-MM-DD format (will be converted to YYYYMMDD)
             end_date: End date in YYYY-MM-DD format (will be converted to YYYYMMDD)
@@ -42,9 +42,7 @@ class EastMoneyAdapter:
         """
         # Map standard interval to akshare supported periods
         interval = interval.lower()
-        if interval == "second":
-            raise ValueError("EastMoney does not support second-level data")
-        elif interval == "minute":
+        if interval == "minute":
             if interval_multiplier < 1:
                 raise ValueError("Minute interval multiplier must be >= 1")
 

akshare_one/adapters/sina.py

@@ -12,7 +12,7 @@ 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 +26,7 @@ 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 +40,7 @@ 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 +98,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]
@@ -420,7 +400,7 @@ class SinaAdapter:
             "币种": "currency",
             "营业总收入": "revenue",
             "营业成本": "cost_of_revenue",
-            "营业利润": "gross_profit",
+            "营业利润": "operating_profit",
             "销售费用": "selling_general_and_administrative_expenses",
             "管理费用": "operating_expense",
             "研发费用": "research_and_development",
@@ -438,16 +418,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/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/stock.py

@@ -21,7 +21,7 @@ def get_hist_data(
 
     Args:
         symbol: 股票代码 (e.g. '600000')
-        interval: 时间间隔 ('second','minute','hour','day','week','month','year')
+        interval: 时间间隔 ('minute','hour','day','week','month','year')
         interval_multiplier: 时间间隔倍数 (e.g. 5 for 5 minutes)
         start_date: 开始日期 (YYYY-MM-DD)
         end_date: 结束日期 (YYYY-MM-DD)

akshare_one-0.1.2.dist-info/METADATA

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: akshare-one
+Version: 0.1.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
+Project-URL: Repository, https://github.com/zwldarren/akshare-one.git
+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: cachetools>=5.5.2
+Dynamic: license-file
+
+<div align="center">
+  <h1>AKShare One</h1>
+  <div>
+    <strong>English</strong> | <a href="README_zh.md">中文</a>
+  </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.
+
+## ✨ Features
+
+- 📊 Unified stock code formats across data sources
+- 🏗️ Standardized return data structures
+- 🛠️ Simplified API parameters
+- ⏱️ Automatic timestamp and adjustment handling
+
+## 🚀 Core Features
+
+| Feature | 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` |
+
+## 📦 Quick Installation
+
+```bash
+pip install akshare-one
+```
+
+## 💻 Usage Example
+
+```python
+from akshare_one import get_hist_data, get_realtime_data
+
+# Get historical data
+df_hist = get_hist_data(
+    symbol="600000",
+    interval="day",
+    adjust="hfq"
+)
+
+# Get real-time data
+df_realtime = get_realtime_data(symbol="600000")
+```
+
+## 📚 Documentation
+
+Detailed API reference: [docs/api.md](docs/api.md)

akshare_one-0.1.2.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=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,,

akshare_one-0.1.0.dist-info/METADATA

@@ -1,61 +0,0 @@
-Metadata-Version: 2.4
-Name: akshare-one
-Version: 0.1.0
-Summary: Add your description here
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: akshare>=1.16.64
-Requires-Dist: cachetools>=5.5.2
-Dynamic: license-file
-
-# AKShare One
-
-**AKShare One** 是一个标准化中国金融市场数据接口，基于 [AKShare](https://github.com/akfamily/akshare) 二次封装，解决AKShare多数据源输入输出不统一的问题。
-
-## 项目背景
-
-AKShare提供了丰富的中国金融市场数据，但不同数据源的：
-- 股票代码格式不统一（如东方财富和新浪使用不同格式）
-- 返回数据结构不一致
-- 参数命名和用法有差异
-
-AKShare One希望通过统一封装，提供：
-- 标准化的股票代码格式
-- 一致的数据返回结构
-- 简化的API参数
-
-## 核心功能
-
-### 目前仅实现了以下功能：
-- 历史数据 (`get_hist_data`)
-- 实时行情 (`get_realtime_data`) 
-- 个股新闻 (`get_news_data`)
-- 财务数据 (资产负债表/利润表/现金流量表)
-- 内部交易 (`get_inner_trade_data`)
-
-### 标准化处理
-- 统一时间戳为UTC
-- 自动处理复权数据
-- 清理异常值和缺失数据
-- 统一列名和数据类型
-
-## 快速开始
-
-使用示例：
-```python
-from akshare_one import get_hist_data, get_realtime_data
-
-# 获取历史数据
-df_hist = get_hist_data(
-    symbol="600000",
-    interval="day",
-    adjust="hfq"
-)
-
-# 获取实时数据
-df_realtime = get_realtime_data(symbol="600000")
-```
-
-## API文档
-详细API说明请参考 [docs/api.md](docs/api.md)

akshare_one-0.1.0.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=oGd432iZ6_hr63L4VG2iT36wOQ2q8RI8QUOflFY-OPg,2466
-akshare_one/adapters/__init__.py,sha256=JrpGJ80drrU9Imc3L_gZ5Z90zyMd3PiJ5dG86VAEnmA,252
-akshare_one/adapters/eastmoney.py,sha256=OP5zNbSRVEKfKX0ikC6onABuifxoWEAbBNYbk_GO3lU,11783
-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.0.dist-info/licenses/LICENSE,sha256=Gg6A1GNSJCZWQ73aHJ7TXOa0i8RQ3FejZCTZ6Db07cU,1066
-akshare_one-0.1.0.dist-info/METADATA,sha256=oHAPghYP-c2rNCZGcqxEYacIxV9pOwuK0eTpnk0l-oQ,1586
-akshare_one-0.1.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-akshare_one-0.1.0.dist-info/top_level.txt,sha256=kNiucyLVAGa89wmUSpXbBLWD7pF_RuahuiaOfLHZSyw,12
-akshare_one-0.1.0.dist-info/RECORD,,