finance_dev 0.9.0__py3-none-any.whl

finance_dev/analytics.py

@@ -0,0 +1,3757 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 6db3756952aa
+
+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 Analytics(BaseSDK):
+    def get_analyst_insights(
+        self,
+        *,
+        page: Optional[int] = None,
+        page_size: Optional[int] = None,
+        symbols: Optional[str] = None,
+        analyst: Optional[str] = None,
+        rating_id: Optional[str] = None,
+        search_keys_type: Optional[models.GetAnalystInsightsSearchKeysType] = None,
+        search_keys: 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,
+    ) -> Optional[models.GetAnalystInsightsResponse]:
+        r"""Get Analyst Insights
+
+        Retrieve analyst insights and research data. All query parameters are optional. Supports pagination and filtering by symbols, analyst, ratingId, and firm.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param page: Zero-based page number. Enter 0 for the first page, 1 for the second page, and so on.
+        :param page_size: Number of results per page. Use this to control pagination size in list views. Use this to control page size; default is 10.
+        :param symbols: Comma-separated ticker symbols, such as AAPL,MSFT. Use this to request or filter multiple companies in one call. (e.g. AAPL,MSFT)
+        :param analyst: Comma-separated analyst IDs. Use this to limit insight results to specific analysts.
+        :param rating_id: Comma-separated rating IDs. Use this to limit insight results to specific rating records.
+        :param search_keys_type: Tells the API how to interpret the value you send in `searchKeys`. Allowed values:
+            - `firm_id` — the value is a firm/company internal ID.
+            - `firm` — the value is the firm/company name.
+        :param search_keys: Search key value (based on searchKeysType)
+        :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.GetAnalystInsightsRequest(
+            page=page,
+            page_size=page_size,
+            symbols=symbols,
+            analyst=analyst,
+            rating_id=rating_id,
+            search_keys_type=search_keys_type,
+            search_keys=search_keys,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/analytics/insights",
+            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="getAnalystInsights",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetAnalystInsightsResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page if isinstance(request.page, int) else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.insights").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit_ = request.page_size if isinstance(request.page_size, int) else 0
+            if len(results[0]) < limit_:
+                return None
+
+            return self.get_analyst_insights(
+                page=next_page,
+                page_size=page_size,
+                symbols=symbols,
+                analyst=analyst,
+                rating_id=rating_id,
+                search_keys_type=search_keys_type,
+                search_keys=search_keys,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetAnalystInsightsResponse(
+                analyst_insights_response=unmarshal_json_response(
+                    Optional[models.AnalystInsightsResponse], 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_analyst_insights_async(
+        self,
+        *,
+        page: Optional[int] = None,
+        page_size: Optional[int] = None,
+        symbols: Optional[str] = None,
+        analyst: Optional[str] = None,
+        rating_id: Optional[str] = None,
+        search_keys_type: Optional[models.GetAnalystInsightsSearchKeysType] = None,
+        search_keys: 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,
+    ) -> Optional[models.GetAnalystInsightsResponse]:
+        r"""Get Analyst Insights
+
+        Retrieve analyst insights and research data. All query parameters are optional. Supports pagination and filtering by symbols, analyst, ratingId, and firm.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param page: Zero-based page number. Enter 0 for the first page, 1 for the second page, and so on.
+        :param page_size: Number of results per page. Use this to control pagination size in list views. Use this to control page size; default is 10.
+        :param symbols: Comma-separated ticker symbols, such as AAPL,MSFT. Use this to request or filter multiple companies in one call. (e.g. AAPL,MSFT)
+        :param analyst: Comma-separated analyst IDs. Use this to limit insight results to specific analysts.
+        :param rating_id: Comma-separated rating IDs. Use this to limit insight results to specific rating records.
+        :param search_keys_type: Tells the API how to interpret the value you send in `searchKeys`. Allowed values:
+            - `firm_id` — the value is a firm/company internal ID.
+            - `firm` — the value is the firm/company name.
+        :param search_keys: Search key value (based on searchKeysType)
+        :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.GetAnalystInsightsRequest(
+            page=page,
+            page_size=page_size,
+            symbols=symbols,
+            analyst=analyst,
+            rating_id=rating_id,
+            search_keys_type=search_keys_type,
+            search_keys=search_keys,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/analytics/insights",
+            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="getAnalystInsights",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetAnalystInsightsResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page if isinstance(request.page, int) else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.insights").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit_ = request.page_size if isinstance(request.page_size, int) else 0
+            if len(results[0]) < limit_:
+                return None
+
+            return self.get_analyst_insights(
+                page=next_page,
+                page_size=page_size,
+                symbols=symbols,
+                analyst=analyst,
+                rating_id=rating_id,
+                search_keys_type=search_keys_type,
+                search_keys=search_keys,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetAnalystInsightsResponse(
+                analyst_insights_response=unmarshal_json_response(
+                    Optional[models.AnalystInsightsResponse], 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_market_breadth(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetMarketBreadthResponse:
+        r"""Get Market Breadth
+
+        Retrieve market breadth data showing advancers vs decliners
+
+        If set, this operation will use `client_id` from the global security.
+
+        :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)
+        req = self._build_request(
+            method="GET",
+            path="/v1/analytics/market-breadth",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            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="getMarketBreadth",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetMarketBreadthResponse(
+                market_breadth_response=unmarshal_json_response(
+                    Optional[models.MarketBreadthResponse], 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_market_breadth_async(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetMarketBreadthResponse:
+        r"""Get Market Breadth
+
+        Retrieve market breadth data showing advancers vs decliners
+
+        If set, this operation will use `client_id` from the global security.
+
+        :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)
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/analytics/market-breadth",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            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="getMarketBreadth",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetMarketBreadthResponse(
+                market_breadth_response=unmarshal_json_response(
+                    Optional[models.MarketBreadthResponse], 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_net_inflow(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetNetInflowResponse:
+        r"""Get Net Inflow
+
+        Retrieve net inflow data for NASDAQ and NYSE
+
+        If set, this operation will use `client_id` from the global security.
+
+        :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)
+        req = self._build_request(
+            method="GET",
+            path="/v1/analytics/net-inflow",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            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="getNetInflow",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetNetInflowResponse(
+                net_inflow_response=unmarshal_json_response(
+                    Optional[models.NetInflowResponse], 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_net_inflow_async(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetNetInflowResponse:
+        r"""Get Net Inflow
+
+        Retrieve net inflow data for NASDAQ and NYSE
+
+        If set, this operation will use `client_id` from the global security.
+
+        :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)
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/analytics/net-inflow",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            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="getNetInflow",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetNetInflowResponse(
+                net_inflow_response=unmarshal_json_response(
+                    Optional[models.NetInflowResponse], 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_ratings(
+        self,
+        *,
+        tickers: Optional[str] = None,
+        page: Optional[int] = None,
+        page_size: Optional[int] = None,
+        date_: Optional[date] = None,
+        date_from: Optional[date] = None,
+        date_to: Optional[date] = None,
+        importance: Optional[int] = None,
+        action: Optional[str] = None,
+        analyst_id: Optional[str] = None,
+        firm_id: 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,
+    ) -> Optional[models.GetRatingsResponseResponse]:
+        r"""Get Analyst Ratings
+
+        Retrieve analyst ratings for stocks. All query parameters are optional.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param tickers: Comma-separated list of ticker symbols to filter by
+        :param page: Page number for pagination (0-based)
+        :param page_size: Number of results per page. Use this to control pagination size in list views.
+        :param date_: Filter by specific date (YYYY-MM-DD)
+        :param date_from: Start date for date range (YYYY-MM-DD)
+        :param date_to: End date for date range (YYYY-MM-DD)
+        :param importance: Minimum importance level to include. Use higher values to filter for more market-moving events or ratings.
+        :param action: Rating action filter. Use it to return only upgrades, downgrades, initiations, or other supported action types.
+        :param analyst_id: Comma-separated analyst IDs. Use this to limit insight results to specific analysts. to filter by
+        :param firm_id: Comma-separated firm IDs to filter by
+        :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.GetRatingsRequest(
+            tickers=tickers,
+            page=page,
+            page_size=page_size,
+            date_=date_,
+            date_from=date_from,
+            date_to=date_to,
+            importance=importance,
+            action=action,
+            analyst_id=analyst_id,
+            firm_id=firm_id,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/analytics/ratings",
+            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="getRatings",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetRatingsResponseResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page if isinstance(request.page, int) else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.ratings").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit_ = request.page_size if isinstance(request.page_size, int) else 0
+            if len(results[0]) < limit_:
+                return None
+
+            return self.get_ratings(
+                tickers=tickers,
+                page=next_page,
+                page_size=page_size,
+                date_=date_,
+                date_from=date_from,
+                date_to=date_to,
+                importance=importance,
+                action=action,
+                analyst_id=analyst_id,
+                firm_id=firm_id,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetRatingsResponseResponse(
+                get_ratings_response=unmarshal_json_response(
+                    Optional[models.GetRatingsResponse], 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_ratings_async(
+        self,
+        *,
+        tickers: Optional[str] = None,
+        page: Optional[int] = None,
+        page_size: Optional[int] = None,
+        date_: Optional[date] = None,
+        date_from: Optional[date] = None,
+        date_to: Optional[date] = None,
+        importance: Optional[int] = None,
+        action: Optional[str] = None,
+        analyst_id: Optional[str] = None,
+        firm_id: 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,
+    ) -> Optional[models.GetRatingsResponseResponse]:
+        r"""Get Analyst Ratings
+
+        Retrieve analyst ratings for stocks. All query parameters are optional.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param tickers: Comma-separated list of ticker symbols to filter by
+        :param page: Page number for pagination (0-based)
+        :param page_size: Number of results per page. Use this to control pagination size in list views.
+        :param date_: Filter by specific date (YYYY-MM-DD)
+        :param date_from: Start date for date range (YYYY-MM-DD)
+        :param date_to: End date for date range (YYYY-MM-DD)
+        :param importance: Minimum importance level to include. Use higher values to filter for more market-moving events or ratings.
+        :param action: Rating action filter. Use it to return only upgrades, downgrades, initiations, or other supported action types.
+        :param analyst_id: Comma-separated analyst IDs. Use this to limit insight results to specific analysts. to filter by
+        :param firm_id: Comma-separated firm IDs to filter by
+        :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.GetRatingsRequest(
+            tickers=tickers,
+            page=page,
+            page_size=page_size,
+            date_=date_,
+            date_from=date_from,
+            date_to=date_to,
+            importance=importance,
+            action=action,
+            analyst_id=analyst_id,
+            firm_id=firm_id,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/analytics/ratings",
+            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="getRatings",
+                oauth2_scopes=["analytics:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetRatingsResponseResponse]:
+            body = utils.unmarshal_json(http_res.text, Union[Dict[Any, Any], List[Any]])
+            page = request.page if isinstance(request.page, int) else 1
+            next_page = page + 1
+
+            if not http_res.text:
+                return None
+            results = JSONPath("$.ratings").parse(body)
+            if len(results) == 0 or len(results[0]) == 0:
+                return None
+            limit_ = request.page_size if isinstance(request.page_size, int) else 0
+            if len(results[0]) < limit_:
+                return None
+
+            return self.get_ratings(
+                tickers=tickers,
+                page=next_page,
+                page_size=page_size,
+                date_=date_,
+                date_from=date_from,
+                date_to=date_to,
+                importance=importance,
+                action=action,
+                analyst_id=analyst_id,
+                firm_id=firm_id,
+                retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
+            )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return models.GetRatingsResponseResponse(
+                get_ratings_response=unmarshal_json_response(
+                    Optional[models.GetRatingsResponse], 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_sector_tickers(
+        self,
+        *,
+        sector: models.Sector,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetSectorTickersResponse:
+        r"""Get Sector Tickers
+
+        Retrieves all stock symbols within a specified sector, sorted by trading volume.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param sector: Which industry sector to list tickers for. Use the exact uppercase value (including spaces) — these match the values returned by [GET /v1/equity/sector-wise-change](/api-reference/analytics/equity-sector-wise-change).
+            - `TECHNOLOGY` — software, hardware, semiconductors
+            - `HEALTHCARE` — pharma, biotech, medical devices, providers
+            - `FINANCIAL SERVICES` — banks, insurance, asset managers
+            - `CONSUMER CYCLICAL` — discretionary spending (autos, retail, travel)
+            - `CONSUMER DEFENSIVE` — staples (food, household goods, drugstores)
+            - `INDUSTRIALS` — manufacturing, transport, defense, machinery
+            - `ENERGY` — oil & gas, renewable energy
+            - `UTILITIES` — power, water, gas distribution
+            - `BASIC MATERIALS` — mining, chemicals, paper, metals
+            - `COMMUNICATION SERVICES` — telecom, media, internet platforms
+            - `REAL ESTATE` — REITs and real-estate operators
+            - `OTHER` — uncategorized
+            - `NONE` — no sector classification
+        :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.GetSectorTickersRequest(
+            sector=sector,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/equity/sector-tickers",
+            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="getSectorTickers",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetSectorTickersResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_sector_tickers_async(
+        self,
+        *,
+        sector: models.Sector,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetSectorTickersResponse:
+        r"""Get Sector Tickers
+
+        Retrieves all stock symbols within a specified sector, sorted by trading volume.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param sector: Which industry sector to list tickers for. Use the exact uppercase value (including spaces) — these match the values returned by [GET /v1/equity/sector-wise-change](/api-reference/analytics/equity-sector-wise-change).
+            - `TECHNOLOGY` — software, hardware, semiconductors
+            - `HEALTHCARE` — pharma, biotech, medical devices, providers
+            - `FINANCIAL SERVICES` — banks, insurance, asset managers
+            - `CONSUMER CYCLICAL` — discretionary spending (autos, retail, travel)
+            - `CONSUMER DEFENSIVE` — staples (food, household goods, drugstores)
+            - `INDUSTRIALS` — manufacturing, transport, defense, machinery
+            - `ENERGY` — oil & gas, renewable energy
+            - `UTILITIES` — power, water, gas distribution
+            - `BASIC MATERIALS` — mining, chemicals, paper, metals
+            - `COMMUNICATION SERVICES` — telecom, media, internet platforms
+            - `REAL ESTATE` — REITs and real-estate operators
+            - `OTHER` — uncategorized
+            - `NONE` — no sector classification
+        :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.GetSectorTickersRequest(
+            sector=sector,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/equity/sector-tickers",
+            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="getSectorTickers",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetSectorTickersResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_sector_wise_change(
+        self,
+        *,
+        limit: Optional[str] = None,
+        size: 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.GetSectorWiseChangeResponse:
+        r"""Get Sector-wise Change
+
+        Retrieves the average percentage change for all available sectors, sorted by change. Use limit=all to return all sectors.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of sectors to return. Two formats are accepted:
+            - An integer like `5`, `10`, `15` to cap the list (default `15`).
+            - The literal string `all` to return every sector with no cap.
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetSectorWiseChangeRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/equity/sector-wise-change",
+            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="getSectorWiseChange",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetSectorWiseChangeResponse(
+                sector_avg_changes=unmarshal_json_response(
+                    Optional[List[models.SectorAvgChange]], 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_sector_wise_change_async(
+        self,
+        *,
+        limit: Optional[str] = None,
+        size: 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.GetSectorWiseChangeResponse:
+        r"""Get Sector-wise Change
+
+        Retrieves the average percentage change for all available sectors, sorted by change. Use limit=all to return all sectors.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of sectors to return. Two formats are accepted:
+            - An integer like `5`, `10`, `15` to cap the list (default `15`).
+            - The literal string `all` to return every sector with no cap.
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetSectorWiseChangeRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/equity/sector-wise-change",
+            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="getSectorWiseChange",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetSectorWiseChangeResponse(
+                sector_avg_changes=unmarshal_json_response(
+                    Optional[List[models.SectorAvgChange]], 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_top_gainers(
+        self,
+        *,
+        limit: Optional[int] = 10,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetTopGainersResponse:
+        r"""Get Top Gaining Stocks
+
+        Retrieves stocks with the highest positive percentage changes, sorted by change percentage in descending order.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetTopGainersRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/equity/top-gainers",
+            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="getTopGainers",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetTopGainersResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_top_gainers_async(
+        self,
+        *,
+        limit: Optional[int] = 10,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetTopGainersResponse:
+        r"""Get Top Gaining Stocks
+
+        Retrieves stocks with the highest positive percentage changes, sorted by change percentage in descending order.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetTopGainersRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/equity/top-gainers",
+            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="getTopGainers",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetTopGainersResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_top_losers(
+        self,
+        *,
+        limit: Optional[int] = 10,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetTopLosersResponse:
+        r"""Get Top Losing Stocks
+
+        Retrieves stocks with the largest negative percentage changes, sorted by change percentage in ascending order.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetTopLosersRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/equity/top-losers",
+            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="getTopLosers",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetTopLosersResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_top_losers_async(
+        self,
+        *,
+        limit: Optional[int] = 10,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetTopLosersResponse:
+        r"""Get Top Losing Stocks
+
+        Retrieves stocks with the largest negative percentage changes, sorted by change percentage in ascending order.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetTopLosersRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/equity/top-losers",
+            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="getTopLosers",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetTopLosersResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_top_most_active(
+        self,
+        *,
+        limit: Optional[int] = 10,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetTopMostActiveResponse:
+        r"""Get Most Active Stocks
+
+        Retrieves stocks sorted by trading volume in descending order.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetTopMostActiveRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/equity/top-most-active",
+            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="getTopMostActive",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetTopMostActiveResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_top_most_active_async(
+        self,
+        *,
+        limit: Optional[int] = 10,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetTopMostActiveResponse:
+        r"""Get Most Active Stocks
+
+        Retrieves stocks sorted by trading volume in descending order.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param limit: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :param size: Alias for limit. Ignored when limit is supplied.
+        :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.GetTopMostActiveRequest(
+            limit=limit,
+            size=size,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/equity/top-most-active",
+            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="getTopMostActive",
+                oauth2_scopes=["market:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetTopMostActiveResponse(
+                symbol_details=unmarshal_json_response(
+                    Optional[List[models.SymbolDetails]], 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_options_et_fs_top_volume(
+        self,
+        *,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetOptionsETFsTopVolumeResponse:
+        r"""Get Top ETF Options by Volume
+
+        Retrieve ETF options with the highest trading volume showing the most actively traded contracts across all ETFs.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param size: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :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.GetOptionsETFsTopVolumeRequest(
+            size=size,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/options/etfs/top-volume",
+            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="getOptionsETFsTopVolume",
+                oauth2_scopes=["options:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetOptionsETFsTopVolumeResponse(
+                options_screener_items=unmarshal_json_response(
+                    Optional[List[models.OptionsScreenerItem]], 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_options_et_fs_top_volume_async(
+        self,
+        *,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetOptionsETFsTopVolumeResponse:
+        r"""Get Top ETF Options by Volume
+
+        Retrieve ETF options with the highest trading volume showing the most actively traded contracts across all ETFs.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param size: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :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.GetOptionsETFsTopVolumeRequest(
+            size=size,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/options/etfs/top-volume",
+            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="getOptionsETFsTopVolume",
+                oauth2_scopes=["options:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetOptionsETFsTopVolumeResponse(
+                options_screener_items=unmarshal_json_response(
+                    Optional[List[models.OptionsScreenerItem]], 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_options_stocks_top_gainers(
+        self,
+        *,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetOptionsStocksTopGainersResponse:
+        r"""Get Top Stock Options by Gains
+
+        Retrieve stock options with the largest percentage gains showing the best performing options contracts.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param size: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :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.GetOptionsStocksTopGainersRequest(
+            size=size,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/options/stocks/top-gainers",
+            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="getOptionsStocksTopGainers",
+                oauth2_scopes=["options:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetOptionsStocksTopGainersResponse(
+                options_screener_items=unmarshal_json_response(
+                    Optional[List[models.OptionsScreenerItem]], 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_options_stocks_top_gainers_async(
+        self,
+        *,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetOptionsStocksTopGainersResponse:
+        r"""Get Top Stock Options by Gains
+
+        Retrieve stock options with the largest percentage gains showing the best performing options contracts.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param size: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :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.GetOptionsStocksTopGainersRequest(
+            size=size,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/options/stocks/top-gainers",
+            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="getOptionsStocksTopGainers",
+                oauth2_scopes=["options:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetOptionsStocksTopGainersResponse(
+                options_screener_items=unmarshal_json_response(
+                    Optional[List[models.OptionsScreenerItem]], 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_options_stocks_top_volume(
+        self,
+        *,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetOptionsStocksTopVolumeResponse:
+        r"""Get Top Stock Options by Volume
+
+        Retrieve stock options with the highest trading volume identifying the most actively traded equity options contracts.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param size: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :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.GetOptionsStocksTopVolumeRequest(
+            size=size,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v1/options/stocks/top-volume",
+            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="getOptionsStocksTopVolume",
+                oauth2_scopes=["options:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetOptionsStocksTopVolumeResponse(
+                options_screener_items=unmarshal_json_response(
+                    Optional[List[models.OptionsScreenerItem]], 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_options_stocks_top_volume_async(
+        self,
+        *,
+        size: Optional[int] = 10,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetOptionsStocksTopVolumeResponse:
+        r"""Get Top Stock Options by Volume
+
+        Retrieve stock options with the highest trading volume identifying the most actively traded equity options contracts.
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param size: Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
+        :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.GetOptionsStocksTopVolumeRequest(
+            size=size,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v1/options/stocks/top-volume",
+            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="getOptionsStocksTopVolume",
+                oauth2_scopes=["options:information"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.GetOptionsStocksTopVolumeResponse(
+                options_screener_items=unmarshal_json_response(
+                    Optional[List[models.OptionsScreenerItem]], 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 stock_screener(
+        self,
+        *,
+        stock_screener_request: Union[
+            models.StockScreenerRequest, models.StockScreenerRequestTypedDict
+        ],
+        page_size: Optional[int] = None,
+        order_column: Optional[str] = None,
+        order_direction: Optional[models.SortOrderEnum] = None,
+        primary_only: 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.StockScreenerResponseResponse:
+        r"""Stock Screener
+
+        Screen securities by sending a JSON body with operator and clauses (and optional groups). At least one clause or group is required. Query params: page_size, order_column, order_direction, primary_only. **Required scope:** analytics:information
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param stock_screener_request: Screener request with operator (AND, OR, or NOT), clauses (field, operator, value), and optional groups.
+        :param page_size: Number of results to return per page. Use smaller values (10–50) for UI screens, larger (100–500) for batch exports. Defaults to the upstream provider's default.
+        :param order_column: Which data column to sort the screened results by. Accepts any column the upstream screener exposes — not a fixed enum on our side. Common columns:
+            - `marketcap` — market capitalization.
+            - `pricetoearnings` — trailing P/E ratio.
+            - `pricetobook` — price-to-book ratio.
+            - `roe` — return on equity.
+            - `volume` — average daily volume.
+            - `open_price` / `close_price` — most recent open / close.
+            - `dilutedeps` — diluted earnings per share (TTM).
+            - `cashandequivalents` — cash + cash equivalents on the balance sheet.
+
+            Pair with `order_direction` (`asc` / `desc`).
+        :param order_direction: Direction to sort `order_column` in:
+            - `asc` — ascending (smallest first).
+            - `desc` — descending (largest first).
+        :param primary_only: When `true`, return only the primary listing for each company (e.g. NYSE for a U.S. dual-listed stock) instead of every listing. Defaults to `false`.
+        :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.StockScreenerRequestRequest(
+            page_size=page_size,
+            order_column=order_column,
+            order_direction=order_direction,
+            primary_only=primary_only,
+            stock_screener_request=utils.get_pydantic_model(
+                stock_screener_request, models.StockScreenerRequest
+            ),
+        )
+
+        req = self._build_request(
+            method="POST",
+            path="/v1/stock/screener",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=True,
+            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,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request.stock_screener_request,
+                False,
+                False,
+                "json",
+                models.StockScreenerRequest,
+            ),
+            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="stockScreener",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.StockScreenerResponseResponse(
+                stock_screener_response=unmarshal_json_response(
+                    Optional[List[models.StockScreenerResponse]], 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 stock_screener_async(
+        self,
+        *,
+        stock_screener_request: Union[
+            models.StockScreenerRequest, models.StockScreenerRequestTypedDict
+        ],
+        page_size: Optional[int] = None,
+        order_column: Optional[str] = None,
+        order_direction: Optional[models.SortOrderEnum] = None,
+        primary_only: 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.StockScreenerResponseResponse:
+        r"""Stock Screener
+
+        Screen securities by sending a JSON body with operator and clauses (and optional groups). At least one clause or group is required. Query params: page_size, order_column, order_direction, primary_only. **Required scope:** analytics:information
+
+        If set, this operation will use `client_id` from the global security.
+
+        :param stock_screener_request: Screener request with operator (AND, OR, or NOT), clauses (field, operator, value), and optional groups.
+        :param page_size: Number of results to return per page. Use smaller values (10–50) for UI screens, larger (100–500) for batch exports. Defaults to the upstream provider's default.
+        :param order_column: Which data column to sort the screened results by. Accepts any column the upstream screener exposes — not a fixed enum on our side. Common columns:
+            - `marketcap` — market capitalization.
+            - `pricetoearnings` — trailing P/E ratio.
+            - `pricetobook` — price-to-book ratio.
+            - `roe` — return on equity.
+            - `volume` — average daily volume.
+            - `open_price` / `close_price` — most recent open / close.
+            - `dilutedeps` — diluted earnings per share (TTM).
+            - `cashandequivalents` — cash + cash equivalents on the balance sheet.
+
+            Pair with `order_direction` (`asc` / `desc`).
+        :param order_direction: Direction to sort `order_column` in:
+            - `asc` — ascending (smallest first).
+            - `desc` — descending (largest first).
+        :param primary_only: When `true`, return only the primary listing for each company (e.g. NYSE for a U.S. dual-listed stock) instead of every listing. Defaults to `false`.
+        :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.StockScreenerRequestRequest(
+            page_size=page_size,
+            order_column=order_column,
+            order_direction=order_direction,
+            primary_only=primary_only,
+            stock_screener_request=utils.get_pydantic_model(
+                stock_screener_request, models.StockScreenerRequest
+            ),
+        )
+
+        req = self._build_request_async(
+            method="POST",
+            path="/v1/stock/screener",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=True,
+            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,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request.stock_screener_request,
+                False,
+                False,
+                "json",
+                models.StockScreenerRequest,
+            ),
+            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="stockScreener",
+                oauth2_scopes=["market:supplemental"],
+                security_source=self.sdk_configuration.security,
+                tags=["Analytics"],
+                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.StockScreenerResponseResponse(
+                stock_screener_response=unmarshal_json_response(
+                    Optional[List[models.StockScreenerResponse]], 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)