finance_dev 0.9.0__py3-none-any.whl

finance_dev/financials.py

@@ -0,0 +1,4079 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 35a0e3edc5ef
+
+from .basesdk import BaseSDK
+from datetime import date
+from finance_dev import errors, models, utils
+from finance_dev._hooks import HookContext
+from finance_dev.types import OptionalNullable, UNSET
+from finance_dev.utils.unmarshal_json_response import unmarshal_json_response
+from jsonpath import JSONPath
+from typing import Any, Dict, List, Mapping, Optional, Union
+
+
+class Financials(BaseSDK):
+    def get_cash_flow_statements(
+        self,
+        *,
+        cik: Optional[str] = None,
+        ciks: Optional[str] = None,
+        cik_after: Optional[str] = None,
+        cik_from: Optional[str] = None,
+        cik_before: Optional[str] = None,
+        cik_to: Optional[str] = None,
+        period_end: Optional[date] = None,
+        period_end_after: Optional[date] = None,
+        period_end_from: Optional[date] = None,
+        period_end_before: Optional[date] = None,
+        period_end_to: Optional[date] = None,
+        filing_date: Optional[date] = None,
+        filing_date_after: Optional[date] = None,
+        filing_date_from: Optional[date] = None,
+        filing_date_before: Optional[date] = None,
+        filing_date_to: Optional[date] = None,
+        tickers: Optional[str] = None,
+        tickers_all_of: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        fiscal_year: Optional[float] = None,
+        fiscal_year_above: Optional[float] = None,
+        fiscal_year_min: Optional[float] = None,
+        fiscal_year_below: Optional[float] = None,
+        fiscal_year_max: Optional[float] = None,
+        fiscal_quarter: Optional[float] = None,
+        fiscal_quarter_above: Optional[float] = None,
+        fiscal_quarter_min: Optional[float] = None,
+        fiscal_quarter_below: Optional[float] = None,
+        fiscal_quarter_max: Optional[float] = None,
+        timeframe: Optional[str] = None,
+        timeframe_any_of: Optional[str] = None,
+        timeframe_after: Optional[str] = None,
+        timeframe_from: Optional[str] = None,
+        timeframe_before: Optional[str] = None,
+        timeframe_to: Optional[str] = None,
+        max_ticker: Optional[str] = None,
+        max_ticker_any_of: Optional[str] = None,
+        max_ticker_after: Optional[str] = None,
+        max_ticker_from: Optional[str] = None,
+        max_ticker_before: Optional[str] = None,
+        max_ticker_to: Optional[str] = None,
+        min_ticker: Optional[str] = None,
+        min_ticker_any_of: Optional[str] = None,
+        min_ticker_after: Optional[str] = None,
+        min_ticker_from: Optional[str] = None,
+        min_ticker_before: Optional[str] = None,
+        min_ticker_to: Optional[str] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetCashFlowStatementsResponse]:
+        r"""Get Cash Flow Statements
+
+        Retrieve SEC cash flow statement rows per filing period. Filter by CIK, tickers, filing or period dates, fiscal year/quarter, timeframe, and pagination. Same query shape as income statements.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param cik: Exact SEC CIK company identifier. Use this when you need one specific SEC registrant.
+        :param ciks: Comma-separated CIKs (maps to cik.any_of)
+        :param cik_after: CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
+        :param cik_from: CIK greater than or equal (inclusive)
+        :param cik_before: CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
+        :param cik_to: CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
+        :param period_end: Exact fiscal period-end date filter. Use it to return statements for one reporting period.
+        :param period_end_after: Fiscal period-end lower-bound filter. Returns records after this date, excluding the date itself.
+        :param period_end_from: Fiscal period-end start filter. Returns records on or after this date.
+        :param period_end_before: Fiscal period-end upper-bound filter. Returns records before this date, excluding the date itself.
+        :param period_end_to: Fiscal period-end end filter. Returns records on or before this date.
+        :param filing_date: Exact filing date filter. Use it to return filings submitted on one specific date.
+        :param filing_date_after: Filing-date lower-bound filter. Returns records after this date, excluding the date itself.
+        :param filing_date_from: Filing-date start filter. Returns records on or after this date.
+        :param filing_date_before: Filing-date upper-bound filter. Returns records before this date, excluding the date itself.
+        :param filing_date_to: Filing-date end filter. Returns records on or before this date.
+        :param tickers: Ticker symbol filter. Enter a ticker such as AAPL to narrow results to one company.
+        :param tickers_all_of: Ticker all-of filter. Return records that include all listed tickers.
+        :param tickers_any_of: Ticker any-of filter. Return records that include at least one listed ticker.
+        :param fiscal_year: Exact fiscal year filter. Use it to return statements for one reporting year.
+        :param fiscal_year_above: Fiscal year greater than (exclusive)
+        :param fiscal_year_min: Fiscal year greater than or equal (inclusive)
+        :param fiscal_year_below: Fiscal-year upper-bound filter. Returns records before this fiscal year, excluding the year itself.
+        :param fiscal_year_max: Fiscal year less than or equal (inclusive)
+        :param fiscal_quarter: Exact fiscal quarter filter. Use values such as 1, 2, 3, or 4 when supported.
+        :param fiscal_quarter_above: Fiscal quarter greater than (exclusive)
+        :param fiscal_quarter_min: Fiscal quarter greater than or equal (inclusive)
+        :param fiscal_quarter_below: Fiscal quarter less than (exclusive)
+        :param fiscal_quarter_max: Fiscal quarter less than or equal (inclusive)
+        :param timeframe: Reporting timeframe (e.g. quarterly, annual)
+        :param timeframe_any_of: Timeframe any-of filter. Return records that match at least one listed timeframe.
+        :param timeframe_after: Timeframe lower-bound filter. Returns records after this timeframe, excluding the value itself.
+        :param timeframe_from: Timeframe greater than or equal (inclusive)
+        :param timeframe_before: Timeframe upper-bound filter. Returns records before this timeframe, excluding the value itself.
+        :param timeframe_to: Timeframe less than or equal (inclusive)
+        :param max_ticker: Exact maximum ticker value from the statement record. Use only for provider-specific filtering.
+        :param max_ticker_any_of: Max ticker any-of filter. Return records matching at least one listed maxTicker value.
+        :param max_ticker_after: Max ticker greater than (exclusive)
+        :param max_ticker_from: Max ticker greater than or equal (inclusive)
+        :param max_ticker_before: Max ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param max_ticker_to: Max ticker less than or equal (inclusive)
+        :param min_ticker: Exact minimum ticker value from the statement record. Use only for provider-specific filtering.
+        :param min_ticker_any_of: Min ticker any-of filter. Return records matching at least one listed minTicker value.
+        :param min_ticker_after: Min ticker greater than (exclusive)
+        :param min_ticker_from: Min ticker greater than or equal (inclusive)
+        :param min_ticker_before: Min ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param min_ticker_to: Min ticker less than or equal (inclusive)
+        :param limit: Maximum number of results per page. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `period_end.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetCashFlowStatementsRequest(
+            cik=cik,
+            ciks=ciks,
+            cik_after=cik_after,
+            cik_from=cik_from,
+            cik_before=cik_before,
+            cik_to=cik_to,
+            period_end=period_end,
+            period_end_after=period_end_after,
+            period_end_from=period_end_from,
+            period_end_before=period_end_before,
+            period_end_to=period_end_to,
+            filing_date=filing_date,
+            filing_date_after=filing_date_after,
+            filing_date_from=filing_date_from,
+            filing_date_before=filing_date_before,
+            filing_date_to=filing_date_to,
+            tickers=tickers,
+            tickers_all_of=tickers_all_of,
+            tickers_any_of=tickers_any_of,
+            fiscal_year=fiscal_year,
+            fiscal_year_above=fiscal_year_above,
+            fiscal_year_min=fiscal_year_min,
+            fiscal_year_below=fiscal_year_below,
+            fiscal_year_max=fiscal_year_max,
+            fiscal_quarter=fiscal_quarter,
+            fiscal_quarter_above=fiscal_quarter_above,
+            fiscal_quarter_min=fiscal_quarter_min,
+            fiscal_quarter_below=fiscal_quarter_below,
+            fiscal_quarter_max=fiscal_quarter_max,
+            timeframe=timeframe,
+            timeframe_any_of=timeframe_any_of,
+            timeframe_after=timeframe_after,
+            timeframe_from=timeframe_from,
+            timeframe_before=timeframe_before,
+            timeframe_to=timeframe_to,
+            max_ticker=max_ticker,
+            max_ticker_any_of=max_ticker_any_of,
+            max_ticker_after=max_ticker_after,
+            max_ticker_from=max_ticker_from,
+            max_ticker_before=max_ticker_before,
+            max_ticker_to=max_ticker_to,
+            min_ticker=min_ticker,
+            min_ticker_any_of=min_ticker_any_of,
+            min_ticker_after=min_ticker_after,
+            min_ticker_from=min_ticker_from,
+            min_ticker_before=min_ticker_before,
+            min_ticker_to=min_ticker_to,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/cash-flow-statements",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getCashFlowStatements",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetCashFlowStatementsResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_cash_flow_statements(
+                cik=cik,
+                ciks=ciks,
+                cik_after=cik_after,
+                cik_from=cik_from,
+                cik_before=cik_before,
+                cik_to=cik_to,
+                period_end=period_end,
+                period_end_after=period_end_after,
+                period_end_from=period_end_from,
+                period_end_before=period_end_before,
+                period_end_to=period_end_to,
+                filing_date=filing_date,
+                filing_date_after=filing_date_after,
+                filing_date_from=filing_date_from,
+                filing_date_before=filing_date_before,
+                filing_date_to=filing_date_to,
+                tickers=tickers,
+                tickers_all_of=tickers_all_of,
+                tickers_any_of=tickers_any_of,
+                fiscal_year=fiscal_year,
+                fiscal_year_above=fiscal_year_above,
+                fiscal_year_min=fiscal_year_min,
+                fiscal_year_below=fiscal_year_below,
+                fiscal_year_max=fiscal_year_max,
+                fiscal_quarter=fiscal_quarter,
+                fiscal_quarter_above=fiscal_quarter_above,
+                fiscal_quarter_min=fiscal_quarter_min,
+                fiscal_quarter_below=fiscal_quarter_below,
+                fiscal_quarter_max=fiscal_quarter_max,
+                timeframe=timeframe,
+                timeframe_any_of=timeframe_any_of,
+                timeframe_after=timeframe_after,
+                timeframe_from=timeframe_from,
+                timeframe_before=timeframe_before,
+                timeframe_to=timeframe_to,
+                max_ticker=max_ticker,
+                max_ticker_any_of=max_ticker_any_of,
+                max_ticker_after=max_ticker_after,
+                max_ticker_from=max_ticker_from,
+                max_ticker_before=max_ticker_before,
+                max_ticker_to=max_ticker_to,
+                min_ticker=min_ticker,
+                min_ticker_any_of=min_ticker_any_of,
+                min_ticker_after=min_ticker_after,
+                min_ticker_from=min_ticker_from,
+                min_ticker_before=min_ticker_before,
+                min_ticker_to=min_ticker_to,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetCashFlowStatementsResponse(
+                cash_flow_statements_response=unmarshal_json_response(
+                    Optional[models.CashFlowStatementsResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_cash_flow_statements_async(
+        self,
+        *,
+        cik: Optional[str] = None,
+        ciks: Optional[str] = None,
+        cik_after: Optional[str] = None,
+        cik_from: Optional[str] = None,
+        cik_before: Optional[str] = None,
+        cik_to: Optional[str] = None,
+        period_end: Optional[date] = None,
+        period_end_after: Optional[date] = None,
+        period_end_from: Optional[date] = None,
+        period_end_before: Optional[date] = None,
+        period_end_to: Optional[date] = None,
+        filing_date: Optional[date] = None,
+        filing_date_after: Optional[date] = None,
+        filing_date_from: Optional[date] = None,
+        filing_date_before: Optional[date] = None,
+        filing_date_to: Optional[date] = None,
+        tickers: Optional[str] = None,
+        tickers_all_of: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        fiscal_year: Optional[float] = None,
+        fiscal_year_above: Optional[float] = None,
+        fiscal_year_min: Optional[float] = None,
+        fiscal_year_below: Optional[float] = None,
+        fiscal_year_max: Optional[float] = None,
+        fiscal_quarter: Optional[float] = None,
+        fiscal_quarter_above: Optional[float] = None,
+        fiscal_quarter_min: Optional[float] = None,
+        fiscal_quarter_below: Optional[float] = None,
+        fiscal_quarter_max: Optional[float] = None,
+        timeframe: Optional[str] = None,
+        timeframe_any_of: Optional[str] = None,
+        timeframe_after: Optional[str] = None,
+        timeframe_from: Optional[str] = None,
+        timeframe_before: Optional[str] = None,
+        timeframe_to: Optional[str] = None,
+        max_ticker: Optional[str] = None,
+        max_ticker_any_of: Optional[str] = None,
+        max_ticker_after: Optional[str] = None,
+        max_ticker_from: Optional[str] = None,
+        max_ticker_before: Optional[str] = None,
+        max_ticker_to: Optional[str] = None,
+        min_ticker: Optional[str] = None,
+        min_ticker_any_of: Optional[str] = None,
+        min_ticker_after: Optional[str] = None,
+        min_ticker_from: Optional[str] = None,
+        min_ticker_before: Optional[str] = None,
+        min_ticker_to: Optional[str] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetCashFlowStatementsResponse]:
+        r"""Get Cash Flow Statements
+
+        Retrieve SEC cash flow statement rows per filing period. Filter by CIK, tickers, filing or period dates, fiscal year/quarter, timeframe, and pagination. Same query shape as income statements.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param cik: Exact SEC CIK company identifier. Use this when you need one specific SEC registrant.
+        :param ciks: Comma-separated CIKs (maps to cik.any_of)
+        :param cik_after: CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
+        :param cik_from: CIK greater than or equal (inclusive)
+        :param cik_before: CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
+        :param cik_to: CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
+        :param period_end: Exact fiscal period-end date filter. Use it to return statements for one reporting period.
+        :param period_end_after: Fiscal period-end lower-bound filter. Returns records after this date, excluding the date itself.
+        :param period_end_from: Fiscal period-end start filter. Returns records on or after this date.
+        :param period_end_before: Fiscal period-end upper-bound filter. Returns records before this date, excluding the date itself.
+        :param period_end_to: Fiscal period-end end filter. Returns records on or before this date.
+        :param filing_date: Exact filing date filter. Use it to return filings submitted on one specific date.
+        :param filing_date_after: Filing-date lower-bound filter. Returns records after this date, excluding the date itself.
+        :param filing_date_from: Filing-date start filter. Returns records on or after this date.
+        :param filing_date_before: Filing-date upper-bound filter. Returns records before this date, excluding the date itself.
+        :param filing_date_to: Filing-date end filter. Returns records on or before this date.
+        :param tickers: Ticker symbol filter. Enter a ticker such as AAPL to narrow results to one company.
+        :param tickers_all_of: Ticker all-of filter. Return records that include all listed tickers.
+        :param tickers_any_of: Ticker any-of filter. Return records that include at least one listed ticker.
+        :param fiscal_year: Exact fiscal year filter. Use it to return statements for one reporting year.
+        :param fiscal_year_above: Fiscal year greater than (exclusive)
+        :param fiscal_year_min: Fiscal year greater than or equal (inclusive)
+        :param fiscal_year_below: Fiscal-year upper-bound filter. Returns records before this fiscal year, excluding the year itself.
+        :param fiscal_year_max: Fiscal year less than or equal (inclusive)
+        :param fiscal_quarter: Exact fiscal quarter filter. Use values such as 1, 2, 3, or 4 when supported.
+        :param fiscal_quarter_above: Fiscal quarter greater than (exclusive)
+        :param fiscal_quarter_min: Fiscal quarter greater than or equal (inclusive)
+        :param fiscal_quarter_below: Fiscal quarter less than (exclusive)
+        :param fiscal_quarter_max: Fiscal quarter less than or equal (inclusive)
+        :param timeframe: Reporting timeframe (e.g. quarterly, annual)
+        :param timeframe_any_of: Timeframe any-of filter. Return records that match at least one listed timeframe.
+        :param timeframe_after: Timeframe lower-bound filter. Returns records after this timeframe, excluding the value itself.
+        :param timeframe_from: Timeframe greater than or equal (inclusive)
+        :param timeframe_before: Timeframe upper-bound filter. Returns records before this timeframe, excluding the value itself.
+        :param timeframe_to: Timeframe less than or equal (inclusive)
+        :param max_ticker: Exact maximum ticker value from the statement record. Use only for provider-specific filtering.
+        :param max_ticker_any_of: Max ticker any-of filter. Return records matching at least one listed maxTicker value.
+        :param max_ticker_after: Max ticker greater than (exclusive)
+        :param max_ticker_from: Max ticker greater than or equal (inclusive)
+        :param max_ticker_before: Max ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param max_ticker_to: Max ticker less than or equal (inclusive)
+        :param min_ticker: Exact minimum ticker value from the statement record. Use only for provider-specific filtering.
+        :param min_ticker_any_of: Min ticker any-of filter. Return records matching at least one listed minTicker value.
+        :param min_ticker_after: Min ticker greater than (exclusive)
+        :param min_ticker_from: Min ticker greater than or equal (inclusive)
+        :param min_ticker_before: Min ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param min_ticker_to: Min ticker less than or equal (inclusive)
+        :param limit: Maximum number of results per page. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `period_end.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetCashFlowStatementsRequest(
+            cik=cik,
+            ciks=ciks,
+            cik_after=cik_after,
+            cik_from=cik_from,
+            cik_before=cik_before,
+            cik_to=cik_to,
+            period_end=period_end,
+            period_end_after=period_end_after,
+            period_end_from=period_end_from,
+            period_end_before=period_end_before,
+            period_end_to=period_end_to,
+            filing_date=filing_date,
+            filing_date_after=filing_date_after,
+            filing_date_from=filing_date_from,
+            filing_date_before=filing_date_before,
+            filing_date_to=filing_date_to,
+            tickers=tickers,
+            tickers_all_of=tickers_all_of,
+            tickers_any_of=tickers_any_of,
+            fiscal_year=fiscal_year,
+            fiscal_year_above=fiscal_year_above,
+            fiscal_year_min=fiscal_year_min,
+            fiscal_year_below=fiscal_year_below,
+            fiscal_year_max=fiscal_year_max,
+            fiscal_quarter=fiscal_quarter,
+            fiscal_quarter_above=fiscal_quarter_above,
+            fiscal_quarter_min=fiscal_quarter_min,
+            fiscal_quarter_below=fiscal_quarter_below,
+            fiscal_quarter_max=fiscal_quarter_max,
+            timeframe=timeframe,
+            timeframe_any_of=timeframe_any_of,
+            timeframe_after=timeframe_after,
+            timeframe_from=timeframe_from,
+            timeframe_before=timeframe_before,
+            timeframe_to=timeframe_to,
+            max_ticker=max_ticker,
+            max_ticker_any_of=max_ticker_any_of,
+            max_ticker_after=max_ticker_after,
+            max_ticker_from=max_ticker_from,
+            max_ticker_before=max_ticker_before,
+            max_ticker_to=max_ticker_to,
+            min_ticker=min_ticker,
+            min_ticker_any_of=min_ticker_any_of,
+            min_ticker_after=min_ticker_after,
+            min_ticker_from=min_ticker_from,
+            min_ticker_before=min_ticker_before,
+            min_ticker_to=min_ticker_to,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/cash-flow-statements",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getCashFlowStatements",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetCashFlowStatementsResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_cash_flow_statements(
+                cik=cik,
+                ciks=ciks,
+                cik_after=cik_after,
+                cik_from=cik_from,
+                cik_before=cik_before,
+                cik_to=cik_to,
+                period_end=period_end,
+                period_end_after=period_end_after,
+                period_end_from=period_end_from,
+                period_end_before=period_end_before,
+                period_end_to=period_end_to,
+                filing_date=filing_date,
+                filing_date_after=filing_date_after,
+                filing_date_from=filing_date_from,
+                filing_date_before=filing_date_before,
+                filing_date_to=filing_date_to,
+                tickers=tickers,
+                tickers_all_of=tickers_all_of,
+                tickers_any_of=tickers_any_of,
+                fiscal_year=fiscal_year,
+                fiscal_year_above=fiscal_year_above,
+                fiscal_year_min=fiscal_year_min,
+                fiscal_year_below=fiscal_year_below,
+                fiscal_year_max=fiscal_year_max,
+                fiscal_quarter=fiscal_quarter,
+                fiscal_quarter_above=fiscal_quarter_above,
+                fiscal_quarter_min=fiscal_quarter_min,
+                fiscal_quarter_below=fiscal_quarter_below,
+                fiscal_quarter_max=fiscal_quarter_max,
+                timeframe=timeframe,
+                timeframe_any_of=timeframe_any_of,
+                timeframe_after=timeframe_after,
+                timeframe_from=timeframe_from,
+                timeframe_before=timeframe_before,
+                timeframe_to=timeframe_to,
+                max_ticker=max_ticker,
+                max_ticker_any_of=max_ticker_any_of,
+                max_ticker_after=max_ticker_after,
+                max_ticker_from=max_ticker_from,
+                max_ticker_before=max_ticker_before,
+                max_ticker_to=max_ticker_to,
+                min_ticker=min_ticker,
+                min_ticker_any_of=min_ticker_any_of,
+                min_ticker_after=min_ticker_after,
+                min_ticker_from=min_ticker_from,
+                min_ticker_before=min_ticker_before,
+                min_ticker_to=min_ticker_to,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetCashFlowStatementsResponse(
+                cash_flow_statements_response=unmarshal_json_response(
+                    Optional[models.CashFlowStatementsResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def get_income_statements(
+        self,
+        *,
+        cik: Optional[str] = None,
+        ciks: Optional[str] = None,
+        cik_after: Optional[str] = None,
+        cik_from: Optional[str] = None,
+        cik_before: Optional[str] = None,
+        cik_to: Optional[str] = None,
+        period_end: Optional[date] = None,
+        period_end_after: Optional[date] = None,
+        period_end_from: Optional[date] = None,
+        period_end_before: Optional[date] = None,
+        period_end_to: Optional[date] = None,
+        filing_date: Optional[date] = None,
+        filing_date_after: Optional[date] = None,
+        filing_date_from: Optional[date] = None,
+        filing_date_before: Optional[date] = None,
+        filing_date_to: Optional[date] = None,
+        tickers: Optional[str] = None,
+        tickers_all_of: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        fiscal_year: Optional[float] = None,
+        fiscal_year_above: Optional[float] = None,
+        fiscal_year_min: Optional[float] = None,
+        fiscal_year_below: Optional[float] = None,
+        fiscal_year_max: Optional[float] = None,
+        fiscal_quarter: Optional[float] = None,
+        fiscal_quarter_above: Optional[float] = None,
+        fiscal_quarter_min: Optional[float] = None,
+        fiscal_quarter_below: Optional[float] = None,
+        fiscal_quarter_max: Optional[float] = None,
+        timeframe: Optional[str] = None,
+        timeframe_any_of: Optional[str] = None,
+        timeframe_after: Optional[str] = None,
+        timeframe_from: Optional[str] = None,
+        timeframe_before: Optional[str] = None,
+        timeframe_to: Optional[str] = None,
+        max_ticker: Optional[str] = None,
+        max_ticker_any_of: Optional[str] = None,
+        max_ticker_after: Optional[str] = None,
+        max_ticker_from: Optional[str] = None,
+        max_ticker_before: Optional[str] = None,
+        max_ticker_to: Optional[str] = None,
+        min_ticker: Optional[str] = None,
+        min_ticker_any_of: Optional[str] = None,
+        min_ticker_after: Optional[str] = None,
+        min_ticker_from: Optional[str] = None,
+        min_ticker_before: Optional[str] = None,
+        min_ticker_to: Optional[str] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetIncomeStatementsResponse]:
+        r"""Get Income Statements
+
+        Retrieve SEC income statement rows per filing period. Filter by CIK, tickers, filing or period dates, fiscal year/quarter, timeframe, and pagination. Same query shape as cash flow statements.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param cik: Exact SEC CIK company identifier. Use this when you need one specific SEC registrant.
+        :param ciks: Comma-separated CIKs (maps to cik.any_of)
+        :param cik_after: CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
+        :param cik_from: CIK greater than or equal (inclusive)
+        :param cik_before: CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
+        :param cik_to: CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
+        :param period_end: Exact fiscal period-end date filter. Use it to return statements for one reporting period.
+        :param period_end_after: Fiscal period-end lower-bound filter. Returns records after this date, excluding the date itself.
+        :param period_end_from: Fiscal period-end start filter. Returns records on or after this date.
+        :param period_end_before: Fiscal period-end upper-bound filter. Returns records before this date, excluding the date itself.
+        :param period_end_to: Fiscal period-end end filter. Returns records on or before this date.
+        :param filing_date: Exact filing date filter. Use it to return filings submitted on one specific date.
+        :param filing_date_after: Filing-date lower-bound filter. Returns records after this date, excluding the date itself.
+        :param filing_date_from: Filing-date start filter. Returns records on or after this date.
+        :param filing_date_before: Filing-date upper-bound filter. Returns records before this date, excluding the date itself.
+        :param filing_date_to: Filing-date end filter. Returns records on or before this date.
+        :param tickers: Ticker symbol filter. Enter a ticker such as AAPL to narrow results to one company.
+        :param tickers_all_of: Ticker all-of filter. Return records that include all listed tickers.
+        :param tickers_any_of: Ticker any-of filter. Return records that include at least one listed ticker.
+        :param fiscal_year: Exact fiscal year filter. Use it to return statements for one reporting year.
+        :param fiscal_year_above: Fiscal year greater than (exclusive)
+        :param fiscal_year_min: Fiscal year greater than or equal (inclusive)
+        :param fiscal_year_below: Fiscal-year upper-bound filter. Returns records before this fiscal year, excluding the year itself.
+        :param fiscal_year_max: Fiscal year less than or equal (inclusive)
+        :param fiscal_quarter: Exact fiscal quarter filter. Use values such as 1, 2, 3, or 4 when supported.
+        :param fiscal_quarter_above: Fiscal quarter greater than (exclusive)
+        :param fiscal_quarter_min: Fiscal quarter greater than or equal (inclusive)
+        :param fiscal_quarter_below: Fiscal quarter less than (exclusive)
+        :param fiscal_quarter_max: Fiscal quarter less than or equal (inclusive)
+        :param timeframe: Reporting timeframe (e.g. quarterly, annual)
+        :param timeframe_any_of: Timeframe any-of filter. Return records that match at least one listed timeframe.
+        :param timeframe_after: Timeframe lower-bound filter. Returns records after this timeframe, excluding the value itself.
+        :param timeframe_from: Timeframe greater than or equal (inclusive)
+        :param timeframe_before: Timeframe upper-bound filter. Returns records before this timeframe, excluding the value itself.
+        :param timeframe_to: Timeframe less than or equal (inclusive)
+        :param max_ticker: Exact maximum ticker value from the statement record. Use only for provider-specific filtering.
+        :param max_ticker_any_of: Max ticker any-of filter. Return records matching at least one listed maxTicker value.
+        :param max_ticker_after: Max ticker greater than (exclusive)
+        :param max_ticker_from: Max ticker greater than or equal (inclusive)
+        :param max_ticker_before: Max ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param max_ticker_to: Max ticker less than or equal (inclusive)
+        :param min_ticker: Exact minimum ticker value from the statement record. Use only for provider-specific filtering.
+        :param min_ticker_any_of: Min ticker any-of filter. Return records matching at least one listed minTicker value.
+        :param min_ticker_after: Min ticker greater than (exclusive)
+        :param min_ticker_from: Min ticker greater than or equal (inclusive)
+        :param min_ticker_before: Min ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param min_ticker_to: Min ticker less than or equal (inclusive)
+        :param limit: Maximum number of results per page. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `period_end.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetIncomeStatementsRequest(
+            cik=cik,
+            ciks=ciks,
+            cik_after=cik_after,
+            cik_from=cik_from,
+            cik_before=cik_before,
+            cik_to=cik_to,
+            period_end=period_end,
+            period_end_after=period_end_after,
+            period_end_from=period_end_from,
+            period_end_before=period_end_before,
+            period_end_to=period_end_to,
+            filing_date=filing_date,
+            filing_date_after=filing_date_after,
+            filing_date_from=filing_date_from,
+            filing_date_before=filing_date_before,
+            filing_date_to=filing_date_to,
+            tickers=tickers,
+            tickers_all_of=tickers_all_of,
+            tickers_any_of=tickers_any_of,
+            fiscal_year=fiscal_year,
+            fiscal_year_above=fiscal_year_above,
+            fiscal_year_min=fiscal_year_min,
+            fiscal_year_below=fiscal_year_below,
+            fiscal_year_max=fiscal_year_max,
+            fiscal_quarter=fiscal_quarter,
+            fiscal_quarter_above=fiscal_quarter_above,
+            fiscal_quarter_min=fiscal_quarter_min,
+            fiscal_quarter_below=fiscal_quarter_below,
+            fiscal_quarter_max=fiscal_quarter_max,
+            timeframe=timeframe,
+            timeframe_any_of=timeframe_any_of,
+            timeframe_after=timeframe_after,
+            timeframe_from=timeframe_from,
+            timeframe_before=timeframe_before,
+            timeframe_to=timeframe_to,
+            max_ticker=max_ticker,
+            max_ticker_any_of=max_ticker_any_of,
+            max_ticker_after=max_ticker_after,
+            max_ticker_from=max_ticker_from,
+            max_ticker_before=max_ticker_before,
+            max_ticker_to=max_ticker_to,
+            min_ticker=min_ticker,
+            min_ticker_any_of=min_ticker_any_of,
+            min_ticker_after=min_ticker_after,
+            min_ticker_from=min_ticker_from,
+            min_ticker_before=min_ticker_before,
+            min_ticker_to=min_ticker_to,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/income-statements",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getIncomeStatements",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetIncomeStatementsResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_income_statements(
+                cik=cik,
+                ciks=ciks,
+                cik_after=cik_after,
+                cik_from=cik_from,
+                cik_before=cik_before,
+                cik_to=cik_to,
+                period_end=period_end,
+                period_end_after=period_end_after,
+                period_end_from=period_end_from,
+                period_end_before=period_end_before,
+                period_end_to=period_end_to,
+                filing_date=filing_date,
+                filing_date_after=filing_date_after,
+                filing_date_from=filing_date_from,
+                filing_date_before=filing_date_before,
+                filing_date_to=filing_date_to,
+                tickers=tickers,
+                tickers_all_of=tickers_all_of,
+                tickers_any_of=tickers_any_of,
+                fiscal_year=fiscal_year,
+                fiscal_year_above=fiscal_year_above,
+                fiscal_year_min=fiscal_year_min,
+                fiscal_year_below=fiscal_year_below,
+                fiscal_year_max=fiscal_year_max,
+                fiscal_quarter=fiscal_quarter,
+                fiscal_quarter_above=fiscal_quarter_above,
+                fiscal_quarter_min=fiscal_quarter_min,
+                fiscal_quarter_below=fiscal_quarter_below,
+                fiscal_quarter_max=fiscal_quarter_max,
+                timeframe=timeframe,
+                timeframe_any_of=timeframe_any_of,
+                timeframe_after=timeframe_after,
+                timeframe_from=timeframe_from,
+                timeframe_before=timeframe_before,
+                timeframe_to=timeframe_to,
+                max_ticker=max_ticker,
+                max_ticker_any_of=max_ticker_any_of,
+                max_ticker_after=max_ticker_after,
+                max_ticker_from=max_ticker_from,
+                max_ticker_before=max_ticker_before,
+                max_ticker_to=max_ticker_to,
+                min_ticker=min_ticker,
+                min_ticker_any_of=min_ticker_any_of,
+                min_ticker_after=min_ticker_after,
+                min_ticker_from=min_ticker_from,
+                min_ticker_before=min_ticker_before,
+                min_ticker_to=min_ticker_to,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetIncomeStatementsResponse(
+                income_statements_response=unmarshal_json_response(
+                    Optional[models.IncomeStatementsResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_income_statements_async(
+        self,
+        *,
+        cik: Optional[str] = None,
+        ciks: Optional[str] = None,
+        cik_after: Optional[str] = None,
+        cik_from: Optional[str] = None,
+        cik_before: Optional[str] = None,
+        cik_to: Optional[str] = None,
+        period_end: Optional[date] = None,
+        period_end_after: Optional[date] = None,
+        period_end_from: Optional[date] = None,
+        period_end_before: Optional[date] = None,
+        period_end_to: Optional[date] = None,
+        filing_date: Optional[date] = None,
+        filing_date_after: Optional[date] = None,
+        filing_date_from: Optional[date] = None,
+        filing_date_before: Optional[date] = None,
+        filing_date_to: Optional[date] = None,
+        tickers: Optional[str] = None,
+        tickers_all_of: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        fiscal_year: Optional[float] = None,
+        fiscal_year_above: Optional[float] = None,
+        fiscal_year_min: Optional[float] = None,
+        fiscal_year_below: Optional[float] = None,
+        fiscal_year_max: Optional[float] = None,
+        fiscal_quarter: Optional[float] = None,
+        fiscal_quarter_above: Optional[float] = None,
+        fiscal_quarter_min: Optional[float] = None,
+        fiscal_quarter_below: Optional[float] = None,
+        fiscal_quarter_max: Optional[float] = None,
+        timeframe: Optional[str] = None,
+        timeframe_any_of: Optional[str] = None,
+        timeframe_after: Optional[str] = None,
+        timeframe_from: Optional[str] = None,
+        timeframe_before: Optional[str] = None,
+        timeframe_to: Optional[str] = None,
+        max_ticker: Optional[str] = None,
+        max_ticker_any_of: Optional[str] = None,
+        max_ticker_after: Optional[str] = None,
+        max_ticker_from: Optional[str] = None,
+        max_ticker_before: Optional[str] = None,
+        max_ticker_to: Optional[str] = None,
+        min_ticker: Optional[str] = None,
+        min_ticker_any_of: Optional[str] = None,
+        min_ticker_after: Optional[str] = None,
+        min_ticker_from: Optional[str] = None,
+        min_ticker_before: Optional[str] = None,
+        min_ticker_to: Optional[str] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetIncomeStatementsResponse]:
+        r"""Get Income Statements
+
+        Retrieve SEC income statement rows per filing period. Filter by CIK, tickers, filing or period dates, fiscal year/quarter, timeframe, and pagination. Same query shape as cash flow statements.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param cik: Exact SEC CIK company identifier. Use this when you need one specific SEC registrant.
+        :param ciks: Comma-separated CIKs (maps to cik.any_of)
+        :param cik_after: CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
+        :param cik_from: CIK greater than or equal (inclusive)
+        :param cik_before: CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
+        :param cik_to: CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
+        :param period_end: Exact fiscal period-end date filter. Use it to return statements for one reporting period.
+        :param period_end_after: Fiscal period-end lower-bound filter. Returns records after this date, excluding the date itself.
+        :param period_end_from: Fiscal period-end start filter. Returns records on or after this date.
+        :param period_end_before: Fiscal period-end upper-bound filter. Returns records before this date, excluding the date itself.
+        :param period_end_to: Fiscal period-end end filter. Returns records on or before this date.
+        :param filing_date: Exact filing date filter. Use it to return filings submitted on one specific date.
+        :param filing_date_after: Filing-date lower-bound filter. Returns records after this date, excluding the date itself.
+        :param filing_date_from: Filing-date start filter. Returns records on or after this date.
+        :param filing_date_before: Filing-date upper-bound filter. Returns records before this date, excluding the date itself.
+        :param filing_date_to: Filing-date end filter. Returns records on or before this date.
+        :param tickers: Ticker symbol filter. Enter a ticker such as AAPL to narrow results to one company.
+        :param tickers_all_of: Ticker all-of filter. Return records that include all listed tickers.
+        :param tickers_any_of: Ticker any-of filter. Return records that include at least one listed ticker.
+        :param fiscal_year: Exact fiscal year filter. Use it to return statements for one reporting year.
+        :param fiscal_year_above: Fiscal year greater than (exclusive)
+        :param fiscal_year_min: Fiscal year greater than or equal (inclusive)
+        :param fiscal_year_below: Fiscal-year upper-bound filter. Returns records before this fiscal year, excluding the year itself.
+        :param fiscal_year_max: Fiscal year less than or equal (inclusive)
+        :param fiscal_quarter: Exact fiscal quarter filter. Use values such as 1, 2, 3, or 4 when supported.
+        :param fiscal_quarter_above: Fiscal quarter greater than (exclusive)
+        :param fiscal_quarter_min: Fiscal quarter greater than or equal (inclusive)
+        :param fiscal_quarter_below: Fiscal quarter less than (exclusive)
+        :param fiscal_quarter_max: Fiscal quarter less than or equal (inclusive)
+        :param timeframe: Reporting timeframe (e.g. quarterly, annual)
+        :param timeframe_any_of: Timeframe any-of filter. Return records that match at least one listed timeframe.
+        :param timeframe_after: Timeframe lower-bound filter. Returns records after this timeframe, excluding the value itself.
+        :param timeframe_from: Timeframe greater than or equal (inclusive)
+        :param timeframe_before: Timeframe upper-bound filter. Returns records before this timeframe, excluding the value itself.
+        :param timeframe_to: Timeframe less than or equal (inclusive)
+        :param max_ticker: Exact maximum ticker value from the statement record. Use only for provider-specific filtering.
+        :param max_ticker_any_of: Max ticker any-of filter. Return records matching at least one listed maxTicker value.
+        :param max_ticker_after: Max ticker greater than (exclusive)
+        :param max_ticker_from: Max ticker greater than or equal (inclusive)
+        :param max_ticker_before: Max ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param max_ticker_to: Max ticker less than or equal (inclusive)
+        :param min_ticker: Exact minimum ticker value from the statement record. Use only for provider-specific filtering.
+        :param min_ticker_any_of: Min ticker any-of filter. Return records matching at least one listed minTicker value.
+        :param min_ticker_after: Min ticker greater than (exclusive)
+        :param min_ticker_from: Min ticker greater than or equal (inclusive)
+        :param min_ticker_before: Min ticker upper-bound filter. Returns records before this value, excluding the value itself.
+        :param min_ticker_to: Min ticker less than or equal (inclusive)
+        :param limit: Maximum number of results per page. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `period_end.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetIncomeStatementsRequest(
+            cik=cik,
+            ciks=ciks,
+            cik_after=cik_after,
+            cik_from=cik_from,
+            cik_before=cik_before,
+            cik_to=cik_to,
+            period_end=period_end,
+            period_end_after=period_end_after,
+            period_end_from=period_end_from,
+            period_end_before=period_end_before,
+            period_end_to=period_end_to,
+            filing_date=filing_date,
+            filing_date_after=filing_date_after,
+            filing_date_from=filing_date_from,
+            filing_date_before=filing_date_before,
+            filing_date_to=filing_date_to,
+            tickers=tickers,
+            tickers_all_of=tickers_all_of,
+            tickers_any_of=tickers_any_of,
+            fiscal_year=fiscal_year,
+            fiscal_year_above=fiscal_year_above,
+            fiscal_year_min=fiscal_year_min,
+            fiscal_year_below=fiscal_year_below,
+            fiscal_year_max=fiscal_year_max,
+            fiscal_quarter=fiscal_quarter,
+            fiscal_quarter_above=fiscal_quarter_above,
+            fiscal_quarter_min=fiscal_quarter_min,
+            fiscal_quarter_below=fiscal_quarter_below,
+            fiscal_quarter_max=fiscal_quarter_max,
+            timeframe=timeframe,
+            timeframe_any_of=timeframe_any_of,
+            timeframe_after=timeframe_after,
+            timeframe_from=timeframe_from,
+            timeframe_before=timeframe_before,
+            timeframe_to=timeframe_to,
+            max_ticker=max_ticker,
+            max_ticker_any_of=max_ticker_any_of,
+            max_ticker_after=max_ticker_after,
+            max_ticker_from=max_ticker_from,
+            max_ticker_before=max_ticker_before,
+            max_ticker_to=max_ticker_to,
+            min_ticker=min_ticker,
+            min_ticker_any_of=min_ticker_any_of,
+            min_ticker_after=min_ticker_after,
+            min_ticker_from=min_ticker_from,
+            min_ticker_before=min_ticker_before,
+            min_ticker_to=min_ticker_to,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/income-statements",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getIncomeStatements",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetIncomeStatementsResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_income_statements(
+                cik=cik,
+                ciks=ciks,
+                cik_after=cik_after,
+                cik_from=cik_from,
+                cik_before=cik_before,
+                cik_to=cik_to,
+                period_end=period_end,
+                period_end_after=period_end_after,
+                period_end_from=period_end_from,
+                period_end_before=period_end_before,
+                period_end_to=period_end_to,
+                filing_date=filing_date,
+                filing_date_after=filing_date_after,
+                filing_date_from=filing_date_from,
+                filing_date_before=filing_date_before,
+                filing_date_to=filing_date_to,
+                tickers=tickers,
+                tickers_all_of=tickers_all_of,
+                tickers_any_of=tickers_any_of,
+                fiscal_year=fiscal_year,
+                fiscal_year_above=fiscal_year_above,
+                fiscal_year_min=fiscal_year_min,
+                fiscal_year_below=fiscal_year_below,
+                fiscal_year_max=fiscal_year_max,
+                fiscal_quarter=fiscal_quarter,
+                fiscal_quarter_above=fiscal_quarter_above,
+                fiscal_quarter_min=fiscal_quarter_min,
+                fiscal_quarter_below=fiscal_quarter_below,
+                fiscal_quarter_max=fiscal_quarter_max,
+                timeframe=timeframe,
+                timeframe_any_of=timeframe_any_of,
+                timeframe_after=timeframe_after,
+                timeframe_from=timeframe_from,
+                timeframe_before=timeframe_before,
+                timeframe_to=timeframe_to,
+                max_ticker=max_ticker,
+                max_ticker_any_of=max_ticker_any_of,
+                max_ticker_after=max_ticker_after,
+                max_ticker_from=max_ticker_from,
+                max_ticker_before=max_ticker_before,
+                max_ticker_to=max_ticker_to,
+                min_ticker=min_ticker,
+                min_ticker_any_of=min_ticker_any_of,
+                min_ticker_after=min_ticker_after,
+                min_ticker_from=min_ticker_from,
+                min_ticker_before=min_ticker_before,
+                min_ticker_to=min_ticker_to,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetIncomeStatementsResponse(
+                income_statements_response=unmarshal_json_response(
+                    Optional[models.IncomeStatementsResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def get_financial_ratios(
+        self,
+        *,
+        ticker: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        ticker_after: Optional[str] = None,
+        ticker_from: Optional[str] = None,
+        ticker_before: Optional[str] = None,
+        ticker_to: Optional[str] = None,
+        cik: Optional[str] = None,
+        ciks: Optional[str] = None,
+        cik_after: Optional[str] = None,
+        cik_from: Optional[str] = None,
+        cik_before: Optional[str] = None,
+        cik_to: Optional[str] = None,
+        price: Optional[float] = None,
+        price_above: Optional[float] = None,
+        price_min: Optional[float] = None,
+        price_below: Optional[float] = None,
+        price_max: Optional[float] = None,
+        average_volume: Optional[float] = None,
+        average_volume_above: Optional[float] = None,
+        average_volume_min: Optional[float] = None,
+        average_volume_below: Optional[float] = None,
+        average_volume_max: Optional[float] = None,
+        market_cap: Optional[float] = None,
+        market_cap_above: Optional[float] = None,
+        market_cap_min: Optional[float] = None,
+        market_cap_below: Optional[float] = None,
+        market_cap_max: Optional[float] = None,
+        eps: Optional[float] = None,
+        eps_above: Optional[float] = None,
+        eps_min: Optional[float] = None,
+        eps_below: Optional[float] = None,
+        eps_max: Optional[float] = None,
+        pe_ratio: Optional[float] = None,
+        pe_ratio_above: Optional[float] = None,
+        pe_ratio_min: Optional[float] = None,
+        pe_ratio_below: Optional[float] = None,
+        pe_ratio_max: Optional[float] = None,
+        pb_ratio: Optional[float] = None,
+        pb_ratio_above: Optional[float] = None,
+        pb_ratio_min: Optional[float] = None,
+        pb_ratio_below: Optional[float] = None,
+        pb_ratio_max: Optional[float] = None,
+        ps_ratio: Optional[float] = None,
+        ps_ratio_above: Optional[float] = None,
+        ps_ratio_min: Optional[float] = None,
+        ps_ratio_below: Optional[float] = None,
+        ps_ratio_max: Optional[float] = None,
+        pcf_ratio: Optional[float] = None,
+        pcf_ratio_above: Optional[float] = None,
+        pcf_ratio_min: Optional[float] = None,
+        pcf_ratio_below: Optional[float] = None,
+        pcf_ratio_max: Optional[float] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetFinancialRatiosResponse]:
+        r"""Get Financial Ratios
+
+        Retrieve comprehensive financial ratios including liquidity, profitability, leverage, and efficiency metrics for fundamental analysis. `ticker` accepts a single symbol only. Use `tickersAnyOf` for multiple symbols. If `ticker` contains multiple comma-separated values, the API returns 400: \"Multiple tickers are not supported. Please provide a single ticker.\" If both `ticker` and `tickersAnyOf` are set, the API returns 400: \"Cannot specify both ticker and tickersAnyOf. Use ticker for a single symbol or tickersAnyOf for multiple.\"
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param ticker: Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company.
+        :param tickers_any_of: Comma-separated list of ticker symbols.
+        :param ticker_after: Ticker pagination lower bound. Returns symbols alphabetically after this ticker, excluding the ticker itself.
+        :param ticker_from: Ticker greater than or equal (inclusive)
+        :param ticker_before: Ticker pagination upper bound. Returns symbols alphabetically before this ticker, excluding the ticker itself.
+        :param ticker_to: Ticker less than or equal (inclusive)
+        :param cik: CIK company identifier from the SEC. Use this when filtering by SEC registrant instead of ticker.
+        :param ciks: Comma-separated SEC CIK identifiers. Use this to filter several registrants in one request.
+        :param cik_after: CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
+        :param cik_from: CIK greater than or equal (inclusive)
+        :param cik_before: CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
+        :param cik_to: CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
+        :param price: Exact price filter. Use it when you need records matching one specific price value.
+        :param price_above: Price lower-bound filter. Returns records above this value, excluding the value itself.
+        :param price_min: Price greater than or equal (inclusive)
+        :param price_below: Price upper-bound filter. Returns records below this value, excluding the value itself.
+        :param price_max: Price less than or equal (inclusive)
+        :param average_volume: Exact average-volume filter. Use it when screening for one specific average volume value.
+        :param average_volume_above: Average volume greater than (exclusive)
+        :param average_volume_min: Average volume greater than or equal (inclusive)
+        :param average_volume_below: Average volume less than (exclusive)
+        :param average_volume_max: Average volume less than or equal (inclusive)
+        :param market_cap: Exact market-cap filter. Use it when screening for one specific company size value.
+        :param market_cap_above: Market cap greater than (exclusive)
+        :param market_cap_min: Market cap greater than or equal (inclusive)
+        :param market_cap_below: Market-cap upper-bound filter. Returns companies below this value, excluding the value itself.
+        :param market_cap_max: Market cap less than or equal (inclusive)
+        :param eps: Exact earnings-per-share filter. Use it when screening for one EPS value.
+        :param eps_above: EPS lower-bound filter. Returns companies with EPS above this value, excluding the value itself.
+        :param eps_min: EPS greater than or equal (inclusive)
+        :param eps_below: EPS upper-bound filter. Returns companies with EPS below this value, excluding the value itself.
+        :param eps_max: EPS upper-bound filter. Returns companies with EPS less than or equal to this value.
+        :param pe_ratio: Exact price-to-earnings ratio filter. Use it when screening for one valuation value.
+        :param pe_ratio_above: P/E ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
+        :param pe_ratio_min: P/E ratio greater than or equal (inclusive)
+        :param pe_ratio_below: P/E ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param pe_ratio_max: P/E ratio less than or equal (inclusive)
+        :param pb_ratio: Exact price-to-book ratio filter. Use it when screening for one valuation value.
+        :param pb_ratio_above: P/B ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
+        :param pb_ratio_min: P/B ratio greater than or equal (inclusive)
+        :param pb_ratio_below: P/B ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param pb_ratio_max: P/B ratio less than or equal (inclusive)
+        :param ps_ratio: Exact price-to-sales ratio filter. Use it when screening for one valuation value.
+        :param ps_ratio_above: P/S ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
+        :param ps_ratio_min: P/S ratio greater than or equal (inclusive)
+        :param ps_ratio_below: P/S ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param ps_ratio_max: P/S ratio less than or equal (inclusive)
+        :param pcf_ratio: Exact price-to-cash-flow ratio filter. Use it when screening for one valuation value.
+        :param pcf_ratio_above: P/CF ratio greater than (exclusive)
+        :param pcf_ratio_min: P/CF ratio greater than or equal (inclusive)
+        :param pcf_ratio_below: P/CF ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param pcf_ratio_max: P/CF ratio less than or equal (inclusive)
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetFinancialRatiosRequest(
+            ticker=ticker,
+            tickers_any_of=tickers_any_of,
+            ticker_after=ticker_after,
+            ticker_from=ticker_from,
+            ticker_before=ticker_before,
+            ticker_to=ticker_to,
+            cik=cik,
+            ciks=ciks,
+            cik_after=cik_after,
+            cik_from=cik_from,
+            cik_before=cik_before,
+            cik_to=cik_to,
+            price=price,
+            price_above=price_above,
+            price_min=price_min,
+            price_below=price_below,
+            price_max=price_max,
+            average_volume=average_volume,
+            average_volume_above=average_volume_above,
+            average_volume_min=average_volume_min,
+            average_volume_below=average_volume_below,
+            average_volume_max=average_volume_max,
+            market_cap=market_cap,
+            market_cap_above=market_cap_above,
+            market_cap_min=market_cap_min,
+            market_cap_below=market_cap_below,
+            market_cap_max=market_cap_max,
+            eps=eps,
+            eps_above=eps_above,
+            eps_min=eps_min,
+            eps_below=eps_below,
+            eps_max=eps_max,
+            pe_ratio=pe_ratio,
+            pe_ratio_above=pe_ratio_above,
+            pe_ratio_min=pe_ratio_min,
+            pe_ratio_below=pe_ratio_below,
+            pe_ratio_max=pe_ratio_max,
+            pb_ratio=pb_ratio,
+            pb_ratio_above=pb_ratio_above,
+            pb_ratio_min=pb_ratio_min,
+            pb_ratio_below=pb_ratio_below,
+            pb_ratio_max=pb_ratio_max,
+            ps_ratio=ps_ratio,
+            ps_ratio_above=ps_ratio_above,
+            ps_ratio_min=ps_ratio_min,
+            ps_ratio_below=ps_ratio_below,
+            ps_ratio_max=ps_ratio_max,
+            pcf_ratio=pcf_ratio,
+            pcf_ratio_above=pcf_ratio_above,
+            pcf_ratio_min=pcf_ratio_min,
+            pcf_ratio_below=pcf_ratio_below,
+            pcf_ratio_max=pcf_ratio_max,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/ratios",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getFinancialRatios",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetFinancialRatiosResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_financial_ratios(
+                ticker=ticker,
+                tickers_any_of=tickers_any_of,
+                ticker_after=ticker_after,
+                ticker_from=ticker_from,
+                ticker_before=ticker_before,
+                ticker_to=ticker_to,
+                cik=cik,
+                ciks=ciks,
+                cik_after=cik_after,
+                cik_from=cik_from,
+                cik_before=cik_before,
+                cik_to=cik_to,
+                price=price,
+                price_above=price_above,
+                price_min=price_min,
+                price_below=price_below,
+                price_max=price_max,
+                average_volume=average_volume,
+                average_volume_above=average_volume_above,
+                average_volume_min=average_volume_min,
+                average_volume_below=average_volume_below,
+                average_volume_max=average_volume_max,
+                market_cap=market_cap,
+                market_cap_above=market_cap_above,
+                market_cap_min=market_cap_min,
+                market_cap_below=market_cap_below,
+                market_cap_max=market_cap_max,
+                eps=eps,
+                eps_above=eps_above,
+                eps_min=eps_min,
+                eps_below=eps_below,
+                eps_max=eps_max,
+                pe_ratio=pe_ratio,
+                pe_ratio_above=pe_ratio_above,
+                pe_ratio_min=pe_ratio_min,
+                pe_ratio_below=pe_ratio_below,
+                pe_ratio_max=pe_ratio_max,
+                pb_ratio=pb_ratio,
+                pb_ratio_above=pb_ratio_above,
+                pb_ratio_min=pb_ratio_min,
+                pb_ratio_below=pb_ratio_below,
+                pb_ratio_max=pb_ratio_max,
+                ps_ratio=ps_ratio,
+                ps_ratio_above=ps_ratio_above,
+                ps_ratio_min=ps_ratio_min,
+                ps_ratio_below=ps_ratio_below,
+                ps_ratio_max=ps_ratio_max,
+                pcf_ratio=pcf_ratio,
+                pcf_ratio_above=pcf_ratio_above,
+                pcf_ratio_min=pcf_ratio_min,
+                pcf_ratio_below=pcf_ratio_below,
+                pcf_ratio_max=pcf_ratio_max,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetFinancialRatiosResponse(
+                financial_ratios_response=unmarshal_json_response(
+                    Optional[models.FinancialRatiosResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_financial_ratios_async(
+        self,
+        *,
+        ticker: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        ticker_after: Optional[str] = None,
+        ticker_from: Optional[str] = None,
+        ticker_before: Optional[str] = None,
+        ticker_to: Optional[str] = None,
+        cik: Optional[str] = None,
+        ciks: Optional[str] = None,
+        cik_after: Optional[str] = None,
+        cik_from: Optional[str] = None,
+        cik_before: Optional[str] = None,
+        cik_to: Optional[str] = None,
+        price: Optional[float] = None,
+        price_above: Optional[float] = None,
+        price_min: Optional[float] = None,
+        price_below: Optional[float] = None,
+        price_max: Optional[float] = None,
+        average_volume: Optional[float] = None,
+        average_volume_above: Optional[float] = None,
+        average_volume_min: Optional[float] = None,
+        average_volume_below: Optional[float] = None,
+        average_volume_max: Optional[float] = None,
+        market_cap: Optional[float] = None,
+        market_cap_above: Optional[float] = None,
+        market_cap_min: Optional[float] = None,
+        market_cap_below: Optional[float] = None,
+        market_cap_max: Optional[float] = None,
+        eps: Optional[float] = None,
+        eps_above: Optional[float] = None,
+        eps_min: Optional[float] = None,
+        eps_below: Optional[float] = None,
+        eps_max: Optional[float] = None,
+        pe_ratio: Optional[float] = None,
+        pe_ratio_above: Optional[float] = None,
+        pe_ratio_min: Optional[float] = None,
+        pe_ratio_below: Optional[float] = None,
+        pe_ratio_max: Optional[float] = None,
+        pb_ratio: Optional[float] = None,
+        pb_ratio_above: Optional[float] = None,
+        pb_ratio_min: Optional[float] = None,
+        pb_ratio_below: Optional[float] = None,
+        pb_ratio_max: Optional[float] = None,
+        ps_ratio: Optional[float] = None,
+        ps_ratio_above: Optional[float] = None,
+        ps_ratio_min: Optional[float] = None,
+        ps_ratio_below: Optional[float] = None,
+        ps_ratio_max: Optional[float] = None,
+        pcf_ratio: Optional[float] = None,
+        pcf_ratio_above: Optional[float] = None,
+        pcf_ratio_min: Optional[float] = None,
+        pcf_ratio_below: Optional[float] = None,
+        pcf_ratio_max: Optional[float] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetFinancialRatiosResponse]:
+        r"""Get Financial Ratios
+
+        Retrieve comprehensive financial ratios including liquidity, profitability, leverage, and efficiency metrics for fundamental analysis. `ticker` accepts a single symbol only. Use `tickersAnyOf` for multiple symbols. If `ticker` contains multiple comma-separated values, the API returns 400: \"Multiple tickers are not supported. Please provide a single ticker.\" If both `ticker` and `tickersAnyOf` are set, the API returns 400: \"Cannot specify both ticker and tickersAnyOf. Use ticker for a single symbol or tickersAnyOf for multiple.\"
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param ticker: Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company.
+        :param tickers_any_of: Comma-separated list of ticker symbols.
+        :param ticker_after: Ticker pagination lower bound. Returns symbols alphabetically after this ticker, excluding the ticker itself.
+        :param ticker_from: Ticker greater than or equal (inclusive)
+        :param ticker_before: Ticker pagination upper bound. Returns symbols alphabetically before this ticker, excluding the ticker itself.
+        :param ticker_to: Ticker less than or equal (inclusive)
+        :param cik: CIK company identifier from the SEC. Use this when filtering by SEC registrant instead of ticker.
+        :param ciks: Comma-separated SEC CIK identifiers. Use this to filter several registrants in one request.
+        :param cik_after: CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
+        :param cik_from: CIK greater than or equal (inclusive)
+        :param cik_before: CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
+        :param cik_to: CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
+        :param price: Exact price filter. Use it when you need records matching one specific price value.
+        :param price_above: Price lower-bound filter. Returns records above this value, excluding the value itself.
+        :param price_min: Price greater than or equal (inclusive)
+        :param price_below: Price upper-bound filter. Returns records below this value, excluding the value itself.
+        :param price_max: Price less than or equal (inclusive)
+        :param average_volume: Exact average-volume filter. Use it when screening for one specific average volume value.
+        :param average_volume_above: Average volume greater than (exclusive)
+        :param average_volume_min: Average volume greater than or equal (inclusive)
+        :param average_volume_below: Average volume less than (exclusive)
+        :param average_volume_max: Average volume less than or equal (inclusive)
+        :param market_cap: Exact market-cap filter. Use it when screening for one specific company size value.
+        :param market_cap_above: Market cap greater than (exclusive)
+        :param market_cap_min: Market cap greater than or equal (inclusive)
+        :param market_cap_below: Market-cap upper-bound filter. Returns companies below this value, excluding the value itself.
+        :param market_cap_max: Market cap less than or equal (inclusive)
+        :param eps: Exact earnings-per-share filter. Use it when screening for one EPS value.
+        :param eps_above: EPS lower-bound filter. Returns companies with EPS above this value, excluding the value itself.
+        :param eps_min: EPS greater than or equal (inclusive)
+        :param eps_below: EPS upper-bound filter. Returns companies with EPS below this value, excluding the value itself.
+        :param eps_max: EPS upper-bound filter. Returns companies with EPS less than or equal to this value.
+        :param pe_ratio: Exact price-to-earnings ratio filter. Use it when screening for one valuation value.
+        :param pe_ratio_above: P/E ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
+        :param pe_ratio_min: P/E ratio greater than or equal (inclusive)
+        :param pe_ratio_below: P/E ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param pe_ratio_max: P/E ratio less than or equal (inclusive)
+        :param pb_ratio: Exact price-to-book ratio filter. Use it when screening for one valuation value.
+        :param pb_ratio_above: P/B ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
+        :param pb_ratio_min: P/B ratio greater than or equal (inclusive)
+        :param pb_ratio_below: P/B ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param pb_ratio_max: P/B ratio less than or equal (inclusive)
+        :param ps_ratio: Exact price-to-sales ratio filter. Use it when screening for one valuation value.
+        :param ps_ratio_above: P/S ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
+        :param ps_ratio_min: P/S ratio greater than or equal (inclusive)
+        :param ps_ratio_below: P/S ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param ps_ratio_max: P/S ratio less than or equal (inclusive)
+        :param pcf_ratio: Exact price-to-cash-flow ratio filter. Use it when screening for one valuation value.
+        :param pcf_ratio_above: P/CF ratio greater than (exclusive)
+        :param pcf_ratio_min: P/CF ratio greater than or equal (inclusive)
+        :param pcf_ratio_below: P/CF ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
+        :param pcf_ratio_max: P/CF ratio less than or equal (inclusive)
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetFinancialRatiosRequest(
+            ticker=ticker,
+            tickers_any_of=tickers_any_of,
+            ticker_after=ticker_after,
+            ticker_from=ticker_from,
+            ticker_before=ticker_before,
+            ticker_to=ticker_to,
+            cik=cik,
+            ciks=ciks,
+            cik_after=cik_after,
+            cik_from=cik_from,
+            cik_before=cik_before,
+            cik_to=cik_to,
+            price=price,
+            price_above=price_above,
+            price_min=price_min,
+            price_below=price_below,
+            price_max=price_max,
+            average_volume=average_volume,
+            average_volume_above=average_volume_above,
+            average_volume_min=average_volume_min,
+            average_volume_below=average_volume_below,
+            average_volume_max=average_volume_max,
+            market_cap=market_cap,
+            market_cap_above=market_cap_above,
+            market_cap_min=market_cap_min,
+            market_cap_below=market_cap_below,
+            market_cap_max=market_cap_max,
+            eps=eps,
+            eps_above=eps_above,
+            eps_min=eps_min,
+            eps_below=eps_below,
+            eps_max=eps_max,
+            pe_ratio=pe_ratio,
+            pe_ratio_above=pe_ratio_above,
+            pe_ratio_min=pe_ratio_min,
+            pe_ratio_below=pe_ratio_below,
+            pe_ratio_max=pe_ratio_max,
+            pb_ratio=pb_ratio,
+            pb_ratio_above=pb_ratio_above,
+            pb_ratio_min=pb_ratio_min,
+            pb_ratio_below=pb_ratio_below,
+            pb_ratio_max=pb_ratio_max,
+            ps_ratio=ps_ratio,
+            ps_ratio_above=ps_ratio_above,
+            ps_ratio_min=ps_ratio_min,
+            ps_ratio_below=ps_ratio_below,
+            ps_ratio_max=ps_ratio_max,
+            pcf_ratio=pcf_ratio,
+            pcf_ratio_above=pcf_ratio_above,
+            pcf_ratio_min=pcf_ratio_min,
+            pcf_ratio_below=pcf_ratio_below,
+            pcf_ratio_max=pcf_ratio_max,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/ratios",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getFinancialRatios",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetFinancialRatiosResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_financial_ratios(
+                ticker=ticker,
+                tickers_any_of=tickers_any_of,
+                ticker_after=ticker_after,
+                ticker_from=ticker_from,
+                ticker_before=ticker_before,
+                ticker_to=ticker_to,
+                cik=cik,
+                ciks=ciks,
+                cik_after=cik_after,
+                cik_from=cik_from,
+                cik_before=cik_before,
+                cik_to=cik_to,
+                price=price,
+                price_above=price_above,
+                price_min=price_min,
+                price_below=price_below,
+                price_max=price_max,
+                average_volume=average_volume,
+                average_volume_above=average_volume_above,
+                average_volume_min=average_volume_min,
+                average_volume_below=average_volume_below,
+                average_volume_max=average_volume_max,
+                market_cap=market_cap,
+                market_cap_above=market_cap_above,
+                market_cap_min=market_cap_min,
+                market_cap_below=market_cap_below,
+                market_cap_max=market_cap_max,
+                eps=eps,
+                eps_above=eps_above,
+                eps_min=eps_min,
+                eps_below=eps_below,
+                eps_max=eps_max,
+                pe_ratio=pe_ratio,
+                pe_ratio_above=pe_ratio_above,
+                pe_ratio_min=pe_ratio_min,
+                pe_ratio_below=pe_ratio_below,
+                pe_ratio_max=pe_ratio_max,
+                pb_ratio=pb_ratio,
+                pb_ratio_above=pb_ratio_above,
+                pb_ratio_min=pb_ratio_min,
+                pb_ratio_below=pb_ratio_below,
+                pb_ratio_max=pb_ratio_max,
+                ps_ratio=ps_ratio,
+                ps_ratio_above=ps_ratio_above,
+                ps_ratio_min=ps_ratio_min,
+                ps_ratio_below=ps_ratio_below,
+                ps_ratio_max=ps_ratio_max,
+                pcf_ratio=pcf_ratio,
+                pcf_ratio_above=pcf_ratio_above,
+                pcf_ratio_min=pcf_ratio_min,
+                pcf_ratio_below=pcf_ratio_below,
+                pcf_ratio_max=pcf_ratio_max,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetFinancialRatiosResponse(
+                financial_ratios_response=unmarshal_json_response(
+                    Optional[models.FinancialRatiosResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def get_reported_financials(
+        self,
+        *,
+        symbol: Optional[str] = None,
+        cik: Optional[str] = None,
+        access_number: Optional[str] = None,
+        freq: Optional[models.ReportingFrequency] = None,
+        from_: Optional[date] = None,
+        to: Optional[date] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetReportedFinancialsResponse:
+        r"""Get Reported Financials
+
+        Retrieve as-reported financial data from company filings. At least one of `symbol`, `cik`, or `accessNumber` is required. Optional filters: `freq`, `from`, and `to`.
+
+        At least one of symbol, cik, or accessNumber is required. Multiple identifiers are accepted.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param symbol: Stock symbol, such as AAPL. Use it to narrow results to one company. Required when both `cik` and `accessNumber` are omitted.
+        :param cik: SEC CIK. Optional when `symbol` or `accessNumber` is provided.
+        :param access_number: SEC access number. Optional when `symbol` or `cik` is provided.
+        :param freq: Optional reporting frequency filter. Use it to limit results to annual or quarterly reports.
+        :param from_: Optional start date in YYYY-MM-DD format. Use it to begin the research window.
+        :param to: Optional end date in YYYY-MM-DD format. Use it to end the research window.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetReportedFinancialsRequest(
+            symbol=symbol,
+            cik=cik,
+            access_number=access_number,
+            freq=freq,
+            from_=from_,
+            to=to,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/reported",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getReportedFinancials",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetReportedFinancialsResponse(
+                financials_reported_response=unmarshal_json_response(
+                    Optional[models.FinancialsReportedResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_reported_financials_async(
+        self,
+        *,
+        symbol: Optional[str] = None,
+        cik: Optional[str] = None,
+        access_number: Optional[str] = None,
+        freq: Optional[models.ReportingFrequency] = None,
+        from_: Optional[date] = None,
+        to: Optional[date] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetReportedFinancialsResponse:
+        r"""Get Reported Financials
+
+        Retrieve as-reported financial data from company filings. At least one of `symbol`, `cik`, or `accessNumber` is required. Optional filters: `freq`, `from`, and `to`.
+
+        At least one of symbol, cik, or accessNumber is required. Multiple identifiers are accepted.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param symbol: Stock symbol, such as AAPL. Use it to narrow results to one company. Required when both `cik` and `accessNumber` are omitted.
+        :param cik: SEC CIK. Optional when `symbol` or `accessNumber` is provided.
+        :param access_number: SEC access number. Optional when `symbol` or `cik` is provided.
+        :param freq: Optional reporting frequency filter. Use it to limit results to annual or quarterly reports.
+        :param from_: Optional start date in YYYY-MM-DD format. Use it to begin the research window.
+        :param to: Optional end date in YYYY-MM-DD format. Use it to end the research window.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetReportedFinancialsRequest(
+            symbol=symbol,
+            cik=cik,
+            access_number=access_number,
+            freq=freq,
+            from_=from_,
+            to=to,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/reported",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getReportedFinancials",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetReportedFinancialsResponse(
+                financials_reported_response=unmarshal_json_response(
+                    Optional[models.FinancialsReportedResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def get_revenue_breakdown(
+        self,
+        *,
+        symbol: Optional[str] = None,
+        cik: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetRevenueBreakdownResponse:
+        r"""Get Revenue Breakdown
+
+        Retrieve revenue segmentation by product, geography, or business unit. Provide at least one of `symbol` or `cik`.
+
+        At least one of symbol or cik is required; both are accepted.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param symbol: Stock ticker symbol to research, such as AAPL. Required when `cik` is omitted.
+        :param cik: SEC CIK. Optional when `symbol` is provided.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetRevenueBreakdownRequest(
+            symbol=symbol,
+            cik=cik,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/revenue-breakdown",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getRevenueBreakdown",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetRevenueBreakdownResponse(
+                financials_revenue_breakdown_response=unmarshal_json_response(
+                    Optional[models.FinancialsRevenueBreakdownResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_revenue_breakdown_async(
+        self,
+        *,
+        symbol: Optional[str] = None,
+        cik: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetRevenueBreakdownResponse:
+        r"""Get Revenue Breakdown
+
+        Retrieve revenue segmentation by product, geography, or business unit. Provide at least one of `symbol` or `cik`.
+
+        At least one of symbol or cik is required; both are accepted.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param symbol: Stock ticker symbol to research, such as AAPL. Required when `cik` is omitted.
+        :param cik: SEC CIK. Optional when `symbol` is provided.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetRevenueBreakdownRequest(
+            symbol=symbol,
+            cik=cik,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/revenue-breakdown",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getRevenueBreakdown",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetRevenueBreakdownResponse(
+                financials_revenue_breakdown_response=unmarshal_json_response(
+                    Optional[models.FinancialsRevenueBreakdownResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def get_short_interest(
+        self,
+        *,
+        ticker: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        ticker_after: Optional[str] = None,
+        ticker_from: Optional[str] = None,
+        ticker_before: Optional[str] = None,
+        ticker_to: Optional[str] = None,
+        days_to_cover: Optional[float] = None,
+        days_to_cover_list: Optional[str] = None,
+        days_to_cover_above: Optional[float] = None,
+        days_to_cover_min: Optional[float] = None,
+        days_to_cover_below: Optional[float] = None,
+        days_to_cover_max: Optional[float] = None,
+        settlement_date: Optional[date] = None,
+        settlement_dates: Optional[str] = None,
+        settlement_date_after: Optional[date] = None,
+        settlement_date_from: Optional[date] = None,
+        settlement_date_before: Optional[date] = None,
+        settlement_date_to: Optional[date] = None,
+        avg_daily_volume: Optional[int] = None,
+        avg_daily_volume_list: Optional[str] = None,
+        avg_daily_volume_above: Optional[int] = None,
+        avg_daily_volume_min: Optional[int] = None,
+        avg_daily_volume_below: Optional[int] = None,
+        avg_daily_volume_max: Optional[int] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetShortInterestResponse]:
+        r"""Get Short Interest Data
+
+        Retrieve short interest statistics including short volume, short ratio, and days to cover for assessing bearish sentiment. `ticker` accepts a single symbol only. Use `tickersAnyOf` for multiple symbols. If `ticker` contains multiple comma-separated values, the API returns 400: \"Multiple tickers are not supported. Please provide a single ticker.\" If both `ticker` and `tickersAnyOf` are set, the API returns 400: \"Cannot specify both ticker and tickersAnyOf. Use ticker for a single symbol or tickersAnyOf for multiple.\"
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param ticker: Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company.
+        :param tickers_any_of: Comma-separated list of ticker symbols.
+        :param ticker_after: Ticker pagination lower bound. Returns symbols alphabetically after this ticker, excluding the ticker itself.
+        :param ticker_from: Ticker greater than or equal (inclusive)
+        :param ticker_before: Ticker pagination upper bound. Returns symbols alphabetically before this ticker, excluding the ticker itself.
+        :param ticker_to: Ticker less than or equal (inclusive)
+        :param days_to_cover: Exact days-to-cover filter for short interest. Use it when screening for one short-squeeze risk value.
+        :param days_to_cover_list: Comma-separated list of days to cover
+        :param days_to_cover_above: Days to cover greater than (exclusive)
+        :param days_to_cover_min: Days to cover greater than or equal (inclusive)
+        :param days_to_cover_below: Days to cover less than (exclusive)
+        :param days_to_cover_max: Days to cover less than or equal (inclusive)
+        :param settlement_date: Settlement date in YYYY-MM-DD format. Use it to filter short-interest records by reporting settlement date.
+        :param settlement_dates: Comma-separated list of settlement dates
+        :param settlement_date_after: Settlement-date lower-bound filter. Returns records after this date, excluding the date itself.
+        :param settlement_date_from: Settlement-date start filter. Returns records on or after this date.
+        :param settlement_date_before: Settlement-date upper-bound filter. Returns records before this date, excluding the date itself.
+        :param settlement_date_to: Settlement-date end filter. Returns records on or before this date.
+        :param avg_daily_volume: Exact average-daily-volume filter. Use it when screening for one specific liquidity value.
+        :param avg_daily_volume_list: Comma-separated list of average daily volumes
+        :param avg_daily_volume_above: Average daily volume greater than (exclusive)
+        :param avg_daily_volume_min: Average daily volume greater than or equal (inclusive)
+        :param avg_daily_volume_below: Average daily volume less than (exclusive)
+        :param avg_daily_volume_max: Average daily volume less than or equal (inclusive)
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetShortInterestRequest(
+            ticker=ticker,
+            tickers_any_of=tickers_any_of,
+            ticker_after=ticker_after,
+            ticker_from=ticker_from,
+            ticker_before=ticker_before,
+            ticker_to=ticker_to,
+            days_to_cover=days_to_cover,
+            days_to_cover_list=days_to_cover_list,
+            days_to_cover_above=days_to_cover_above,
+            days_to_cover_min=days_to_cover_min,
+            days_to_cover_below=days_to_cover_below,
+            days_to_cover_max=days_to_cover_max,
+            settlement_date=settlement_date,
+            settlement_dates=settlement_dates,
+            settlement_date_after=settlement_date_after,
+            settlement_date_from=settlement_date_from,
+            settlement_date_before=settlement_date_before,
+            settlement_date_to=settlement_date_to,
+            avg_daily_volume=avg_daily_volume,
+            avg_daily_volume_list=avg_daily_volume_list,
+            avg_daily_volume_above=avg_daily_volume_above,
+            avg_daily_volume_min=avg_daily_volume_min,
+            avg_daily_volume_below=avg_daily_volume_below,
+            avg_daily_volume_max=avg_daily_volume_max,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/short-interest",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getShortInterest",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetShortInterestResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_short_interest(
+                ticker=ticker,
+                tickers_any_of=tickers_any_of,
+                ticker_after=ticker_after,
+                ticker_from=ticker_from,
+                ticker_before=ticker_before,
+                ticker_to=ticker_to,
+                days_to_cover=days_to_cover,
+                days_to_cover_list=days_to_cover_list,
+                days_to_cover_above=days_to_cover_above,
+                days_to_cover_min=days_to_cover_min,
+                days_to_cover_below=days_to_cover_below,
+                days_to_cover_max=days_to_cover_max,
+                settlement_date=settlement_date,
+                settlement_dates=settlement_dates,
+                settlement_date_after=settlement_date_after,
+                settlement_date_from=settlement_date_from,
+                settlement_date_before=settlement_date_before,
+                settlement_date_to=settlement_date_to,
+                avg_daily_volume=avg_daily_volume,
+                avg_daily_volume_list=avg_daily_volume_list,
+                avg_daily_volume_above=avg_daily_volume_above,
+                avg_daily_volume_min=avg_daily_volume_min,
+                avg_daily_volume_below=avg_daily_volume_below,
+                avg_daily_volume_max=avg_daily_volume_max,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetShortInterestResponse(
+                short_interest_response=unmarshal_json_response(
+                    Optional[models.ShortInterestResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_short_interest_async(
+        self,
+        *,
+        ticker: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        ticker_after: Optional[str] = None,
+        ticker_from: Optional[str] = None,
+        ticker_before: Optional[str] = None,
+        ticker_to: Optional[str] = None,
+        days_to_cover: Optional[float] = None,
+        days_to_cover_list: Optional[str] = None,
+        days_to_cover_above: Optional[float] = None,
+        days_to_cover_min: Optional[float] = None,
+        days_to_cover_below: Optional[float] = None,
+        days_to_cover_max: Optional[float] = None,
+        settlement_date: Optional[date] = None,
+        settlement_dates: Optional[str] = None,
+        settlement_date_after: Optional[date] = None,
+        settlement_date_from: Optional[date] = None,
+        settlement_date_before: Optional[date] = None,
+        settlement_date_to: Optional[date] = None,
+        avg_daily_volume: Optional[int] = None,
+        avg_daily_volume_list: Optional[str] = None,
+        avg_daily_volume_above: Optional[int] = None,
+        avg_daily_volume_min: Optional[int] = None,
+        avg_daily_volume_below: Optional[int] = None,
+        avg_daily_volume_max: Optional[int] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetShortInterestResponse]:
+        r"""Get Short Interest Data
+
+        Retrieve short interest statistics including short volume, short ratio, and days to cover for assessing bearish sentiment. `ticker` accepts a single symbol only. Use `tickersAnyOf` for multiple symbols. If `ticker` contains multiple comma-separated values, the API returns 400: \"Multiple tickers are not supported. Please provide a single ticker.\" If both `ticker` and `tickersAnyOf` are set, the API returns 400: \"Cannot specify both ticker and tickersAnyOf. Use ticker for a single symbol or tickersAnyOf for multiple.\"
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param ticker: Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company.
+        :param tickers_any_of: Comma-separated list of ticker symbols.
+        :param ticker_after: Ticker pagination lower bound. Returns symbols alphabetically after this ticker, excluding the ticker itself.
+        :param ticker_from: Ticker greater than or equal (inclusive)
+        :param ticker_before: Ticker pagination upper bound. Returns symbols alphabetically before this ticker, excluding the ticker itself.
+        :param ticker_to: Ticker less than or equal (inclusive)
+        :param days_to_cover: Exact days-to-cover filter for short interest. Use it when screening for one short-squeeze risk value.
+        :param days_to_cover_list: Comma-separated list of days to cover
+        :param days_to_cover_above: Days to cover greater than (exclusive)
+        :param days_to_cover_min: Days to cover greater than or equal (inclusive)
+        :param days_to_cover_below: Days to cover less than (exclusive)
+        :param days_to_cover_max: Days to cover less than or equal (inclusive)
+        :param settlement_date: Settlement date in YYYY-MM-DD format. Use it to filter short-interest records by reporting settlement date.
+        :param settlement_dates: Comma-separated list of settlement dates
+        :param settlement_date_after: Settlement-date lower-bound filter. Returns records after this date, excluding the date itself.
+        :param settlement_date_from: Settlement-date start filter. Returns records on or after this date.
+        :param settlement_date_before: Settlement-date upper-bound filter. Returns records before this date, excluding the date itself.
+        :param settlement_date_to: Settlement-date end filter. Returns records on or before this date.
+        :param avg_daily_volume: Exact average-daily-volume filter. Use it when screening for one specific liquidity value.
+        :param avg_daily_volume_list: Comma-separated list of average daily volumes
+        :param avg_daily_volume_above: Average daily volume greater than (exclusive)
+        :param avg_daily_volume_min: Average daily volume greater than or equal (inclusive)
+        :param avg_daily_volume_below: Average daily volume less than (exclusive)
+        :param avg_daily_volume_max: Average daily volume less than or equal (inclusive)
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetShortInterestRequest(
+            ticker=ticker,
+            tickers_any_of=tickers_any_of,
+            ticker_after=ticker_after,
+            ticker_from=ticker_from,
+            ticker_before=ticker_before,
+            ticker_to=ticker_to,
+            days_to_cover=days_to_cover,
+            days_to_cover_list=days_to_cover_list,
+            days_to_cover_above=days_to_cover_above,
+            days_to_cover_min=days_to_cover_min,
+            days_to_cover_below=days_to_cover_below,
+            days_to_cover_max=days_to_cover_max,
+            settlement_date=settlement_date,
+            settlement_dates=settlement_dates,
+            settlement_date_after=settlement_date_after,
+            settlement_date_from=settlement_date_from,
+            settlement_date_before=settlement_date_before,
+            settlement_date_to=settlement_date_to,
+            avg_daily_volume=avg_daily_volume,
+            avg_daily_volume_list=avg_daily_volume_list,
+            avg_daily_volume_above=avg_daily_volume_above,
+            avg_daily_volume_min=avg_daily_volume_min,
+            avg_daily_volume_below=avg_daily_volume_below,
+            avg_daily_volume_max=avg_daily_volume_max,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/short-interest",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getShortInterest",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetShortInterestResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_short_interest(
+                ticker=ticker,
+                tickers_any_of=tickers_any_of,
+                ticker_after=ticker_after,
+                ticker_from=ticker_from,
+                ticker_before=ticker_before,
+                ticker_to=ticker_to,
+                days_to_cover=days_to_cover,
+                days_to_cover_list=days_to_cover_list,
+                days_to_cover_above=days_to_cover_above,
+                days_to_cover_min=days_to_cover_min,
+                days_to_cover_below=days_to_cover_below,
+                days_to_cover_max=days_to_cover_max,
+                settlement_date=settlement_date,
+                settlement_dates=settlement_dates,
+                settlement_date_after=settlement_date_after,
+                settlement_date_from=settlement_date_from,
+                settlement_date_before=settlement_date_before,
+                settlement_date_to=settlement_date_to,
+                avg_daily_volume=avg_daily_volume,
+                avg_daily_volume_list=avg_daily_volume_list,
+                avg_daily_volume_above=avg_daily_volume_above,
+                avg_daily_volume_min=avg_daily_volume_min,
+                avg_daily_volume_below=avg_daily_volume_below,
+                avg_daily_volume_max=avg_daily_volume_max,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetShortInterestResponse(
+                short_interest_response=unmarshal_json_response(
+                    Optional[models.ShortInterestResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def get_short_volume(
+        self,
+        *,
+        ticker: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        ticker_after: Optional[str] = None,
+        ticker_from: Optional[str] = None,
+        ticker_before: Optional[str] = None,
+        ticker_to: Optional[str] = None,
+        date_: Optional[date] = None,
+        dates: Optional[str] = None,
+        date_after: Optional[date] = None,
+        date_from: Optional[date] = None,
+        date_before: Optional[date] = None,
+        date_to: Optional[date] = None,
+        short_volume_ratio: Optional[float] = None,
+        short_volume_ratio_list: Optional[str] = None,
+        short_volume_ratio_above: Optional[float] = None,
+        short_volume_ratio_min: Optional[float] = None,
+        short_volume_ratio_below: Optional[float] = None,
+        short_volume_ratio_max: Optional[float] = None,
+        total_volume: Optional[int] = None,
+        total_volume_list: Optional[str] = None,
+        total_volume_above: Optional[int] = None,
+        total_volume_min: Optional[int] = None,
+        total_volume_below: Optional[int] = None,
+        total_volume_max: Optional[int] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetShortVolumeResponse]:
+        r"""Get Short Volume Data
+
+        Retrieve daily short volume data showing the number of shares sold short and overall short selling activity. `ticker` accepts a single symbol only. Use `tickersAnyOf` for multiple symbols. If `ticker` contains multiple comma-separated values, the API returns 400: \"Multiple tickers are not supported. Please provide a single ticker.\" If both `ticker` and `tickersAnyOf` are set, the API returns 400: \"Cannot specify both ticker and tickersAnyOf. Use ticker for a single symbol or tickersAnyOf for multiple.\"
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param ticker: Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company.
+        :param tickers_any_of: Comma-separated list of ticker symbols.
+        :param ticker_after: Ticker pagination lower bound. Returns symbols alphabetically after this ticker, excluding the ticker itself.
+        :param ticker_from: Ticker greater than or equal (inclusive)
+        :param ticker_before: Ticker pagination upper bound. Returns symbols alphabetically before this ticker, excluding the ticker itself.
+        :param ticker_to: Ticker less than or equal (inclusive)
+        :param date_: Exact date in YYYY-MM-DD format. Use this when you want one specific calendar day.
+        :param dates: Comma-separated list of dates in YYYY-MM-DD format. Use this when you want several specific dates in one request.
+        :param date_after: After-date filter. Returns records after this date, excluding the date itself.
+        :param date_from: Start-date filter. Returns records on or after this date.
+        :param date_before: Before-date filter. Returns records before this date, excluding the date itself.
+        :param date_to: End-date filter. Returns records on or before this date.
+        :param short_volume_ratio: Exact short-volume ratio filter. Use it when you need records matching one specific ratio value.
+        :param short_volume_ratio_list: Comma-separated list of short volume ratios
+        :param short_volume_ratio_above: Short volume ratio greater than (exclusive)
+        :param short_volume_ratio_min: Short volume ratio greater than or equal (inclusive)
+        :param short_volume_ratio_below: Short volume ratio less than (exclusive)
+        :param short_volume_ratio_max: Short volume ratio less than or equal (inclusive)
+        :param total_volume: Exact total-volume filter. Use it when you need records matching one specific volume value.
+        :param total_volume_list: Comma-separated list of total volumes
+        :param total_volume_above: Total volume greater than (exclusive)
+        :param total_volume_min: Total volume greater than or equal (inclusive)
+        :param total_volume_below: Total-volume upper-bound filter. Returns records below this value, excluding the value itself.
+        :param total_volume_max: Total volume less than or equal (inclusive)
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetShortVolumeRequest(
+            ticker=ticker,
+            tickers_any_of=tickers_any_of,
+            ticker_after=ticker_after,
+            ticker_from=ticker_from,
+            ticker_before=ticker_before,
+            ticker_to=ticker_to,
+            date_=date_,
+            dates=dates,
+            date_after=date_after,
+            date_from=date_from,
+            date_before=date_before,
+            date_to=date_to,
+            short_volume_ratio=short_volume_ratio,
+            short_volume_ratio_list=short_volume_ratio_list,
+            short_volume_ratio_above=short_volume_ratio_above,
+            short_volume_ratio_min=short_volume_ratio_min,
+            short_volume_ratio_below=short_volume_ratio_below,
+            short_volume_ratio_max=short_volume_ratio_max,
+            total_volume=total_volume,
+            total_volume_list=total_volume_list,
+            total_volume_above=total_volume_above,
+            total_volume_min=total_volume_min,
+            total_volume_below=total_volume_below,
+            total_volume_max=total_volume_max,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/short-volume",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getShortVolume",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetShortVolumeResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_short_volume(
+                ticker=ticker,
+                tickers_any_of=tickers_any_of,
+                ticker_after=ticker_after,
+                ticker_from=ticker_from,
+                ticker_before=ticker_before,
+                ticker_to=ticker_to,
+                date_=date_,
+                dates=dates,
+                date_after=date_after,
+                date_from=date_from,
+                date_before=date_before,
+                date_to=date_to,
+                short_volume_ratio=short_volume_ratio,
+                short_volume_ratio_list=short_volume_ratio_list,
+                short_volume_ratio_above=short_volume_ratio_above,
+                short_volume_ratio_min=short_volume_ratio_min,
+                short_volume_ratio_below=short_volume_ratio_below,
+                short_volume_ratio_max=short_volume_ratio_max,
+                total_volume=total_volume,
+                total_volume_list=total_volume_list,
+                total_volume_above=total_volume_above,
+                total_volume_min=total_volume_min,
+                total_volume_below=total_volume_below,
+                total_volume_max=total_volume_max,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetShortVolumeResponse(
+                short_volume_response=unmarshal_json_response(
+                    Optional[models.ShortVolumeResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_short_volume_async(
+        self,
+        *,
+        ticker: Optional[str] = None,
+        tickers_any_of: Optional[str] = None,
+        ticker_after: Optional[str] = None,
+        ticker_from: Optional[str] = None,
+        ticker_before: Optional[str] = None,
+        ticker_to: Optional[str] = None,
+        date_: Optional[date] = None,
+        dates: Optional[str] = None,
+        date_after: Optional[date] = None,
+        date_from: Optional[date] = None,
+        date_before: Optional[date] = None,
+        date_to: Optional[date] = None,
+        short_volume_ratio: Optional[float] = None,
+        short_volume_ratio_list: Optional[str] = None,
+        short_volume_ratio_above: Optional[float] = None,
+        short_volume_ratio_min: Optional[float] = None,
+        short_volume_ratio_below: Optional[float] = None,
+        short_volume_ratio_max: Optional[float] = None,
+        total_volume: Optional[int] = None,
+        total_volume_list: Optional[str] = None,
+        total_volume_above: Optional[int] = None,
+        total_volume_min: Optional[int] = None,
+        total_volume_below: Optional[int] = None,
+        total_volume_max: Optional[int] = None,
+        limit: Optional[int] = None,
+        sort: Optional[str] = None,
+        next: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        url_override: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> Optional[models.GetShortVolumeResponse]:
+        r"""Get Short Volume Data
+
+        Retrieve daily short volume data showing the number of shares sold short and overall short selling activity. `ticker` accepts a single symbol only. Use `tickersAnyOf` for multiple symbols. If `ticker` contains multiple comma-separated values, the API returns 400: \"Multiple tickers are not supported. Please provide a single ticker.\" If both `ticker` and `tickersAnyOf` are set, the API returns 400: \"Cannot specify both ticker and tickersAnyOf. Use ticker for a single symbol or tickersAnyOf for multiple.\"
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param ticker: Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company.
+        :param tickers_any_of: Comma-separated list of ticker symbols.
+        :param ticker_after: Ticker pagination lower bound. Returns symbols alphabetically after this ticker, excluding the ticker itself.
+        :param ticker_from: Ticker greater than or equal (inclusive)
+        :param ticker_before: Ticker pagination upper bound. Returns symbols alphabetically before this ticker, excluding the ticker itself.
+        :param ticker_to: Ticker less than or equal (inclusive)
+        :param date_: Exact date in YYYY-MM-DD format. Use this when you want one specific calendar day.
+        :param dates: Comma-separated list of dates in YYYY-MM-DD format. Use this when you want several specific dates in one request.
+        :param date_after: After-date filter. Returns records after this date, excluding the date itself.
+        :param date_from: Start-date filter. Returns records on or after this date.
+        :param date_before: Before-date filter. Returns records before this date, excluding the date itself.
+        :param date_to: End-date filter. Returns records on or before this date.
+        :param short_volume_ratio: Exact short-volume ratio filter. Use it when you need records matching one specific ratio value.
+        :param short_volume_ratio_list: Comma-separated list of short volume ratios
+        :param short_volume_ratio_above: Short volume ratio greater than (exclusive)
+        :param short_volume_ratio_min: Short volume ratio greater than or equal (inclusive)
+        :param short_volume_ratio_below: Short volume ratio less than (exclusive)
+        :param short_volume_ratio_max: Short volume ratio less than or equal (inclusive)
+        :param total_volume: Exact total-volume filter. Use it when you need records matching one specific volume value.
+        :param total_volume_list: Comma-separated list of total volumes
+        :param total_volume_above: Total volume greater than (exclusive)
+        :param total_volume_min: Total volume greater than or equal (inclusive)
+        :param total_volume_below: Total-volume upper-bound filter. Returns records below this value, excluding the value itself.
+        :param total_volume_max: Total volume less than or equal (inclusive)
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.
+        :param sort: A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified.
+        :param next: Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetShortVolumeRequest(
+            ticker=ticker,
+            tickers_any_of=tickers_any_of,
+            ticker_after=ticker_after,
+            ticker_from=ticker_from,
+            ticker_before=ticker_before,
+            ticker_to=ticker_to,
+            date_=date_,
+            dates=dates,
+            date_after=date_after,
+            date_from=date_from,
+            date_before=date_before,
+            date_to=date_to,
+            short_volume_ratio=short_volume_ratio,
+            short_volume_ratio_list=short_volume_ratio_list,
+            short_volume_ratio_above=short_volume_ratio_above,
+            short_volume_ratio_min=short_volume_ratio_min,
+            short_volume_ratio_below=short_volume_ratio_below,
+            short_volume_ratio_max=short_volume_ratio_max,
+            total_volume=total_volume,
+            total_volume_list=total_volume_list,
+            total_volume_above=total_volume_above,
+            total_volume_min=total_volume_min,
+            total_volume_below=total_volume_below,
+            total_volume_max=total_volume_max,
+            limit=limit,
+            sort=sort,
+            next=next,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/short-volume",
+            base_url=base_url,
+            url_variables=url_variables,
+            url_override=url_override,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getShortVolume",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        def next_func() -> Optional[models.GetShortVolumeResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            next_url_match = JSONPath("$.nextUrl").parse(body)
+            if len(next_url_match) == 0:
+                return None
+
+            next_url = next_url_match[0]
+            if not next_url:
+                return None
+
+            if next_url[0] == "/":
+                url = self._get_url(base_url, url_variables)
+                next_url = url + next_url
+
+            return self.get_short_volume(
+                ticker=ticker,
+                tickers_any_of=tickers_any_of,
+                ticker_after=ticker_after,
+                ticker_from=ticker_from,
+                ticker_before=ticker_before,
+                ticker_to=ticker_to,
+                date_=date_,
+                dates=dates,
+                date_after=date_after,
+                date_from=date_from,
+                date_before=date_before,
+                date_to=date_to,
+                short_volume_ratio=short_volume_ratio,
+                short_volume_ratio_list=short_volume_ratio_list,
+                short_volume_ratio_above=short_volume_ratio_above,
+                short_volume_ratio_min=short_volume_ratio_min,
+                short_volume_ratio_below=short_volume_ratio_below,
+                short_volume_ratio_max=short_volume_ratio_max,
+                total_volume=total_volume,
+                total_volume_list=total_volume_list,
+                total_volume_above=total_volume_above,
+                total_volume_min=total_volume_min,
+                total_volume_below=total_volume_below,
+                total_volume_max=total_volume_max,
+                limit=limit,
+                sort=sort,
+                next=next,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+                url_override=next_url,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetShortVolumeResponse(
+                short_volume_response=unmarshal_json_response(
+                    Optional[models.ShortVolumeResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+                next=next_func,
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def get_financial_statements(
+        self,
+        *,
+        symbol: str,
+        statement: models.FinancialStatementType,
+        freq: models.ReportingFrequency,
+        preliminary: Optional[bool] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetFinancialStatementsResponse:
+        r"""Get Financial Statements
+
+        Retrieve standardized financial statements (income, balance sheet, cash flow). **symbol**, **statement**, and **freq** are required.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param symbol: Stock symbol, such as AAPL. Use it to choose the company you want to research.
+        :param statement: Financial statement type to return. Choose the statement category your analysis needs.
+        :param freq: Reporting frequency to return. Use annual or quarterly based on your analysis view.
+        :param preliminary: Include preliminary data (optional boolean).
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetFinancialStatementsRequest(
+            symbol=symbol,
+            statement=statement,
+            freq=freq,
+            preliminary=preliminary,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/financials/statements",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getFinancialStatements",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetFinancialStatementsResponse(
+                financials_statements_response=unmarshal_json_response(
+                    Optional[models.FinancialsStatementsResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def get_financial_statements_async(
+        self,
+        *,
+        symbol: str,
+        statement: models.FinancialStatementType,
+        freq: models.ReportingFrequency,
+        preliminary: Optional[bool] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetFinancialStatementsResponse:
+        r"""Get Financial Statements
+
+        Retrieve standardized financial statements (income, balance sheet, cash flow). **symbol**, **statement**, and **freq** are required.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param symbol: Stock symbol, such as AAPL. Use it to choose the company you want to research.
+        :param statement: Financial statement type to return. Choose the statement category your analysis needs.
+        :param freq: Reporting frequency to return. Use annual or quarterly based on your analysis view.
+        :param preliminary: Include preliminary data (optional boolean).
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if timeout_ms is None:
+            timeout_ms = 30000
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.GetFinancialStatementsRequest(
+            symbol=symbol,
+            statement=statement,
+            freq=freq,
+            preliminary=preliminary,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/financials/statements",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            allowed_fields=["client_id"],
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+            else:
+                retries = utils.RetryConfig(
+                    "backoff", utils.BackoffStrategy(500, 8000, 1.5, 60000), True
+                )
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getFinancialStatements",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Financials"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetFinancialStatementsResponse(
+                financials_statements_response=unmarshal_json_response(
+                    Optional[models.FinancialsStatementsResponse], http_res
+                ),
+                http_meta=models.HTTPMetadata(request=req, response=http_res),
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.BadRequestUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.BadRequest(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.UnauthorizedUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Unauthorized(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.ForbiddenUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.Forbidden(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.NotFoundUnion, http_res)
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.NotFound(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.InternalServerErrorUnion, http_res
+            )
+            response_data.http_meta = models.HTTPMetadata(
+                request=req, response=http_res
+            )
+            raise errors.InternalServerError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)