kalshi-python-async 3.0.0__py3-none-any.whl

kalshi_python_async/models/structured_target.py

@@ -0,0 +1,98 @@
+# coding: utf-8
+
+"""
+    Kalshi Trade API Manual Endpoints
+
+    Manually defined OpenAPI spec for endpoints being migrated to spec-first approach
+
+    The version of the OpenAPI document: 3.0.0
+    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 datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class StructuredTarget(BaseModel):
+    """
+    StructuredTarget
+    """ # noqa: E501
+    id: Optional[StrictStr] = Field(default=None, description="Unique identifier for the structured target.")
+    name: Optional[StrictStr] = Field(default=None, description="Name of the structured target.")
+    type: Optional[StrictStr] = Field(default=None, description="Type of the structured target.")
+    details: Optional[Dict[str, Any]] = Field(default=None, description="Additional details about the structured target. Contains flexible JSON data specific to the target type.")
+    source_id: Optional[StrictStr] = Field(default=None, description="External source identifier for the structured target, if available (e.g., third-party data provider ID).")
+    last_updated_ts: Optional[datetime] = Field(default=None, description="Timestamp when this structured target was last updated.")
+    __properties: ClassVar[List[str]] = ["id", "name", "type", "details", "source_id", "last_updated_ts"]
+
+    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 StructuredTarget 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,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of StructuredTarget 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"),
+            "name": obj.get("name"),
+            "type": obj.get("type"),
+            "details": obj.get("details"),
+            "source_id": obj.get("source_id"),
+            "last_updated_ts": obj.get("last_updated_ts")
+        })
+        return _obj
+
+

kalshi_python_async/models/ticker_pair.py

@@ -0,0 +1,98 @@
+# coding: utf-8
+
+"""
+    Kalshi Trade API Manual Endpoints
+
+    Manually defined OpenAPI spec for endpoints being migrated to spec-first approach
+
+    The version of the OpenAPI document: 3.0.0
+    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, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List
+from typing import Optional, Set
+from typing_extensions import Self
+
+class TickerPair(BaseModel):
+    """
+    TickerPair
+    """ # noqa: E501
+    market_ticker: StrictStr = Field(description="Market ticker identifier.")
+    event_ticker: StrictStr = Field(description="Event ticker identifier.")
+    side: StrictStr = Field(description="Side of the market (yes or no).")
+    __properties: ClassVar[List[str]] = ["market_ticker", "event_ticker", "side"]
+
+    @field_validator('side')
+    def side_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['true', 'false']):
+            raise ValueError("must be one of enum values ('true', 'false')")
+        return value
+
+    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 TickerPair 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,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of TickerPair from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "market_ticker": obj.get("market_ticker"),
+            "event_ticker": obj.get("event_ticker"),
+            "side": obj.get("side")
+        })
+        return _obj
+
+

kalshi_python_async/models/trade.py

@@ -0,0 +1,113 @@
+# coding: utf-8
+
+"""
+    Kalshi Trade API Manual Endpoints
+
+    Manually defined OpenAPI spec for endpoints being migrated to spec-first approach
+
+    The version of the OpenAPI document: 3.0.0
+    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 datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictFloat, StrictInt, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class Trade(BaseModel):
+    """
+    Trade
+    """ # noqa: E501
+    trade_id: StrictStr = Field(description="Unique identifier for this trade")
+    ticker: StrictStr = Field(description="Unique identifier for the market")
+    price: Union[StrictFloat, StrictInt] = Field(description="Trade price (deprecated - use yes_price or no_price)")
+    count: StrictInt = Field(description="Number of contracts bought or sold in this trade")
+    yes_price: StrictInt = Field(description="Yes price for this trade in cents")
+    no_price: StrictInt = Field(description="No price for this trade in cents")
+    yes_price_dollars: StrictStr = Field(description="US dollar amount as a fixed-point decimal string with exactly 4 decimal places")
+    no_price_dollars: StrictStr = Field(description="US dollar amount as a fixed-point decimal string with exactly 4 decimal places")
+    taker_side: StrictStr = Field(description="Side for the taker of this trade")
+    created_time: Optional[datetime] = Field(default=None, description="Timestamp when this trade was executed")
+    __properties: ClassVar[List[str]] = ["trade_id", "ticker", "price", "count", "yes_price", "no_price", "yes_price_dollars", "no_price_dollars", "taker_side", "created_time"]
+
+    @field_validator('taker_side')
+    def taker_side_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['yes', 'no']):
+            raise ValueError("must be one of enum values ('yes', 'no')")
+        return value
+
+    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 Trade 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,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of Trade from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "trade_id": obj.get("trade_id"),
+            "ticker": obj.get("ticker"),
+            "price": obj.get("price"),
+            "count": obj.get("count"),
+            "yes_price": obj.get("yes_price"),
+            "no_price": obj.get("no_price"),
+            "yes_price_dollars": obj.get("yes_price_dollars"),
+            "no_price_dollars": obj.get("no_price_dollars"),
+            "taker_side": obj.get("taker_side"),
+            "created_time": obj.get("created_time")
+        })
+        return _obj
+
+

kalshi_python_async/models/weekly_schedule.py

@@ -0,0 +1,154 @@
+# coding: utf-8
+
+"""
+    Kalshi Trade API Manual Endpoints
+
+    Manually defined OpenAPI spec for endpoints being migrated to spec-first approach
+
+    The version of the OpenAPI document: 3.0.0
+    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 datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Any, ClassVar, Dict, List
+from kalshi_python_async.models.daily_schedule import DailySchedule
+from typing import Optional, Set
+from typing_extensions import Self
+
+class WeeklySchedule(BaseModel):
+    """
+    WeeklySchedule
+    """ # noqa: E501
+    start_time: datetime = Field(description="Start date and time for when this weekly schedule is effective.")
+    end_time: datetime = Field(description="End date and time for when this weekly schedule is no longer effective.")
+    monday: List[DailySchedule] = Field(description="Trading hours for Monday. May contain multiple sessions.")
+    tuesday: List[DailySchedule] = Field(description="Trading hours for Tuesday. May contain multiple sessions.")
+    wednesday: List[DailySchedule] = Field(description="Trading hours for Wednesday. May contain multiple sessions.")
+    thursday: List[DailySchedule] = Field(description="Trading hours for Thursday. May contain multiple sessions.")
+    friday: List[DailySchedule] = Field(description="Trading hours for Friday. May contain multiple sessions.")
+    saturday: List[DailySchedule] = Field(description="Trading hours for Saturday. May contain multiple sessions.")
+    sunday: List[DailySchedule] = Field(description="Trading hours for Sunday. May contain multiple sessions.")
+    __properties: ClassVar[List[str]] = ["start_time", "end_time", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"]
+
+    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 WeeklySchedule 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 monday (list)
+        _items = []
+        if self.monday:
+            for _item_monday in self.monday:
+                if _item_monday:
+                    _items.append(_item_monday.to_dict())
+            _dict['monday'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in tuesday (list)
+        _items = []
+        if self.tuesday:
+            for _item_tuesday in self.tuesday:
+                if _item_tuesday:
+                    _items.append(_item_tuesday.to_dict())
+            _dict['tuesday'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in wednesday (list)
+        _items = []
+        if self.wednesday:
+            for _item_wednesday in self.wednesday:
+                if _item_wednesday:
+                    _items.append(_item_wednesday.to_dict())
+            _dict['wednesday'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in thursday (list)
+        _items = []
+        if self.thursday:
+            for _item_thursday in self.thursday:
+                if _item_thursday:
+                    _items.append(_item_thursday.to_dict())
+            _dict['thursday'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in friday (list)
+        _items = []
+        if self.friday:
+            for _item_friday in self.friday:
+                if _item_friday:
+                    _items.append(_item_friday.to_dict())
+            _dict['friday'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in saturday (list)
+        _items = []
+        if self.saturday:
+            for _item_saturday in self.saturday:
+                if _item_saturday:
+                    _items.append(_item_saturday.to_dict())
+            _dict['saturday'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in sunday (list)
+        _items = []
+        if self.sunday:
+            for _item_sunday in self.sunday:
+                if _item_sunday:
+                    _items.append(_item_sunday.to_dict())
+            _dict['sunday'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of WeeklySchedule from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "start_time": obj.get("start_time"),
+            "end_time": obj.get("end_time"),
+            "monday": [DailySchedule.from_dict(_item) for _item in obj["monday"]] if obj.get("monday") is not None else None,
+            "tuesday": [DailySchedule.from_dict(_item) for _item in obj["tuesday"]] if obj.get("tuesday") is not None else None,
+            "wednesday": [DailySchedule.from_dict(_item) for _item in obj["wednesday"]] if obj.get("wednesday") is not None else None,
+            "thursday": [DailySchedule.from_dict(_item) for _item in obj["thursday"]] if obj.get("thursday") is not None else None,
+            "friday": [DailySchedule.from_dict(_item) for _item in obj["friday"]] if obj.get("friday") is not None else None,
+            "saturday": [DailySchedule.from_dict(_item) for _item in obj["saturday"]] if obj.get("saturday") is not None else None,
+            "sunday": [DailySchedule.from_dict(_item) for _item in obj["sunday"]] if obj.get("sunday") is not None else None
+        })
+        return _obj
+
+

kalshi_python_async/rest.py

@@ -0,0 +1,213 @@
+# coding: utf-8
+
+"""
+    Kalshi Trade API Manual Endpoints
+
+    Manually defined OpenAPI spec for endpoints being migrated to spec-first approach
+
+    The version of the OpenAPI document: 3.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+import io
+import json
+import re
+import ssl
+from typing import Optional, Union
+
+import aiohttp
+import aiohttp_retry
+
+from kalshi_python_async.exceptions import ApiException, ApiValueError
+
+RESTResponseType = aiohttp.ClientResponse
+
+ALLOW_RETRY_METHODS = frozenset({'DELETE', 'GET', 'HEAD', 'OPTIONS', 'PUT', 'TRACE'})
+
+class RESTResponse(io.IOBase):
+
+    def __init__(self, resp) -> None:
+        self.response = resp
+        self.status = resp.status
+        self.reason = resp.reason
+        self.data = None
+
+    async def read(self):
+        if self.data is None:
+            self.data = await self.response.read()
+        return self.data
+
+    def getheaders(self):
+        """Returns a CIMultiDictProxy of the response headers."""
+        return self.response.headers
+
+    def getheader(self, name, default=None):
+        """Returns a given response header."""
+        return self.response.headers.get(name, default)
+
+
+class RESTClientObject:
+
+    def __init__(self, configuration) -> None:
+
+        # maxsize is number of requests to host that are allowed in parallel
+        self.maxsize = configuration.connection_pool_maxsize
+
+        self.ssl_context = ssl.create_default_context(
+            cafile=configuration.ssl_ca_cert,
+            cadata=configuration.ca_cert_data,
+        )
+        if configuration.cert_file:
+            self.ssl_context.load_cert_chain(
+                configuration.cert_file, keyfile=configuration.key_file
+            )
+
+        if not configuration.verify_ssl:
+            self.ssl_context.check_hostname = False
+            self.ssl_context.verify_mode = ssl.CERT_NONE
+
+        self.proxy = configuration.proxy
+        self.proxy_headers = configuration.proxy_headers
+
+        self.retries = configuration.retries
+
+        self.pool_manager: Optional[aiohttp.ClientSession] = None
+        self.retry_client: Optional[aiohttp_retry.RetryClient] = None
+
+    async def close(self) -> None:
+        if self.pool_manager:
+            await self.pool_manager.close()
+        if self.retry_client is not None:
+            await self.retry_client.close()
+
+    async def request(
+        self,
+        method,
+        url,
+        headers=None,
+        body=None,
+        post_params=None,
+        _request_timeout=None
+    ):
+        """Execute request
+
+        :param method: http request method
+        :param url: http request url
+        :param headers: http request headers
+        :param body: request json body, for `application/json`
+        :param post_params: request post parameters,
+                            `application/x-www-form-urlencoded`
+                            and `multipart/form-data`
+        :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.
+        """
+        method = method.upper()
+        assert method in [
+            'GET',
+            'HEAD',
+            'DELETE',
+            'POST',
+            'PUT',
+            'PATCH',
+            'OPTIONS'
+        ]
+
+        if post_params and body:
+            raise ApiValueError(
+                "body parameter cannot be used with post_params parameter."
+            )
+
+        post_params = post_params or {}
+        headers = headers or {}
+        # url already contains the URL query string
+        timeout = _request_timeout or 5 * 60
+
+        if 'Content-Type' not in headers:
+            headers['Content-Type'] = 'application/json'
+
+        args = {
+            "method": method,
+            "url": url,
+            "timeout": timeout,
+            "headers": headers
+        }
+
+        if self.proxy:
+            args["proxy"] = self.proxy
+        if self.proxy_headers:
+            args["proxy_headers"] = self.proxy_headers
+
+        # For `POST`, `PUT`, `PATCH`, `OPTIONS`, `DELETE`
+        if method in ['POST', 'PUT', 'PATCH', 'OPTIONS', 'DELETE']:
+            if re.search('json', headers['Content-Type'], re.IGNORECASE):
+                if body is not None:
+                    body = json.dumps(body)
+                args["data"] = body
+            elif headers['Content-Type'] == 'application/x-www-form-urlencoded':
+                args["data"] = aiohttp.FormData(post_params)
+            elif headers['Content-Type'] == 'multipart/form-data':
+                # must del headers['Content-Type'], or the correct
+                # Content-Type which generated by aiohttp
+                del headers['Content-Type']
+                data = aiohttp.FormData()
+                for param in post_params:
+                    k, v = param
+                    if isinstance(v, tuple) and len(v) == 3:
+                        data.add_field(
+                            k,
+                            value=v[1],
+                            filename=v[0],
+                            content_type=v[2]
+                        )
+                    else:
+                        # Ensures that dict objects are serialized
+                        if isinstance(v, dict):
+                            v = json.dumps(v)
+                        elif isinstance(v, int):
+                            v = str(v)
+                        data.add_field(k, v)
+                args["data"] = data
+
+            # Pass a `bytes` or `str` parameter directly in the body to support
+            # other content types than Json when `body` argument is provided
+            # in serialized form
+            elif isinstance(body, str) or isinstance(body, bytes):
+                args["data"] = body
+            else:
+                # Cannot generate the request from given parameters
+                msg = """Cannot prepare a request message for provided
+                         arguments. Please check that your arguments match
+                         declared content type."""
+                raise ApiException(status=0, reason=msg)
+
+        pool_manager: Union[aiohttp.ClientSession, aiohttp_retry.RetryClient]
+
+        # https pool manager
+        if self.pool_manager is None:
+            self.pool_manager = aiohttp.ClientSession(
+                connector=aiohttp.TCPConnector(limit=self.maxsize, ssl=self.ssl_context),
+                trust_env=True,
+            )
+        pool_manager = self.pool_manager
+
+        if self.retries is not None and method in ALLOW_RETRY_METHODS:
+            if self.retry_client is None:
+                self.retry_client = aiohttp_retry.RetryClient(
+                    client_session=self.pool_manager,
+                    retry_options=aiohttp_retry.ExponentialRetry(
+                        attempts=self.retries,
+                        factor=2.0,
+                        start_timeout=0.1,
+                        max_timeout=120.0
+                    )
+                )
+            pool_manager = self.retry_client
+
+        r = await pool_manager.request(**args)
+
+        return RESTResponse(r)