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

lixinger/__init__.py

@@ -1,6 +1,12 @@
 from lixinger.api.cn.company import get_company, get_equity_change, get_profile
 from lixinger.api.cn.company.candlestick import get_candlestick
-from lixinger.api.cn.company.fs.non_financial import get_non_financial_statements
+from lixinger.api.cn.company.fs import (
+    get_bank_statements,
+    get_insurance_statements,
+    get_non_financial_statements,
+    get_other_financial_statements,
+    get_security_statements,
+)
 from lixinger.api.cn.company.fundamental import (
     get_bank_fundamental,
     get_insurance_fundamental,
@@ -73,6 +79,10 @@ __all__ = [
     "get_index_candlestick",
     "get_index_drawdown",
     "get_non_financial_statements",
+    "get_bank_statements",
+    "get_insurance_statements",
+    "get_security_statements",
+    "get_other_financial_statements",
     "get_non_financial_fundamental",
     "get_bank_fundamental",
     "get_insurance_fundamental",

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

@@ -1,5 +1,46 @@
-"""Financial statement APIs."""
+"""Financial statement APIs.
 
-from lixinger.api.cn.company.fs.non_financial import get_non_financial_statements
+This module provides access to company financial statement APIs by company type:
 
-__all__ = ["get_non_financial_statements"]
+- non_financial: Non-financial companies (非金融企业)
+- bank: Banks (银行)
+- insurance: Insurance companies (保险)
+- security: Securities companies (证券)
+- other_financial: Other financial companies (租赁、消费金融等)
+"""
+
+from lixinger.api.cn.company.fs.bank import (
+    BankStatementAPI,
+    get_bank_statements,
+)
+from lixinger.api.cn.company.fs.insurance import (
+    InsuranceStatementAPI,
+    get_insurance_statements,
+)
+from lixinger.api.cn.company.fs.non_financial import (
+    NonFinancialStatementAPI,
+    get_non_financial_statements,
+)
+from lixinger.api.cn.company.fs.other_financial import (
+    OtherFinancialStatementAPI,
+    get_other_financial_statements,
+)
+from lixinger.api.cn.company.fs.security import (
+    SecurityStatementAPI,
+    get_security_statements,
+)
+
+__all__ = [
+    # API Classes
+    "BankStatementAPI",
+    "InsuranceStatementAPI",
+    "NonFinancialStatementAPI",
+    "OtherFinancialStatementAPI",
+    "SecurityStatementAPI",
+    # Functional APIs
+    "get_bank_statements",
+    "get_insurance_statements",
+    "get_non_financial_statements",
+    "get_other_financial_statements",
+    "get_security_statements",
+]

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

@@ -0,0 +1,132 @@
+"""Bank financial statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.company.fs.bank import BankStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class BankStatementAPI(BaseAPI):
+    """Bank financial 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:
+        """获取A股上市银行的财务报表数据.
+
+        API Endpoint: /cn/company/fs/bank
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/company/fs/bank
+
+        获取A股上市银行的财务报表数据，包括利润表、资产负债表、现金流量表、
+        正常财务指标以及银行特有财务指标（净息差、净利差、资本充足率、
+        不良率、拨贷比等）。
+
+        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:
+            包含A股银行财务报表数据的 DataFrame。
+
+        Example:
+            获取民生银行和工商银行的营业收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.cn_company.fs.bank.get_bank_statements(
+                        stock_codes=["600016", "601398"],
+                        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/company/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, BankStatementSchema)
+
+
+# Functional API instance
+_api_instance = BankStatementAPI()
+
+
+@api
+async def get_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:
+    """获取A股上市银行的财务报表数据.
+
+    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:
+        包含A股银行财务报表数据的 DataFrame。
+
+    Example:
+        获取民生银行的营业收入::
+
+            from lixinger import get_bank_statements
+
+            df = await get_bank_statements(
+                stock_codes=["600016"],
+                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/company/fs/insurance.py

@@ -0,0 +1,132 @@
+"""Insurance financial statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.company.fs.insurance import InsuranceStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class InsuranceStatementAPI(BaseAPI):
+    """Insurance financial statement APIs."""
+
+    async def get_insurance_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:
+        """获取A股保险公司的财务报表数据.
+
+        API Endpoint: /cn/company/fs/insurance
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/company/fs/insurance
+
+        获取A股保险公司的财务报表数据，包括利润表、资产负债表、现金流量表、
+        正常财务指标以及保险公司特有财务指标（内含价值、新业务价值、
+        核心偿付能力充足率、综合偿付能力充足率等）。
+
+        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:
+            包含A股保险公司财务报表数据的 DataFrame。
+
+        Example:
+            获取中国平安的营业总收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.cn_company.fs.insurance.get_insurance_statements(
+                        stock_codes=["601318"],
+                        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/company/fs/insurance", 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, InsuranceStatementSchema)
+
+
+# Functional API instance
+_api_instance = InsuranceStatementAPI()
+
+
+@api
+async def get_insurance_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:
+    """获取A股保险公司的财务报表数据.
+
+    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:
+        包含A股保险公司财务报表数据的 DataFrame。
+
+    Example:
+        获取中国平安的营业总收入::
+
+            from lixinger import get_insurance_statements
+
+            df = await get_insurance_statements(
+                stock_codes=["601318"],
+                metrics=["q.ps.toi.t"],
+                date="2026-03-31",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_insurance_statements(
+        stock_codes=stock_codes,
+        metrics=metrics,
+        date=date,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

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

@@ -14,13 +14,14 @@ from lixinger.utils.dict import flatten_dict
 class NonFinancialStatementAPI(BaseAPI):
     """Non-financial statement APIs."""
 
-    async def get_non_financial_statements(
+    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:
         """获取非金融企业财务报表数据.
 
@@ -34,6 +35,7 @@ class NonFinancialStatementAPI(BaseAPI):
             date: 日期 (YYYY-MM-DD), 与 startDate 二选一
             start_date: 开始日期 (YYYY-MM-DD), 与 date 二选一
             end_date: 结束日期 (YYYY-MM-DD), 可选
+            limit: 返回最近数据的数量，仅在 date range 请求下生效
 
         """
         payload: dict[str, Any] = {
@@ -46,6 +48,8 @@ class NonFinancialStatementAPI(BaseAPI):
             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/company/fs/non_financial", json=payload)
 
@@ -60,12 +64,13 @@ _api_instance = NonFinancialStatementAPI()
 
 
 @api
-async def get_non_financial_statements(
+async def get_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:
     """获取非金融企业财务报表数据."""
     return await _api_instance.get_non_financial_statements(
@@ -74,4 +79,5 @@ async def get_non_financial_statements(
         date=date,
         start_date=start_date,
         end_date=end_date,
+        limit=limit,
     )

lixinger/api/cn/company/fs/other_financial.py

@@ -0,0 +1,131 @@
+"""Other financial company financial statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.company.fs.other_financial import OtherFinancialStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class OtherFinancialStatementAPI(BaseAPI):
+    """Other financial company financial statement APIs."""
+
+    async def get_other_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:
+        """获取A股其他金融公司（租赁、消费金融等）的财务报表数据.
+
+        API Endpoint: /cn/company/fs/other_financial
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/company/fs/other_financial
+
+        获取A股其他金融公司（租赁、消费金融等）的财务报表数据，包括利润表、
+        资产负债表、现金流量表以及各类财务指标。
+
+        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:
+            包含A股其他金融公司财务报表数据的 DataFrame。
+
+        Example:
+            获取江苏租赁的营业总收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.cn_company.fs.other_financial.get_other_financial_statements(
+                        stock_codes=["600901"],
+                        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/company/fs/other_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, OtherFinancialStatementSchema)
+
+
+# Functional API instance
+_api_instance = OtherFinancialStatementAPI()
+
+
+@api
+async def get_other_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:
+    """获取A股其他金融公司（租赁、消费金融等）的财务报表数据.
+
+    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:
+        包含A股其他金融公司财务报表数据的 DataFrame。
+
+    Example:
+        获取江苏租赁的营业总收入::
+
+            from lixinger import get_other_financial_statements
+
+            df = await get_other_financial_statements(
+                stock_codes=["600901"],
+                metrics=["q.ps.toi.t"],
+                date="2026-03-31",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_other_financial_statements(
+        stock_codes=stock_codes,
+        metrics=metrics,
+        date=date,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

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

@@ -0,0 +1,132 @@
+"""Security (securities firm) financial statement APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.company.fs.security import SecurityStatementSchema
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+from lixinger.utils.dict import flatten_dict
+
+
+class SecurityStatementAPI(BaseAPI):
+    """Security (securities firm) financial 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:
+        """获取A股证券公司的财务报表数据.
+
+        API Endpoint: /cn/company/fs/security
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/company/fs/security
+
+        获取A股证券公司的财务报表数据，包括利润表、资产负债表、现金流量表、
+        正常财务指标以及证券公司特有财务指标（净资本、风险覆盖率、
+        资本杠杆率、流动性覆盖率、净稳定资金率等）。
+
+        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:
+            包含A股证券公司财务报表数据的 DataFrame。
+
+        Example:
+            获取中信证券的营业总收入::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.cn_company.fs.security.get_security_statements(
+                        stock_codes=["600030"],
+                        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/company/fs/security", 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, SecurityStatementSchema)
+
+
+# Functional API instance
+_api_instance = SecurityStatementAPI()
+
+
+@api
+async def get_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:
+    """获取A股证券公司的财务报表数据.
+
+    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:
+        包含A股证券公司财务报表数据的 DataFrame。
+
+    Example:
+        获取中信证券的营业总收入::
+
+            from lixinger import get_security_statements
+
+            df = await get_security_statements(
+                stock_codes=["600030"],
+                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/company/namespace.py

@@ -5,7 +5,11 @@ from lixinger.api.cn.company.candlestick import CandlestickAPI
 from lixinger.api.cn.company.company import CompanyAPI
 from lixinger.api.cn.company.dividend import DividendAPI
 from lixinger.api.cn.company.equity_change import EquityChangeAPI
+from lixinger.api.cn.company.fs.bank import BankStatementAPI
+from lixinger.api.cn.company.fs.insurance import InsuranceStatementAPI
 from lixinger.api.cn.company.fs.non_financial import NonFinancialStatementAPI
+from lixinger.api.cn.company.fs.other_financial import OtherFinancialStatementAPI
+from lixinger.api.cn.company.fs.security import SecurityStatementAPI
 from lixinger.api.cn.company.fundamental.bank import BankFundamentalAPI
 from lixinger.api.cn.company.fundamental.insurance import InsuranceFundamentalAPI
 from lixinger.api.cn.company.fundamental.non_financial import NonFinancialFundamentalAPI
@@ -43,11 +47,31 @@ class FundamentalNamespace:
 
 
 class FSNamespace:
-    """Namespace for financial statement APIs."""
+    """Namespace for financial statement APIs.
 
-    def __init__(self, non_financial: NonFinancialStatementAPI):
+    Groups all financial statement APIs by company type:
+
+    - non_financial: Non-financial companies (非金融企业)
+    - bank: Banks (银行)
+    - insurance: Insurance companies (保险)
+    - security: Securities companies (证券)
+    - other_financial: Other financial companies (租赁、消费金融等)
+    """
+
+    def __init__(
+        self,
+        non_financial: NonFinancialStatementAPI,
+        bank: BankStatementAPI,
+        insurance: InsuranceStatementAPI,
+        security: SecurityStatementAPI,
+        other_financial: OtherFinancialStatementAPI,
+    ):
         """Initialize the financial statement namespace."""
         self.non_financial = non_financial
+        self.bank = bank
+        self.insurance = insurance
+        self.security = security
+        self.other_financial = other_financial
 
 
 class CompanyNamespace:
@@ -66,8 +90,12 @@ class CompanyNamespace:
       - fundamental.security: Securities company fundamental data
       - fundamental.other_financial: Other financial company fundamental data
     - candlestick: Candlestick data API
-    - fs: Financial statement APIs
+    - fs: Financial statement APIs (contains sub-APIs for different company types)
       - fs.non_financial: Non-financial statements API
+      - fs.bank: Bank statements API
+      - fs.insurance: Insurance statements API
+      - fs.security: Security statements API
+      - fs.other_financial: Other financial company statements API
     - indices: Company indices API
     - dividend: Dividend data API
     - announcement: Announcement data API
@@ -86,6 +114,10 @@ class CompanyNamespace:
         fundamental_other_financial: OtherFinancialFundamentalAPI,
         candlestick: CandlestickAPI,
         fs_non_financial: NonFinancialStatementAPI,
+        fs_bank: BankStatementAPI,
+        fs_insurance: InsuranceStatementAPI,
+        fs_security: SecurityStatementAPI,
+        fs_other_financial: OtherFinancialStatementAPI,
         indices: IndicesAPI,
         dividend: DividendAPI,
         announcement: AnnouncementAPI,
@@ -103,6 +135,10 @@ class CompanyNamespace:
             fundamental_other_financial: Other financial company fundamental data API
             candlestick: Candlestick data API
             fs_non_financial: Non-financial statements API
+            fs_bank: Bank statements API
+            fs_insurance: Insurance statements API
+            fs_security: Security statements API
+            fs_other_financial: Other financial company statements API
             indices: Company indices API
             dividend: Dividend data API
             announcement: Announcement data API
@@ -119,7 +155,13 @@ class CompanyNamespace:
             other_financial=fundamental_other_financial,
         )
         self.candlestick = candlestick
-        self.fs = FSNamespace(non_financial=fs_non_financial)
+        self.fs = FSNamespace(
+            non_financial=fs_non_financial,
+            bank=fs_bank,
+            insurance=fs_insurance,
+            security=fs_security,
+            other_financial=fs_other_financial,
+        )
         self.indices = indices
         self.dividend = dividend
         self.announcement = announcement

lixinger/client.py

@@ -5,7 +5,11 @@ from lixinger.api.cn.company.candlestick import CandlestickAPI
 from lixinger.api.cn.company.company import CompanyAPI
 from lixinger.api.cn.company.dividend import DividendAPI
 from lixinger.api.cn.company.equity_change import EquityChangeAPI
+from lixinger.api.cn.company.fs.bank import BankStatementAPI
+from lixinger.api.cn.company.fs.insurance import InsuranceStatementAPI
 from lixinger.api.cn.company.fs.non_financial import NonFinancialStatementAPI
+from lixinger.api.cn.company.fs.other_financial import OtherFinancialStatementAPI
+from lixinger.api.cn.company.fs.security import SecurityStatementAPI
 from lixinger.api.cn.company.fundamental.bank import BankFundamentalAPI
 from lixinger.api.cn.company.fundamental.insurance import InsuranceFundamentalAPI
 from lixinger.api.cn.company.fundamental.non_financial import NonFinancialFundamentalAPI
@@ -134,6 +138,10 @@ class AsyncLixingerClient:
         )
         cn_company_candlestick = CandlestickAPI(self._http_client, self.config, self._rate_limiter)
         cn_company_fs_non_financial = NonFinancialStatementAPI(self._http_client, self.config, self._rate_limiter)
+        cn_company_fs_bank = BankStatementAPI(self._http_client, self.config, self._rate_limiter)
+        cn_company_fs_insurance = InsuranceStatementAPI(self._http_client, self.config, self._rate_limiter)
+        cn_company_fs_security = SecurityStatementAPI(self._http_client, self.config, self._rate_limiter)
+        cn_company_fs_other_financial = OtherFinancialStatementAPI(self._http_client, self.config, self._rate_limiter)
         cn_company_indices = IndicesAPI(self._http_client, self.config, self._rate_limiter)
         cn_company_dividend = DividendAPI(self._http_client, self.config, self._rate_limiter)
         cn_company_announcement = AnnouncementAPI(self._http_client, self.config, self._rate_limiter)
@@ -150,6 +158,10 @@ class AsyncLixingerClient:
             fundamental_other_financial=cn_company_fundamental_other_financial,
             candlestick=cn_company_candlestick,
             fs_non_financial=cn_company_fs_non_financial,
+            fs_bank=cn_company_fs_bank,
+            fs_insurance=cn_company_fs_insurance,
+            fs_security=cn_company_fs_security,
+            fs_other_financial=cn_company_fs_other_financial,
             indices=cn_company_indices,
             dividend=cn_company_dividend,
             announcement=cn_company_announcement,
@@ -158,6 +170,10 @@ class AsyncLixingerClient:
         # Legacy flat access (deprecated, for backward compatibility)
         self.cn_company_candlestick = cn_company_candlestick
         self.cn_company_fs_non_financial = cn_company_fs_non_financial
+        self.cn_company_fs_bank = cn_company_fs_bank
+        self.cn_company_fs_insurance = cn_company_fs_insurance
+        self.cn_company_fs_security = cn_company_fs_security
+        self.cn_company_fs_other_financial = cn_company_fs_other_financial
         self.cn_company_indices = cn_company_indices
         self.cn_company_dividend = cn_company_dividend
         self.cn_company_announcement = cn_company_announcement

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

@@ -1,5 +1,15 @@
 """Financial statement models."""
 
+from lixinger.models.cn.company.fs.bank import BankStatementSchema
+from lixinger.models.cn.company.fs.insurance import InsuranceStatementSchema
 from lixinger.models.cn.company.fs.non_financial import NonFinancialStatementSchema
+from lixinger.models.cn.company.fs.other_financial import OtherFinancialStatementSchema
+from lixinger.models.cn.company.fs.security import SecurityStatementSchema
 
-__all__ = ["NonFinancialStatementSchema"]
+__all__ = [
+    "BankStatementSchema",
+    "InsuranceStatementSchema",
+    "NonFinancialStatementSchema",
+    "OtherFinancialStatementSchema",
+    "SecurityStatementSchema",
+]

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

@@ -0,0 +1,20 @@
+"""Bank financial statement models."""
+
+import pandera.pandas as pa
+
+
+class BankStatementSchema(pa.DataFrameModel):
+    """Bank 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/company/fs/insurance.py

@@ -0,0 +1,20 @@
+"""Insurance financial statement models."""
+
+import pandera.pandas as pa
+
+
+class InsuranceStatementSchema(pa.DataFrameModel):
+    """Insurance 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/company/fs/other_financial.py

@@ -0,0 +1,20 @@
+"""Other financial company financial statement models."""
+
+import pandera.pandas as pa
+
+
+class OtherFinancialStatementSchema(pa.DataFrameModel):
+    """Other financial company 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/company/fs/security.py

@@ -0,0 +1,20 @@
+"""Security (securities firm) financial statement models."""
+
+import pandera.pandas as pa
+
+
+class SecurityStatementSchema(pa.DataFrameModel):
+    """Security (securities firm) 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_python-0.3.7.dist-info → lixinger_python-0.3.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lixinger-python
-Version: 0.3.7
+Version: 0.3.8
 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.7.dist-info → lixinger_python-0.3.8.dist-info}/RECORD

@@ -1,5 +1,5 @@
-lixinger/__init__.py,sha256=WhuTjjENkj2h5Qr66PNfv41AGV6hKNdGi87borIqeBw,2445
-lixinger/client.py,sha256=djI2Lf4a09Vkdm7ManJs4WVP_cDS-_coqT3h2Eg4UHc,11296
+lixinger/__init__.py,sha256=sJ29I0A6B_tfYReum3zhSxr6B_fVmVG5JR0LmEvIAiY,2688
+lixinger/client.py,sha256=3bLqyLsAUm-8OHZSJ9yMeN-vSReVRjhhGLm4nwhqmT0,12462
 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
@@ -13,10 +13,14 @@ lixinger/api/cn/company/company.py,sha256=D6yhmFPzhdWadBsNka-8h4mkbKjD4HoBFQCw72
 lixinger/api/cn/company/dividend.py,sha256=21AWQbi56G7wVf8sv_YSy-Qy36OFKSvB9L2M3cbslGc,2658
 lixinger/api/cn/company/equity_change.py,sha256=hf2SZhvCcYvu1lRhEz-b61yo9D7mDckKJSerAxGvsXI,2356
 lixinger/api/cn/company/indices.py,sha256=GFoCf58DDh1a4Fx4lGaqPmk9NBW0hlRbnaIYoXBtFXI,1161
-lixinger/api/cn/company/namespace.py,sha256=qNyzM0qHwf9sJUTSZpb-_gaJYpT62oTUJinJzYpC7RE,5117
+lixinger/api/cn/company/namespace.py,sha256=gb50qxxtgGcFycHLrW05hCEnz31KA32Ey8ljo2rCoDw,6854
 lixinger/api/cn/company/profile.py,sha256=iMwR5REcJNhKvS3hpWg6bCD1DOH-7fSN21zoIeRIh3k,1691
-lixinger/api/cn/company/fs/__init__.py,sha256=1UCVekvwGy7quda_gJoVH5BjttJqA7Yeo0HZ_tn1RWQ,159
-lixinger/api/cn/company/fs/non_financial.py,sha256=Gm9S5LMvlGCEEUz7PgnwabSN86A-1I_VU7WARGaW-UI,2330
+lixinger/api/cn/company/fs/__init__.py,sha256=B21nlQ_kwTvtwGbRovbsPQfDuj5rf3YqNp03orgpV0g,1281
+lixinger/api/cn/company/fs/bank.py,sha256=rdUvFNVWwF1ZCMzy_a6Sc7e-NUykb8OfU4MnAL-EUI4,4514
+lixinger/api/cn/company/fs/insurance.py,sha256=s94yd80Yl6N3RI30Bz2062MbKOmiDcg6VUW_uuNztx8,4629
+lixinger/api/cn/company/fs/non_financial.py,sha256=gMyco2L4OARQoL_EQuTQHKXCES1PjvL45kSFTLZUFSU,2599
+lixinger/api/cn/company/fs/other_financial.py,sha256=yRycb5LgacdgGQ1jBidaMCDvc4PysYHoMUwshMLUzUU,4722
+lixinger/api/cn/company/fs/security.py,sha256=AW6x--bA2dgNj5SL17f0lHg1XM76BNOlGXxqYlo_rZw,4645
 lixinger/api/cn/company/fundamental/__init__.py,sha256=7UQG9tNv-RBELrUnN1OV218jcaT2Auf5oNIXxvLNo8s,1357
 lixinger/api/cn/company/fundamental/bank.py,sha256=bvLh7XovjaCWC2k3MKucVr57S0EgK1flqv08zuPERCM,3386
 lixinger/api/cn/company/fundamental/insurance.py,sha256=INs9UaqaRCTdv8yz09SdSZzWbUUXQRGQ39ndIBiVkm8,3497
@@ -54,8 +58,12 @@ lixinger/models/cn/company/company.py,sha256=BJRUWLifoxMVN3umOw99t8thaFcuwK244Hv
 lixinger/models/cn/company/dividend.py,sha256=yvIEHtNbj22eZOG_XPCLL-zCJLefe6DjomDiRpNwqU4,2044
 lixinger/models/cn/company/equity_change.py,sha256=8I0u8Jkfj-bnIpQi_0YHpYhrPK-1X0BON_9YcIbLVzk,860
 lixinger/models/cn/company/indices.py,sha256=Dxi_lAZPEWy3evcUHArsST0oTmJHyYAcT2Y8suqZQdc,349
-lixinger/models/cn/company/fs/__init__.py,sha256=qYUQzRdsr7vvyczQ-79ntZvRkHQWSnkQxIXWA81-nqA,162
+lixinger/models/cn/company/fs/__init__.py,sha256=LPqxRhIlzOrV_c9RUFDxIVP25N1QtyQnDvBCAqKdn1s,603
+lixinger/models/cn/company/fs/bank.py,sha256=y5F-RdMoHzOMXc0ZF9_bpqHn3eKSoyAh1tsxPrZdbgk,562
+lixinger/models/cn/company/fs/insurance.py,sha256=XCr1DU2r474cctVpz5VETuNQEWyGZMXQ_NqDCvg78kM,577
 lixinger/models/cn/company/fs/non_financial.py,sha256=t2C5_dqvX1DUF_iR54UiCxis4O84YU1bUTZRdYCiaT8,568
+lixinger/models/cn/company/fs/other_financial.py,sha256=gEE1axWGFcyT6JW5jtkKzbaCg2NpnPTiyfkR84Doy7w,610
+lixinger/models/cn/company/fs/security.py,sha256=PdG6_w96h55ppEQMiI-j5FQS4U4bRukMG9EQHKWIImM,610
 lixinger/models/cn/company/fundamental/__init__.py,sha256=tZ-Byn1jlkN9du6s9hzcSojUGDTQ1kDJ_QqTRnnqUik,665
 lixinger/models/cn/company/fundamental/bank.py,sha256=CvqEfU3btDWlphJTDWMxlUyTiAPU80a4zzpeFueZAWU,373
 lixinger/models/cn/company/fundamental/insurance.py,sha256=-bP3VeKr-0yYvGuZnolCxvoU9R4Yg3-w8czskWUpK1g,404
@@ -89,7 +97,7 @@ lixinger/utils/dataframe.py,sha256=tYBrNdmJ4poyuwD-9XgzHt3A_A8bBo0cdHiu8Yy9e9A,2
 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.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,,
+lixinger_python-0.3.8.dist-info/METADATA,sha256=rTnRLHhbIoF-zUaR81ea8zz480sjWRSVMYY0Vw6efVQ,9206
+lixinger_python-0.3.8.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+lixinger_python-0.3.8.dist-info/licenses/LICENSE,sha256=5oOwRq1lHSOScbNGCHr2feuNnhNYdGcArj6fSUfsC5U,1064
+lixinger_python-0.3.8.dist-info/RECORD,,