reportify-sdk 0.2.10__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.2.10"
+__version__ = "0.3.1"
 __all__ = [
     "Reportify",
     "ReportifyError",

reportify_sdk/chat.py

@@ -54,7 +54,7 @@ class ChatModule:
             categories: Filter by document categories
             markets: Filter by markets (cn, hk, us)
             institutions: Filter by institutions
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             tags: Filter by tags
             start_date: Start date filter (YYYY-MM-DD)
             end_date: End date filter (YYYY-MM-DD)

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.2.10",
+            "User-Agent": "reportify-sdk-python/0.3.1",
         }
 
     def _request(

reportify_sdk/docs.py

@@ -101,7 +101,7 @@ class DocsModule:
         List documents with filters
 
         Args:
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             categories: Filter by document categories (financials, transcripts, reports, news, files, filings, socials)
             markets: Filter by markets (cn, hk, us)
             institutions: Filter by institutions
@@ -176,7 +176,7 @@ class DocsModule:
 
         Args:
             query: Search query string
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             categories: Filter by document categories (financials, transcripts, reports, news, filings, socials)
             markets: Filter by markets (cn, hk, us)
             institutions: Filter by institutions
@@ -251,7 +251,7 @@ class DocsModule:
         Query documents by stock symbols
 
         Args:
-            symbols: Stock symbols to filter by (required)
+            symbols: Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             categories: Filter by document categories
             markets: Filter by markets (cn, hk, us)
             start_date: Start date filter (YYYY-MM-DD)
@@ -345,7 +345,7 @@ class DocsModule:
 
         Args:
             query: Search query string
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             categories: Filter by document categories
             markets: Filter by markets (cn, hk, us)
             institutions: Filter by institutions

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/search.py

@@ -44,7 +44,7 @@ class SearchModule:
             query: Search query string
             num: Number of results to return (default: 10, max: 100)
             categories: Filter by categories (news, reports, filings, transcripts, socials)
-            symbols: Filter by stock symbols (e.g., ["US:AAPL", "HK:0700"])
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             industries: Filter by industries
             channel_ids: Filter by channel IDs
             start_datetime: Start datetime filter (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
@@ -86,7 +86,7 @@ class SearchModule:
         Args:
             query: Search query string
             num: Number of results to return
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             channel_ids: Filter by channel IDs
             start_datetime: Start datetime filter
             end_datetime: End datetime filter
@@ -124,7 +124,7 @@ class SearchModule:
         Args:
             query: Search query string
             num: Number of results to return
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             industries: Filter by industries
             channel_ids: Filter by channel IDs
             start_datetime: Start datetime filter
@@ -162,7 +162,7 @@ class SearchModule:
 
         Args:
             query: Search query string
-            symbols: Stock symbols to filter by (required)
+            symbols: Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             num: Number of results to return
             start_datetime: Start datetime filter
             end_datetime: End datetime filter
@@ -195,7 +195,7 @@ class SearchModule:
 
         Args:
             query: Search query string
-            symbols: Stock symbols to filter by (required)
+            symbols: Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             num: Number of results to return
             start_datetime: Start datetime filter (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
             end_datetime: End datetime filter (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
@@ -234,7 +234,7 @@ class SearchModule:
 
         Args:
             query: Search query string
-            symbols: Stock symbols to filter by (required)
+            symbols: Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             num: Number of results to return
             start_datetime: Start datetime filter (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
             end_datetime: End datetime filter (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
@@ -272,7 +272,7 @@ class SearchModule:
         Args:
             query: Search query string
             num: Number of results to return
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             start_datetime: Start datetime filter
             end_datetime: End datetime filter
 
@@ -306,7 +306,7 @@ class SearchModule:
         Args:
             query: Search query string
             num: Number of results to return
-            symbols: Filter by stock symbols
+            symbols: Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
             channel_ids: Filter by channel IDs
             start_datetime: Start datetime filter
             end_datetime: End datetime filter

reportify_sdk/stock.py

@@ -118,7 +118,7 @@ class StockModule:
         Get income statement data
 
         Args:
-            symbol: Stock symbol (e.g., "US:AAPL")
+            symbol: Stock symbol
             period: Report cycle ("annual", "quarterly", "cumulative quarterly")
             limit: Return latest N records (default: 8)
             start_date: Start date (YYYY-MM-DD)
@@ -329,7 +329,7 @@ class StockModule:
         Get real-time stock quote
 
         Args:
-            symbol: Stock symbol (e.g., "US:AAPL", "688001", "00700")
+            symbol: Stock symbol
 
         Returns:
             DataFrame with real-time quote data

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reportify-sdk
-Version: 0.2.10
+Version: 0.3.1
 Summary: Python SDK for Reportify API - Financial data and document search
 Author-email: Reportify <support@reportify.cn>
 License-Expression: MIT
@@ -75,19 +75,18 @@ balance = client.stock.balance_sheet("US:AAPL")
 cashflow = client.stock.cashflow_statement("US:AAPL")
 
 # Price data
-prices = client.stock.prices("US:AAPL", limit=30)
-kline = client.stock.kline("US:TSLA", interval="1d", limit=100)
+prices = client.stock.prices("US:AAPL", start_date="2024-01-01")
 
-# Real-time quotes
-quotes = client.stock.quote(["US:AAPL", "US:MSFT"])
+# Real-time quote
+quote = client.stock.quote("US:AAPL")
 
 # Company info
 overview = client.stock.overview("US:AAPL")
 shareholders = client.stock.shareholders("US:AAPL")
 
 # Screening and calendar
-stocks = client.stock.screener(market="US", min_market_cap=1e10)
-earnings = client.stock.earnings_calendar(area="us", start_date="2024-01-01")
+stocks = client.stock.screener(country="US", market_cap_more_than=1e10)
+earnings = client.stock.earnings_calendar(market="us", start_date="2024-01-01", end_date="2024-01-31")
 ```
 
 ### Timeline
@@ -118,6 +117,102 @@ summary = client.docs.summary("doc_id")
 # List and search documents
 docs = client.docs.list(symbols=["US:AAPL"], page_size=10)
 chunks = client.docs.search_chunks("revenue breakdown", num=5)
+
+# Upload documents
+result = client.docs.upload([
+    {"url": "https://example.com/report.pdf", "name": "Annual Report"}
+])
+```
+
+### Quant (Quantitative Analysis)
+
+```python
+# Compute technical indicators
+df = client.quant.compute_indicators(["000001"], "RSI(14)")
+df = client.quant.compute_indicators(["000001"], "MACD()")
+
+# Screen stocks by formula
+stocks = client.quant.screen(formula="RSI(14) < 30")
+stocks = client.quant.screen(formula="CROSS(MA(5), MA(20))")
+
+# Get OHLCV data
+ohlcv = client.quant.ohlcv("000001", start_date="2024-01-01")
+ohlcv_batch = client.quant.ohlcv_batch(["000001", "600519"])
+
+# Backtest strategy
+result = client.quant.backtest(
+    start_date="2023-01-01",
+    end_date="2024-01-01",
+    symbol="000001",
+    entry_formula="CROSS(MA(5), MA(20))",
+    exit_formula="CROSSDOWN(MA(5), MA(20))"
+)
+print(f"Total Return: {result['total_return_pct']:.2%}")
+```
+
+### Concepts
+
+```python
+# Get latest concepts
+concepts = client.concepts.latest()
+for c in concepts:
+    print(c["concept_name"])
+
+# Get today's concept feeds
+feeds = client.concepts.today()
+```
+
+### Channels
+
+```python
+# Search channels
+result = client.channels.search("Goldman Sachs")
+
+# Get followed channels
+followings = client.channels.followings()
+
+# Follow/unfollow a channel
+client.channels.follow("channel_id")
+client.channels.unfollow("channel_id")
+```
+
+### Chat
+
+```python
+# Chat completion based on documents
+response = client.chat.completion(
+    "What are Tesla's revenue projections?",
+    symbols=["US:TSLA"],
+    mode="comprehensive"  # concise, comprehensive, deepresearch
+)
+print(response["message"])
+```
+
+### Agent
+
+```python
+# Create agent conversation
+conv = client.agent.create_conversation(agent_id=11887655289749510)
+
+# Chat with agent
+response = client.agent.chat(
+    conversation_id=conv["id"],
+    message="Analyze NVIDIA's latest earnings"
+)
+
+# Get agent-generated file
+file_content = client.agent.get_file("file_id")
+with open("output.xlsx", "wb") as f:
+    f.write(file_content)
+```
+
+### User
+
+```python
+# Get followed companies
+companies = client.user.followed_companies()
+for company in companies:
+    print(f"{company['symbol']}: {company['name']}")
 ```
 
 ## Error Handling

reportify_sdk-0.3.1.dist-info/RECORD

@@ -0,0 +1,19 @@
+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=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=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.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,,

reportify_sdk-0.2.10.dist-info/RECORD

@@ -1,19 +0,0 @@
-reportify_sdk/__init__.py,sha256=DLgFU-rq_NX0Xl420Qyt-gJehRnNhPsLaAwK3trr4Ms,663
-reportify_sdk/agent.py,sha256=y1iP4Jq7-ESMxeCWB_vxkAvwCjUCWT8K-ZSeJswU6nQ,6358
-reportify_sdk/channels.py,sha256=VbBCispCiP2Mzqn5lmBWVNWog4ElVni46mK2zg7KKzg,3518
-reportify_sdk/chat.py,sha256=w2KE8kO9PgL1uFSpBGI-8oD6pVhr0NF5ZAS_YoaFU5I,3551
-reportify_sdk/client.py,sha256=1pePkYX9vt0iG6z7yYxiXAwxbEZSqvyFdbFJBDzUM6E,8207
-reportify_sdk/concepts.py,sha256=XlHPuuZacFFUccMthyeb5R2OTayFYxXgIODKNfJLa_c,1891
-reportify_sdk/docs.py,sha256=6VylFci91gdV89tVKnaUgLYRF3suGEFTkO85VwK_ip4,16570
-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/search.py,sha256=QChN1hDP0q_fEaDm_Sb8SnKwHqTMg6yzpPsFHHWZQVw,11413
-reportify_sdk/stock.py,sha256=DkZkLXAPVK4AbkjWRRe6OdjXjUyJD1JZz0hEXMjtT_Y,21528
-reportify_sdk/timeline.py,sha256=7ZbF5-0eGoF_N5h9swEyYgZSaMb54PMwLDXlaqFS4ns,5396
-reportify_sdk/user.py,sha256=lsdhvaovllEwYiz4fhhSwl8PMX8tKswzABAvZbB0iJw,1261
-reportify_sdk-0.2.10.dist-info/licenses/LICENSE,sha256=zBUq4DL4lE-fZU_PMkr0gnxkYS1LhdRHFw8_LmCb-ek,1066
-reportify_sdk-0.2.10.dist-info/METADATA,sha256=7zKml8JYyFUsjaeiasHMmWp-RDiZnFs17LztA_GRogs,4312
-reportify_sdk-0.2.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-reportify_sdk-0.2.10.dist-info/top_level.txt,sha256=tc_dzCSWIDsNbHSi-FlyEEX8xwinhN9gl-CwyLRE4B0,14
-reportify_sdk-0.2.10.dist-info/RECORD,,