finbrain-python 0.2.4__py3-none-any.whl → 0.2.5__py3-none-any.whl

finbrain/aio/client.py

@@ -25,10 +25,11 @@ from .endpoints.recent import AsyncRecentAPI
 from .endpoints.corporate_lobbying import AsyncCorporateLobbyingAPI
 from .endpoints.reddit_mentions import AsyncRedditMentionsAPI
 from .endpoints.government_contracts import AsyncGovernmentContractsAPI
+from .endpoints.patent_filings import AsyncPatentFilingsAPI
 
 
-# Which status codes merit a retry
-_RETRYABLE_STATUS = {500}
+# Which status codes merit a retry (transient server / gateway errors)
+_RETRYABLE_STATUS = {500, 502, 503, 504}
 # How long to wait between retries   (2, 4, 8 … seconds)
 _BACKOFF_BASE = 2
 
@@ -86,6 +87,7 @@ class AsyncFinBrainClient:
         self.corporate_lobbying = AsyncCorporateLobbyingAPI(self)
         self.reddit_mentions = AsyncRedditMentionsAPI(self)
         self.government_contracts = AsyncGovernmentContractsAPI(self)
+        self.patent_filings = AsyncPatentFilingsAPI(self)
 
     async def __aenter__(self) -> "AsyncFinBrainClient":
         """Context manager entry."""
@@ -164,7 +166,7 @@ class AsyncFinBrainClient:
 
             # ── Error path ───────────────────────────────────
             if resp.status_code in _RETRYABLE_STATUS and attempt < self.retries:
-                # 500 – exponential back-off then retry
+                # Transient server/gateway error – exponential back-off then retry
                 await asyncio.sleep(_BACKOFF_BASE**attempt)
                 continue
 

finbrain/aio/endpoints/_utils.py

@@ -1,37 +1,12 @@
 """
 Shared utility functions for async endpoint modules.
 
-This module contains common helper functions used across multiple async endpoint
-implementations to avoid code duplication.
+These helpers are identical to the synchronous ones, so they are re-exported
+from :mod:`finbrain.endpoints._utils` to keep a single source of truth.
 """
 
 from __future__ import annotations
-import datetime as _dt
 
+from ...endpoints._utils import to_datestr
 
-def to_datestr(value: _dt.date | str) -> str:
-    """
-    Convert datetime.date to ISO format string (YYYY-MM-DD).
-
-    If the input is already a string, it is returned unchanged.
-    This allows flexible date parameter handling in API calls.
-
-    Parameters
-    ----------
-    value : datetime.date or str
-        Date value to convert.
-
-    Returns
-    -------
-    str
-        ISO format date string (YYYY-MM-DD).
-
-    Examples
-    --------
-    >>> from datetime import date
-    >>> to_datestr(date(2025, 1, 15))
-    '2025-01-15'
-    >>> to_datestr("2025-01-15")
-    '2025-01-15'
-    """
-    return value.isoformat() if isinstance(value, _dt.date) else value
+__all__ = ["to_datestr"]

finbrain/aio/endpoints/patent_filings.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+import pandas as pd
+import datetime as _dt
+from typing import TYPE_CHECKING, Dict, Any, List
+
+from ._utils import to_datestr
+
+if TYPE_CHECKING:
+    from ..client import AsyncFinBrainClient
+
+
+class AsyncPatentFilingsAPI:
+    """Async wrapper for /patent-filings and /screener/patent-filings endpoints."""
+
+    def __init__(self, client: "AsyncFinBrainClient") -> None:
+        self._c = client
+
+    async def ticker(
+        self,
+        symbol: str,
+        *,
+        date_from: _dt.date | str | None = None,
+        date_to: _dt.date | str | None = None,
+        limit: int | None = None,
+        as_dataframe: bool = False,
+    ) -> Dict[str, Any] | pd.DataFrame:
+        """Fetch USPTO granted patents for a symbol (async)."""
+        params: Dict[str, str] = {}
+        if date_from:
+            params["startDate"] = to_datestr(date_from)
+        if date_to:
+            params["endDate"] = to_datestr(date_to)
+        if limit is not None:
+            params["limit"] = str(limit)
+
+        path = f"patent-filings/{symbol.upper()}"
+
+        data: Dict[str, Any] = await self._c._request("GET", path, params=params)
+
+        if as_dataframe:
+            rows: List[Dict[str, Any]] = data.get("patents", [])
+            df = pd.DataFrame(rows)
+            if not df.empty and "patentDate" in df.columns:
+                df["patentDate"] = pd.to_datetime(df["patentDate"])
+                df.set_index("patentDate", inplace=True)
+            return df
+
+        return data

finbrain/aio/endpoints/screener.py

@@ -234,3 +234,15 @@ class AsyncScreenerAPI:
         """Screen government contracts across all tickers (async)."""
         params = self._build_params(limit=limit)
         return await self._get("screener/government-contracts", params, as_dataframe)
+
+    # ── patent filings ────────────────────────────────────────
+
+    async def patent_filings(
+        self,
+        *,
+        limit: int | None = None,
+        as_dataframe: bool = False,
+    ) -> List[Dict[str, Any]] | pd.DataFrame:
+        """Screen USPTO patent filings across all tickers (async)."""
+        params = self._build_params(limit=limit)
+        return await self._get("screener/patent-filings", params, as_dataframe)

finbrain/client.py

@@ -26,10 +26,11 @@ from .endpoints.recent import RecentAPI
 from .endpoints.corporate_lobbying import CorporateLobbyingAPI
 from .endpoints.reddit_mentions import RedditMentionsAPI
 from .endpoints.government_contracts import GovernmentContractsAPI
+from .endpoints.patent_filings import PatentFilingsAPI
 
 
-# Which status codes merit a retry
-_RETRYABLE_STATUS = {500}
+# Which status codes merit a retry (transient server / gateway errors)
+_RETRYABLE_STATUS = {500, 502, 503, 504}
 # How long to wait between retries   (2, 4, 8 … seconds)
 _BACKOFF_BASE = 2
 
@@ -81,6 +82,20 @@ class FinBrainClient:
         self.corporate_lobbying = CorporateLobbyingAPI(self)
         self.reddit_mentions = RedditMentionsAPI(self)
         self.government_contracts = GovernmentContractsAPI(self)
+        self.patent_filings = PatentFilingsAPI(self)
+
+    # ---------- lifecycle ----------
+    def __enter__(self) -> "FinBrainClient":
+        """Context manager entry."""
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb) -> None:
+        """Context manager exit — close the underlying HTTP session."""
+        self.close()
+
+    def close(self) -> None:
+        """Close the underlying ``requests.Session``."""
+        self.session.close()
 
     # ---------- private helpers ----------
     def _request(
@@ -131,7 +146,7 @@ class FinBrainClient:
 
             # ── Error path ───────────────────────────────────
             if resp.status_code in _RETRYABLE_STATUS and attempt < self.retries:
-                # 500 – exponential back-off then retry
+                # Transient server/gateway error – exponential back-off then retry
                 time.sleep(_BACKOFF_BASE**attempt)
                 continue
 

finbrain/endpoints/_utils.py

@@ -28,10 +28,16 @@ def to_datestr(value: _dt.date | str) -> str:
 
     Examples
     --------
-    >>> from datetime import date
+    >>> from datetime import date, datetime
     >>> to_datestr(date(2025, 1, 15))
     '2025-01-15'
+    >>> to_datestr(datetime(2025, 1, 15, 9, 30))
+    '2025-01-15'
     >>> to_datestr("2025-01-15")
     '2025-01-15'
     """
+    # ``datetime`` subclasses ``date``; take the date part so the time
+    # component never leaks into the ``YYYY-MM-DD`` API parameter.
+    if isinstance(value, _dt.datetime):
+        return value.date().isoformat()
     return value.isoformat() if isinstance(value, _dt.date) else value

finbrain/endpoints/patent_filings.py

@@ -0,0 +1,74 @@
+from __future__ import annotations
+import pandas as pd
+import datetime as _dt
+from typing import TYPE_CHECKING, Dict, Any, List
+
+from ._utils import to_datestr
+
+if TYPE_CHECKING:  # imported only by type-checkers
+    from ..client import FinBrainClient
+
+
+class PatentFilingsAPI:
+    """
+    Endpoints
+    ---------
+    ``/patent-filings/<TICKER>`` - USPTO granted patents mapped to a ticker.
+    ``/screener/patent-filings`` - cross-ticker patent filings screener.
+    """
+
+    # ------------------------------------------------------------------ #
+    def __init__(self, client: "FinBrainClient") -> None:
+        self._c = client  # reference to the parent client
+
+    # ------------------------------------------------------------------ #
+    def ticker(
+        self,
+        symbol: str,
+        *,
+        date_from: _dt.date | str | None = None,
+        date_to: _dt.date | str | None = None,
+        limit: int | None = None,
+        as_dataframe: bool = False,
+    ) -> Dict[str, Any] | pd.DataFrame:
+        """
+        Fetch USPTO granted patents for *symbol*.
+
+        Parameters
+        ----------
+        symbol :
+            Ticker symbol; auto-upper-cased.
+        date_from, date_to :
+            Optional ISO dates (``YYYY-MM-DD``) bounding the returned rows by
+            grant date (``patentDate``).
+        limit :
+            Maximum number of records to return (1-500).
+        as_dataframe :
+            If *True*, return a **pandas.DataFrame** indexed by ``patentDate``;
+            otherwise return the raw JSON dict.
+
+        Returns
+        -------
+        dict | pandas.DataFrame
+        """
+        params: Dict[str, str] = {}
+        if date_from:
+            params["startDate"] = to_datestr(date_from)
+        if date_to:
+            params["endDate"] = to_datestr(date_to)
+        if limit is not None:
+            params["limit"] = str(limit)
+
+        path = f"patent-filings/{symbol.upper()}"
+
+        data: Dict[str, Any] = self._c._request("GET", path, params=params)
+
+        if as_dataframe:
+            rows: List[Dict[str, Any]] = data.get("patents", [])
+            df = pd.DataFrame(rows)
+            if not df.empty and "patentDate" in df.columns:
+                df["patentDate"] = pd.to_datetime(df["patentDate"])
+                df.set_index("patentDate", inplace=True)
+            return df
+
+        return data

finbrain/endpoints/screener.py

@@ -239,3 +239,15 @@ class ScreenerAPI:
         """Screen government contracts across all tickers."""
         params = self._build_params(limit=limit)
         return self._get("screener/government-contracts", params, as_dataframe)
+
+    # ── patent filings ────────────────────────────────────────
+
+    def patent_filings(
+        self,
+        *,
+        limit: int | None = None,
+        as_dataframe: bool = False,
+    ) -> List[Dict[str, Any]] | pd.DataFrame:
+        """Screen USPTO patent filings across all tickers."""
+        params = self._build_params(limit=limit)
+        return self._get("screener/patent-filings", params, as_dataframe)

finbrain/exceptions.py

@@ -14,6 +14,9 @@ Docs-based mapping
 405  Method Not Allowed     → MethodNotAllowed
 429  Rate Limit Exceeded    → RateLimitError
 500  Internal Server Error  → ServerError
+502  Bad Gateway            → BadGateway
+503  Service Unavailable    → ServiceUnavailable
+504  Gateway Timeout        → GatewayTimeout
 """
 
 from __future__ import annotations
@@ -29,6 +32,9 @@ __all__ = [
     "MethodNotAllowed",
     "RateLimitError",
     "ServerError",
+    "BadGateway",
+    "ServiceUnavailable",
+    "GatewayTimeout",
     #
     "InvalidResponse",
     "http_error_to_exception",
@@ -96,6 +102,18 @@ class ServerError(FinBrainError):
     """500 - Internal error on FinBrain's side. Retrying later may help."""
 
 
+class BadGateway(FinBrainError):
+    """502 - Invalid response from an upstream server. Usually transient."""
+
+
+class ServiceUnavailable(FinBrainError):
+    """503 - Service temporarily unavailable (overloaded or in maintenance)."""
+
+
+class GatewayTimeout(FinBrainError):
+    """504 - Upstream server did not respond in time. Usually transient."""
+
+
 # ─────────────────────────────────────────────────────────────
 # Transport / decoding guard
 # ─────────────────────────────────────────────────────────────
@@ -167,6 +185,12 @@ def http_error_to_exception(resp) -> FinBrainError:  # expects requests.Response
         return RateLimitError(message, **kwargs)
     if status == 500:
         return ServerError(message, **kwargs)
+    if status == 502:
+        return BadGateway(message, **kwargs)
+    if status == 503:
+        return ServiceUnavailable(message, **kwargs)
+    if status == 504:
+        return GatewayTimeout(message, **kwargs)
 
     # Fallback for undocumented codes (future-proofing)
     return FinBrainError(message, **kwargs)

finbrain/plotting.py

@@ -1,6 +1,6 @@
 # src/finbrain/plotting.py
 from __future__ import annotations
-from typing import Union, TYPE_CHECKING
+from typing import Literal, Union, TYPE_CHECKING
 import numpy as np
 import pandas as pd
 import plotly.graph_objects as go
@@ -46,7 +46,7 @@ class _PlotNamespace:
         Other args/kwargs identical to the other plotting wrappers.
         """
         # 1) pull data
-        df = self._fb.app_ratings.ticker(
+        df: pd.DataFrame = self._fb.app_ratings.ticker(
             ticker,
             date_from=date_from,
             date_to=date_to,
@@ -150,7 +150,7 @@ class _PlotNamespace:
         * **Bars**   → ``employeeCount`` (primary y-axis)
         * **Line**   → ``followerCount`` (secondary y-axis)
         """
-        df = self._fb.linkedin_data.ticker(
+        df: pd.DataFrame = self._fb.linkedin_data.ticker(
             ticker,
             date_from=date_from,
             date_to=date_to,
@@ -344,7 +344,7 @@ class _PlotNamespace:
         ...                 date_to="2025-05-31")
         """
         if kind == "put_call":
-            df = self._fb.options.put_call(
+            df: pd.DataFrame = self._fb.options.put_call(
                 ticker,
                 date_from=date_from,
                 date_to=date_to,
@@ -368,7 +368,7 @@ class _PlotNamespace:
         self,
         ticker: str,
         *,
-        prediction_type: str = "daily",
+        prediction_type: Literal["daily", "monthly"] = "daily",
         as_json=False,
         show=True,
         template="plotly_dark",
@@ -398,7 +398,7 @@ class _PlotNamespace:
         --------
         >>> fb.plot.predictions("AMZN", prediction_type="monthly")
         """
-        df = self._fb.predictions.ticker(
+        df: pd.DataFrame = self._fb.predictions.ticker(
             ticker, prediction_type=prediction_type, as_dataframe=True, **kw
         )
 
@@ -496,30 +496,10 @@ class _PlotNamespace:
         ... }).set_index("date")
         >>> fb.plot.insider_transactions("AAPL", price_df)
         """
-        # Validate price_data
-        if price_data.empty:
-            raise ValueError("price_data cannot be empty")
-
-        # Flatten MultiIndex columns if present (e.g., from yf.download())
-        if isinstance(price_data.columns, pd.MultiIndex):
-            # Get the first level (price types like 'Close', 'Open', etc.)
-            price_data = price_data.copy()
-            price_data.columns = price_data.columns.get_level_values(0)
-
-        # Find price column (case-insensitive search)
-        price_col = None
-        for col in ["close", "Close", "price", "Price", "adj_close", "Adj Close"]:
-            if col in price_data.columns:
-                price_col = col
-                break
-        if price_col is None:
-            raise ValueError(
-                f"price_data must contain a price column (e.g. 'close', 'Close', 'price'). "
-                f"Found columns: {price_data.columns.tolist()}"
-            )
+        price_data, price_col = self._resolve_price_column(price_data)
 
         # Fetch insider transactions
-        transactions_df = self._fb.insider_transactions.ticker(
+        transactions_df: pd.DataFrame = self._fb.insider_transactions.ticker(
             ticker, as_dataframe=True, **kwargs
         )
 
@@ -599,30 +579,10 @@ class _PlotNamespace:
         >>> fb.plot.house_trades("AAPL", price_df,
         ...                      date_from="2024-01-01", date_to="2024-12-31")
         """
-        # Validate price_data
-        if price_data.empty:
-            raise ValueError("price_data cannot be empty")
-
-        # Flatten MultiIndex columns if present (e.g., from yf.download())
-        if isinstance(price_data.columns, pd.MultiIndex):
-            # Get the first level (price types like 'Close', 'Open', etc.)
-            price_data = price_data.copy()
-            price_data.columns = price_data.columns.get_level_values(0)
-
-        # Find price column (case-insensitive search)
-        price_col = None
-        for col in ["close", "Close", "price", "Price", "adj_close", "Adj Close"]:
-            if col in price_data.columns:
-                price_col = col
-                break
-        if price_col is None:
-            raise ValueError(
-                f"price_data must contain a price column (e.g. 'close', 'Close', 'price'). "
-                f"Found columns: {price_data.columns.tolist()}"
-            )
+        price_data, price_col = self._resolve_price_column(price_data)
 
         # Fetch house trades
-        transactions_df = self._fb.house_trades.ticker(
+        transactions_df: pd.DataFrame = self._fb.house_trades.ticker(
             ticker,
             date_from=date_from,
             date_to=date_to,
@@ -706,30 +666,10 @@ class _PlotNamespace:
         >>> fb.plot.senate_trades("META", price_df,
         ...                       date_from="2024-01-01", date_to="2024-12-31")
         """
-        # Validate price_data
-        if price_data.empty:
-            raise ValueError("price_data cannot be empty")
-
-        # Flatten MultiIndex columns if present (e.g., from yf.download())
-        if isinstance(price_data.columns, pd.MultiIndex):
-            # Get the first level (price types like 'Close', 'Open', etc.)
-            price_data = price_data.copy()
-            price_data.columns = price_data.columns.get_level_values(0)
-
-        # Find price column (case-insensitive search)
-        price_col = None
-        for col in ["close", "Close", "price", "Price", "adj_close", "Adj Close"]:
-            if col in price_data.columns:
-                price_col = col
-                break
-        if price_col is None:
-            raise ValueError(
-                f"price_data must contain a price column (e.g. 'close', 'Close', 'price'). "
-                f"Found columns: {price_data.columns.tolist()}"
-            )
+        price_data, price_col = self._resolve_price_column(price_data)
 
         # Fetch senate trades
-        transactions_df = self._fb.senate_trades.ticker(
+        transactions_df: pd.DataFrame = self._fb.senate_trades.ticker(
             ticker,
             date_from=date_from,
             date_to=date_to,
@@ -802,29 +742,10 @@ class _PlotNamespace:
         ValueError
             If ``price_data`` is empty or missing required price column.
         """
-        # Validate price_data
-        if price_data.empty:
-            raise ValueError("price_data cannot be empty")
-
-        # Flatten MultiIndex columns if present (e.g., from yf.download())
-        if isinstance(price_data.columns, pd.MultiIndex):
-            price_data = price_data.copy()
-            price_data.columns = price_data.columns.get_level_values(0)
-
-        # Find price column (case-insensitive search)
-        price_col = None
-        for col in ["close", "Close", "price", "Price", "adj_close", "Adj Close"]:
-            if col in price_data.columns:
-                price_col = col
-                break
-        if price_col is None:
-            raise ValueError(
-                f"price_data must contain a price column (e.g. 'close', 'Close', 'price'). "
-                f"Found columns: {price_data.columns.tolist()}"
-            )
+        price_data, price_col = self._resolve_price_column(price_data)
 
         # Fetch lobbying filings
-        filings_df = self._fb.corporate_lobbying.ticker(
+        filings_df: pd.DataFrame = self._fb.corporate_lobbying.ticker(
             ticker,
             date_from=date_from,
             date_to=date_to,
@@ -833,9 +754,7 @@ class _PlotNamespace:
         )
 
         # Normalize timezones
-        price_data_normalized = price_data.copy()
-        if price_data_normalized.index.tz is not None:
-            price_data_normalized.index = price_data_normalized.index.tz_localize(None)
+        price_data_normalized = self._to_naive_index(price_data)
 
         fig = go.Figure(
             layout=dict(
@@ -857,9 +776,7 @@ class _PlotNamespace:
         )
 
         if not filings_df.empty:
-            filings_normalized = filings_df.copy()
-            if filings_normalized.index.tz is not None:
-                filings_normalized.index = filings_normalized.index.tz_localize(None)
+            filings_normalized = self._to_naive_index(filings_df)
 
             # Compute total spend per filing (income + expenses)
             spend = filings_normalized.get("income", 0) + filings_normalized.get(
@@ -958,29 +875,10 @@ class _PlotNamespace:
         ValueError
             If ``price_data`` is empty or missing required price column.
         """
-        # Validate price_data
-        if price_data.empty:
-            raise ValueError("price_data cannot be empty")
-
-        # Flatten MultiIndex columns if present (e.g., from yf.download())
-        if isinstance(price_data.columns, pd.MultiIndex):
-            price_data = price_data.copy()
-            price_data.columns = price_data.columns.get_level_values(0)
-
-        # Find price column (case-insensitive search)
-        price_col = None
-        for col in ["close", "Close", "price", "Price", "adj_close", "Adj Close"]:
-            if col in price_data.columns:
-                price_col = col
-                break
-        if price_col is None:
-            raise ValueError(
-                f"price_data must contain a price column (e.g. 'close', 'Close', 'price'). "
-                f"Found columns: {price_data.columns.tolist()}"
-            )
+        price_data, price_col = self._resolve_price_column(price_data)
 
         # Fetch Reddit mentions
-        mentions_df = self._fb.reddit_mentions.ticker(
+        mentions_df: pd.DataFrame = self._fb.reddit_mentions.ticker(
             ticker,
             date_from=date_from,
             date_to=date_to,
@@ -989,9 +887,7 @@ class _PlotNamespace:
         )
 
         # Normalize timezones
-        price_data_normalized = price_data.copy()
-        if price_data_normalized.index.tz is not None:
-            price_data_normalized.index = price_data_normalized.index.tz_localize(None)
+        price_data_normalized = self._to_naive_index(price_data)
 
         fig = go.Figure(
             layout=dict(
@@ -1013,9 +909,7 @@ class _PlotNamespace:
         )
 
         if not mentions_df.empty:
-            mentions_normalized = mentions_df.copy()
-            if mentions_normalized.index.tz is not None:
-                mentions_normalized.index = mentions_normalized.index.tz_localize(None)
+            mentions_normalized = self._to_naive_index(mentions_df)
 
             # Exclude _all (aggregate) — use individual subreddits for stacked bars
             per_sub = mentions_normalized[
@@ -1205,29 +1099,10 @@ class _PlotNamespace:
         ValueError
             If ``price_data`` is empty or missing required price column.
         """
-        # Validate price_data
-        if price_data.empty:
-            raise ValueError("price_data cannot be empty")
-
-        # Flatten MultiIndex columns if present (e.g., from yf.download())
-        if isinstance(price_data.columns, pd.MultiIndex):
-            price_data = price_data.copy()
-            price_data.columns = price_data.columns.get_level_values(0)
-
-        # Find price column (case-insensitive search)
-        price_col = None
-        for col in ["close", "Close", "price", "Price", "adj_close", "Adj Close"]:
-            if col in price_data.columns:
-                price_col = col
-                break
-        if price_col is None:
-            raise ValueError(
-                f"price_data must contain a price column (e.g. 'close', 'Close', 'price'). "
-                f"Found columns: {price_data.columns.tolist()}"
-            )
+        price_data, price_col = self._resolve_price_column(price_data)
 
         # Fetch government contracts
-        contracts_df = self._fb.government_contracts.ticker(
+        contracts_df: pd.DataFrame = self._fb.government_contracts.ticker(
             ticker,
             date_from=date_from,
             date_to=date_to,
@@ -1236,9 +1111,7 @@ class _PlotNamespace:
         )
 
         # Normalize timezones
-        price_data_normalized = price_data.copy()
-        if price_data_normalized.index.tz is not None:
-            price_data_normalized.index = price_data_normalized.index.tz_localize(None)
+        price_data_normalized = self._to_naive_index(price_data)
 
         fig = go.Figure(
             layout=dict(
@@ -1260,9 +1133,7 @@ class _PlotNamespace:
         )
 
         if not contracts_df.empty:
-            contracts_normalized = contracts_df.copy()
-            if contracts_normalized.index.tz is not None:
-                contracts_normalized.index = contracts_normalized.index.tz_localize(None)
+            contracts_normalized = self._to_naive_index(contracts_df)
 
             amounts = contracts_normalized.get("awardAmount", pd.Series(dtype=float))
 
@@ -1308,12 +1179,365 @@ class _PlotNamespace:
             return None
         return fig.to_json() if as_json else fig
 
+    def patent_filings(
+        self,
+        ticker: str,
+        price_data: pd.DataFrame,
+        *,
+        date_from: str | None = None,
+        date_to: str | None = None,
+        as_json: bool = False,
+        show: bool = True,
+        template: str = "plotly_dark",
+        **kwargs,
+    ):
+        """
+        Plot USPTO granted patents overlaid on a price chart.
+
+        Each granted patent is drawn as a bar (sized by its claim count) on a
+        secondary y-axis, positioned at the patent's grant date. This method
+        requires user-provided historical price data, as FinBrain does not
+        currently offer a price history endpoint.
+
+        Parameters
+        ----------
+        ticker : str
+            Ticker symbol (e.g. ``"AAPL"``).
+        price_data : pandas.DataFrame
+            **User-provided** price history with a DatetimeIndex and a column
+            containing prices (e.g. ``"close"``, ``"Close"``, or ``"price"``).
+            The index must be timezone-naive or UTC.
+        date_from, date_to : str or None, optional
+            Date range for patents in ``YYYY-MM-DD`` format (filters grant date).
+        as_json : bool, default False
+            If ``True``, return JSON string instead of Figure object.
+        show : bool, default True
+            If ``True`` and ``as_json=False``, display the figure immediately.
+        template : str, default "plotly_dark"
+            Plotly template name.
+        **kwargs
+            Additional arguments passed to
+            :meth:`FinBrainClient.patent_filings.ticker`.
+
+        Returns
+        -------
+        plotly.graph_objects.Figure or str or None
+            Figure object, JSON string, or None (when shown).
+
+        Raises
+        ------
+        ValueError
+            If ``price_data`` is empty or missing required price column.
+        """
+        price_data, price_col = self._resolve_price_column(price_data)
+
+        # Fetch patent filings
+        patents_df: pd.DataFrame = self._fb.patent_filings.ticker(
+            ticker,
+            date_from=date_from,
+            date_to=date_to,
+            as_dataframe=True,
+            **kwargs,
+        )
+
+        # Normalize timezones
+        price_data_normalized = self._to_naive_index(price_data)
+
+        fig = go.Figure(
+            layout=dict(
+                template=template,
+                title=f"Patent Filings · {ticker}",
+                xaxis_title="Date",
+                hovermode="x unified",
+            )
+        )
+
+        # Plot price line on primary y-axis
+        fig.add_scatter(
+            name="Price",
+            x=price_data_normalized.index,
+            y=price_data_normalized[price_col],
+            mode="lines",
+            line=dict(width=2, color="#02d2ff"),
+            hovertemplate="<b>%{x|%Y-%m-%d}</b><br>Price: $%{y:.2f}<extra></extra>",
+        )
+
+        if not patents_df.empty:
+            patents_normalized = self._to_naive_index(patents_df)
+
+            claims = patents_normalized.get("numClaims", pd.Series(dtype=float))
+
+            hover_text = []
+            for _, row in patents_normalized.iterrows():
+                title = row.get("title", "")
+                if len(str(title)) > 80:
+                    title = str(title)[:80] + "…"
+                ptype = row.get("type", "N/A")
+                section = row.get("primaryCpcSection", "")
+                n_claims = row.get("numClaims", 0)
+                hover_text.append(
+                    f"Title: {title}<br>"
+                    f"Type: {ptype}<br>"
+                    f"CPC Section: {section}<br>"
+                    f"Claims: {n_claims}"
+                )
+
+            fig.add_bar(
+                name="Patent Grant",
+                x=patents_normalized.index,
+                y=claims,
+                marker_color="rgba(249,200,14,0.6)",
+                yaxis="y2",
+                hovertext=hover_text,
+                hovertemplate="<b>%{x|%Y-%m-%d}</b><br>%{hovertext}<extra></extra>",
+            )
+
+        fig.update_layout(
+            yaxis=dict(title="Price", showgrid=True),
+            yaxis2=dict(
+                title="Claims",
+                overlaying="y",
+                side="right",
+                showgrid=False,
+                zeroline=False,
+                rangemode="tozero",
+            ),
+        )
+
+        if show and not as_json:
+            fig.show()
+            return None
+        return fig.to_json() if as_json else fig
+
+    def analyst_ratings(
+        self,
+        ticker: str,
+        price_data: pd.DataFrame,
+        *,
+        date_from: str | None = None,
+        date_to: str | None = None,
+        as_json: bool = False,
+        show: bool = True,
+        template: str = "plotly_dark",
+        **kwargs,
+    ):
+        """
+        Plot analyst rating actions and price targets overlaid on a price chart.
+
+        Each rating is drawn as a marker at its **target price** (where one is
+        provided) or, when no target is given, at the prevailing price on that
+        date, so every action remains visible. Markers are grouped and coloured
+        by action category (upgrade, downgrade, initiate, maintain, other). This
+        method requires user-provided historical price data, as FinBrain does
+        not currently offer a price history endpoint.
+
+        Parameters
+        ----------
+        ticker : str
+            Ticker symbol (e.g. ``"AAPL"``).
+        price_data : pandas.DataFrame
+            **User-provided** price history with a DatetimeIndex and a column
+            containing prices (e.g. ``"close"``, ``"Close"``, or ``"price"``).
+            The index must be timezone-naive or UTC.
+        date_from, date_to : str or None, optional
+            Date range for ratings in ``YYYY-MM-DD`` format.
+        as_json : bool, default False
+            If ``True``, return JSON string instead of Figure object.
+        show : bool, default True
+            If ``True`` and ``as_json=False``, display the figure immediately.
+        template : str, default "plotly_dark"
+            Plotly template name.
+        **kwargs
+            Additional arguments passed to
+            :meth:`FinBrainClient.analyst_ratings.ticker`.
+
+        Returns
+        -------
+        plotly.graph_objects.Figure or str or None
+            Figure object, JSON string, or None (when shown).
+
+        Raises
+        ------
+        ValueError
+            If ``price_data`` is empty or missing required price column.
+        """
+        price_data, price_col = self._resolve_price_column(price_data)
+
+        # Fetch analyst ratings
+        ratings_df: pd.DataFrame = self._fb.analyst_ratings.ticker(
+            ticker,
+            date_from=date_from,
+            date_to=date_to,
+            as_dataframe=True,
+            **kwargs,
+        )
+
+        # Normalize timezones
+        price_data_normalized = self._to_naive_index(price_data)
+
+        fig = go.Figure(
+            layout=dict(
+                template=template,
+                title=f"Analyst Ratings · {ticker}",
+                xaxis_title="Date",
+                yaxis_title="Price / Target ($)",
+                hovermode="x unified",
+            )
+        )
+
+        # Plot price line on primary y-axis
+        fig.add_scatter(
+            name="Price",
+            x=price_data_normalized.index,
+            y=price_data_normalized[price_col],
+            mode="lines",
+            line=dict(width=2, color="#02d2ff"),
+            hovertemplate="<b>%{x|%Y-%m-%d}</b><br>Price: $%{y:.2f}<extra></extra>",
+        )
+
+        if not ratings_df.empty:
+            ratings_normalized = self._to_naive_index(ratings_df)
+
+            targets = pd.to_numeric(
+                ratings_normalized.get("targetPrice"), errors="coerce"
+            )
+
+            def _price_at(when):
+                """Nearest available price for a rating date."""
+                if when in price_data_normalized.index:
+                    return price_data_normalized.loc[when, price_col]
+                idx = price_data_normalized.index.get_indexer([when], method="nearest")[0]
+                if 0 <= idx < len(price_data_normalized):
+                    return price_data_normalized.iloc[idx][price_col]
+                return None
+
+            # action category → (legend label, colour)
+            categories = {
+                "upgrade": ("Upgrade", "#26a69a"),
+                "downgrade": ("Downgrade", "#ef5350"),
+                "initiate": ("Initiate", "#42a5f5"),
+                "maintain": ("Maintain", "#bdbdbd"),
+                "other": ("Other", "#f9c80e"),
+            }
+
+            def _categorize(action: str) -> str:
+                a = str(action).lower()
+                if "upgrade" in a:
+                    return "upgrade"
+                if "downgrade" in a:
+                    return "downgrade"
+                if "initiat" in a:
+                    return "initiate"
+                if any(k in a for k in ("maintain", "reiterat", "reaffirm", "hold")):
+                    return "maintain"
+                return "other"
+
+            # Bucket each rating row by action category
+            buckets: dict[str, dict[str, list]] = {
+                key: {"x": [], "y": [], "symbol": [], "hover": []}
+                for key in categories
+            }
+
+            for pos, (when, row) in enumerate(ratings_normalized.iterrows()):
+                target = targets.iloc[pos]
+                has_target = pd.notna(target)
+                y_val = target if has_target else _price_at(when)
+                if y_val is None:
+                    continue
+
+                cat = _categorize(row.get("action", ""))
+                bucket = buckets[cat]
+                bucket["x"].append(when)
+                bucket["y"].append(y_val)
+                # diamond = plotted at target, open circle = plotted at price
+                bucket["symbol"].append("diamond" if has_target else "circle-open")
+                target_str = f"${target:,.2f}" if has_target else "n/a"
+                bucket["hover"].append(
+                    f"Institution: {row.get('institution', 'N/A')}<br>"
+                    f"Action: {row.get('action', 'N/A')}<br>"
+                    f"Rating: {row.get('rating', 'N/A')}<br>"
+                    f"Target: {target_str}"
+                )
+
+            for key, (label, color) in categories.items():
+                bucket = buckets[key]
+                if not bucket["x"]:
+                    continue
+                fig.add_scatter(
+                    name=label,
+                    x=bucket["x"],
+                    y=bucket["y"],
+                    mode="markers",
+                    marker=dict(
+                        size=10,
+                        color=color,
+                        symbol=bucket["symbol"],
+                        line=dict(width=1, color="#000000"),
+                    ),
+                    hovertext=bucket["hover"],
+                    hovertemplate="<b>%{x|%Y-%m-%d}</b><br>%{hovertext}<extra></extra>",
+                )
+
+        if show and not as_json:
+            fig.show()
+            return None
+        return fig.to_json() if as_json else fig
+
     # --------------------------------------------------------------------- #
     # Helper methods                                                         #
     # --------------------------------------------------------------------- #
 
     @staticmethod
+    def _resolve_price_column(price_data: pd.DataFrame) -> tuple[pd.DataFrame, str]:
+        """
+        Validate ``price_data`` and locate its price column.
+
+        Flattens a MultiIndex column layout (e.g. from ``yf.download()``) and
+        searches for a known price column case-insensitively.
+
+        Returns
+        -------
+        tuple[pandas.DataFrame, str]
+            The (possibly flattened) frame and the resolved price column name.
+
+        Raises
+        ------
+        ValueError
+            If ``price_data`` is empty or has no recognised price column.
+        """
+        if price_data.empty:
+            raise ValueError("price_data cannot be empty")
+
+        # Flatten MultiIndex columns if present (e.g., from yf.download())
+        if isinstance(price_data.columns, pd.MultiIndex):
+            price_data = price_data.copy()
+            price_data.columns = price_data.columns.get_level_values(0)
+
+        for col in ["close", "Close", "price", "Price", "adj_close", "Adj Close"]:
+            if col in price_data.columns:
+                return price_data, col
+
+        raise ValueError(
+            f"price_data must contain a price column (e.g. 'close', 'Close', 'price'). "
+            f"Found columns: {price_data.columns.tolist()}"
+        )
+
+    @staticmethod
+    def _to_naive_index(df: pd.DataFrame) -> pd.DataFrame:
+        """
+        Return a copy of ``df`` with a timezone-naive DatetimeIndex.
+
+        yfinance often returns timezone-aware data while FinBrain returns naive
+        timestamps; normalising both sides lets them be compared and plotted
+        together.
+        """
+        out = df.copy()
+        if out.index.tz is not None:
+            out.index = out.index.tz_localize(None)
+        return out
+
     def _plot_transactions_on_price(
+        self,
         price_data: pd.DataFrame,
         price_col: str,
         transactions_df: pd.DataFrame,
@@ -1344,17 +1568,10 @@ class _PlotNamespace:
         -------
         go.Figure
         """
-        # Normalize timezones - convert both to timezone-naive for comparison
-        # yfinance often returns timezone-aware data, FinBrain returns naive
-        price_data_normalized = price_data.copy()
-        if price_data_normalized.index.tz is not None:
-            price_data_normalized.index = price_data_normalized.index.tz_localize(None)
-
-        transactions_df_normalized = transactions_df.copy()
-        if transactions_df_normalized.index.tz is not None:
-            transactions_df_normalized.index = (
-                transactions_df_normalized.index.tz_localize(None)
-            )
+        # Normalize timezones so yfinance (often tz-aware) and FinBrain (naive)
+        # timestamps can be compared.
+        price_data_normalized = self._to_naive_index(price_data)
+        transactions_df_normalized = self._to_naive_index(transactions_df)
 
         fig = go.Figure(
             layout=dict(

{finbrain_python-0.2.4.dist-info → finbrain_python-0.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finbrain-python
-Version: 0.2.4
+Version: 0.2.5
 Summary: Official Python client for the FinBrain API
 Author-email: Ahmet Salim Bilgin <ahmet@finbrain.tech>
 License-Expression: MIT
@@ -22,6 +22,8 @@ Requires-Dist: httpx>=0.24; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
 Dynamic: license-file
 
 # FinBrain Python SDK&nbsp;<!-- omit in toc -->
@@ -112,6 +114,13 @@ fb.government_contracts.ticker("LMT",
                                limit=50,
                                as_dataframe=True)
 
+# ---------- patent filings ----------
+fb.patent_filings.ticker("AAPL",
+                         date_from="2025-01-01",
+                         date_to="2025-12-31",
+                         limit=50,
+                         as_dataframe=True)
+
 # ---------- insider transactions ----------
 fb.insider_transactions.ticker("AMZN", as_dataframe=True)
 
@@ -145,6 +154,7 @@ fb.screener.predictions_daily(limit=100, as_dataframe=True)
 fb.screener.insider_trading(limit=50)
 fb.screener.reddit_mentions(limit=100, as_dataframe=True)
 fb.screener.government_contracts(limit=100, as_dataframe=True)
+fb.screener.patent_filings(limit=100, as_dataframe=True)
 
 # ---------- recent data ----------
 fb.recent.news(limit=100, as_dataframe=True)
@@ -265,6 +275,18 @@ fb.plot.reddit_mentions("TSLA",
                         price_data=price_df,
                         date_from="2026-03-01",
                         date_to="2026-03-17")
+
+# Plot patent grants (bars sized by claim count) on your price chart
+fb.plot.patent_filings("AAPL",
+                       price_data=price_df,
+                       date_from="2024-01-01",
+                       date_to="2025-06-30")
+
+# Plot analyst ratings & price targets (markers coloured by action) on your price chart
+fb.plot.analyst_ratings("AAPL",
+                        price_data=price_df,
+                        date_from="2024-01-01",
+                        date_to="2025-06-30")
 ```
 
 ```python
@@ -321,6 +343,7 @@ fb = FinBrainClient()  # reads from FINBRAIN_API_KEY env var
 | Corporate lobbying   | `client.corporate_lobbying.ticker()`     | `/lobbying/{SYMBOL}`                        |
 | Reddit mentions      | `client.reddit_mentions.ticker()`        | `/reddit-mentions/{SYMBOL}`                 |
 | Gov. contracts       | `client.government_contracts.ticker()`   | `/government-contracts/{SYMBOL}`            |
+| Patent filings       | `client.patent_filings.ticker()`         | `/patent-filings/{SYMBOL}`                  |
 | Insider transactions | `client.insider_transactions.ticker()`   | `/insider-trading/{SYMBOL}`                 |
 | LinkedIn             | `client.linkedin_data.ticker()`          | `/linkedin/{SYMBOL}`                        |
 | Options – Put/Call   | `client.options.put_call()`              | `/put-call-ratio/{SYMBOL}`                  |
@@ -329,6 +352,7 @@ fb = FinBrainClient()  # reads from FINBRAIN_API_KEY env var
 |                      | `client.screener.insider_trading()`      | `/screener/insider-trading`                 |
 |                      | `client.screener.reddit_mentions()`      | `/screener/reddit-mentions`                 |
 |                      | `client.screener.government_contracts()` | `/screener/government-contracts`            |
+|                      | `client.screener.patent_filings()`       | `/screener/patent-filings`                  |
 |                      | ... and 8 more screener methods          |                                             |
 | Recent               | `client.recent.news()`                   | `/recent/news`                              |
 |                      | `client.recent.analyst_ratings()`        | `/recent/analyst-ratings`                   |
@@ -356,6 +380,9 @@ except BadRequest as exc:
 | 405         | `MethodNotAllowed`       | HTTP method not supported on endpoint |
 | 429         | `RateLimitError`         | Too many requests                     |
 | 500         | `ServerError`            | FinBrain internal error               |
+| 502         | `BadGateway`             | Invalid response from upstream server |
+| 503         | `ServiceUnavailable`     | Service temporarily unavailable       |
+| 504         | `GatewayTimeout`         | Upstream server timed out             |
 
 ---
 

{finbrain_python-0.2.4.dist-info → finbrain_python-0.2.5.dist-info}/RECORD

@@ -1,12 +1,12 @@
 finbrain/__init__.py,sha256=ULIgwHkWbj5sT0udC3SlTROhZCgm2y9BtPox-4joNn4,416
-finbrain/client.py,sha256=7ytNARm22V9ePOIPv6hq-UGvphSC9fsIuxQqTfL313I,5252
-finbrain/exceptions.py,sha256=ZkuhWfaMAqoEfhrN_6V2XPq0eY7vPCINM9S__tfgqYI,6249
-finbrain/plotting.py,sha256=ZDswlMAGfQzjCYNmKmcfpkljs9FYl4kOKJyy9vl1z2w,53596
+finbrain/client.py,sha256=iu39iTUSPmiBcB-7gEJMvxHtkHXDSRVfq03Grw9UOVY,5850
+finbrain/exceptions.py,sha256=xgn1UMirprJDhBNUVjxJUMfqKxHdFoBmkvCw3Hb5CH0,7019
+finbrain/plotting.py,sha256=gvw2PuFwOy0vg3GRSfaQb5sSl6SdKH1zhY5USPShtn4,60606
 finbrain/py.typed,sha256=INFR1qO3jdMrtVPs0N0SAVKVbjKV80HQPoPshwGEpGo,27
 finbrain/aio/__init__.py,sha256=eJra9SqvLMkq5zoZfG6WFw7kd1jGpf9l-ovuPMeWvdw,125
-finbrain/aio/client.py,sha256=aiYDmukVDoCw9MmrPdxMyLOoPlR77il_nZO9CvP3ZHk,7171
+finbrain/aio/client.py,sha256=I5oMft5T-ttBRw31-qFItlYPdIzj0qG30pNx0_SHXNA,7367
 finbrain/aio/endpoints/__init__.py,sha256=zdNSU1jzvnK6JnHxrvb3ye9KFCkA86xDTu9bBzmwrEQ,48
-finbrain/aio/endpoints/_utils.py,sha256=4ElYWGCcJ7t_lx02e49NvFHMt2g6DTcnwx3Mvwf3KyY,908
+finbrain/aio/endpoints/_utils.py,sha256=yyritVvWL_boiHzgomY0_J3OHSr9CRr6Ihna-Chihfw,317
 finbrain/aio/endpoints/analyst_ratings.py,sha256=IYG-PU8HDOZoyyMcb_2KRxhiMVicYyaU_TOCVZPWroo,1451
 finbrain/aio/endpoints/app_ratings.py,sha256=QrJoLc7roTPRfInAEMwlr9vtxzruFJulGdB6msz7Eg0,2177
 finbrain/aio/endpoints/available.py,sha256=rQuffHowNF7FrVV5Ds-KE5iFjdz0I_vD7Qk2_zY2WLo,2315
@@ -17,14 +17,15 @@ finbrain/aio/endpoints/insider_transactions.py,sha256=EBqHdvapYWvI53PM_sQy0caN2r
 finbrain/aio/endpoints/linkedin_data.py,sha256=ucnkyNc1waiFHLxas1onPhxh9Y7ekcI_gOfUJ5gu1hI,1469
 finbrain/aio/endpoints/news.py,sha256=NJkcpoP8ngNsJdCzQab8yaXJzNe5ypYstzq3-mEHfqU,1446
 finbrain/aio/endpoints/options.py,sha256=k1XL3ktoFL2Exw6UE2XfU-EcS1Xw8BPXQzABLYXmfxk,1442
+finbrain/aio/endpoints/patent_filings.py,sha256=Wumihz2X7knKZNF36X9t0UJ8mk0ydg6H7qdXFhEd4LQ,1513
 finbrain/aio/endpoints/predictions.py,sha256=BrUSmqy0v7ngXyoE_UHgqdght8qtJ8IRxAhk_s9UeR0,1285
 finbrain/aio/endpoints/recent.py,sha256=TSaAwf5w86O1plSmm4eg_gKSjSap2Z8rd2i7FAvgm90,2302
 finbrain/aio/endpoints/reddit_mentions.py,sha256=P9ToZRaRN521RJ9W2J8cBCySUsNT47ROe-8TTdVtlqA,1508
-finbrain/aio/endpoints/screener.py,sha256=MYkIIZ6ocyx9khkxYjJnMQeg098-uZpdoSVbkUUj8Z4,9751
+finbrain/aio/endpoints/screener.py,sha256=bmBs0uTrt7B8byaGfLTg8IfZckE_5GpeoUty79bea4Q,10272
 finbrain/aio/endpoints/senate_trades.py,sha256=nhZd8R7Tclxzn-J4-ZWZ5onvBBd8pVOtiLfhKFtFBHw,1431
 finbrain/aio/endpoints/sentiments.py,sha256=BXFT0jr5j0MnB65MXGxZK36BJLXMTuggkFF9A9eenEQ,1532
 finbrain/endpoints/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-finbrain/endpoints/_utils.py,sha256=0JIybEiSXVCm5SQI73i80OtoGQ2mJWAjImgA_2ru30U,896
+finbrain/endpoints/_utils.py,sha256=wY8SKthpVernWlKwZfWoM8zZtQ3GS_hBQioH1Fk7RK4,1190
 finbrain/endpoints/analyst_ratings.py,sha256=6q_tecgnbzXn2wLSWqHNUa9MbLcybTD7xEBAkUyGPR0,2218
 finbrain/endpoints/app_ratings.py,sha256=mbeKiJ87nNibnz9AT2kmH4fVFA4goEcld910abm3tFs,3597
 finbrain/endpoints/available.py,sha256=3cXjDK1qE38RHAfQ2C14oD7l7dR8mhDtUcva3LzlK5s,3911
@@ -35,14 +36,15 @@ finbrain/endpoints/insider_transactions.py,sha256=TU6EsSHIeams4OLJ9s8BpNuXeBnWPH
 finbrain/endpoints/linkedin_data.py,sha256=zcNboQ-Ejt_7Ncu3p9WCd-PsjEBFbojVaJZdkbaGT8Q,2215
 finbrain/endpoints/news.py,sha256=q4aaEiunrUbl1FF0JZuX9__cZWxm2r1-B9x-c8g4Ia8,1913
 finbrain/endpoints/options.py,sha256=_TYWPcJ-gmPTQRg_kEVQl6Oj6fAirtZJ8QrfqFA2cMU,2611
+finbrain/endpoints/patent_filings.py,sha256=496m-3lnGc3twMAdcIDOyMWs3KwHD2W8c_vzOl7rI3I,2362
 finbrain/endpoints/predictions.py,sha256=og1RY68p4O71smogrx-M5FyGk8FVclBGP18BvttzbZk,2026
 finbrain/endpoints/recent.py,sha256=7D36oVRJKF5hkR42y6M6CiEMYksuFleZou1v86SbEfA,3004
 finbrain/endpoints/reddit_mentions.py,sha256=WiePVAyUbA0VpWOd22M2YTlDWOQITp8qUBraI29y6d4,2305
-finbrain/endpoints/screener.py,sha256=jBPUvmfj0Zfj5aoDLBtfXlYIR0UynIG613duSkck3NY,9665
+finbrain/endpoints/screener.py,sha256=Ebw4Oksi8JNj1B8xX2Mh2U7MqO57telCpxx0rphPCe4,10166
 finbrain/endpoints/senate_trades.py,sha256=K6r_-Wt1HOs0dDXngHdj6Eo_UUJXAy5yE4EmmQbGaiU,2226
 finbrain/endpoints/sentiments.py,sha256=sGGPaxzGGFvMOaYv3VSCmnG7H9v7OVlX7Vsndct8jhA,2606
-finbrain_python-0.2.4.dist-info/licenses/LICENSE,sha256=x71LjIUPbK7Y8YBulH_AXzEIX7BK90dgFL2zA6LBT-A,1069
-finbrain_python-0.2.4.dist-info/METADATA,sha256=qLUp9VxSkq5FRsYFAgpI5rLxClH-uUfcy2auc8bNLno,15402
-finbrain_python-0.2.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-finbrain_python-0.2.4.dist-info/top_level.txt,sha256=dCiQtTx3z2TtO_yQI6q3yODcdb-pABB-iEReJegVAv0,9
-finbrain_python-0.2.4.dist-info/RECORD,,
+finbrain_python-0.2.5.dist-info/licenses/LICENSE,sha256=x71LjIUPbK7Y8YBulH_AXzEIX7BK90dgFL2zA6LBT-A,1069
+finbrain_python-0.2.5.dist-info/METADATA,sha256=Oxu3uLLP90SHboG4mMl2fQoJLDsqUTgGgu5XhMqhebs,16763
+finbrain_python-0.2.5.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+finbrain_python-0.2.5.dist-info/top_level.txt,sha256=dCiQtTx3z2TtO_yQI6q3yODcdb-pABB-iEReJegVAv0,9
+finbrain_python-0.2.5.dist-info/RECORD,,