ffdata 0.2.5__tar.gz → 0.2.7__tar.gz

{ffdata-0.2.5 → ffdata-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffdata
-Version: 0.2.5
+Version: 0.2.7
 Summary: ffdata lightweight Python client for governed financial-data APIs
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown

{ffdata-0.2.5 → ffdata-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ffdata"
-version = "0.2.5"
+version = "0.2.7"
 description = "ffdata lightweight Python client for governed financial-data APIs"
 readme = "README.md"
 requires-python = ">=3.12"

{ffdata-0.2.5 → ffdata-0.2.7}/src/ffdata/__init__.py

@@ -82,6 +82,21 @@ def index_industry(*args: Any, **kwargs: Any):
     return _client().index_industry(*args, **kwargs)
 
 
+def index_performance(*args: Any, **kwargs: Any):
+    """通过默认客户端查询指数区间行情表现（12 个区间，120 列）。"""
+    return _client().index_performance(*args, **kwargs)
+
+
+def index_valuation(*args: Any, **kwargs: Any):
+    """通过默认客户端查询指数估值指标（33 列）。"""
+    return _client().index_valuation(*args, **kwargs)
+
+
+def index_fina_indicator(*args: Any, **kwargs: Any):
+    """通过默认客户端查询指数财务指标（季频，118 列）。"""
+    return _client().index_fina_indicator(*args, **kwargs)
+
+
 def etf_basic(*args: Any, **kwargs: Any):
     """通过默认客户端查询 ETF 基础信息（返回含 ETF 与跟踪目标两个聚源内码）。"""
     return _client().etf_basic(*args, **kwargs)
@@ -171,6 +186,9 @@ __all__ = [
     "fund_stock_portfolio",
     "index_basic",
     "index_daily",
+    "index_fina_indicator",
+    "index_performance",
+    "index_valuation",
     "index_weight",
     "index_industry",
     "macro_indicator_basic",

{ffdata-0.2.5 → ffdata-0.2.7}/src/ffdata/client.py

@@ -274,6 +274,85 @@ class Client:
             fields=fields,
         )
 
+    def index_performance(
+        self,
+        ts_code: str | list[str] | None = None,
+        *,
+        trade_date: Any = None,
+        start_date: Any = None,
+        end_date: Any = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询指数区间行情表现（12 个区间，120 列，ffdata 扩展接口）。
+
+        ``ts_code`` 与 ``trade_date`` 至少提供一个；``trade_date`` 与起止日期互斥。
+        字段名与聚源 ``QT_IndexPerformance`` 源字段一一对应（机械 snake_case），
+        例如 ``change_pct_tw``（1 周以来涨跌幅）、``change_pct_ytd``（今年以来涨跌幅）、
+        ``change_pct``（成立以来涨跌幅）。本接口仅支持远程查询。
+        """
+        return self.query(
+            "index_performance",
+            ts_code=ts_code,
+            trade_date=trade_date,
+            start_date=start_date,
+            end_date=end_date,
+            fields=fields,
+        )
+
+    def index_valuation(
+        self,
+        ts_code: str | list[str] | None = None,
+        *,
+        trade_date: Any = None,
+        start_date: Any = None,
+        end_date: Any = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询 A 股/港股主要股票指数的每日估值指标（33 列，ffdata 扩展接口）。
+
+        覆盖总市值、流通市值、自由流通市值、PE/PB/PCF/PS、股息率、风险溢价、PEG 等；
+        过滤规则与 :meth:`index_performance` 相同。本接口仅支持远程查询。
+        """
+        return self.query(
+            "index_valuation",
+            ts_code=ts_code,
+            trade_date=trade_date,
+            start_date=start_date,
+            end_date=end_date,
+            fields=fields,
+        )
+
+    def index_fina_indicator(
+        self,
+        ts_code: str | list[str] | None = None,
+        *,
+        period: Any = None,
+        ann_date: Any = None,
+        start_ann_date: Any = None,
+        end_ann_date: Any = None,
+        start_date: Any = None,
+        end_date: Any = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询 A 股/港股主要股票指数的季度财务指标（118 列，ffdata 扩展接口）。
+
+        报告期维度（``period`` 或 ``start_date``+``end_date``）与公告日维度
+        （``ann_date`` 或 ``start_ann_date``+``end_ann_date``）可组合求交集；
+        同维度参数互斥、区间成对。同一报告期可能有多个发布版本，接口不去重。
+        本接口仅支持远程查询。
+        """
+        return self.query(
+            "index_fina_indicator",
+            ts_code=ts_code,
+            period=period,
+            ann_date=ann_date,
+            start_ann_date=start_ann_date,
+            end_ann_date=end_ann_date,
+            start_date=start_date,
+            end_date=end_date,
+            fields=fields,
+        )
+
     def macro_indicator_basic(
         self,
         *,
@@ -401,6 +480,7 @@ class Client:
         list_status: str | None = None,
         exchange: str | None = None,
         mgr: str | None = None,
+        csrc_category: str | None = None,
         fields: list[str] | None = None,
     ) -> pd.DataFrame:
         """查询 ETF 基础信息。
@@ -409,7 +489,7 @@ class Client:
         或纯代码（服务端剥离后缀后匹配，并校验后缀与交易所一致）；``index_code``
         是跟踪目标代码，可能是指数，也可能是现货/商品标的；``list_status`` 取
         ``L``/``D``/``P``；``exchange`` 取 ``SH``/``SZ``；``mgr`` 按管理人简称
-        模糊匹配。返回 16 列，其中 ``inner_code``（ETF 聚源内码）与
+        模糊匹配；``csrc_category`` 按证监会分类中文名称等值过滤。返回 19 列，其中 ``inner_code``（ETF 聚源内码）与
         ``index_inner_code``（跟踪目标聚源内码）是 ffdata 扩展字段；不传任何过滤
         条件时返回全部沪深上市 ETF。本接口仅支持远程查询。
         """
@@ -421,6 +501,7 @@ class Client:
             list_status=list_status,
             exchange=exchange,
             mgr=mgr,
+            csrc_category=csrc_category,
             fields=fields,
         )
 

{ffdata-0.2.5 → ffdata-0.2.7}/src/ffdata.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffdata
-Version: 0.2.5
+Version: 0.2.7
 Summary: ffdata lightweight Python client for governed financial-data APIs
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown