lixinger-python 0.3.9__py3-none-any.whl → 0.3.11__py3-none-any.whl

lixinger/__init__.py

@@ -42,6 +42,11 @@ from lixinger.api.cn.index import (
 from lixinger.api.cn.index import (
     get_drawdown as get_index_drawdown,
 )
+from lixinger.api.cn.industry import (
+    get_industry_cni_margin_trading,
+    get_industry_sw_2021_margin_trading,
+    get_industry_sw_margin_trading,
+)
 from lixinger.client import AsyncLixingerClient
 from lixinger.config import set_token
 from lixinger.exceptions import (
@@ -95,4 +100,8 @@ __all__ = [
     "get_index_bank_statements",
     "get_index_security_statements",
     "get_index_hybrid_statements",
+    # Industry margin trading
+    "get_industry_sw_margin_trading",
+    "get_industry_sw_2021_margin_trading",
+    "get_industry_cni_margin_trading",
 ]

lixinger/api/base.py

@@ -37,7 +37,7 @@ class BaseAPI:
         client: httpx.AsyncClient | None = None,
         config: Config | None = None,
         rate_limiter: AsyncRateLimiter | None = None,
-    ):
+    ) -> None:
         self._client = client
         self._config = config or settings
         self._rate_limiter = rate_limiter or _global_rate_limiter

lixinger/api/cn/company/namespace.py

@@ -37,7 +37,7 @@ class FundamentalNamespace:
         insurance: InsuranceFundamentalAPI,
         security: SecurityFundamentalAPI,
         other_financial: OtherFinancialFundamentalAPI,
-    ):
+    ) -> None:
         """Initialize the fundamental namespace."""
         self.non_financial = non_financial
         self.bank = bank
@@ -65,7 +65,7 @@ class FSNamespace:
         insurance: InsuranceStatementAPI,
         security: SecurityStatementAPI,
         other_financial: OtherFinancialStatementAPI,
-    ):
+    ) -> None:
         """Initialize the financial statement namespace."""
         self.non_financial = non_financial
         self.bank = bank
@@ -121,7 +121,7 @@ class CompanyNamespace:
         indices: IndicesAPI,
         dividend: DividendAPI,
         announcement: AnnouncementAPI,
-    ):
+    ) -> None:
         """Initialize the company namespace.
 
         Args:

lixinger/api/cn/index/namespace.py

@@ -1,5 +1,9 @@
 """Index namespace for grouping related APIs."""
 
+from typing import Any
+
+import pandas as pd
+
 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
@@ -32,7 +36,7 @@ class IndexFSNamespace:
         bank: IndexBankStatementAPI,
         security: IndexSecurityStatementAPI,
         hybrid: IndexHybridStatementAPI,
-    ):
+    ) -> None:
         """Initialize the index financial statement namespace.
 
         Args:
@@ -84,7 +88,7 @@ class IndexNamespace:
         fs_bank: IndexBankStatementAPI,
         fs_security: IndexSecurityStatementAPI,
         fs_hybrid: IndexHybridStatementAPI,
-    ):
+    ) -> None:
         """Initialize the index namespace.
 
         Args:
@@ -118,34 +122,34 @@ class IndexNamespace:
         )
 
     # Convenience aliases for shorter access
-    def get_index(self, *args, **kwargs):
+    async def get_index(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for index.get_index."""
-        return self.index.get_index(*args, **kwargs)
+        return await self.index.get_index(*args, **kwargs)
 
-    def get_constituents(self, *args, **kwargs):
+    async def get_constituents(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for constituents.get_constituents."""
-        return self.constituents.get_constituents(*args, **kwargs)
+        return await self.constituents.get_constituents(*args, **kwargs)
 
-    def get_constituent_weightings(self, *args, **kwargs):
+    async def get_constituent_weightings(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for constituent_weightings.get_constituent_weightings."""
-        return self.constituent_weightings.get_constituent_weightings(*args, **kwargs)
+        return await self.constituent_weightings.get_constituent_weightings(*args, **kwargs)
 
-    def get_fundamental(self, *args, **kwargs):
+    async def get_fundamental(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for fundamental.get_fundamental."""
-        return self.fundamental.get_fundamental(*args, **kwargs)
+        return await self.fundamental.get_fundamental(*args, **kwargs)
 
-    def get_candlestick(self, *args, **kwargs):
+    async def get_candlestick(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for candlestick.get_candlestick."""
-        return self.candlestick.get_candlestick(*args, **kwargs)
+        return await self.candlestick.get_candlestick(*args, **kwargs)
 
-    def get_drawdown(self, *args, **kwargs):
+    async def get_drawdown(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for drawdown.get_drawdown."""
-        return self.drawdown.get_drawdown(*args, **kwargs)
+        return await self.drawdown.get_drawdown(*args, **kwargs)
 
-    def get_tracking_fund(self, *args, **kwargs):
+    async def get_tracking_fund(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for tracking_fund.get_tracking_fund."""
-        return self.tracking_fund.get_tracking_fund(*args, **kwargs)
+        return await self.tracking_fund.get_tracking_fund(*args, **kwargs)
 
-    def get_margin_trading(self, *args, **kwargs):
+    async def get_margin_trading(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
         """Alias for margin_trading.get_margin_trading."""
-        return self.margin_trading.get_margin_trading(*args, **kwargs)
+        return await self.margin_trading.get_margin_trading(*args, **kwargs)

lixinger/api/cn/industry/__init__.py

@@ -0,0 +1,21 @@
+"""Industry-related APIs."""
+
+from lixinger.api.cn.industry.margin_trading import (
+    IndustryCniMarginTradingAPI,
+    IndustrySw2021MarginTradingAPI,
+    IndustrySwMarginTradingAPI,
+    get_industry_cni_margin_trading,
+    get_industry_sw_2021_margin_trading,
+    get_industry_sw_margin_trading,
+)
+
+__all__ = [
+    # API Classes
+    "IndustryCniMarginTradingAPI",
+    "IndustrySw2021MarginTradingAPI",
+    "IndustrySwMarginTradingAPI",
+    # Functional APIs
+    "get_industry_cni_margin_trading",
+    "get_industry_sw_2021_margin_trading",
+    "get_industry_sw_margin_trading",
+]

lixinger/api/cn/industry/margin_trading/__init__.py

@@ -0,0 +1,33 @@
+"""Industry margin trading and securities lending APIs.
+
+This module provides access to industry margin trading APIs by industry
+classification system:
+
+- sw: 申万行业 (Shenwan / SW)
+- sw_2021: 申万2021版行业 (Shenwan 2021)
+- cni: 国证行业 (CNI)
+"""
+
+from lixinger.api.cn.industry.margin_trading.cni import (
+    IndustryCniMarginTradingAPI,
+    get_industry_cni_margin_trading,
+)
+from lixinger.api.cn.industry.margin_trading.sw import (
+    IndustrySwMarginTradingAPI,
+    get_industry_sw_margin_trading,
+)
+from lixinger.api.cn.industry.margin_trading.sw_2021 import (
+    IndustrySw2021MarginTradingAPI,
+    get_industry_sw_2021_margin_trading,
+)
+
+__all__ = [
+    # API Classes
+    "IndustryCniMarginTradingAPI",
+    "IndustrySw2021MarginTradingAPI",
+    "IndustrySwMarginTradingAPI",
+    # Functional APIs
+    "get_industry_cni_margin_trading",
+    "get_industry_sw_2021_margin_trading",
+    "get_industry_sw_margin_trading",
+]

lixinger/api/cn/industry/margin_trading/cni.py

@@ -0,0 +1,129 @@
+"""Industry (国证) margin trading and securities lending APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.industry.margin_trading.cni import IndustryCniMarginTrading
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+
+
+class IndustryCniMarginTradingAPI(BaseAPI):
+    """国证行业融资融券 API."""
+
+    async def get_margin_trading(
+        self,
+        stock_code: str,
+        start_date: str,
+        end_date: str | None = None,
+        limit: int | None = None,
+    ) -> pd.DataFrame:
+        """获取国证行业融资融券数据.
+
+        获取国证（cni）行业每日的融资融券数据. 可按行业代码批量查询返回每日行业融资买入金额、
+        融资偿还金额、融资净买入金额、融资余额、融券卖出金额、融券偿还金额、
+        融券净卖出金额、融券余额等数据. 当用户想了解国证（cni）行业每日的融资融券余额
+        以及变动情况、观察杠杆资金进出节奏或分析做空力量时, 调用此接口.
+
+        API Endpoint: /cn/industry/margin-trading-and-securities-lending/cni
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/industry/margin-trading-and-securities-lending/cni
+
+        Args:
+            stock_code: 国证行业代码, 请参考行业信息API获取合法的stockCode
+            start_date: 信息起始时间 (YYYY-MM-DD, 北京时间), 开始和结束的时间间隔不超过10年
+            end_date: 结束信息日期 (YYYY-MM-DD, 北京时间), 默认为今天结束
+            limit: 返回最近数据的数量
+
+        Returns:
+            DataFrame containing margin trading data with columns:
+
+            - date: 数据时间
+            - stock_code: 行业代码
+            - financing_purchase_amount: 融资买入金额
+            - financing_repayment_amount: 融资偿还金额
+            - financing_net_purchase_amount: 融资净买入金额
+            - financing_balance: 融资余额
+            - securities_sell_amount: 融券卖出金额
+            - securities_repayment_amount: 融券偿还金额
+            - securities_net_sell_amount: 融券净卖出金额
+            - securities_balance: 融券余额
+            - financing_balance_to_market_cap: 融资余额占流通市值比例
+            - securities_balance_to_market_cap: 融券余额占流通市值比例
+
+        Example:
+            获取国证行业融资融券数据::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.cn_industry.margin_trading.cni.get_margin_trading(
+                        stock_code="C07",
+                        start_date="2025-06-13",
+                        end_date="2026-06-13",
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCode": stock_code,
+            "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/industry/margin-trading-and-securities-lending/cni",
+            json=payload,
+        )
+        for item in data:
+            item["stockCode"] = stock_code
+        return get_response_df(data, IndustryCniMarginTrading)
+
+
+# Functional API instance
+_api_instance = IndustryCniMarginTradingAPI()
+
+
+@api
+async def get_industry_cni_margin_trading(
+    stock_code: str,
+    start_date: str,
+    end_date: str | None = None,
+    limit: int | None = None,
+) -> pd.DataFrame:
+    """获取国证行业融资融券数据.
+
+    Args:
+        stock_code: 国证行业代码
+        start_date: 信息起始时间 (YYYY-MM-DD)
+        end_date: 结束信息日期 (YYYY-MM-DD)
+        limit: 返回最近数据的数量
+
+    Returns:
+        DataFrame containing cni industry margin trading data
+
+    Example:
+        获取国证行业融资融券数据::
+
+            from lixinger import get_industry_cni_margin_trading
+
+            df = await get_industry_cni_margin_trading(
+                stock_code="C07",
+                start_date="2025-06-13",
+                end_date="2026-06-13",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_margin_trading(
+        stock_code=stock_code,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

lixinger/api/cn/industry/margin_trading/sw.py

@@ -0,0 +1,129 @@
+"""Industry (申万) margin trading and securities lending APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.industry.margin_trading.sw import IndustrySwMarginTrading
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+
+
+class IndustrySwMarginTradingAPI(BaseAPI):
+    """申万行业融资融券 API."""
+
+    async def get_margin_trading(
+        self,
+        stock_code: str,
+        start_date: str,
+        end_date: str | None = None,
+        limit: int | None = None,
+    ) -> pd.DataFrame:
+        """获取申万行业融资融券数据.
+
+        获取申万（sw）行业每日的融资融券数据. 可按行业代码批量查询返回每日行业融资买入金额、
+        融资偿还金额、融资净买入金额、融资余额、融券卖出金额、融券偿还金额、
+        融券净卖出金额、融券余额等数据. 当用户想了解申万（sw）行业每日的融资融券余额
+        以及变动情况、观察杠杆资金进出节奏或分析做空力量时, 调用此接口.
+
+        API Endpoint: /cn/industry/margin-trading-and-securities-lending/sw
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/industry/margin-trading-and-securities-lending/sw
+
+        Args:
+            stock_code: 申万行业代码, 请参考行业信息API获取合法的stockCode
+            start_date: 信息起始时间 (YYYY-MM-DD, 北京时间), 开始和结束的时间间隔不超过10年
+            end_date: 结束信息日期 (YYYY-MM-DD, 北京时间), 默认为今天结束
+            limit: 返回最近数据的数量
+
+        Returns:
+            DataFrame containing margin trading data with columns:
+
+            - date: 数据时间
+            - stock_code: 行业代码
+            - financing_purchase_amount: 融资买入金额
+            - financing_repayment_amount: 融资偿还金额
+            - financing_net_purchase_amount: 融资净买入金额
+            - financing_balance: 融资余额
+            - securities_sell_amount: 融券卖出金额
+            - securities_repayment_amount: 融券偿还金额
+            - securities_net_sell_amount: 融券净卖出金额
+            - securities_balance: 融券余额
+            - financing_balance_to_market_cap: 融资余额占流通市值比例
+            - securities_balance_to_market_cap: 融券余额占流通市值比例
+
+        Example:
+            获取申万行业融资融券数据::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.cn_industry.margin_trading.sw.get_margin_trading(
+                        stock_code="490000",
+                        start_date="2025-06-13",
+                        end_date="2026-06-13",
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCode": stock_code,
+            "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/industry/margin-trading-and-securities-lending/sw",
+            json=payload,
+        )
+        for item in data:
+            item["stockCode"] = stock_code
+        return get_response_df(data, IndustrySwMarginTrading)
+
+
+# Functional API instance
+_api_instance = IndustrySwMarginTradingAPI()
+
+
+@api
+async def get_industry_sw_margin_trading(
+    stock_code: str,
+    start_date: str,
+    end_date: str | None = None,
+    limit: int | None = None,
+) -> pd.DataFrame:
+    """获取申万行业融资融券数据.
+
+    Args:
+        stock_code: 申万行业代码
+        start_date: 信息起始时间 (YYYY-MM-DD)
+        end_date: 结束信息日期 (YYYY-MM-DD)
+        limit: 返回最近数据的数量
+
+    Returns:
+        DataFrame containing sw industry margin trading data
+
+    Example:
+        获取申万行业融资融券数据::
+
+            from lixinger import get_industry_sw_margin_trading
+
+            df = await get_industry_sw_margin_trading(
+                stock_code="490000",
+                start_date="2025-06-13",
+                end_date="2026-06-13",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_margin_trading(
+        stock_code=stock_code,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

lixinger/api/cn/industry/margin_trading/sw_2021.py

@@ -0,0 +1,129 @@
+"""Industry (申万2021版) margin trading and securities lending APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.base import BaseAPI
+from lixinger.models.cn.industry.margin_trading.sw_2021 import IndustrySw2021MarginTrading
+from lixinger.utils.api import api
+from lixinger.utils.dataframe import get_response_df
+
+
+class IndustrySw2021MarginTradingAPI(BaseAPI):
+    """申万2021版行业融资融券 API."""
+
+    async def get_margin_trading(
+        self,
+        stock_code: str,
+        start_date: str,
+        end_date: str | None = None,
+        limit: int | None = None,
+    ) -> pd.DataFrame:
+        """获取申万2021版行业融资融券数据.
+
+        获取申万2021版行业每日的融资融券数据. 可按行业代码批量查询返回每日行业融资买入金额、
+        融资偿还金额、融资净买入金额、融资余额、融券卖出金额、融券偿还金额、
+        融券净卖出金额、融券余额等数据. 当用户想了解申万2021版行业每日的融资融券余额
+        以及变动情况、观察杠杆资金进出节奏或分析做空力量时, 调用此接口.
+
+        API Endpoint: /cn/industry/margin-trading-and-securities-lending/sw_2021
+        API Method: POST
+        API Doc: https://www.lixinger.com/open/api/doc?api-key=cn/industry/margin-trading-and-securities-lending/sw_2021
+
+        Args:
+            stock_code: 申万2021版行业代码, 请参考行业信息API获取合法的stockCode
+            start_date: 信息起始时间 (YYYY-MM-DD, 北京时间), 开始和结束的时间间隔不超过10年
+            end_date: 结束信息日期 (YYYY-MM-DD, 北京时间), 默认为今天结束
+            limit: 返回最近数据的数量
+
+        Returns:
+            DataFrame containing margin trading data with columns:
+
+            - date: 数据时间
+            - stock_code: 行业代码
+            - financing_purchase_amount: 融资买入金额
+            - financing_repayment_amount: 融资偿还金额
+            - financing_net_purchase_amount: 融资净买入金额
+            - financing_balance: 融资余额
+            - securities_sell_amount: 融券卖出金额
+            - securities_repayment_amount: 融券偿还金额
+            - securities_net_sell_amount: 融券净卖出金额
+            - securities_balance: 融券余额
+            - financing_balance_to_market_cap: 融资余额占流通市值比例
+            - securities_balance_to_market_cap: 融券余额占流通市值比例
+
+        Example:
+            获取申万2021版行业融资融券数据::
+
+                from lixinger import AsyncLixingerClient
+
+                async with AsyncLixingerClient() as client:
+                    df = await client.cn_industry.margin_trading.sw_2021.get_margin_trading(
+                        stock_code="490000",
+                        start_date="2025-06-13",
+                        end_date="2026-06-13",
+                    )
+                    print(df)
+
+        """
+        payload: dict[str, Any] = {
+            "stockCode": stock_code,
+            "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/industry/margin-trading-and-securities-lending/sw_2021",
+            json=payload,
+        )
+        for item in data:
+            item["stockCode"] = stock_code
+        return get_response_df(data, IndustrySw2021MarginTrading)
+
+
+# Functional API instance
+_api_instance = IndustrySw2021MarginTradingAPI()
+
+
+@api
+async def get_industry_sw_2021_margin_trading(
+    stock_code: str,
+    start_date: str,
+    end_date: str | None = None,
+    limit: int | None = None,
+) -> pd.DataFrame:
+    """获取申万2021版行业融资融券数据.
+
+    Args:
+        stock_code: 申万2021版行业代码
+        start_date: 信息起始时间 (YYYY-MM-DD)
+        end_date: 结束信息日期 (YYYY-MM-DD)
+        limit: 返回最近数据的数量
+
+    Returns:
+        DataFrame containing sw_2021 industry margin trading data
+
+    Example:
+        获取申万2021版行业融资融券数据::
+
+            from lixinger import get_industry_sw_2021_margin_trading
+
+            df = await get_industry_sw_2021_margin_trading(
+                stock_code="490000",
+                start_date="2025-06-13",
+                end_date="2026-06-13",
+            )
+            print(df)
+
+    """
+    return await _api_instance.get_margin_trading(
+        stock_code=stock_code,
+        start_date=start_date,
+        end_date=end_date,
+        limit=limit,
+    )

lixinger/api/cn/industry/namespace.py

@@ -0,0 +1,88 @@
+"""Industry namespace for grouping related APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.cn.industry.margin_trading.cni import IndustryCniMarginTradingAPI
+from lixinger.api.cn.industry.margin_trading.sw import IndustrySwMarginTradingAPI
+from lixinger.api.cn.industry.margin_trading.sw_2021 import (
+    IndustrySw2021MarginTradingAPI,
+)
+
+
+class IndustryMarginTradingNamespace:
+    """Namespace for industry margin trading APIs.
+
+    Groups all industry margin trading APIs by industry classification system:
+
+    - sw: 申万行业 (Shenwan / SW)
+    - sw_2021: 申万2021版行业 (Shenwan 2021)
+    - cni: 国证行业 (CNI)
+
+    """
+
+    def __init__(
+        self,
+        sw: IndustrySwMarginTradingAPI,
+        sw_2021: IndustrySw2021MarginTradingAPI,
+        cni: IndustryCniMarginTradingAPI,
+    ) -> None:
+        """Initialize the industry margin trading namespace.
+
+        Args:
+            sw: 申万行业融资融券 API
+            sw_2021: 申万2021版行业融资融券 API
+            cni: 国证行业融资融券 API
+
+        """
+        self.sw = sw
+        self.sw_2021 = sw_2021
+        self.cni = cni
+
+
+class IndustryNamespace:
+    """Namespace for industry-related APIs.
+
+    This class groups all industry-related APIs under a single namespace.
+    Access APIs via their specific attributes:
+
+    - margin_trading: 行业融资融券 API 组
+      - margin_trading.sw: 申万行业
+      - margin_trading.sw_2021: 申万2021版行业
+      - margin_trading.cni: 国证行业
+
+    """
+
+    def __init__(
+        self,
+        margin_trading_sw: IndustrySwMarginTradingAPI,
+        margin_trading_sw_2021: IndustrySw2021MarginTradingAPI,
+        margin_trading_cni: IndustryCniMarginTradingAPI,
+    ) -> None:
+        """Initialize the industry namespace.
+
+        Args:
+            margin_trading_sw: 申万行业融资融券 API
+            margin_trading_sw_2021: 申万2021版行业融资融券 API
+            margin_trading_cni: 国证行业融资融券 API
+
+        """
+        self.margin_trading = IndustryMarginTradingNamespace(
+            sw=margin_trading_sw,
+            sw_2021=margin_trading_sw_2021,
+            cni=margin_trading_cni,
+        )
+
+    # Convenience aliases for shorter access
+    async def get_sw_margin_trading(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
+        """Alias for margin_trading.sw.get_margin_trading."""
+        return await self.margin_trading.sw.get_margin_trading(*args, **kwargs)
+
+    async def get_sw_2021_margin_trading(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
+        """Alias for margin_trading.sw_2021.get_margin_trading."""
+        return await self.margin_trading.sw_2021.get_margin_trading(*args, **kwargs)
+
+    async def get_cni_margin_trading(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
+        """Alias for margin_trading.cni.get_margin_trading."""
+        return await self.margin_trading.cni.get_margin_trading(*args, **kwargs)

lixinger/client.py

@@ -1,3 +1,5 @@
+from types import TracebackType
+
 import httpx
 
 from lixinger.api.cn.company.announcement import AnnouncementAPI
@@ -42,6 +44,12 @@ from lixinger.api.cn.index import (
     TrackingFundAPI,
 )
 from lixinger.api.cn.index.namespace import IndexNamespace
+from lixinger.api.cn.industry import (
+    IndustryCniMarginTradingAPI,
+    IndustrySw2021MarginTradingAPI,
+    IndustrySwMarginTradingAPI,
+)
+from lixinger.api.cn.industry.namespace import IndustryNamespace
 from lixinger.config import get_config_from_env
 from lixinger.utils.rate_limiter import AsyncRateLimiter
 
@@ -62,7 +70,7 @@ class AsyncLixingerClient:
         max_retries: int | None = None,
         proxy: str | None = None,
         max_requests_per_minute: int = 1000,
-    ):
+    ) -> None:
         """Initialize the async Lixinger API client.
 
         The API key is ALWAYS loaded from the LIXINGER_API_KEY environment variable.
@@ -222,6 +230,25 @@ class AsyncLixingerClient:
         self.cn_index_fs_security = cn_index_fs_security
         self.cn_index_fs_hybrid = cn_index_fs_hybrid
 
+        # Industry APIs
+        cn_industry_margin_trading_sw = IndustrySwMarginTradingAPI(self._http_client, self.config, self._rate_limiter)
+        cn_industry_margin_trading_sw_2021 = IndustrySw2021MarginTradingAPI(
+            self._http_client, self.config, self._rate_limiter
+        )
+        cn_industry_margin_trading_cni = IndustryCniMarginTradingAPI(self._http_client, self.config, self._rate_limiter)
+
+        # Industry namespace (groups all industry APIs)
+        self.cn_industry = IndustryNamespace(
+            margin_trading_sw=cn_industry_margin_trading_sw,
+            margin_trading_sw_2021=cn_industry_margin_trading_sw_2021,
+            margin_trading_cni=cn_industry_margin_trading_cni,
+        )
+
+        # Legacy flat access for industry APIs (deprecated, for backward compatibility)
+        self.cn_industry_margin_trading_sw = cn_industry_margin_trading_sw
+        self.cn_industry_margin_trading_sw_2021 = cn_industry_margin_trading_sw_2021
+        self.cn_industry_margin_trading_cni = cn_industry_margin_trading_cni
+
         # Fund APIs
         self.cn_fund = FundAPI(self._http_client, self.config, self._rate_limiter)
         self.cn_fund_profile = FundProfileAPI(self._http_client, self.config, self._rate_limiter)
@@ -233,13 +260,18 @@ class AsyncLixingerClient:
         )
         self.cn_fund_announcement = FundAnnouncementAPI(self._http_client, self.config, self._rate_limiter)
 
-    async def __aenter__(self):
+    async def __aenter__(self) -> "AsyncLixingerClient":
         return self
 
-    async def __aexit__(self, exc_type, exc_val, exc_tb):
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
         await self.close()
 
-    async def close(self):
+    async def close(self) -> None:
         """Close the underlying HTTP client."""
         await self._http_client.aclose()
 
@@ -253,6 +285,11 @@ class AsyncLixingerClient:
         """Alias for cn_index."""
         return self.cn_index
 
+    @property
+    def industry(self) -> IndustryNamespace:
+        """Alias for cn_industry."""
+        return self.cn_industry
+
     @property
     def candlestick(self) -> CandlestickAPI:
         """Alias for cn_company_candlestick."""

lixinger/exceptions.py

@@ -5,7 +5,7 @@ class LixingerError(Exception):
 class APIError(LixingerError):
     """API request failed."""
 
-    def __init__(self, message: str, status_code: int | None = None):
+    def __init__(self, message: str, status_code: int | None = None) -> None:
         super().__init__(message)
         self.status_code = status_code
 

lixinger/models/cn/industry/__init__.py

@@ -0,0 +1,13 @@
+"""Industry-related models."""
+
+from lixinger.models.cn.industry.margin_trading import (
+    IndustryCniMarginTrading,
+    IndustrySw2021MarginTrading,
+    IndustrySwMarginTrading,
+)
+
+__all__ = [
+    "IndustryCniMarginTrading",
+    "IndustrySw2021MarginTrading",
+    "IndustrySwMarginTrading",
+]

lixinger/models/cn/industry/margin_trading/__init__.py

@@ -0,0 +1,11 @@
+"""Industry margin trading and securities lending models."""
+
+from lixinger.models.cn.industry.margin_trading.cni import IndustryCniMarginTrading
+from lixinger.models.cn.industry.margin_trading.sw import IndustrySwMarginTrading
+from lixinger.models.cn.industry.margin_trading.sw_2021 import IndustrySw2021MarginTrading
+
+__all__ = [
+    "IndustryCniMarginTrading",
+    "IndustrySw2021MarginTrading",
+    "IndustrySwMarginTrading",
+]

lixinger/models/cn/industry/margin_trading/cni.py

@@ -0,0 +1,29 @@
+"""Industry (国证) margin trading and securities lending model."""
+
+import pandera.pandas as pa
+
+
+class IndustryCniMarginTrading(pa.DataFrameModel):
+    """国证行业融资融券数据模型.
+
+    表示单个国证行业每日的融资（financing）与融券（securities lending）指标.
+    """
+
+    class Config:
+        """Pandera configuration."""
+
+        coerce = True
+        strict = False
+
+    date: pa.typing.Series[pa.typing.DateTime]
+    stock_code: pa.typing.Series[str]
+    financing_purchase_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_repayment_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_net_purchase_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_balance: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_sell_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_repayment_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_net_sell_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_balance: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_balance_to_market_cap: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_balance_to_market_cap: pa.typing.Series[float] | None = pa.Field(nullable=True)

lixinger/models/cn/industry/margin_trading/sw.py

@@ -0,0 +1,29 @@
+"""Industry (申万) margin trading and securities lending model."""
+
+import pandera.pandas as pa
+
+
+class IndustrySwMarginTrading(pa.DataFrameModel):
+    """申万行业融资融券数据模型.
+
+    表示单个申万行业每日的融资（financing）与融券（securities lending）指标.
+    """
+
+    class Config:
+        """Pandera configuration."""
+
+        coerce = True
+        strict = False
+
+    date: pa.typing.Series[pa.typing.DateTime]
+    stock_code: pa.typing.Series[str]
+    financing_purchase_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_repayment_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_net_purchase_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_balance: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_sell_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_repayment_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_net_sell_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_balance: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_balance_to_market_cap: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_balance_to_market_cap: pa.typing.Series[float] | None = pa.Field(nullable=True)

lixinger/models/cn/industry/margin_trading/sw_2021.py

@@ -0,0 +1,29 @@
+"""Industry (申万2021版) margin trading and securities lending model."""
+
+import pandera.pandas as pa
+
+
+class IndustrySw2021MarginTrading(pa.DataFrameModel):
+    """申万2021版行业融资融券数据模型.
+
+    表示单个申万2021版行业每日的融资（financing）与融券（securities lending）指标.
+    """
+
+    class Config:
+        """Pandera configuration."""
+
+        coerce = True
+        strict = False
+
+    date: pa.typing.Series[pa.typing.DateTime]
+    stock_code: pa.typing.Series[str]
+    financing_purchase_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_repayment_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_net_purchase_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_balance: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_sell_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_repayment_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_net_sell_amount: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_balance: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    financing_balance_to_market_cap: pa.typing.Series[float] | None = pa.Field(nullable=True)
+    securities_balance_to_market_cap: pa.typing.Series[float] | None = pa.Field(nullable=True)

lixinger/utils/rate_limiter.py

@@ -6,7 +6,7 @@ import time
 class AsyncRateLimiter:
     """Async token bucket rate limiter."""
 
-    def __init__(self, max_requests: int, window: float = 60.0):
+    def __init__(self, max_requests: int, window: float = 60.0) -> None:
         self.max_requests = max_requests
         self.window = window
         self.requests: deque[float] = deque()

{lixinger_python-0.3.9.dist-info → lixinger_python-0.3.11.dist-info}/METADATA

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

@@ -1,10 +1,10 @@
-lixinger/__init__.py,sha256=q-HBT1HyVJ6NKlsP_T6T5WCq_bYn330wAo9bsfD-lNQ,2750
-lixinger/client.py,sha256=8_V2T4e0_4D1UVN_1lBpg4YKYhdV4c_OTWnhy_wpx18,12712
+lixinger/__init__.py,sha256=mDw-kB3UVdtderRekHCA2xPsWr2GiPuBPyBOelEkgE0,3055
+lixinger/client.py,sha256=EXxE1hEczIaVpe3HxgQ7wWd71YjzkRNIAitPnhyV9MY,14290
 lixinger/config.py,sha256=JPz8EOrf1kP4Do-Z5-MsnOM0pMrNE1ZsP-Qoarh9y4c,2008
-lixinger/exceptions.py,sha256=eWSDO-3CRESPsfzomzMc-9NYPBQ1EEPJ_CPSIo-UlDM,508
+lixinger/exceptions.py,sha256=haJOQzZinH0tKk_e2BTUzJfPbtnyLHyRR7HSnWHeKfk,516
 lixinger/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lixinger/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lixinger/api/base.py,sha256=lmlfLV4DGm1WQKEjBzC_PWnD8m1xbdvFFp8wzoClsnc,3174
+lixinger/api/base.py,sha256=j90uXrBEIHyPkTu-4hF1876HtsWIPM_J7tunFi-1O1Q,3182
 lixinger/api/cn/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lixinger/api/cn/company/__init__.py,sha256=K8aNp2gGj4iQOvc8KjXA5668QUAhwyTfMBPhP3tgtMg,961
 lixinger/api/cn/company/announcement.py,sha256=lYt4AWOV5b9OTKfvJ7ZOqWP61pcPcyIQzb5N2DqFT6k,1920
@@ -13,7 +13,7 @@ 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=gb50qxxtgGcFycHLrW05hCEnz31KA32Ey8ljo2rCoDw,6854
+lixinger/api/cn/company/namespace.py,sha256=0YVK79MZJpH6p70vdNFgjkm0K0bc4QO9feFq8B3mYJY,6878
 lixinger/api/cn/company/profile.py,sha256=iMwR5REcJNhKvS3hpWg6bCD1DOH-7fSN21zoIeRIh3k,1691
 lixinger/api/cn/company/fs/__init__.py,sha256=B21nlQ_kwTvtwGbRovbsPQfDuj5rf3YqNp03orgpV0g,1281
 lixinger/api/cn/company/fs/bank.py,sha256=rdUvFNVWwF1ZCMzy_a6Sc7e-NUykb8OfU4MnAL-EUI4,4514
@@ -43,13 +43,19 @@ lixinger/api/cn/index/drawdown.py,sha256=D-fhA-Sv2-gf6VzX0zG1dm7Tn5Wy7NK1IB-f5kF
 lixinger/api/cn/index/fundamental.py,sha256=MyhGmMk7GkOZflpT0JMoiLsCs3DLMLLkopyUsD94Y4Q,2474
 lixinger/api/cn/index/index.py,sha256=5gDwE5K3tYNlCrV-EsSC4HXhfIi58uqWpHQxTt9LJMk,4177
 lixinger/api/cn/index/margin_trading.py,sha256=Tr5nXXC5H38FoAB5RoiTysr2wQEB0K4i4eKcEZnV4dw,4161
-lixinger/api/cn/index/namespace.py,sha256=QBEZRoLfMnQI6NABBXpuEwIqgv0p1TxllCBUwQwd3HM,6048
+lixinger/api/cn/index/namespace.py,sha256=GQrvboQiqXOpY7KULhIt-BwOqYktpelHp-fSQUSq120,6413
 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/api/cn/industry/__init__.py,sha256=RyBtbJuc-4DEgcpv3soXtmCI_NJtHlD-HiG96Ehwo9Q,583
+lixinger/api/cn/industry/namespace.py,sha256=GBl4gYrP6CYp9qeC7UelID2qhzrk4DeK_uh5F_G1rhM,2966
+lixinger/api/cn/industry/margin_trading/__init__.py,sha256=4JZDCF6v2TPg9uyBLKXAfHKVrDGpshjQkoJejdKwCC4,944
+lixinger/api/cn/industry/margin_trading/cni.py,sha256=7IqidE2N2_INiVybeiTt5qFRUY4PJsY6nUPEGtdWJlM,4600
+lixinger/api/cn/industry/margin_trading/sw.py,sha256=hjC5Uf7XXSwiiqoloIWFx5nDzbxd_D5bB1QPQCEjUjg,4591
+lixinger/api/cn/industry/margin_trading/sw_2021.py,sha256=uZWAiIdPPLWnvYduAULPythgzgNzLFeVkqP5OEMq_vw,4706
 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
@@ -93,13 +99,18 @@ lixinger/models/cn/index/fs/bank.py,sha256=DA_sRFSsK5IE0JQtp3pHdvPJQxbipHsSyKahc
 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/models/cn/industry/__init__.py,sha256=TlUmf_uAoCdyO8uNJDoXWUV7-P8C3H8FLJKF8HN2b9Q,296
+lixinger/models/cn/industry/margin_trading/__init__.py,sha256=JHzyvqzawYkgHa3HPNcY1B58PN2SZe-ZXhThHXlmSJ8,432
+lixinger/models/cn/industry/margin_trading/cni.py,sha256=D8O-SXFR1_6lboRzMMNxaLA3KnSlHHeS1N5kjUIUPrs,1375
+lixinger/models/cn/industry/margin_trading/sw.py,sha256=GyBhpZxSm1aoQHdzJvjb5INp_lrTFh4Alp2WaDyPhVM,1374
+lixinger/models/cn/industry/margin_trading/sw_2021.py,sha256=JWdEVXarlKso3JOpMJ7zvkw-I5tsLlXagJFXEJxYC3s,1399
 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/rate_limiter.py,sha256=ZHlRTTL60L62uRA_f--LD26qkAfk-pHBllRqPapAXQM,1141
 lixinger/utils/retry.py,sha256=sXtb0ESp12_JedjzDxoeIH48TlOrbxtIA0j1V33DW7M,1026
-lixinger_python-0.3.9.dist-info/METADATA,sha256=-8w_eCbpNhcG4vO_pGo4st1wPJ1Xozb7Je-tC8ETYu4,9206
-lixinger_python-0.3.9.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-lixinger_python-0.3.9.dist-info/licenses/LICENSE,sha256=5oOwRq1lHSOScbNGCHr2feuNnhNYdGcArj6fSUfsC5U,1064
-lixinger_python-0.3.9.dist-info/RECORD,,
+lixinger_python-0.3.11.dist-info/METADATA,sha256=wqCIHQktxMBfmP8Wzz45QT1_belv6nIcck0YZ_Dhkhg,9207
+lixinger_python-0.3.11.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+lixinger_python-0.3.11.dist-info/licenses/LICENSE,sha256=5oOwRq1lHSOScbNGCHr2feuNnhNYdGcArj6fSUfsC5U,1064
+lixinger_python-0.3.11.dist-info/RECORD,,