ffdata 0.2.1__tar.gz → 0.2.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffdata
-Version: 0.2.1
+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.1 → ffdata-0.2.7}/pyproject.toml

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

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

@@ -77,6 +77,26 @@ def index_weight(*args: Any, **kwargs: Any):
     return _client().index_weight(*args, **kwargs)
 
 
+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)
@@ -93,7 +113,7 @@ def etf_adj_daily(*args: Any, **kwargs: Any):
 
 
 def cb_basic(*args: Any, **kwargs: Any):
-    """通过默认客户端查询可转债基本信息（125 列，含条款文本与最新评级）。"""
+    """通过默认客户端查询可转债基本信息（124 列，含条款文本与最新评级）。"""
     return _client().cb_basic(*args, **kwargs)
 
 
@@ -112,11 +132,26 @@ def cb_issue(*args: Any, **kwargs: Any):
     return _client().cb_issue(*args, **kwargs)
 
 
+def bond_yield_curve(*args: Any, **kwargs: Any):
+    """通过默认客户端查询中债债券收益率曲线（11 列，含到期/即期/远期 N、K）。"""
+    return _client().bond_yield_curve(*args, **kwargs)
+
+
+def bond_sap_yield_curve(*args: Any, **kwargs: Any):
+    """通过默认客户端查询全球（美国/日本）国债收益率曲线（12 列，仅到期）。"""
+    return _client().bond_sap_yield_curve(*args, **kwargs)
+
+
 def fund_basic(*args: Any, **kwargs: Any):
     """通过默认客户端查询公募基金列表（71 列，含管理人/托管人全称与投资范围）。"""
     return _client().fund_basic(*args, **kwargs)
 
 
+def fund_stock_portfolio(*args: Any, **kwargs: Any):
+    """通过默认客户端查询公募基金股票组合明细（半年度，12 列）。"""
+    return _client().fund_stock_portfolio(*args, **kwargs)
+
+
 def macro_indicator_basic(*args: Any, **kwargs: Any):
     return _client().macro_indicator_basic(*args, **kwargs)
 
@@ -137,6 +172,8 @@ def stock_basic(*args: Any, **kwargs: Any):
 
 __all__ = [
     "Client",
+    "bond_sap_yield_curve",
+    "bond_yield_curve",
     "cb_basic",
     "cb_daily",
     "cb_deriv",
@@ -146,9 +183,14 @@ __all__ = [
     "etf_basic",
     "etf_daily",
     "fund_basic",
+    "fund_stock_portfolio",
     "index_basic",
     "index_daily",
+    "index_fina_indicator",
+    "index_performance",
+    "index_valuation",
     "index_weight",
+    "index_industry",
     "macro_indicator_basic",
     "macro_indicator_data",
     "query",

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

@@ -100,7 +100,11 @@ class Client:
         max_rows: int = 1_000,
         fields: list[str] | None = None,
     ) -> pd.DataFrame:
-        """通过独立权限的服务端接口执行单条受限 SELECT。"""
+        """通过独立权限的服务端接口执行单条受限 SELECT。
+
+        ``max_rows`` 为同步返回行数上限，默认 1,000，最多 50,000；结果超出上限时
+        服务端返回 413 而不是截断。需要更大结果集时使用 :meth:`create_export`。
+        """
         return self.query(
             "sql_query",
             sql=sql,
@@ -245,6 +249,110 @@ class Client:
             fields=fields,
         )
 
+    def index_industry(
+        self,
+        *,
+        industry_standard: int | None = None,
+        index_state: int | None = None,
+        index_code: str | list[str] | None = None,
+        industry_level: int | None = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询指数与行业的对应关系。
+
+        四个过滤条件至少提供一个：``industry_standard``（仅支持
+        28/30/37/38/40/44）、``index_state``（1/2/3）、``index_code``
+        （可带后缀或裸代码，支持列表/逗号分隔）、``industry_level``（1~6）。
+        返回 9 列，含行业代码、行业名称与行业级别；本接口仅支持远程查询。
+        """
+        return self.query(
+            "index_industry",
+            industry_standard=industry_standard,
+            index_state=index_state,
+            index_code=index_code,
+            industry_level=industry_level,
+            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,
         *,
@@ -372,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 基础信息。
@@ -380,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。本接口仅支持远程查询。
         """
@@ -392,6 +501,7 @@ class Client:
             list_status=list_status,
             exchange=exchange,
             mgr=mgr,
+            csrc_category=csrc_category,
             fields=fields,
         )
 
@@ -445,6 +555,36 @@ class Client:
             fields=fields,
         )
 
+    def fund_stock_portfolio(
+        self,
+        *,
+        ts_code: str | list[str] | None = None,
+        fund_inner_code: int | list[int] | None = None,
+        stock_inner_code: int | list[int] | None = None,
+        report_date: Any = None,
+        start_date: Any = None,
+        end_date: Any = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询公募基金股票组合明细（半年度，12 列）。
+
+        仅提供**年报 / 半年报**数据（报告期只有 ``06-30`` 与 ``12-31``）：``report_date``
+        （截止日期）必须是半年度末，与 ``start_date``/``end_date`` 区间互斥；至少提供
+        基金代码、基金内码、股票内码或日期条件之一。``ts_code`` 支持 ``.SH``/``.SZ``/``.OF``
+        后缀或纯代码（按主代码匹配，A/C 份额的 C 类代码请改用主代码）。
+        返回 12 列：``ts_code`` + 主表 11 个业务字段；不输出股票代码/名称、基金简称与投资类型文本。
+        """
+        return self.query(
+            "fund_stock_portfolio",
+            ts_code=ts_code,
+            fund_inner_code=fund_inner_code,
+            stock_inner_code=stock_inner_code,
+            report_date=report_date,
+            start_date=start_date,
+            end_date=end_date,
+            fields=fields,
+        )
+
     def cb_daily(
         self,
         *,
@@ -537,7 +677,7 @@ class Client:
         ``.SH``/``.SZ`` 后缀或纯代码，支持列表与逗号分隔（服务端剥离后缀匹配并校验市场一致）；
         ``list_date`` 为上市日期（精确到日）；``exchange`` 取 ``SH``/``SZ``；
         ``latest_status`` 为聚源最新状态（``1`` 发行中、``2`` 存续中、``3`` 已到期、
-        ``4`` 发行失败）。返回 125 列：38 列 Tushare 兼容段 + 74 列聚源主表扩展 +
+        ``4`` 发行失败）。返回 124 列：37 列 Tushare 兼容段 + 74 列聚源主表扩展 +
         13 列关联扩展（含条款文本、最新评级、剩余金额等）。不传过滤条件时返回全部沪深
         可转债；本接口仅支持远程查询。
         """
@@ -550,5 +690,78 @@ class Client:
             fields=fields,
         )
 
+    def bond_yield_curve(
+        self,
+        *,
+        start_date: Any = None,
+        end_date: Any = None,
+        curve_code: int | list[int] | None = None,
+        yield_type_code: int | None = None,
+        years_to_maturity: float | list[float] | None = None,
+        n: float | None = None,
+        k: float | None = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询中债债券收益率曲线（聚源 ``Bond_CBYieldCurve`` 原生契约，11 列）。
+
+        ``start_date`` / ``end_date`` 均必填且按 ``EndDate`` 闭区间过滤（单日查询时令二者
+        相同）。``curve_code`` 为收益率曲线代码（``10`` 中债国债、``195`` 中债国开债，可传
+        列表）；``yield_type_code`` 为收益率类型（``1`` 到期、``2`` 即期、``3`` 远期的到期、
+        ``4`` 远期的即期、``5`` 远期）；``years_to_maturity`` 为待偿期（年，可传列表）。
+
+        ``yield_type_code`` 为 ``3``/``4`` 时可用远期字段 ``n``、``k``，二者是同一远期利率的
+        两种等价编码、只能传其一：``n`` 表示「N 年后开始、持有 ``years_to_maturity`` 年」的
+        收益率（此时 ``years_to_maturity`` 是持有期），``k`` 表示「``years_to_maturity`` 年后
+        开始、持有 ``k`` 年」的收益率（此时 ``years_to_maturity`` 是远期起点）。
+        ``yield_type_code`` 为 ``1``（到期）或 ``2``（即期）时**不要传** ``n``/``k``。
+
+        单位保留聚源原值：``yield`` 是小数（``0.025601`` = 2.5601%），``base_rate`` /
+        ``yield_value`` 是百分数（``1.5`` = 1.5%，仅浮动利率点差类曲线有值）。
+        本接口仅支持远程查询。
+        """
+        return self.query(
+            "bond_yield_curve",
+            start_date=start_date,
+            end_date=end_date,
+            curve_code=curve_code,
+            yield_type_code=yield_type_code,
+            years_to_maturity=years_to_maturity,
+            n=n,
+            k=k,
+            fields=fields,
+        )
+
+    def bond_sap_yield_curve(
+        self,
+        *,
+        start_date: Any = None,
+        end_date: Any = None,
+        curve_code: int | list[int] | None = None,
+        yield_type_code: int | None = None,
+        remain_maturity: float | list[float] | None = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询全球债券收益率曲线（聚源 ``Bond_SAPYieldCurve`` 原生契约，12 列）。
+
+        ``start_date`` / ``end_date`` 均必填且按 ``EndDate`` 闭区间过滤（单日查询时令二者
+        相同）。``curve_code`` 只支持 ``188``（美国国债收益率曲线）、``189``（日本国债收益率
+        曲线）；``yield_type_code`` 只有 ``1``（到期）；``remain_maturity`` 为待偿期（年，
+        可传列表）。
+
+        数据字典与源表确认：``YieldTypeCode`` 只有到期，没有即期/远期；``StepTypeCode``
+        固定为 ``99``（标准待偿期）、不是入参；``NPara`` / ``KPara`` 当前全为空、暂无语义，
+        也不是入参。``yield_rate`` 是**百分数**（``5.15`` = 5.15%，可为负），与
+        :meth:`bond_yield_curve` 的 ``yield``（小数形式）不同。本接口仅支持远程查询。
+        """
+        return self.query(
+            "bond_sap_yield_curve",
+            start_date=start_date,
+            end_date=end_date,
+            curve_code=curve_code,
+            yield_type_code=yield_type_code,
+            remain_maturity=remain_maturity,
+            fields=fields,
+        )
+
 
 __all__ = ["Client", "Source"]

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

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