ffdata 0.2.7__tar.gz → 0.2.8__tar.gz

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

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

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

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

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

@@ -152,6 +152,11 @@ def fund_stock_portfolio(*args: Any, **kwargs: Any):
     return _client().fund_stock_portfolio(*args, **kwargs)
 
 
+def sge_daily(*args: Any, **kwargs: Any):
+    """通过默认客户端查询上海黄金交易所现货日行情（20 列，前 14 列对齐 Tushare）。"""
+    return _client().sge_daily(*args, **kwargs)
+
+
 def macro_indicator_basic(*args: Any, **kwargs: Any):
     return _client().macro_indicator_basic(*args, **kwargs)
 
@@ -194,6 +199,7 @@ __all__ = [
     "macro_indicator_basic",
     "macro_indicator_data",
     "query",
+    "sge_daily",
     "sql_query",
     "set_token",
     "stock_adjusting_factor",

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

@@ -489,8 +489,9 @@ class Client:
         或纯代码（服务端剥离后缀后匹配，并校验后缀与交易所一致）；``index_code``
         是跟踪目标代码，可能是指数，也可能是现货/商品标的；``list_status`` 取
         ``L``/``D``/``P``；``exchange`` 取 ``SH``/``SZ``；``mgr`` 按管理人简称
-        模糊匹配；``csrc_category`` 按证监会分类中文名称等值过滤。返回 19 列，其中 ``inner_code``（ETF 聚源内码）与
-        ``index_inner_code``（跟踪目标聚源内码）是 ffdata 扩展字段；不传任何过滤
+        模糊匹配；``csrc_category`` 按证监会分类中文名称等值过滤。返回 21 列，其中 ``inner_code``（ETF 聚源内码）、
+        ``index_inner_code``（跟踪目标聚源内码）、``track_asset_type``（跟踪资产类型）
+        与 ``track_asset_category``（原始类别编码）是 ffdata 扩展字段；不传任何过滤
         条件时返回全部沪深上市 ETF。本接口仅支持远程查询。
         """
         return self.query(
@@ -585,6 +586,35 @@ class Client:
             fields=fields,
         )
 
+    def sge_daily(
+        self,
+        *,
+        ts_code: str | list[str] | None = None,
+        trade_date: Any = None,
+        start_date: Any = None,
+        end_date: Any = None,
+        date_type: int = 3,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询上海黄金交易所现货日行情（20 列，前 14 列对齐 Tushare ``sge_daily``）。
+
+        ``ts_code`` 为聚源现货合约代码原值（如 ``Au99.99``、``Au(T+D)``、``iAu99.99``），
+        **不带市场后缀**，支持列表与逗号分隔；``trade_date`` 与 ``start_date``/
+        ``end_date`` 互斥，且至少需要 ``ts_code`` 或 ``trade_date`` 之一。
+        ``date_type`` 默认 ``3``（日，与 Tushare 一致），``4`` 为聚源周频扩展。
+        价格元/克、``vol`` 千克、``amount`` 元、``pct_change`` 为百分数；``change`` 与
+        ``pct_change`` 为聚源原值（两者比较基准不同，见接口文档）。
+        """
+        return self.query(
+            "sge_daily",
+            ts_code=ts_code,
+            trade_date=trade_date,
+            start_date=start_date,
+            end_date=end_date,
+            date_type=date_type,
+            fields=fields,
+        )
+
     def cb_daily(
         self,
         *,

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

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