pmxt 1.2.0__py3-none-any.whl → 1.3.1__py3-none-any.whl

pmxt/__init__.py

@@ -33,7 +33,7 @@ from .models import (
     CreateOrderParams,
 )
 
-__version__ = "1.2.0"
+__version__ = "1.3.1"
 __all__ = [
     # Exchanges
     "Polymarket",

{pmxt-1.2.0.dist-info → pmxt-1.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pmxt
-Version: 1.2.0
+Version: 1.3.1
 Summary: Unified prediction market data API - The ccxt for prediction markets
 Author: PMXT Contributors
 License: MIT

{pmxt-1.2.0.dist-info → pmxt-1.3.1.dist-info}/RECORD

@@ -1,20 +1,20 @@
-pmxt/__init__.py,sha256=j56wDMQ7UDMKuCfCG21_Yyu5sRfQZYAJr_O5KgazqAs,1150
+pmxt/__init__.py,sha256=mm5_kfUsSx190jvgYhc7y04ZQZRA7REcwua8cWGDsZM,1150
 pmxt/client.py,sha256=pTU7MYP_k0lj-0eJifbHVcpGQVn5U7MTTDisKbv3fVI,27755
 pmxt/models.py,sha256=ZqRu__L8jnhZOYjE_Zy20dpft177Jb4lOZIkvBwuorg,6438
 pmxt/server_manager.py,sha256=-G97dYEdKl7F3HK9bAOKYl-SGWP6HsvzZIx2QxiZm24,11494
 pmxt/_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pmxt/_server/bin/pmxt-ensure-server,sha256=kXIond0UbxS52FAVQD7kHmSBaL_s6cbIyapLRr4KZJw,4544
 pmxt/_server/server/bundled.js,sha256=bgJSNnbYAsY2opHDoF-EfnJZgD03Ws2FmKpWGGKcGYg,4187137
-pmxt_internal/__init__.py,sha256=5scd_3UsIdcgcasF_lMtLRrmio0gNi-AqDefszhlCuE,6400
-pmxt_internal/api_client.py,sha256=t5ZZ-asj3thoDVhqc0XqzS6XsVqtjYrCBnIBb_zMERw,27889
+pmxt_internal/__init__.py,sha256=nuOM-A8asA5lJO2qP9q9uBwLXwlex-pazKQNdWtkR5g,6762
+pmxt_internal/api_client.py,sha256=7y61gqLd-HeKujV0svE1aeZRW7l1xpYSkonb-HQLCt8,27889
 pmxt_internal/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
-pmxt_internal/configuration.py,sha256=mxljZIa_w0ecXcUnhWUSvlfp9ItsSAy7G2Srhmc4Ohg,18320
+pmxt_internal/configuration.py,sha256=tnBzBQ_X9_II0E0dwZaHKWd9pU0YbLDXxxm8qYjPEIc,18320
 pmxt_internal/exceptions.py,sha256=txF8A7vlan57JS69kFPs-IZF-Qhp7IZobBTJVa4fOaM,6644
 pmxt_internal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pmxt_internal/rest.py,sha256=FMj4yaV6XLr842u_ScWHSzQsTFdk0jaUeuWLJoRbogQ,9760
 pmxt_internal/api/__init__.py,sha256=ppJSCipQ5IAk2z6UZkFaGSsEmnoAnSSHb8sjb_DYUkY,101
-pmxt_internal/api/default_api.py,sha256=h1vGidUmbkXhBHAE1THOWsGjiJc0RnIQTy1fRVSye7M,171451
-pmxt_internal/models/__init__.py,sha256=vjHF9UaS2iEhSGavMQL9PtS5NFaFUMTEKKzg-qJwKeE,3449
+pmxt_internal/api/default_api.py,sha256=4ySNtjkT9zJBfaHzX4fmXN5IgE-zIsr-uJs6WMO_N28,183099
+pmxt_internal/models/__init__.py,sha256=VPMpFsTZYckNs5JLcdO_8UwcZn4xEK3xQ58LUO0rxv4,3667
 pmxt_internal/models/balance.py,sha256=Dj5kFiLrsXOZyyXTC18bPjWrgw7qdWnTgTSCmk_l6xk,2962
 pmxt_internal/models/base_request.py,sha256=ZNipF7ycXFkQJ6j3QmB1TzA0UO3fB54AMPlAgIA3KOA,2987
 pmxt_internal/models/base_response.py,sha256=g-NG4Swxl3cg4-YOCPl65dUeHzOnA9S7ubTj8HOYZs0,2975
@@ -49,14 +49,17 @@ pmxt_internal/models/order_book.py,sha256=FZQ5g81szBtpCun3vFFTDZb_xZkwUMVyEIF1ZZ
 pmxt_internal/models/order_level.py,sha256=dMeuXlhBqe1kA-R1ysFjt77qJxx6ukrZHwO1y3hZ6EM,2735
 pmxt_internal/models/position.py,sha256=a2v8JudGks66xtSU_BILwnEhxqfTu1o01g-ShWHpkeA,3740
 pmxt_internal/models/price_candle.py,sha256=AebmNrnVl_JI0Vqy_IRoRh08qX9ZUdzzazKmnVTuyio,3151
+pmxt_internal/models/search_events200_response.py,sha256=70Nope-KWr4MBAFSMyjNugkOPgQZ1bZZym7HPdYR9vE,3560
+pmxt_internal/models/search_events_request.py,sha256=F9Y8fUARgIKUmMKkIZn3SviCVn-3CF8jJzUz9byWOB8,3710
 pmxt_internal/models/search_markets_request.py,sha256=BARoy2GXgV7RQNIGck6UaOyQqf0NIJkyGGbFf2cfZKc,3714
 pmxt_internal/models/search_markets_request_args_inner.py,sha256=PkusFd_OxhUsItsBpluPJA11zg0sXXjbOK-lPmemvLs,5561
 pmxt_internal/models/trade.py,sha256=U6Fc18rbwILs9FmX8CSDYYL8dF6763l8QzeMQNRxQdo,3328
+pmxt_internal/models/unified_event.py,sha256=zJVokyA3_Ny9cFxI_kZaJShB_V-KMqr5rY-i6oMDXCU,3896
 pmxt_internal/models/unified_market.py,sha256=DoYhiH4HycYGlq858PEeB-CIA7haT6rxmJeYZJuulMA,5646
 pmxt_internal/models/watch_order_book_request.py,sha256=kavGUI-SLz2-Kam_jcJ_h0GDe0-9UkxqCmVsAi6Uios,3726
 pmxt_internal/models/watch_order_book_request_args_inner.py,sha256=ZHrjmFDGxRG5MXbuz4mUp9KFfo3XS7zuXWTyMNgi4xI,5464
 pmxt_internal/models/watch_trades_request.py,sha256=brrg8JbEe-aeg7mIe_Y2HzRPogp-IfRhkXChrxzqoLU,3722
-pmxt-1.2.0.dist-info/METADATA,sha256=r9aUUGW_AalVxZIHnLRDdyt40XIqBYl5XrYv1nE7oLA,6288
-pmxt-1.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-pmxt-1.2.0.dist-info/top_level.txt,sha256=J_jrcouJ-x-5lpcXMxeW0GOSi1HsBVR5_PdSfvigVrw,19
-pmxt-1.2.0.dist-info/RECORD,,
+pmxt-1.3.1.dist-info/METADATA,sha256=5mXZyNIa4bGaNYCgyGOpv02knCgXn4J8J5xyjCe9rBM,6288
+pmxt-1.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pmxt-1.3.1.dist-info/top_level.txt,sha256=J_jrcouJ-x-5lpcXMxeW0GOSi1HsBVR5_PdSfvigVrw,19
+pmxt-1.3.1.dist-info/RECORD,,

pmxt_internal/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "1.2.0"
+__version__ = "1.3.1"
 
 # Define package exports
 __all__ = [
@@ -62,9 +62,12 @@ __all__ = [
     "OrderLevel",
     "Position",
     "PriceCandle",
+    "SearchEvents200Response",
+    "SearchEventsRequest",
     "SearchMarketsRequest",
     "SearchMarketsRequestArgsInner",
     "Trade",
+    "UnifiedEvent",
     "UnifiedMarket",
     "WatchOrderBookRequest",
     "WatchOrderBookRequestArgsInner",
@@ -120,9 +123,12 @@ from pmxt_internal.models.order_book import OrderBook as OrderBook
 from pmxt_internal.models.order_level import OrderLevel as OrderLevel
 from pmxt_internal.models.position import Position as Position
 from pmxt_internal.models.price_candle import PriceCandle as PriceCandle
+from pmxt_internal.models.search_events200_response import SearchEvents200Response as SearchEvents200Response
+from pmxt_internal.models.search_events_request import SearchEventsRequest as SearchEventsRequest
 from pmxt_internal.models.search_markets_request import SearchMarketsRequest as SearchMarketsRequest
 from pmxt_internal.models.search_markets_request_args_inner import SearchMarketsRequestArgsInner as SearchMarketsRequestArgsInner
 from pmxt_internal.models.trade import Trade as Trade
+from pmxt_internal.models.unified_event import UnifiedEvent as UnifiedEvent
 from pmxt_internal.models.unified_market import UnifiedMarket as UnifiedMarket
 from pmxt_internal.models.watch_order_book_request import WatchOrderBookRequest as WatchOrderBookRequest
 from pmxt_internal.models.watch_order_book_request_args_inner import WatchOrderBookRequestArgsInner as WatchOrderBookRequestArgsInner

pmxt_internal/api/default_api.py

@@ -37,6 +37,8 @@ from pmxt_internal.models.fetch_trades200_response import FetchTrades200Response
 from pmxt_internal.models.fetch_trades_request import FetchTradesRequest
 from pmxt_internal.models.get_markets_by_slug_request import GetMarketsBySlugRequest
 from pmxt_internal.models.health_check200_response import HealthCheck200Response
+from pmxt_internal.models.search_events200_response import SearchEvents200Response
+from pmxt_internal.models.search_events_request import SearchEventsRequest
 from pmxt_internal.models.search_markets_request import SearchMarketsRequest
 from pmxt_internal.models.watch_order_book_request import WatchOrderBookRequest
 from pmxt_internal.models.watch_trades_request import WatchTradesRequest
@@ -3436,6 +3438,294 @@ class DefaultApi:
 
 
 
+    @validate_call
+    def search_events(
+        self,
+        exchange: Annotated[StrictStr, Field(description="The prediction market exchange to target.")],
+        search_events_request: Optional[SearchEventsRequest] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> SearchEvents200Response:
+        """Search Events
+
+        Search for events (groups of related markets) by title or description.
+
+        :param exchange: The prediction market exchange to target. (required)
+        :type exchange: str
+        :param search_events_request:
+        :type search_events_request: SearchEventsRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._search_events_serialize(
+            exchange=exchange,
+            search_events_request=search_events_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "SearchEvents200Response",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def search_events_with_http_info(
+        self,
+        exchange: Annotated[StrictStr, Field(description="The prediction market exchange to target.")],
+        search_events_request: Optional[SearchEventsRequest] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[SearchEvents200Response]:
+        """Search Events
+
+        Search for events (groups of related markets) by title or description.
+
+        :param exchange: The prediction market exchange to target. (required)
+        :type exchange: str
+        :param search_events_request:
+        :type search_events_request: SearchEventsRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._search_events_serialize(
+            exchange=exchange,
+            search_events_request=search_events_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "SearchEvents200Response",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def search_events_without_preload_content(
+        self,
+        exchange: Annotated[StrictStr, Field(description="The prediction market exchange to target.")],
+        search_events_request: Optional[SearchEventsRequest] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Search Events
+
+        Search for events (groups of related markets) by title or description.
+
+        :param exchange: The prediction market exchange to target. (required)
+        :type exchange: str
+        :param search_events_request:
+        :type search_events_request: SearchEventsRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._search_events_serialize(
+            exchange=exchange,
+            search_events_request=search_events_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "SearchEvents200Response",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _search_events_serialize(
+        self,
+        exchange,
+        search_events_request,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if exchange is not None:
+            _path_params['exchange'] = exchange
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if search_events_request is not None:
+            _body_params = search_events_request
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+        ]
+
+        return self.api_client.param_serialize(
+            method='POST',
+            resource_path='/api/{exchange}/searchEvents',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
     @validate_call
     def search_markets(
         self,

pmxt_internal/api_client.py

@@ -91,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/1.2.0/python'
+        self.user_agent = 'OpenAPI-Generator/1.3.1/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

pmxt_internal/configuration.py

@@ -506,7 +506,7 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 0.4.4\n"\
-               "SDK Package Version: 1.2.0".\
+               "SDK Package Version: 1.3.1".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

pmxt_internal/models/__init__.py

@@ -47,9 +47,12 @@ from pmxt_internal.models.order_book import OrderBook
 from pmxt_internal.models.order_level import OrderLevel
 from pmxt_internal.models.position import Position
 from pmxt_internal.models.price_candle import PriceCandle
+from pmxt_internal.models.search_events200_response import SearchEvents200Response
+from pmxt_internal.models.search_events_request import SearchEventsRequest
 from pmxt_internal.models.search_markets_request import SearchMarketsRequest
 from pmxt_internal.models.search_markets_request_args_inner import SearchMarketsRequestArgsInner
 from pmxt_internal.models.trade import Trade
+from pmxt_internal.models.unified_event import UnifiedEvent
 from pmxt_internal.models.unified_market import UnifiedMarket
 from pmxt_internal.models.watch_order_book_request import WatchOrderBookRequest
 from pmxt_internal.models.watch_order_book_request_args_inner import WatchOrderBookRequestArgsInner

pmxt_internal/models/search_events200_response.py

@@ -0,0 +1,103 @@
+# coding: utf-8
+
+"""
+    PMXT Sidecar API
+
+    A unified local sidecar API for prediction markets (Polymarket, Kalshi). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation. 
+
+    The version of the OpenAPI document: 0.4.4
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictBool
+from typing import Any, ClassVar, Dict, List, Optional
+from pmxt_internal.models.error_detail import ErrorDetail
+from pmxt_internal.models.unified_event import UnifiedEvent
+from typing import Optional, Set
+from typing_extensions import Self
+
+class SearchEvents200Response(BaseModel):
+    """
+    SearchEvents200Response
+    """ # noqa: E501
+    success: Optional[StrictBool] = None
+    error: Optional[ErrorDetail] = None
+    data: Optional[List[UnifiedEvent]] = None
+    __properties: ClassVar[List[str]] = ["success", "error", "data"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of SearchEvents200Response from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of error
+        if self.error:
+            _dict['error'] = self.error.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of each item in data (list)
+        _items = []
+        if self.data:
+            for _item_data in self.data:
+                if _item_data:
+                    _items.append(_item_data.to_dict())
+            _dict['data'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of SearchEvents200Response from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "success": obj.get("success"),
+            "error": ErrorDetail.from_dict(obj["error"]) if obj.get("error") is not None else None,
+            "data": [UnifiedEvent.from_dict(_item) for _item in obj["data"]] if obj.get("data") is not None else None
+        })
+        return _obj
+
+

pmxt_internal/models/search_events_request.py

@@ -0,0 +1,102 @@
+# coding: utf-8
+
+"""
+    PMXT Sidecar API
+
+    A unified local sidecar API for prediction markets (Polymarket, Kalshi). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation. 
+
+    The version of the OpenAPI document: 0.4.4
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from pmxt_internal.models.exchange_credentials import ExchangeCredentials
+from pmxt_internal.models.search_markets_request_args_inner import SearchMarketsRequestArgsInner
+from typing import Optional, Set
+from typing_extensions import Self
+
+class SearchEventsRequest(BaseModel):
+    """
+    SearchEventsRequest
+    """ # noqa: E501
+    args: Annotated[List[SearchMarketsRequestArgsInner], Field(min_length=1, max_length=2)] = Field(description="[query, params?]")
+    credentials: Optional[ExchangeCredentials] = None
+    __properties: ClassVar[List[str]] = ["args", "credentials"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of SearchEventsRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in args (list)
+        _items = []
+        if self.args:
+            for _item_args in self.args:
+                if _item_args:
+                    _items.append(_item_args.to_dict())
+            _dict['args'] = _items
+        # override the default output from pydantic by calling `to_dict()` of credentials
+        if self.credentials:
+            _dict['credentials'] = self.credentials.to_dict()
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of SearchEventsRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "args": [SearchMarketsRequestArgsInner.from_dict(_item) for _item in obj["args"]] if obj.get("args") is not None else None,
+            "credentials": ExchangeCredentials.from_dict(obj["credentials"]) if obj.get("credentials") is not None else None
+        })
+        return _obj
+
+

pmxt_internal/models/unified_event.py

@@ -0,0 +1,111 @@
+# coding: utf-8
+
+"""
+    PMXT Sidecar API
+
+    A unified local sidecar API for prediction markets (Polymarket, Kalshi). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation. 
+
+    The version of the OpenAPI document: 0.4.4
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from pmxt_internal.models.unified_market import UnifiedMarket
+from typing import Optional, Set
+from typing_extensions import Self
+
+class UnifiedEvent(BaseModel):
+    """
+    A grouped collection of related markets (e.g., \"Who will be Fed Chair?\" contains multiple candidate markets)
+    """ # noqa: E501
+    id: Optional[StrictStr] = None
+    title: Optional[StrictStr] = None
+    description: Optional[StrictStr] = None
+    slug: Optional[StrictStr] = None
+    markets: Optional[List[UnifiedMarket]] = None
+    url: Optional[StrictStr] = None
+    image: Optional[StrictStr] = None
+    category: Optional[StrictStr] = None
+    tags: Optional[List[StrictStr]] = None
+    __properties: ClassVar[List[str]] = ["id", "title", "description", "slug", "markets", "url", "image", "category", "tags"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of UnifiedEvent from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in markets (list)
+        _items = []
+        if self.markets:
+            for _item_markets in self.markets:
+                if _item_markets:
+                    _items.append(_item_markets.to_dict())
+            _dict['markets'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of UnifiedEvent from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "id": obj.get("id"),
+            "title": obj.get("title"),
+            "description": obj.get("description"),
+            "slug": obj.get("slug"),
+            "markets": [UnifiedMarket.from_dict(_item) for _item in obj["markets"]] if obj.get("markets") is not None else None,
+            "url": obj.get("url"),
+            "image": obj.get("image"),
+            "category": obj.get("category"),
+            "tags": obj.get("tags")
+        })
+        return _obj
+
+