oddspipe 0.1.0__tar.gz

oddspipe-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OddsPipe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

oddspipe-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: oddspipe
+Version: 0.1.0
+Summary: Python client for the OddsPipe prediction market API
+Home-page: https://oddspipe.com
+Author: OddsPipe
+Author-email: hello@oddspipe.com
+License: MIT
+Project-URL: Documentation, https://oddspipe.com/docs
+Project-URL: Source, https://github.com/OddsPipe/oddspipe
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# OddsPipe Python SDK
+
+Python client for the [OddsPipe](https://oddspipe.com) prediction market API.
+
+## Install
+
+```bash
+pip install oddspipe
+```
+
+## Quick start
+
+```python
+from oddspipe import OddsPipe
+
+client = OddsPipe(api_key="your-api-key")
+
+# List top markets by volume
+markets = client.markets(limit=10)
+for m in markets["items"]:
+    print(m["title"], m["spread"])
+
+# Search for a market
+results = client.search("Trump", platform="polymarket")
+
+# Get OHLCV candlesticks
+candles = client.candlesticks(market_id=123, interval="1h", limit=100)
+for c in candles["candles"]:
+    print(c["timestamp"], c["close"], c["volume"])
+
+# Find cross-platform price divergences
+spreads = client.spreads(min_spread=0.03)
+for item in spreads["items"]:
+    print(item["title"], item["spread"]["yes_diff"])
+
+# Cross-platform spread for a single market
+spread = client.spread(market_id=123)
+print(spread["sources"])
+print(spread["spread"])
+```
+
+## API reference
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `markets()` | `GET /v1/markets` | List markets with latest prices |
+| `market(id)` | `GET /v1/markets/{id}` | Single market detail |
+| `search(q)` | `GET /v1/markets/search` | Full-text search |
+| `history(id)` | `GET /v1/markets/{id}/history` | Raw price snapshots |
+| `candlesticks(id)` | `GET /v1/markets/{id}/candlesticks` | OHLCV candles (1m/5m/1h/1d) |
+| `spread(id)` | `GET /v1/markets/{id}/spread` | Cross-platform spread |
+| `spreads()` | `GET /v1/spreads` | Cross-platform price spreads |
+
+## Error handling
+
+```python
+from oddspipe import OddsPipe, OddsPipeError
+
+client = OddsPipe(api_key="your-key")
+try:
+    client.market(999999)
+except OddsPipeError as e:
+    print(e.status_code)  # 404
+    print(e.body)         # {"detail": "Market not found"}
+```

oddspipe-0.1.0/README.md

@@ -0,0 +1,65 @@
+# OddsPipe Python SDK
+
+Python client for the [OddsPipe](https://oddspipe.com) prediction market API.
+
+## Install
+
+```bash
+pip install oddspipe
+```
+
+## Quick start
+
+```python
+from oddspipe import OddsPipe
+
+client = OddsPipe(api_key="your-api-key")
+
+# List top markets by volume
+markets = client.markets(limit=10)
+for m in markets["items"]:
+    print(m["title"], m["spread"])
+
+# Search for a market
+results = client.search("Trump", platform="polymarket")
+
+# Get OHLCV candlesticks
+candles = client.candlesticks(market_id=123, interval="1h", limit=100)
+for c in candles["candles"]:
+    print(c["timestamp"], c["close"], c["volume"])
+
+# Find cross-platform price divergences
+spreads = client.spreads(min_spread=0.03)
+for item in spreads["items"]:
+    print(item["title"], item["spread"]["yes_diff"])
+
+# Cross-platform spread for a single market
+spread = client.spread(market_id=123)
+print(spread["sources"])
+print(spread["spread"])
+```
+
+## API reference
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `markets()` | `GET /v1/markets` | List markets with latest prices |
+| `market(id)` | `GET /v1/markets/{id}` | Single market detail |
+| `search(q)` | `GET /v1/markets/search` | Full-text search |
+| `history(id)` | `GET /v1/markets/{id}/history` | Raw price snapshots |
+| `candlesticks(id)` | `GET /v1/markets/{id}/candlesticks` | OHLCV candles (1m/5m/1h/1d) |
+| `spread(id)` | `GET /v1/markets/{id}/spread` | Cross-platform spread |
+| `spreads()` | `GET /v1/spreads` | Cross-platform price spreads |
+
+## Error handling
+
+```python
+from oddspipe import OddsPipe, OddsPipeError
+
+client = OddsPipe(api_key="your-key")
+try:
+    client.market(999999)
+except OddsPipeError as e:
+    print(e.status_code)  # 404
+    print(e.body)         # {"detail": "Market not found"}
+```

oddspipe-0.1.0/oddspipe/__init__.py

@@ -0,0 +1,4 @@
+from .client import OddsPipe, OddsPipeError
+
+__all__ = ["OddsPipe", "OddsPipeError"]
+__version__ = "0.1.0"

oddspipe-0.1.0/oddspipe/client.py

@@ -0,0 +1,146 @@
+"""Synchronous Python client for the OddsPipe prediction market API."""
+
+from __future__ import annotations
+
+import httpx
+
+
+class OddsPipeError(Exception):
+    """Raised when the API returns a non-200 response."""
+
+    def __init__(self, status_code: int, body: dict | str):
+        self.status_code = status_code
+        self.body = body
+        detail = body.get("detail", body) if isinstance(body, dict) else body
+        super().__init__(f"HTTP {status_code}: {detail}")
+
+
+class OddsPipe:
+    """Synchronous client for the OddsPipe API.
+
+    Usage::
+
+        client = OddsPipe(api_key="your-key")
+        markets = client.markets(limit=10)
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://oddspipe.com",
+        timeout: float = 30.0,
+    ):
+        self._base_url = base_url.rstrip("/")
+        self._client = httpx.Client(
+            base_url=f"{self._base_url}/v1",
+            headers={"X-API-Key": api_key},
+            timeout=timeout,
+        )
+
+    def _request(self, method: str, path: str, params: dict | None = None) -> dict:
+        resp = self._client.request(method, path, params=params)
+        if resp.status_code != 200:
+            try:
+                body = resp.json()
+            except Exception:
+                body = resp.text
+            raise OddsPipeError(resp.status_code, body)
+        return resp.json()
+
+    def _clean(self, params: dict) -> dict:
+        return {k: v for k, v in params.items() if v is not None}
+
+    # ----- endpoints -----
+
+    def markets(
+        self,
+        limit: int = 50,
+        offset: int = 0,
+        search: str | None = None,
+        status: str | None = None,
+    ) -> dict:
+        """List markets with sources and latest prices."""
+        return self._request("GET", "/markets", self._clean({
+            "limit": limit,
+            "offset": offset,
+            "search": search,
+            "status": status,
+        }))
+
+    def market(self, market_id: int) -> dict:
+        """Get a single market with all sources and latest snapshot per source."""
+        return self._request("GET", f"/markets/{market_id}")
+
+    def search(
+        self,
+        q: str,
+        platform: str | None = None,
+        status: str | None = None,
+        limit: int = 20,
+        offset: int = 0,
+    ) -> dict:
+        """Full-text search across market titles."""
+        return self._request("GET", "/markets/search", self._clean({
+            "q": q,
+            "platform": platform,
+            "status": status,
+            "limit": limit,
+            "offset": offset,
+        }))
+
+    def history(
+        self,
+        market_id: int,
+        source: str | None = None,
+        since: str | None = None,
+    ) -> dict:
+        """Get all price snapshots for a market."""
+        return self._request("GET", f"/markets/{market_id}/history", self._clean({
+            "source": source,
+            "since": since,
+        }))
+
+    def candlesticks(
+        self,
+        market_id: int,
+        interval: str = "1h",
+        source: str | None = None,
+        start: str | None = None,
+        end: str | None = None,
+        limit: int = 500,
+    ) -> dict:
+        """Get OHLCV candlestick data for a market."""
+        return self._request("GET", f"/markets/{market_id}/candlesticks", self._clean({
+            "interval": interval,
+            "source": source,
+            "start": start,
+            "end": end,
+            "limit": limit,
+        }))
+
+    def spread(self, market_id: int) -> dict:
+        """Get cross-platform spread for a single market."""
+        return self._request("GET", f"/markets/{market_id}/spread")
+
+    def spreads(
+        self,
+        limit: int = 50,
+        offset: int = 0,
+        min_spread: float | None = None,
+    ) -> dict:
+        """List all markets with cross-platform spreads, sorted by largest spread."""
+        return self._request("GET", "/spreads", self._clean({
+            "limit": limit,
+            "offset": offset,
+            "min_spread": min_spread,
+        }))
+
+    def close(self):
+        """Close the underlying HTTP client."""
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()

oddspipe-0.1.0/oddspipe.egg-info/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: oddspipe
+Version: 0.1.0
+Summary: Python client for the OddsPipe prediction market API
+Home-page: https://oddspipe.com
+Author: OddsPipe
+Author-email: hello@oddspipe.com
+License: MIT
+Project-URL: Documentation, https://oddspipe.com/docs
+Project-URL: Source, https://github.com/OddsPipe/oddspipe
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# OddsPipe Python SDK
+
+Python client for the [OddsPipe](https://oddspipe.com) prediction market API.
+
+## Install
+
+```bash
+pip install oddspipe
+```
+
+## Quick start
+
+```python
+from oddspipe import OddsPipe
+
+client = OddsPipe(api_key="your-api-key")
+
+# List top markets by volume
+markets = client.markets(limit=10)
+for m in markets["items"]:
+    print(m["title"], m["spread"])
+
+# Search for a market
+results = client.search("Trump", platform="polymarket")
+
+# Get OHLCV candlesticks
+candles = client.candlesticks(market_id=123, interval="1h", limit=100)
+for c in candles["candles"]:
+    print(c["timestamp"], c["close"], c["volume"])
+
+# Find cross-platform price divergences
+spreads = client.spreads(min_spread=0.03)
+for item in spreads["items"]:
+    print(item["title"], item["spread"]["yes_diff"])
+
+# Cross-platform spread for a single market
+spread = client.spread(market_id=123)
+print(spread["sources"])
+print(spread["spread"])
+```
+
+## API reference
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `markets()` | `GET /v1/markets` | List markets with latest prices |
+| `market(id)` | `GET /v1/markets/{id}` | Single market detail |
+| `search(q)` | `GET /v1/markets/search` | Full-text search |
+| `history(id)` | `GET /v1/markets/{id}/history` | Raw price snapshots |
+| `candlesticks(id)` | `GET /v1/markets/{id}/candlesticks` | OHLCV candles (1m/5m/1h/1d) |
+| `spread(id)` | `GET /v1/markets/{id}/spread` | Cross-platform spread |
+| `spreads()` | `GET /v1/spreads` | Cross-platform price spreads |
+
+## Error handling
+
+```python
+from oddspipe import OddsPipe, OddsPipeError
+
+client = OddsPipe(api_key="your-key")
+try:
+    client.market(999999)
+except OddsPipeError as e:
+    print(e.status_code)  # 404
+    print(e.body)         # {"detail": "Market not found"}
+```

oddspipe-0.1.0/oddspipe.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+oddspipe/__init__.py
+oddspipe/client.py
+oddspipe.egg-info/PKG-INFO
+oddspipe.egg-info/SOURCES.txt
+oddspipe.egg-info/dependency_links.txt
+oddspipe.egg-info/requires.txt
+oddspipe.egg-info/top_level.txt

oddspipe-0.1.0/oddspipe.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

oddspipe-0.1.0/oddspipe.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx

oddspipe-0.1.0/oddspipe.egg-info/top_level.txt

@@ -0,0 +1 @@
+oddspipe

oddspipe-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

oddspipe-0.1.0/setup.py

@@ -0,0 +1,30 @@
+from setuptools import setup, find_packages
+
+with open("README.md", encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="oddspipe",
+    version="0.1.0",
+    description="Python client for the OddsPipe prediction market API",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="OddsPipe",
+    author_email="hello@oddspipe.com",
+    url="https://oddspipe.com",
+    project_urls={
+        "Documentation": "https://oddspipe.com/docs",
+        "Source": "https://github.com/OddsPipe/oddspipe",
+    },
+    packages=find_packages(),
+    install_requires=["httpx"],
+    python_requires=">=3.8",
+    license="MIT",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Topic :: Office/Business :: Financial",
+    ],
+)