reportify-sdk 0.3.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

reportify_sdk/__init__.py

@@ -20,7 +20,7 @@ from reportify_sdk.exceptions import (
     APIError,
 )
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 __all__ = [
     "Reportify",
     "ReportifyError",

reportify_sdk/client.py

@@ -74,7 +74,7 @@ class Reportify:
         return {
             "Authorization": f"Bearer {self.api_key}",
             "Content-Type": "application/json",
-            "User-Agent": "reportify-sdk-python/0.3.0",
+            "User-Agent": "reportify-sdk-python/0.3.1",
         }
 
     def _request(

reportify_sdk/quant.py

@@ -315,6 +315,63 @@ class QuantModule:
         response = self._client._post("/v1/quant/quotes/ohlcv/batch", json=data)
         return self._to_dataframe(response.get("datas", []))
 
+    # -------------------------------------------------------------------------
+    # Financials
+    # -------------------------------------------------------------------------
+
+    def financials(
+        self,
+        financial_type: Literal["income", "cashflow", "balancesheet", "equity"],
+        symbol: str,
+        *,
+        market: StockMarket = "cn",
+        start_year: int | None = None,
+        end_year: int | None = None,
+    ) -> pd.DataFrame:
+        """
+        Get historical financial statement data for a single symbol
+
+        Args:
+            financial_type: Type of financial statement
+                - "income": Income statement (利润表)
+                - "cashflow": Cash flow statement (现金流量表)
+                - "balancesheet": Balance sheet (资产负债表)
+                - "equity": Equity statement (股东权益变动表)
+            symbol: Stock code
+            market: Stock market ("cn", "hk", "us"), default "cn"
+            start_year: Start year (default: 3 years ago)
+            end_year: End year (default: current year)
+
+        Returns:
+            DataFrame with financial data sorted by report period
+
+        Example:
+            >>> # Get income statement
+            >>> df = client.quant.financials("income", "000001")
+            >>> print(df[["report_period", "revenue", "net_profit"]])
+
+            >>> # Get balance sheet for specific years
+            >>> df = client.quant.financials(
+            ...     "balancesheet", "600519",
+            ...     start_year=2020,
+            ...     end_year=2024
+            ... )
+
+            >>> # Get cash flow statement for HK stock
+            >>> df = client.quant.financials("cashflow", "00700", market="hk")
+        """
+        params: dict[str, Any] = {
+            "symbol": symbol,
+            "market": market,
+        }
+        if start_year:
+            params["start_year"] = start_year
+        if end_year:
+            params["end_year"] = end_year
+
+        response = self._client._get(f"/v1/quant/financials/{financial_type}", params=params)
+        return self._to_dataframe(response.get("datas", []))
+
     # -------------------------------------------------------------------------
     # Backtest
     # -------------------------------------------------------------------------

{reportify_sdk-0.3.0.dist-info → reportify_sdk-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reportify-sdk
-Version: 0.3.0
+Version: 0.3.1
 Summary: Python SDK for Reportify API - Financial data and document search
 Author-email: Reportify <support@reportify.cn>
 License-Expression: MIT

{reportify_sdk-0.3.0.dist-info → reportify_sdk-0.3.1.dist-info}/RECORD

@@ -1,19 +1,19 @@
-reportify_sdk/__init__.py,sha256=l7E4ELvxQ8qSEpgDK3-I3JfhBBKmLS8RP4hpbxieVac,662
+reportify_sdk/__init__.py,sha256=EnQDmMSdKDtDP-in6pgEHvx224JTzWltM7AGVTBHMV8,662
 reportify_sdk/agent.py,sha256=y1iP4Jq7-ESMxeCWB_vxkAvwCjUCWT8K-ZSeJswU6nQ,6358
 reportify_sdk/channels.py,sha256=VbBCispCiP2Mzqn5lmBWVNWog4ElVni46mK2zg7KKzg,3518
 reportify_sdk/chat.py,sha256=GQVfre4p2H9Kb0imX1-LvGqMrtnsuGhjQskBNUqUI_I,3613
-reportify_sdk/client.py,sha256=RqJusEisy7-bWC35gTByb3E6BaD5DlDsTP7VmZ9zFQ0,8206
+reportify_sdk/client.py,sha256=fj5pMBXZSMgwfgj_BqD1Riqaz5PW4S7fTq7PXuRqkPM,8206
 reportify_sdk/concepts.py,sha256=XlHPuuZacFFUccMthyeb5R2OTayFYxXgIODKNfJLa_c,1891
 reportify_sdk/docs.py,sha256=PsOJrm-tFvvfHyVOWUptLC6wHhze5AMizD8MkcktEBo,16814
 reportify_sdk/exceptions.py,sha256=r2_C_kTh6tCrQnfA3UozSqMMA-2OBnoP3pGpgYeqcdU,1049
 reportify_sdk/kb.py,sha256=3e82_56hvnGQ2fI404g3DAem9javPY7OpE5B8goYOB8,2895
-reportify_sdk/quant.py,sha256=9rWKWo2UlG3GfsQC-jpEgXUl25ojEabpvOGISyGMamM,15110
+reportify_sdk/quant.py,sha256=BfhdKiimfC4tZDRkaMjssyoQJKy39aXbz2KfjShLiTg,17245
 reportify_sdk/search.py,sha256=rzleME8_DwdiJ-__0qPjXkQZmaJ6JXH-ycJ_mUlkkNw,11866
 reportify_sdk/stock.py,sha256=sBUYmbj3nz5HaOGF5HakRF5Qt9Y5veZA1U2vDRau2vw,21473
 reportify_sdk/timeline.py,sha256=7ZbF5-0eGoF_N5h9swEyYgZSaMb54PMwLDXlaqFS4ns,5396
 reportify_sdk/user.py,sha256=lsdhvaovllEwYiz4fhhSwl8PMX8tKswzABAvZbB0iJw,1261
-reportify_sdk-0.3.0.dist-info/licenses/LICENSE,sha256=zBUq4DL4lE-fZU_PMkr0gnxkYS1LhdRHFw8_LmCb-ek,1066
-reportify_sdk-0.3.0.dist-info/METADATA,sha256=1xLeNuSnTG6nMOzBH6AIzmoWdDWAN5d3HXXGPSQfMZA,6451
-reportify_sdk-0.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-reportify_sdk-0.3.0.dist-info/top_level.txt,sha256=tc_dzCSWIDsNbHSi-FlyEEX8xwinhN9gl-CwyLRE4B0,14
-reportify_sdk-0.3.0.dist-info/RECORD,,
+reportify_sdk-0.3.1.dist-info/licenses/LICENSE,sha256=zBUq4DL4lE-fZU_PMkr0gnxkYS1LhdRHFw8_LmCb-ek,1066
+reportify_sdk-0.3.1.dist-info/METADATA,sha256=Mc2ecqS81TS9UlR2_RrHp26RQsUkg5DTpXi6Sa9_4dE,6451
+reportify_sdk-0.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+reportify_sdk-0.3.1.dist-info/top_level.txt,sha256=tc_dzCSWIDsNbHSi-FlyEEX8xwinhN9gl-CwyLRE4B0,14
+reportify_sdk-0.3.1.dist-info/RECORD,,