lixinger-python 0.3.6__py3-none-any.whl → 0.3.7__py3-none-any.whl

lixinger/__init__.py

@@ -25,7 +25,11 @@ from lixinger.api.cn.index import (
     get_constituent_weightings,
     get_constituents,
     get_index,
+    get_index_bank_statements,
     get_index_fundamental,
+    get_index_hybrid_statements,
+    get_index_non_financial_statements,
+    get_index_security_statements,
     get_tracking_fund,
 )
 from lixinger.api.cn.index import (
@@ -74,4 +78,9 @@ __all__ = [
     "get_insurance_fundamental",
     "get_security_fundamental",
     "get_other_financial_fundamental",
+    # Index financial statements
+    "get_index_non_financial_statements",
+    "get_index_bank_statements",
+    "get_index_security_statements",
+    "get_index_hybrid_statements",
 ]

lixinger/api/cn/index/__init__.py

@@ -7,6 +7,16 @@ from lixinger.api.cn.index.constituent_weightings import (
 )
 from lixinger.api.cn.index.constituents import ConstituentsAPI, get_constituents
 from lixinger.api.cn.index.drawdown import DrawdownAPI, get_drawdown
+from lixinger.api.cn.index.fs import (
+    IndexBankStatementAPI,
+    IndexHybridStatementAPI,
+    IndexNonFinancialStatementAPI,
+    IndexSecurityStatementAPI,
+    get_index_bank_statements,
+    get_index_hybrid_statements,
+    get_index_non_financial_statements,
+    get_index_security_statements,
+)
 from lixinger.api.cn.index.fundamental import (
     IndexFundamentalAPI,
     get_index_fundamental,
@@ -29,4 +39,13 @@ __all__ = [
     "get_index_fundamental",
     "TrackingFundAPI",
     "get_tracking_fund",
+    # Index financial statements
+    "IndexBankStatementAPI",
+    "IndexHybridStatementAPI",
+    "IndexNonFinancialStatementAPI",
+    "IndexSecurityStatementAPI",
+    "get_index_bank_statements",
+    "get_index_hybrid_statements",
+    "get_index_non_financial_statements",
+    "get_index_security_statements",
 ]

lixinger/api/cn/index/fs/__init__.py

@@ -0,0 +1,38 @@
+"""Index financial statement APIs.
+
+This module provides access to index financial statement APIs by index type:
+- Non-financial indices (非金融类指数)
+- Bank indices (银行类指数)
+- Security indices (证券类指数)
+- Hybrid indices (混合型指数)
+"""
+
+from lixinger.api.cn.index.fs.bank import (
+    IndexBankStatementAPI,
+    get_index_bank_statements,
+)
+from lixinger.api.cn.index.fs.hybrid import (
+    IndexHybridStatementAPI,
+    get_index_hybrid_statements,
+)
+from lixinger.api.cn.index.fs.non_financial import (
+    IndexNonFinancialStatementAPI,
+    get_index_non_financial_statements,
+)
+from lixinger.api.cn.index.fs.security import (
+    IndexSecurityStatementAPI,
+    get_index_security_statements,
+)
+
+__all__ = [
+    # API Classes
+    "IndexBankStatementAPI",
+    "IndexHybridStatementAPI",
+    "IndexNonFinancialStatementAPI",
+    "IndexSecurityStatementAPI",
+    # Functional APIs
+    "get_index_bank_statements",
+    "get_index_hybrid_statements",
+    "get_index_non_financial_statements",
+    "get_index_security_statements",
+]

lixinger/api/cn/index/fs/bank.py

@@ -0,0 +1,130 @@
+"""Index bank statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.index.fs.bank import IndexBankStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class IndexBankStatementAPI(BaseAPI):
+    """Index bank statement APIs."""
+
+    async def get_bank_statements(  # noqa: PLR0913
+        self,
+        stock_codes: list[str],
+        metrics: list[str],
+        date: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        limit: int | None = None,
+    ) -> pd.DataFrame:
+        """获取银行类指数的财务报表数据.
+
+        API Endpoint: /cn/index/fs/bank
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/index/fs/bank
+
+        获取银行类大陆指数（样本仅包含银行）的财务数据，包括利润表、
+        资产负债表、现金流量表、财务指标。
+
+        Args:
+            stock_codes: 指数代码列表，长度 >=1 且 <=100。当传入 start_date 时只能
+                传入一个指数代码。
+            metrics: 指标列表，格式为 [granularity].[tableName].[fieldName].[expressionCalculateType]，
+                例如 ``"q.ps.oi.t"``。当 stock_codes 长度大于 1 时最多 48 个指标；
+                等于 1 时最多 128 个指标。
+            date: 日期 (YYYY-MM-DD)，与 start_date 二选一。支持 ``"latest"``。
+            start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+            end_date: 结束日期 (YYYY-MM-DD)，可选，默认上周一。
+            limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+        Returns:
+            包含银行类指数财务报表数据的 DataFrame。
+
+        Example:
+            获取中证银行指数的营业收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.index.fs.bank.get_bank_statements(
+                        stock_codes=["399986"],
+                        metrics=["q.ps.oi.t"],
+                        date="2026-03-31",
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCodes": stock_codes,
+            "metricsList": metrics,
+        }
+        if date is not None:
+            payload["date"] = date
+        if start_date is not None:
+            payload["startDate"] = start_date
+        if end_date is not None:
+            payload["endDate"] = end_date
+        if limit is not None:
+            payload["limit"] = limit
+
+        data = await self._request("POST", "/cn/index/fs/bank", json=payload)
+
+        # Flatten nested metrics (e.g. {"q": {"ps": {"oi": {"t": ...}}}})
+        flattened_data = [flatten_dict(item) for item in data]
+
+        return get_response_df(flattened_data, IndexBankStatementSchema)
+
+
+# Functional API instance
+_api_instance = IndexBankStatementAPI()
+
+
+@api
+async def get_index_bank_statements(  # noqa: PLR0913
+    stock_codes: list[str],
+    metrics: list[str],
+    date: str | None = None,
+    start_date: str | None = None,
+    end_date: str | None = None,
+    limit: int | None = None,
+) -> pd.DataFrame:
+    """获取银行类指数的财务报表数据.
+
+    Args:
+        stock_codes: 指数代码列表。
+        metrics: 指标列表。
+        date: 日期 (YYYY-MM-DD)，与 start_date 二选一。
+        start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+        end_date: 结束日期 (YYYY-MM-DD)，可选。
+        limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+    Returns:
+        包含银行类指数财务报表数据的 DataFrame。
+
+    Example:
+        获取中证银行指数的营业收入::
+
+            from lixinger import get_index_bank_statements
+
+            df = await get_index_bank_statements(
+                stock_codes=["399986"],
+                metrics=["q.ps.oi.t"],
+                date="2026-03-31",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_bank_statements(
+        stock_codes=stock_codes,
+        metrics=metrics,
+        date=date,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

lixinger/api/cn/index/fs/hybrid.py

@@ -0,0 +1,130 @@
+"""Index hybrid statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.index.fs.hybrid import IndexHybridStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class IndexHybridStatementAPI(BaseAPI):
+    """Index hybrid statement APIs."""
+
+    async def get_hybrid_statements(  # noqa: PLR0913
+        self,
+        stock_codes: list[str],
+        metrics: list[str],
+        date: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        limit: int | None = None,
+    ) -> pd.DataFrame:
+        """获取混合型指数的财务报表数据.
+
+        API Endpoint: /cn/index/fs/hybrid
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/index/fs/hybrid
+
+        获取混合型大陆指数（样本同时包含金融公司和非金融公司）的财务数据，
+        包括利润表、资产负债表、现金流量表、财务指标。
+
+        Args:
+            stock_codes: 指数代码列表，长度 >=1 且 <=100。当传入 start_date 时只能
+                传入一个指数代码。
+            metrics: 指标列表，格式为 [granularity].[tableName].[fieldName].[expressionCalculateType]，
+                例如 ``"q.ps.toi.t"``。当 stock_codes 长度大于 1 时最多 48 个指标；
+                等于 1 时最多 128 个指标。
+            date: 日期 (YYYY-MM-DD)，与 start_date 二选一。支持 ``"latest"``。
+            start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+            end_date: 结束日期 (YYYY-MM-DD)，可选，默认上周一。
+            limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+        Returns:
+            包含混合型指数财务报表数据的 DataFrame。
+
+        Example:
+            获取上证 50 的营业总收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.index.fs.hybrid.get_hybrid_statements(
+                        stock_codes=["000016"],
+                        metrics=["q.ps.toi.t"],
+                        date="2026-03-31",
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCodes": stock_codes,
+            "metricsList": metrics,
+        }
+        if date is not None:
+            payload["date"] = date
+        if start_date is not None:
+            payload["startDate"] = start_date
+        if end_date is not None:
+            payload["endDate"] = end_date
+        if limit is not None:
+            payload["limit"] = limit
+
+        data = await self._request("POST", "/cn/index/fs/hybrid", json=payload)
+
+        # Flatten nested metrics
+        flattened_data = [flatten_dict(item) for item in data]
+
+        return get_response_df(flattened_data, IndexHybridStatementSchema)
+
+
+# Functional API instance
+_api_instance = IndexHybridStatementAPI()
+
+
+@api
+async def get_index_hybrid_statements(  # noqa: PLR0913
+    stock_codes: list[str],
+    metrics: list[str],
+    date: str | None = None,
+    start_date: str | None = None,
+    end_date: str | None = None,
+    limit: int | None = None,
+) -> pd.DataFrame:
+    """获取混合型指数的财务报表数据.
+
+    Args:
+        stock_codes: 指数代码列表。
+        metrics: 指标列表。
+        date: 日期 (YYYY-MM-DD)，与 start_date 二选一。
+        start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+        end_date: 结束日期 (YYYY-MM-DD)，可选。
+        limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+    Returns:
+        包含混合型指数财务报表数据的 DataFrame。
+
+    Example:
+        获取上证 50 的营业总收入::
+
+            from lixinger import get_index_hybrid_statements
+
+            df = await get_index_hybrid_statements(
+                stock_codes=["000016"],
+                metrics=["q.ps.toi.t"],
+                date="2026-03-31",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_hybrid_statements(
+        stock_codes=stock_codes,
+        metrics=metrics,
+        date=date,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

lixinger/api/cn/index/fs/non_financial.py

@@ -0,0 +1,130 @@
+"""Index non-financial statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.index.fs.non_financial import IndexNonFinancialStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class IndexNonFinancialStatementAPI(BaseAPI):
+    """Index non-financial statement APIs."""
+
+    async def get_non_financial_statements(  # noqa: PLR0913
+        self,
+        stock_codes: list[str],
+        metrics: list[str],
+        date: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        limit: int | None = None,
+    ) -> pd.DataFrame:
+        """获取非金融类指数的财务报表数据.
+
+        API Endpoint: /cn/index/fs/non_financial
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/index/fs/non_financial
+
+        获取非金融类大陆指数（样本仅包含非金融公司）的财务数据，包括利润表、
+        资产负债表、现金流量表、财务指标。
+
+        Args:
+            stock_codes: 指数代码列表，长度 >=1 且 <=100。当传入 start_date 时只能
+                传入一个指数代码。
+            metrics: 指标列表，格式为 [granularity].[tableName].[fieldName].[expressionCalculateType]，
+                例如 ``"q.ps.toi.t"``。当 stock_codes 长度大于 1 时最多 48 个指标；
+                等于 1 时最多 128 个指标。
+            date: 日期 (YYYY-MM-DD)，与 start_date 二选一。支持 ``"latest"``。
+            start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+            end_date: 结束日期 (YYYY-MM-DD)，可选，默认上周一。
+            limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+        Returns:
+            包含非金融类指数财务报表数据的 DataFrame。
+
+        Example:
+            获取中证白酒指数的营业总收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.index.fs.non_financial.get_non_financial_statements(
+                        stock_codes=["000932"],
+                        metrics=["q.ps.toi.t"],
+                        date="2026-03-31",
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCodes": stock_codes,
+            "metricsList": metrics,
+        }
+        if date is not None:
+            payload["date"] = date
+        if start_date is not None:
+            payload["startDate"] = start_date
+        if end_date is not None:
+            payload["endDate"] = end_date
+        if limit is not None:
+            payload["limit"] = limit
+
+        data = await self._request("POST", "/cn/index/fs/non_financial", json=payload)
+
+        # Flatten nested metrics (e.g. {"q": {"ps": {"toi": {"t": ...}}}})
+        flattened_data = [flatten_dict(item) for item in data]
+
+        return get_response_df(flattened_data, IndexNonFinancialStatementSchema)
+
+
+# Functional API instance
+_api_instance = IndexNonFinancialStatementAPI()
+
+
+@api
+async def get_index_non_financial_statements(  # noqa: PLR0913
+    stock_codes: list[str],
+    metrics: list[str],
+    date: str | None = None,
+    start_date: str | None = None,
+    end_date: str | None = None,
+    limit: int | None = None,
+) -> pd.DataFrame:
+    """获取非金融类指数的财务报表数据.
+
+    Args:
+        stock_codes: 指数代码列表。
+        metrics: 指标列表。
+        date: 日期 (YYYY-MM-DD)，与 start_date 二选一。
+        start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+        end_date: 结束日期 (YYYY-MM-DD)，可选。
+        limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+    Returns:
+        包含非金融类指数财务报表数据的 DataFrame。
+
+    Example:
+        获取中证白酒指数的营业总收入::
+
+            from lixinger import get_index_non_financial_statements
+
+            df = await get_index_non_financial_statements(
+                stock_codes=["000932"],
+                metrics=["q.ps.toi.t"],
+                date="2026-03-31",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_non_financial_statements(
+        stock_codes=stock_codes,
+        metrics=metrics,
+        date=date,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

lixinger/api/cn/index/fs/security.py

@@ -0,0 +1,130 @@
+"""Index security statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.index.fs.security import IndexSecurityStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class IndexSecurityStatementAPI(BaseAPI):
+    """Index security statement APIs."""
+
+    async def get_security_statements(  # noqa: PLR0913
+        self,
+        stock_codes: list[str],
+        metrics: list[str],
+        date: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        limit: int | None = None,
+    ) -> pd.DataFrame:
+        """获取证券类指数的财务报表数据.
+
+        API Endpoint: /cn/index/fs/security
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/index/fs/security
+
+        获取证券类大陆指数（样本仅包含证券公司）的财务数据，包括利润表、
+        资产负债表、现金流量表、财务指标。
+
+        Args:
+            stock_codes: 指数代码列表，长度 >=1 且 <=100。当传入 start_date 时只能
+                传入一个指数代码。
+            metrics: 指标列表，格式为 [granularity].[tableName].[fieldName].[expressionCalculateType]，
+                例如 ``"q.ps.toi.t"``。当 stock_codes 长度大于 1 时最多 48 个指标；
+                等于 1 时最多 128 个指标。
+            date: 日期 (YYYY-MM-DD)，与 start_date 二选一。支持 ``"latest"``。
+            start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+            end_date: 结束日期 (YYYY-MM-DD)，可选，默认上周一。
+            limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+        Returns:
+            包含证券类指数财务报表数据的 DataFrame。
+
+        Example:
+            获取证券公司指数的营业总收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.index.fs.security.get_security_statements(
+                        stock_codes=["399975"],
+                        metrics=["q.ps.toi.t"],
+                        date="2026-03-31",
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCodes": stock_codes,
+            "metricsList": metrics,
+        }
+        if date is not None:
+            payload["date"] = date
+        if start_date is not None:
+            payload["startDate"] = start_date
+        if end_date is not None:
+            payload["endDate"] = end_date
+        if limit is not None:
+            payload["limit"] = limit
+
+        data = await self._request("POST", "/cn/index/fs/security", json=payload)
+
+        # Flatten nested metrics
+        flattened_data = [flatten_dict(item) for item in data]
+
+        return get_response_df(flattened_data, IndexSecurityStatementSchema)
+
+
+# Functional API instance
+_api_instance = IndexSecurityStatementAPI()
+
+
+@api
+async def get_index_security_statements(  # noqa: PLR0913
+    stock_codes: list[str],
+    metrics: list[str],
+    date: str | None = None,
+    start_date: str | None = None,
+    end_date: str | None = None,
+    limit: int | None = None,
+) -> pd.DataFrame:
+    """获取证券类指数的财务报表数据.
+
+    Args:
+        stock_codes: 指数代码列表。
+        metrics: 指标列表。
+        date: 日期 (YYYY-MM-DD)，与 start_date 二选一。
+        start_date: 开始日期 (YYYY-MM-DD)，与 date 二选一。
+        end_date: 结束日期 (YYYY-MM-DD)，可选。
+        limit: 返回最近数据的数量，仅在 date range 请求下生效。
+
+    Returns:
+        包含证券类指数财务报表数据的 DataFrame。
+
+    Example:
+        获取证券公司指数的营业总收入::
+
+            from lixinger import get_index_security_statements
+
+            df = await get_index_security_statements(
+                stock_codes=["399975"],
+                metrics=["q.ps.toi.t"],
+                date="2026-03-31",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_security_statements(
+        stock_codes=stock_codes,
+        metrics=metrics,
+        date=date,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

lixinger/api/cn/index/namespace.py

@@ -4,11 +4,49 @@ from lixinger.api.cn.index.candlestick import IndexCandlestickAPI
 from lixinger.api.cn.index.constituent_weightings import ConstituentWeightingsAPI
 from lixinger.api.cn.index.constituents import ConstituentsAPI
 from lixinger.api.cn.index.drawdown import DrawdownAPI
+from lixinger.api.cn.index.fs.bank import IndexBankStatementAPI
+from lixinger.api.cn.index.fs.hybrid import IndexHybridStatementAPI
+from lixinger.api.cn.index.fs.non_financial import IndexNonFinancialStatementAPI
+from lixinger.api.cn.index.fs.security import IndexSecurityStatementAPI
 from lixinger.api.cn.index.fundamental import IndexFundamentalAPI
 from lixinger.api.cn.index.index import IndexAPI
 from lixinger.api.cn.index.tracking_fund import TrackingFundAPI
 
 
+class IndexFSNamespace:
+    """Namespace for index financial statement APIs.
+
+    Groups all index financial statement APIs by index type:
+
+    - non_financial: Non-financial indices (非金融类指数)
+    - bank: Bank indices (银行类指数)
+    - security: Security indices (证券类指数)
+    - hybrid: Hybrid indices (混合型指数)
+
+    """
+
+    def __init__(
+        self,
+        non_financial: IndexNonFinancialStatementAPI,
+        bank: IndexBankStatementAPI,
+        security: IndexSecurityStatementAPI,
+        hybrid: IndexHybridStatementAPI,
+    ):
+        """Initialize the index financial statement namespace.
+
+        Args:
+            non_financial: Non-financial index statement API
+            bank: Bank index statement API
+            security: Security index statement API
+            hybrid: Hybrid index statement API
+
+        """
+        self.non_financial = non_financial
+        self.bank = bank
+        self.security = security
+        self.hybrid = hybrid
+
+
 class IndexNamespace:
     """Namespace for index-related APIs.
 
@@ -22,6 +60,11 @@ class IndexNamespace:
     - candlestick: Index candlestick data API (get_candlestick)
     - drawdown: Index drawdown data API (get_drawdown)
     - tracking_fund: Index tracking fund API (get_tracking_fund)
+    - fs: Index financial statement APIs (sub-APIs for different index types)
+      - fs.non_financial: Non-financial index statements
+      - fs.bank: Bank index statements
+      - fs.security: Security index statements
+      - fs.hybrid: Hybrid index statements
 
     """
 
@@ -34,6 +77,10 @@ class IndexNamespace:
         candlestick: IndexCandlestickAPI,
         drawdown: DrawdownAPI,
         tracking_fund: TrackingFundAPI,
+        fs_non_financial: IndexNonFinancialStatementAPI,
+        fs_bank: IndexBankStatementAPI,
+        fs_security: IndexSecurityStatementAPI,
+        fs_hybrid: IndexHybridStatementAPI,
     ):
         """Initialize the index namespace.
 
@@ -45,6 +92,10 @@ class IndexNamespace:
             candlestick: Index candlestick data API
             drawdown: Index drawdown data API
             tracking_fund: Index tracking fund API
+            fs_non_financial: Non-financial index statement API
+            fs_bank: Bank index statement API
+            fs_security: Security index statement API
+            fs_hybrid: Hybrid index statement API
 
         """
         self.index = index
@@ -54,6 +105,12 @@ class IndexNamespace:
         self.candlestick = candlestick
         self.drawdown = drawdown
         self.tracking_fund = tracking_fund
+        self.fs = IndexFSNamespace(
+            non_financial=fs_non_financial,
+            bank=fs_bank,
+            security=fs_security,
+            hybrid=fs_hybrid,
+        )
 
     # Convenience aliases for shorter access
     def get_index(self, *args, **kwargs):

lixinger/client.py

@@ -28,8 +28,12 @@ from lixinger.api.cn.index import (
     ConstituentWeightingsAPI,
     DrawdownAPI,
     IndexAPI,
+    IndexBankStatementAPI,
     IndexCandlestickAPI,
     IndexFundamentalAPI,
+    IndexHybridStatementAPI,
+    IndexNonFinancialStatementAPI,
+    IndexSecurityStatementAPI,
     TrackingFundAPI,
 )
 from lixinger.api.cn.index.namespace import IndexNamespace
@@ -166,6 +170,10 @@ class AsyncLixingerClient:
         cn_index_drawdown = DrawdownAPI(self._http_client, self.config, self._rate_limiter)
         cn_index_fundamental = IndexFundamentalAPI(self._http_client, self.config, self._rate_limiter)
         cn_index_tracking_fund = TrackingFundAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_fs_non_financial = IndexNonFinancialStatementAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_fs_bank = IndexBankStatementAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_fs_security = IndexSecurityStatementAPI(self._http_client, self.config, self._rate_limiter)
+        cn_index_fs_hybrid = IndexHybridStatementAPI(self._http_client, self.config, self._rate_limiter)
 
         # Index namespace (groups all index APIs)
         self.cn_index = IndexNamespace(
@@ -176,6 +184,10 @@ class AsyncLixingerClient:
             candlestick=cn_index_candlestick,
             drawdown=cn_index_drawdown,
             tracking_fund=cn_index_tracking_fund,
+            fs_non_financial=cn_index_fs_non_financial,
+            fs_bank=cn_index_fs_bank,
+            fs_security=cn_index_fs_security,
+            fs_hybrid=cn_index_fs_hybrid,
         )
 
         # Legacy flat access for index APIs (deprecated, for backward compatibility)
@@ -185,6 +197,10 @@ class AsyncLixingerClient:
         self.cn_index_drawdown = cn_index_drawdown
         self.cn_index_fundamental = cn_index_fundamental
         self.cn_index_tracking_fund = cn_index_tracking_fund
+        self.cn_index_fs_non_financial = cn_index_fs_non_financial
+        self.cn_index_fs_bank = cn_index_fs_bank
+        self.cn_index_fs_security = cn_index_fs_security
+        self.cn_index_fs_hybrid = cn_index_fs_hybrid
 
         # Fund APIs
         self.cn_fund = FundAPI(self._http_client, self.config, self._rate_limiter)

lixinger/models/cn/index/__init__.py

@@ -4,6 +4,12 @@ from lixinger.models.cn.index.candlestick import IndexCandlestick
 from lixinger.models.cn.index.constituent_weightings import ConstituentWeighting
 from lixinger.models.cn.index.constituents import Constituent
 from lixinger.models.cn.index.drawdown import IndexDrawdown
+from lixinger.models.cn.index.fs import (
+    IndexBankStatementSchema,
+    IndexHybridStatementSchema,
+    IndexNonFinancialStatementSchema,
+    IndexSecurityStatementSchema,
+)
 from lixinger.models.cn.index.fundamental import IndexFundamentalData
 from lixinger.models.cn.index.index import Index
 from lixinger.models.cn.index.tracking_fund import TrackingFund
@@ -16,4 +22,9 @@ __all__ = [
     "IndexDrawdown",
     "IndexFundamentalData",
     "TrackingFund",
+    # Index financial statements
+    "IndexBankStatementSchema",
+    "IndexHybridStatementSchema",
+    "IndexNonFinancialStatementSchema",
+    "IndexSecurityStatementSchema",
 ]

lixinger/models/cn/index/fs/__init__.py

@@ -0,0 +1,13 @@
+"""Index financial statement models."""
+
+from lixinger.models.cn.index.fs.bank import IndexBankStatementSchema
+from lixinger.models.cn.index.fs.hybrid import IndexHybridStatementSchema
+from lixinger.models.cn.index.fs.non_financial import IndexNonFinancialStatementSchema
+from lixinger.models.cn.index.fs.security import IndexSecurityStatementSchema
+
+__all__ = [
+    "IndexBankStatementSchema",
+    "IndexHybridStatementSchema",
+    "IndexNonFinancialStatementSchema",
+    "IndexSecurityStatementSchema",
+]

lixinger/models/cn/index/fs/bank.py

@@ -0,0 +1,20 @@
+"""Index bank statement models."""
+
+import pandera.pandas as pa
+
+
+class IndexBankStatementSchema(pa.DataFrameModel):
+    """Index bank statement model."""
+
+    class Config:
+        """Pandera configuration."""
+
+        coerce = True
+        strict = False  # Allow extra metrics columns
+
+    date: pa.typing.Series[pa.typing.DateTime]
+    stock_code: pa.typing.Series[str]
+    currency: pa.typing.Series[str]
+    report_date: pa.typing.Series[pa.typing.DateTime]
+    report_type: pa.typing.Series[str]
+    standard_date: pa.typing.Series[pa.typing.DateTime]

lixinger/models/cn/index/fs/hybrid.py

@@ -0,0 +1,20 @@
+"""Index hybrid statement models."""
+
+import pandera.pandas as pa
+
+
+class IndexHybridStatementSchema(pa.DataFrameModel):
+    """Index hybrid statement model."""
+
+    class Config:
+        """Pandera configuration."""
+
+        coerce = True
+        strict = False  # Allow extra metrics columns
+
+    date: pa.typing.Series[pa.typing.DateTime]
+    stock_code: pa.typing.Series[str]
+    currency: pa.typing.Series[str]
+    report_date: pa.typing.Series[pa.typing.DateTime]
+    report_type: pa.typing.Series[str]
+    standard_date: pa.typing.Series[pa.typing.DateTime]

lixinger/models/cn/index/fs/non_financial.py

@@ -0,0 +1,20 @@
+"""Index non-financial statement models."""
+
+import pandera.pandas as pa
+
+
+class IndexNonFinancialStatementSchema(pa.DataFrameModel):
+    """Index non-financial statement model."""
+
+    class Config:
+        """Pandera configuration."""
+
+        coerce = True
+        strict = False  # Allow extra metrics columns
+
+    date: pa.typing.Series[pa.typing.DateTime]
+    stock_code: pa.typing.Series[str]
+    currency: pa.typing.Series[str]
+    report_date: pa.typing.Series[pa.typing.DateTime]
+    report_type: pa.typing.Series[str]
+    standard_date: pa.typing.Series[pa.typing.DateTime]

lixinger/models/cn/index/fs/security.py

@@ -0,0 +1,20 @@
+"""Index security statement models."""
+
+import pandera.pandas as pa
+
+
+class IndexSecurityStatementSchema(pa.DataFrameModel):
+    """Index security statement model."""
+
+    class Config:
+        """Pandera configuration."""
+
+        coerce = True
+        strict = False  # Allow extra metrics columns
+
+    date: pa.typing.Series[pa.typing.DateTime]
+    stock_code: pa.typing.Series[str]
+    currency: pa.typing.Series[str]
+    report_date: pa.typing.Series[pa.typing.DateTime]
+    report_type: pa.typing.Series[str]
+    standard_date: pa.typing.Series[pa.typing.DateTime]

{lixinger_python-0.3.6.dist-info → lixinger_python-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lixinger-python
-Version: 0.3.6
+Version: 0.3.7
 Summary: Python SDK for Lixinger Financial Data API
 Project-URL: Homepage, https://www.lixinger.com
 Project-URL: Documentation, https://www.lixinger.com/open/api/doc

{lixinger_python-0.3.6.dist-info → lixinger_python-0.3.7.dist-info}/RECORD

@@ -1,5 +1,5 @@
-lixinger/__init__.py,sha256=_W43coEZ9iVNFec80S_uRcYYkSkgLuvq3PaPLFj16qU,2126
-lixinger/client.py,sha256=aaYJfOjc9-IxqGe1LqiXtR6ldUNrqoorMSg67TbUA0A,10333
+lixinger/__init__.py,sha256=WhuTjjENkj2h5Qr66PNfv41AGV6hKNdGi87borIqeBw,2445
+lixinger/client.py,sha256=djI2Lf4a09Vkdm7ManJs4WVP_cDS-_coqT3h2Eg4UHc,11296
 lixinger/config.py,sha256=JPz8EOrf1kP4Do-Z5-MsnOM0pMrNE1ZsP-Qoarh9y4c,2008
 lixinger/exceptions.py,sha256=eWSDO-3CRESPsfzomzMc-9NYPBQ1EEPJ_CPSIo-UlDM,508
 lixinger/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -31,15 +31,20 @@ lixinger/api/cn/fund/candlestick.py,sha256=XdkxjtjIT1ixNzOArJRKBvlabTHz3PA9w2zsG
 lixinger/api/cn/fund/fund.py,sha256=Y1ysdyl1zpu71iiFR4G6ixqBT4Kb9PxSWk_oFpFVeMI,1624
 lixinger/api/cn/fund/profile.py,sha256=kTbqmz3obYRNjFjkD74I-R3x0SBsZCqI0KPjiWe84QI,1347
 lixinger/api/cn/fund/shareholdings.py,sha256=aGFsyBiIW-wsbpAnwnAnRY6duiBKeYbQVKfpdQXs3tY,2358
-lixinger/api/cn/index/__init__.py,sha256=T1vGReTsHm9l-nCp0H_Um0nCQcNb7y0KR9gGVh--xQs,982
+lixinger/api/cn/index/__init__.py,sha256=IylYWSnDd5KD5HbTAoiJRgBkasYf53YurKxf5pFwdgc,1594
 lixinger/api/cn/index/candlestick.py,sha256=MdFGWf3pSoqPtzkCQJbSY1b6vw1nmZ6lKmgxdFMIMlo,2356
 lixinger/api/cn/index/constituent_weightings.py,sha256=UuAmqhgapMAMW6qZge3yKb9E9h7WNuZZ83sLkZIq-rA,3352
 lixinger/api/cn/index/constituents.py,sha256=8kQjTJER8PqpZMTQWusDK9mbQ27YLYgYxw8u_vHqsy4,3372
 lixinger/api/cn/index/drawdown.py,sha256=D-fhA-Sv2-gf6VzX0zG1dm7Tn5Wy7NK1IB-f5kFXi7w,2450
 lixinger/api/cn/index/fundamental.py,sha256=MyhGmMk7GkOZflpT0JMoiLsCs3DLMLLkopyUsD94Y4Q,2474
 lixinger/api/cn/index/index.py,sha256=5gDwE5K3tYNlCrV-EsSC4HXhfIi58uqWpHQxTt9LJMk,4177
-lixinger/api/cn/index/namespace.py,sha256=YoxOwbA3_8o4iUvqIRWFPIBnvkF3PfToelBy1aWPkkw,3431
+lixinger/api/cn/index/namespace.py,sha256=pzYkQzYqu5TASTZxk5IQJDqt2U7oTbTzwBErfp2aKxE,5559
 lixinger/api/cn/index/tracking_fund.py,sha256=su0zJRROKuTZlHe0XkIQz8kJOyPZmyg7HxZIbmpM_YM,1960
+lixinger/api/cn/index/fs/__init__.py,sha256=eQTxjzZfiqxDU8WdLA-deAtus-nYEiO2mLq2gOkFTts,1060
+lixinger/api/cn/index/fs/bank.py,sha256=zjDB_d06E_gxAvVNyk9Byoa5ShlevNoc75z5gVBH6aY,4416
+lixinger/api/cn/index/fs/hybrid.py,sha256=qs25ZXdCBiIRQ3mm2yyXQngSGtLIs1W93nvRxQDubIE,4429
+lixinger/api/cn/index/fs/non_financial.py,sha256=XlP9Jl5bHUto6mybj4WGCb11LjYINzwYhJaG_WEHYww,4599
+lixinger/api/cn/index/fs/security.py,sha256=l1Raf8GuYpthRDgNSMnVjDn9AcKLG5qP-wVKMd4GKQw,4458
 lixinger/models/__init__.py,sha256=OAUYpI_JaGZExFqZ0H6l8fJ5qyLW0oFnnO4JGJQknTE,154
 lixinger/models/cn/__init__.py,sha256=mhTq_PfPJ_0720E1rTKdqBTpb9A14_ZDDWLfJXjcVck,27
 lixinger/models/cn/company/__init__.py,sha256=7E7p1NED5qr0yf_wcmOq_DDvOq2hzXv3bD4cLjHTtSQ,957
@@ -65,7 +70,7 @@ lixinger/models/cn/fund/candlestick.py,sha256=JSmEPTIB992Mujb6qBBX3NUTq9tafoJdNh
 lixinger/models/cn/fund/fund.py,sha256=IQQJic7dL58eM00E6DDY9beePpqJSqxu6E1DW0-X3iY,762
 lixinger/models/cn/fund/profile.py,sha256=j02zgDXdFC9zLPcEgNKpoxIeHLac27ySngU6Vikh_V4,1202
 lixinger/models/cn/fund/shareholdings.py,sha256=67cJfRGBjMRwI6f1RQbg-Hnb-SK620gKIphvCdjNzOk,611
-lixinger/models/cn/index/__init__.py,sha256=bDSqijHQ_DskEpSp4qZzrKdAw9gCM6cwEd87Z_cJrRM,649
+lixinger/models/cn/index/__init__.py,sha256=NxxKPPv3qg-nVA3UHmWIbKLaMKTKHBcc01PyWcq7P7s,1002
 lixinger/models/cn/index/candlestick.py,sha256=So3ArqKge-reoeAn5E26I1fQusPks6jtvfHVNKF_yY0,560
 lixinger/models/cn/index/constituent_weightings.py,sha256=Vr68TyJ6mjXtKMUD-d_daG2CR1GJ60ipAfK-HhdXZVo,370
 lixinger/models/cn/index/constituents.py,sha256=UDVCoQsKahMhlF9Os-Xgo0XRg6dfH5WBBiOuQMlPqz8,371
@@ -73,13 +78,18 @@ lixinger/models/cn/index/drawdown.py,sha256=kvrhy7_fIjvUHXFTUn3TXqSNip7vZXpfWjly
 lixinger/models/cn/index/fundamental.py,sha256=4gBOFADCq1C0pcSa9JfxDkH-3spRErkg3LwVJyYrGvU,374
 lixinger/models/cn/index/index.py,sha256=M_ZYGGfcpWXrmwhz58HfojInsmAUQeZSNJ74sAqTbqA,842
 lixinger/models/cn/index/tracking_fund.py,sha256=qbsdMlD0FBpWDBWS8smOeqK_hJOp8OzkT2NA0Zn_k-s,424
+lixinger/models/cn/index/fs/__init__.py,sha256=CMHJ7UaslJYuUkynpd_yADsP8gsNFEOS67kng5Ryvok,507
+lixinger/models/cn/index/fs/bank.py,sha256=DA_sRFSsK5IE0JQtp3pHdvPJQxbipHsSyKahcBbaZ-U,559
+lixinger/models/cn/index/fs/hybrid.py,sha256=AlCoEfkkPdWGxE_K71rBKgwWpR4iWTaMJ8bc56YxYrk,565
+lixinger/models/cn/index/fs/non_financial.py,sha256=UpWXDDMiOdJN6WNc5R-PsHy9l9Th3xsKnOjUbID4Gug,585
+lixinger/models/cn/index/fs/security.py,sha256=VTYDvTQ5CKhqZsXeEyWqFNvugZ4UA3CLW0DkYTrOHtc,571
 lixinger/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lixinger/utils/api.py,sha256=BktR40JtKCMe9excFWo4ujsq3GiQK4ypJLG3MpJgo2s,402
 lixinger/utils/dataframe.py,sha256=tYBrNdmJ4poyuwD-9XgzHt3A_A8bBo0cdHiu8Yy9e9A,2208
 lixinger/utils/dict.py,sha256=yvbUtv8QpRmy0d_o_7gCuEwwiEfBji5_xB490ANxilw,589
 lixinger/utils/rate_limiter.py,sha256=DCaG87kIjDU5triYHU33-FW7h6KsbELBnU9f6mCQKCU,1133
 lixinger/utils/retry.py,sha256=sXtb0ESp12_JedjzDxoeIH48TlOrbxtIA0j1V33DW7M,1026
-lixinger_python-0.3.6.dist-info/METADATA,sha256=aT8MpJ92JR865fQkw2Zf4ex0l8HfTy4zioD-xkYMjuw,9206
-lixinger_python-0.3.6.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-lixinger_python-0.3.6.dist-info/licenses/LICENSE,sha256=5oOwRq1lHSOScbNGCHr2feuNnhNYdGcArj6fSUfsC5U,1064
-lixinger_python-0.3.6.dist-info/RECORD,,
+lixinger_python-0.3.7.dist-info/METADATA,sha256=Kom1Z2xPM3d87I39ccLzH4zTSz_Vwc-UZohr9DZqAhQ,9206
+lixinger_python-0.3.7.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+lixinger_python-0.3.7.dist-info/licenses/LICENSE,sha256=5oOwRq1lHSOScbNGCHr2feuNnhNYdGcArj6fSUfsC5U,1064
+lixinger_python-0.3.7.dist-info/RECORD,,