predictorsdk 0.0.1__tar.gz

predictorsdk-0.0.1/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: predictorsdk
+Version: 0.0.1
+Summary: The official Python client for the PredictorSDK matching markets API
+Author-email: PredictorSDK <nick@predictorsdk.com>
+License-Expression: MIT
+Project-URL: Homepage, https://docs.predictorsdk.com
+Project-URL: Repository, https://github.com/PredictorSDK/sdk-python
+Project-URL: Issues, https://github.com/PredictorSDK/sdk-python/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.21.2
+Requires-Dist: pydantic>=1.9.2
+Requires-Dist: typing_extensions>=4.0.0
+
+# predictorsdk
+
+The official Python client for the [PredictorSDK](https://predictorsdk.com) matching markets API.
+
+## Installation
+
+```bash
+pip install predictorsdk
+```
+
+## Usage
+
+```python
+from predictorsdk import PredictorSDK
+
+client = PredictorSDK(token="your-api-key")
+
+response = client.get_sports_matching_markets(
+    kalshi_event_ticker="KXMLB-25-NYM-COL-2025-04-03",
+)
+```
+
+## Documentation
+
+- [Docs](https://docs.predictorsdk.com)
+- [API Reference](https://docs.predictorsdk.com/api-reference)
+
+## License
+
+[MIT](https://github.com/PredictorSDK/sdk-python/blob/main/LICENSE)

predictorsdk-0.0.1/README.md

@@ -0,0 +1,30 @@
+# predictorsdk
+
+The official Python client for the [PredictorSDK](https://predictorsdk.com) matching markets API.
+
+## Installation
+
+```bash
+pip install predictorsdk
+```
+
+## Usage
+
+```python
+from predictorsdk import PredictorSDK
+
+client = PredictorSDK(token="your-api-key")
+
+response = client.get_sports_matching_markets(
+    kalshi_event_ticker="KXMLB-25-NYM-COL-2025-04-03",
+)
+```
+
+## Documentation
+
+- [Docs](https://docs.predictorsdk.com)
+- [API Reference](https://docs.predictorsdk.com/api-reference)
+
+## License
+
+[MIT](https://github.com/PredictorSDK/sdk-python/blob/main/LICENSE)

predictorsdk-0.0.1/predictorsdk/__init__.py

@@ -0,0 +1,69 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .types import ErrorResponse, PlatformMarket, PlatformMarketPlatform, SportsMatchingResponse
+    from .errors import (
+        BadRequestError,
+        ForbiddenError,
+        ServiceUnavailableError,
+        TooManyRequestsError,
+        UnauthorizedError,
+    )
+    from .client import AsyncPredictorSdkApi, PredictorSdkApi
+    from .environment import PredictorSdkApiEnvironment
+_dynamic_imports: typing.Dict[str, str] = {
+    "AsyncPredictorSdkApi": ".client",
+    "BadRequestError": ".errors",
+    "ErrorResponse": ".types",
+    "ForbiddenError": ".errors",
+    "PlatformMarket": ".types",
+    "PlatformMarketPlatform": ".types",
+    "PredictorSdkApi": ".client",
+    "PredictorSdkApiEnvironment": ".environment",
+    "ServiceUnavailableError": ".errors",
+    "SportsMatchingResponse": ".types",
+    "TooManyRequestsError": ".errors",
+    "UnauthorizedError": ".errors",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = [
+    "AsyncPredictorSdkApi",
+    "BadRequestError",
+    "ErrorResponse",
+    "ForbiddenError",
+    "PlatformMarket",
+    "PlatformMarketPlatform",
+    "PredictorSdkApi",
+    "PredictorSdkApiEnvironment",
+    "ServiceUnavailableError",
+    "SportsMatchingResponse",
+    "TooManyRequestsError",
+    "UnauthorizedError",
+]

predictorsdk-0.0.1/predictorsdk/client.py

@@ -0,0 +1,305 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import httpx
+from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from .core.logging import LogConfig, Logger
+from .core.request_options import RequestOptions
+from .environment import PredictorSdkApiEnvironment
+from .raw_client import AsyncRawPredictorSdkApi, RawPredictorSdkApi
+from .types.sports_matching_response import SportsMatchingResponse
+
+
+class PredictorSdkApi:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : PredictorSdkApiEnvironment
+        The environment to use for requests from the client. from .environment import PredictorSdkApiEnvironment
+
+
+
+        Defaults to PredictorSdkApiEnvironment.PRODUCTION
+
+
+
+    token : typing.Union[str, typing.Callable[[], str]]
+    headers : typing.Optional[typing.Dict[str, str]]
+        Additional headers to send with every request.
+
+    timeout : typing.Optional[float]
+        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.Client]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    logging : typing.Optional[typing.Union[LogConfig, Logger]]
+        Configure logging for the SDK. Accepts a LogConfig dict with 'level' (debug/info/warn/error), 'logger' (custom logger implementation), and 'silent' (boolean, defaults to True) fields. You can also pass a pre-configured Logger instance.
+
+    Examples
+    --------
+    from predictorsdk import PredictorSdkApi
+
+    client = PredictorSdkApi(
+        token="YOUR_TOKEN",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        environment: PredictorSdkApiEnvironment = PredictorSdkApiEnvironment.PRODUCTION,
+        token: typing.Union[str, typing.Callable[[], str]],
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        timeout: typing.Optional[float] = None,
+        follow_redirects: typing.Optional[bool] = True,
+        httpx_client: typing.Optional[httpx.Client] = None,
+        logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,
+    ):
+        _defaulted_timeout = (
+            timeout if timeout is not None else 60 if httpx_client is None else httpx_client.timeout.read
+        )
+        self._client_wrapper = SyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            token=token,
+            headers=headers,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else httpx.Client(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
+            if follow_redirects is not None
+            else httpx.Client(timeout=_defaulted_timeout),
+            timeout=_defaulted_timeout,
+            logging=logging,
+        )
+        self._raw_client = RawPredictorSdkApi(client_wrapper=self._client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawPredictorSdkApi:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawPredictorSdkApi
+        """
+        return self._raw_client
+
+    def get_sports_matching_markets(
+        self,
+        *,
+        kalshi_event_ticker: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        polymarket_market_slug: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        predict_market_id: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        sxbet_market_id: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SportsMatchingResponse:
+        """
+        Find cross-platform market matches for sports events. Provide a Kalshi event ticker or Polymarket market slug to look up the equivalent market on other platforms. When called without parameters, returns all currently matched sports markets.
+
+        Parameters
+        ----------
+        kalshi_event_ticker : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Kalshi event ticker(s) to find matching markets for (e.g. `KXNFLGAME-25AUG16ARIDEN`). Provide the parameter multiple times for multiple tickers. Only one filter type may be used per request.
+
+        polymarket_market_slug : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Polymarket market slug(s) to find matching markets for (e.g. `nfl-ari-den-2025-08-16`). Provide the parameter multiple times for multiple slugs. Only one filter type may be used per request.
+
+        predict_market_id : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Predict market ID(s) to find matching markets for (e.g. `110629`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request.
+
+        sxbet_market_id : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            SX Bet market ID(s) to find matching markets for (e.g. `0x4c000abdbf197ef32ecdf15561b1d636f1e5b02629f466678757fd83e2ec3599`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SportsMatchingResponse
+            Matching markets keyed by identifier
+
+        Examples
+        --------
+        from predictorsdk import PredictorSdkApi
+
+        client = PredictorSdkApi(
+            token="YOUR_TOKEN",
+        )
+        client.get_sports_matching_markets()
+        """
+        _response = self._raw_client.get_sports_matching_markets(
+            kalshi_event_ticker=kalshi_event_ticker,
+            polymarket_market_slug=polymarket_market_slug,
+            predict_market_id=predict_market_id,
+            sxbet_market_id=sxbet_market_id,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+class AsyncPredictorSdkApi:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : PredictorSdkApiEnvironment
+        The environment to use for requests from the client. from .environment import PredictorSdkApiEnvironment
+
+
+
+        Defaults to PredictorSdkApiEnvironment.PRODUCTION
+
+
+
+    token : typing.Union[str, typing.Callable[[], str]]
+    headers : typing.Optional[typing.Dict[str, str]]
+        Additional headers to send with every request.
+
+    async_token : typing.Optional[typing.Callable[[], typing.Awaitable[str]]]
+        An async callable that returns a bearer token. Use this when token acquisition involves async I/O (e.g., refreshing tokens via an async HTTP client). When provided, this is used instead of the synchronous token for async requests.
+
+    timeout : typing.Optional[float]
+        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.AsyncClient]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    logging : typing.Optional[typing.Union[LogConfig, Logger]]
+        Configure logging for the SDK. Accepts a LogConfig dict with 'level' (debug/info/warn/error), 'logger' (custom logger implementation), and 'silent' (boolean, defaults to True) fields. You can also pass a pre-configured Logger instance.
+
+    Examples
+    --------
+    from predictorsdk import AsyncPredictorSdkApi
+
+    client = AsyncPredictorSdkApi(
+        token="YOUR_TOKEN",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        environment: PredictorSdkApiEnvironment = PredictorSdkApiEnvironment.PRODUCTION,
+        token: typing.Union[str, typing.Callable[[], str]],
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        async_token: typing.Optional[typing.Callable[[], typing.Awaitable[str]]] = None,
+        timeout: typing.Optional[float] = None,
+        follow_redirects: typing.Optional[bool] = True,
+        httpx_client: typing.Optional[httpx.AsyncClient] = None,
+        logging: typing.Optional[typing.Union[LogConfig, Logger]] = None,
+    ):
+        _defaulted_timeout = (
+            timeout if timeout is not None else 60 if httpx_client is None else httpx_client.timeout.read
+        )
+        self._client_wrapper = AsyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            token=token,
+            headers=headers,
+            async_token=async_token,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else httpx.AsyncClient(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
+            if follow_redirects is not None
+            else httpx.AsyncClient(timeout=_defaulted_timeout),
+            timeout=_defaulted_timeout,
+            logging=logging,
+        )
+        self._raw_client = AsyncRawPredictorSdkApi(client_wrapper=self._client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawPredictorSdkApi:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawPredictorSdkApi
+        """
+        return self._raw_client
+
+    async def get_sports_matching_markets(
+        self,
+        *,
+        kalshi_event_ticker: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        polymarket_market_slug: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        predict_market_id: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        sxbet_market_id: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SportsMatchingResponse:
+        """
+        Find cross-platform market matches for sports events. Provide a Kalshi event ticker or Polymarket market slug to look up the equivalent market on other platforms. When called without parameters, returns all currently matched sports markets.
+
+        Parameters
+        ----------
+        kalshi_event_ticker : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Kalshi event ticker(s) to find matching markets for (e.g. `KXNFLGAME-25AUG16ARIDEN`). Provide the parameter multiple times for multiple tickers. Only one filter type may be used per request.
+
+        polymarket_market_slug : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Polymarket market slug(s) to find matching markets for (e.g. `nfl-ari-den-2025-08-16`). Provide the parameter multiple times for multiple slugs. Only one filter type may be used per request.
+
+        predict_market_id : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Predict market ID(s) to find matching markets for (e.g. `110629`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request.
+
+        sxbet_market_id : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            SX Bet market ID(s) to find matching markets for (e.g. `0x4c000abdbf197ef32ecdf15561b1d636f1e5b02629f466678757fd83e2ec3599`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SportsMatchingResponse
+            Matching markets keyed by identifier
+
+        Examples
+        --------
+        import asyncio
+
+        from predictorsdk import AsyncPredictorSdkApi
+
+        client = AsyncPredictorSdkApi(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.get_sports_matching_markets()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_sports_matching_markets(
+            kalshi_event_ticker=kalshi_event_ticker,
+            polymarket_market_slug=polymarket_market_slug,
+            predict_market_id=predict_market_id,
+            sxbet_market_id=sxbet_market_id,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+def _get_base_url(*, base_url: typing.Optional[str] = None, environment: PredictorSdkApiEnvironment) -> str:
+    if base_url is not None:
+        return base_url
+    elif environment is not None:
+        return environment.value
+    else:
+        raise Exception("Please pass in either base_url or environment to construct the client")

predictorsdk-0.0.1/predictorsdk/core/__init__.py

@@ -0,0 +1,125 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .api_error import ApiError
+    from .client_wrapper import AsyncClientWrapper, BaseClientWrapper, SyncClientWrapper
+    from .datetime_utils import Rfc2822DateTime, parse_rfc2822_datetime, serialize_datetime
+    from .file import File, convert_file_dict_to_httpx_tuples, with_content_type
+    from .http_client import AsyncHttpClient, HttpClient
+    from .http_response import AsyncHttpResponse, HttpResponse
+    from .jsonable_encoder import jsonable_encoder
+    from .logging import ConsoleLogger, ILogger, LogConfig, LogLevel, Logger, create_logger
+    from .parse_error import ParsingError
+    from .pydantic_utilities import (
+        IS_PYDANTIC_V2,
+        UniversalBaseModel,
+        UniversalRootModel,
+        parse_obj_as,
+        universal_field_validator,
+        universal_root_validator,
+        update_forward_refs,
+    )
+    from .query_encoder import encode_query
+    from .remove_none_from_dict import remove_none_from_dict
+    from .request_options import RequestOptions
+    from .serialization import FieldMetadata, convert_and_respect_annotation_metadata
+_dynamic_imports: typing.Dict[str, str] = {
+    "ApiError": ".api_error",
+    "AsyncClientWrapper": ".client_wrapper",
+    "AsyncHttpClient": ".http_client",
+    "AsyncHttpResponse": ".http_response",
+    "BaseClientWrapper": ".client_wrapper",
+    "ConsoleLogger": ".logging",
+    "FieldMetadata": ".serialization",
+    "File": ".file",
+    "HttpClient": ".http_client",
+    "HttpResponse": ".http_response",
+    "ILogger": ".logging",
+    "IS_PYDANTIC_V2": ".pydantic_utilities",
+    "LogConfig": ".logging",
+    "LogLevel": ".logging",
+    "Logger": ".logging",
+    "ParsingError": ".parse_error",
+    "RequestOptions": ".request_options",
+    "Rfc2822DateTime": ".datetime_utils",
+    "SyncClientWrapper": ".client_wrapper",
+    "UniversalBaseModel": ".pydantic_utilities",
+    "UniversalRootModel": ".pydantic_utilities",
+    "convert_and_respect_annotation_metadata": ".serialization",
+    "convert_file_dict_to_httpx_tuples": ".file",
+    "create_logger": ".logging",
+    "encode_query": ".query_encoder",
+    "jsonable_encoder": ".jsonable_encoder",
+    "parse_obj_as": ".pydantic_utilities",
+    "parse_rfc2822_datetime": ".datetime_utils",
+    "remove_none_from_dict": ".remove_none_from_dict",
+    "serialize_datetime": ".datetime_utils",
+    "universal_field_validator": ".pydantic_utilities",
+    "universal_root_validator": ".pydantic_utilities",
+    "update_forward_refs": ".pydantic_utilities",
+    "with_content_type": ".file",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = [
+    "ApiError",
+    "AsyncClientWrapper",
+    "AsyncHttpClient",
+    "AsyncHttpResponse",
+    "BaseClientWrapper",
+    "ConsoleLogger",
+    "FieldMetadata",
+    "File",
+    "HttpClient",
+    "HttpResponse",
+    "ILogger",
+    "IS_PYDANTIC_V2",
+    "LogConfig",
+    "LogLevel",
+    "Logger",
+    "ParsingError",
+    "RequestOptions",
+    "Rfc2822DateTime",
+    "SyncClientWrapper",
+    "UniversalBaseModel",
+    "UniversalRootModel",
+    "convert_and_respect_annotation_metadata",
+    "convert_file_dict_to_httpx_tuples",
+    "create_logger",
+    "encode_query",
+    "jsonable_encoder",
+    "parse_obj_as",
+    "parse_rfc2822_datetime",
+    "remove_none_from_dict",
+    "serialize_datetime",
+    "universal_field_validator",
+    "universal_root_validator",
+    "update_forward_refs",
+    "with_content_type",
+]

predictorsdk-0.0.1/predictorsdk/core/api_error.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from typing import Any, Dict, Optional
+
+
+class ApiError(Exception):
+    headers: Optional[Dict[str, str]]
+    status_code: Optional[int]
+    body: Any
+
+    def __init__(
+        self,
+        *,
+        headers: Optional[Dict[str, str]] = None,
+        status_code: Optional[int] = None,
+        body: Any = None,
+    ) -> None:
+        self.headers = headers
+        self.status_code = status_code
+        self.body = body
+
+    def __str__(self) -> str:
+        return f"headers: {self.headers}, status_code: {self.status_code}, body: {self.body}"