lixinger-python 0.3.10__py3-none-any.whl → 0.3.12__py3-none-any.whl

lixinger/__init__.py

@@ -42,6 +42,17 @@ 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.api.macro import (
+    get_national_debt,
+    get_rmb_deposits,
+    get_rmb_loans,
+    get_social_financing,
+)
 from lixinger.client import AsyncLixingerClient
 from lixinger.config import set_token
 from lixinger.exceptions import (
@@ -95,4 +106,13 @@ __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",
+    # Macro
+    "get_national_debt",
+    "get_rmb_deposits",
+    "get_rmb_loans",
+    "get_social_financing",
 ]

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/api/macro/__init__.py

@@ -0,0 +1,30 @@
+"""Macro APIs.
+
+This module provides access to macroeconomic data APIs:
+
+- national_debt: 国债收益率 (/macro/national-debt)
+- rmb_deposits: 人民币存款 (/macro/rmb-deposits)
+- rmb_loans: 人民币贷款 (/macro/rmb-loans)
+- social_financing: 社会融资规模 (/macro/social-financing)
+"""
+
+from lixinger.api.macro.national_debt import NationalDebtAPI, get_national_debt
+from lixinger.api.macro.rmb_deposits import RmbDepositsAPI, get_rmb_deposits
+from lixinger.api.macro.rmb_loans import RmbLoansAPI, get_rmb_loans
+from lixinger.api.macro.social_financing import (
+    SocialFinancingAPI,
+    get_social_financing,
+)
+
+__all__ = [
+    # API Classes
+    "NationalDebtAPI",
+    "RmbDepositsAPI",
+    "RmbLoansAPI",
+    "SocialFinancingAPI",
+    # Functional APIs
+    "get_national_debt",
+    "get_rmb_deposits",
+    "get_rmb_loans",
+    "get_social_financing",
+]

lixinger/api/macro/namespace.py

@@ -0,0 +1,62 @@
+"""Macro namespace for grouping related APIs."""
+
+from typing import Any
+
+import pandas as pd
+
+from lixinger.api.macro.national_debt import NationalDebtAPI
+from lixinger.api.macro.rmb_deposits import RmbDepositsAPI
+from lixinger.api.macro.rmb_loans import RmbLoansAPI
+from lixinger.api.macro.social_financing import SocialFinancingAPI
+
+
+class MacroNamespace:
+    """Namespace for macroeconomic APIs.
+
+    This class groups all macro APIs under a single namespace.
+    Access APIs via their specific attributes:
+
+    - national_debt: 国债收益率 API
+    - rmb_deposits: 人民币存款 API
+    - rmb_loans: 人民币贷款 API
+    - social_financing: 社会融资 API
+
+    """
+
+    def __init__(
+        self,
+        national_debt: NationalDebtAPI,
+        rmb_deposits: RmbDepositsAPI,
+        rmb_loans: RmbLoansAPI,
+        social_financing: SocialFinancingAPI,
+    ) -> None:
+        """Initialize the macro namespace.
+
+        Args:
+            national_debt: 国债 API
+            rmb_deposits: 人民币存款 API
+            rmb_loans: 人民币贷款 API
+            social_financing: 社会融资 API
+
+        """
+        self.national_debt = national_debt
+        self.rmb_deposits = rmb_deposits
+        self.rmb_loans = rmb_loans
+        self.social_financing = social_financing
+
+    # Convenience aliases for shorter access
+    async def get_national_debt(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
+        """Alias for national_debt.get_national_debt."""
+        return await self.national_debt.get_national_debt(*args, **kwargs)
+
+    async def get_rmb_deposits(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
+        """Alias for rmb_deposits.get_rmb_deposits."""
+        return await self.rmb_deposits.get_rmb_deposits(*args, **kwargs)
+
+    async def get_rmb_loans(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
+        """Alias for rmb_loans.get_rmb_loans."""
+        return await self.rmb_loans.get_rmb_loans(*args, **kwargs)
+
+    async def get_social_financing(self, *args: Any, **kwargs: Any) -> pd.DataFrame:
+        """Alias for social_financing.get_social_financing."""
+        return await self.social_financing.get_social_financing(*args, **kwargs)