omnibook 1.1.0__tar.gz

omnibook-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: pip install -e ".[dev]"
+      - name: Unit tests
+        run: pytest -q --ignore=tests/integration

omnibook-1.1.0/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build
+        run: |
+          pip install build
+          python -m build
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

omnibook-1.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+.env
+*.egg
+.coverage
+htmlcov/
+.DS_Store

omnibook-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Raeth AI
+
+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.

omnibook-1.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: omnibook
+Version: 1.1.0
+Summary: Official Python SDK for the Omnibook prediction market exchange
+Project-URL: Homepage, https://omnibook.xyz
+Project-URL: Documentation, https://docs.omnibook.xyz/sdk/python
+Project-URL: Repository, https://github.com/OmniBook-HQ/python-sdk-v1
+Project-URL: Issues, https://github.com/OmniBook-HQ/python-sdk-v1/issues
+Author-email: Raeth AI <devs@omnibook.xyz>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: exchange,omnibook,prediction-markets,sdk,trading
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Omnibook Python SDK
+
+Official Python client for the [Omnibook](https://omnibook.xyz) prediction market
+exchange. Sign up, create an API key, install this package, and trade.
+
+```bash
+pip install omnibook
+```
+
+```python
+from omnibook import Client
+
+client = Client(api_key="<alphanumeric-api-key>", api_secret="<64-char-hex-secret>")
+
+status = client.get_exchange_status()
+rounds = client.get_rounds(limit=5)
+order = client.place_order(
+    client_order_id="42",
+    market_id=66,
+    side="buy",
+    outcome="yes",
+    type="limit",
+    tick=47,
+    qty=10,
+    tif="gtc",
+    post_only=True,
+)
+```
+
+## Prerequisites
+
+1. Sign in at [omnibook.xyz](https://omnibook.xyz).
+2. Deposit USDC (bot keys cannot withdraw).
+3. Create a key under **Settings → API keys**. Copy the **API key** and **secret**
+   (the secret is shown once).
+
+Docs: [docs.omnibook.xyz/sdk/python](https://docs.omnibook.xyz/sdk/python)
+
+## Environments
+
+| Env | REST | WebSocket |
+| --- | --- | --- |
+| Production (default) | `https://api.omnibook.xyz` | `wss://api.omnibook.xyz/v1/ws` |
+| Local | `http://127.0.0.1:9104` | `ws://127.0.0.1:9105/v1/ws` |
+
+```python
+client = Client(
+    api_key="...",
+    api_secret="...",
+    base_url="http://127.0.0.1:9104",
+    ws_url="ws://127.0.0.1:9105/v1/ws",
+)
+```
+
+## Sync and async
+
+```python
+from omnibook import Client, AsyncClient
+
+# Sync
+with Client(api_key=..., api_secret=...) as client:
+    print(client.get_balance())
+
+# Async
+async with AsyncClient(api_key=..., api_secret=...) as client:
+    print(await client.get_balance())
+```
+
+## WebSocket
+
+```python
+from omnibook import Client
+
+with Client(api_key=..., api_secret=...) as client:
+    with client.websocket() as ws:
+        ws.subscribe(channels=["rounds", "oracle", "user"])
+        ws.subscribe(channels=["orderbook_delta", "trades"], market_ids=[66])
+        for msg in ws:
+            print(msg)
+```
+
+## Auth note
+
+Every request is HMAC-SHA256 signed. Settings hands you a **64-character hex**
+secret (32 raw bytes). Pass that string (or a legacy base64 secret) to
+`api_secret` — the SDK hex-/base64-decodes it to the raw HMAC key for you.
+
+## Tests
+
+```bash
+pip install -e ".[dev]"
+pytest                     # unit tests (mocked)
+OMNIBOOK_RUN_INTEGRATION=1 \
+  OMNIBOOK_API_KEY=... \
+  OMNIBOOK_API_SECRET=... \
+  pytest -m integration    # live venue
+```
+
+## License
+
+MIT

omnibook-1.1.0/PUBLISHING.md

@@ -0,0 +1,26 @@
+# Publishing Omnibook Python SDK
+
+Local package is ready at version **1.0.0** (`dist/` passes `twine check`).
+
+Repo: https://github.com/OmniBook-HQ/python-sdk-v1
+
+## Publish to PyPI
+
+Preferred: Trusted Publishing (OIDC) via `.github/workflows/publish.yml`.
+
+1. On [pypi.org](https://pypi.org): create project `omnibook` (or claim the name).
+2. Add a trusted publisher: GitHub org `OmniBook-HQ`, repo `python-sdk-v1`,
+   workflow `publish.yml`, environment optional.
+3. Create a GitHub Release `v1.0.0` (or run the workflow manually).
+
+Manual upload (needs a PyPI API token):
+
+```bash
+twine upload dist/omnibook-1.0.0*
+```
+
+## Docs PR
+
+Branch already pushed: `docs/python-sdk` on `omnibook-docs`.
+
+Open: https://github.com/Raeth-AI/omnibook-docs/pull/new/docs/python-sdk

omnibook-1.1.0/README.md

@@ -0,0 +1,101 @@
+# Omnibook Python SDK
+
+Official Python client for the [Omnibook](https://omnibook.xyz) prediction market
+exchange. Sign up, create an API key, install this package, and trade.
+
+```bash
+pip install omnibook
+```
+
+```python
+from omnibook import Client
+
+client = Client(api_key="<alphanumeric-api-key>", api_secret="<64-char-hex-secret>")
+
+status = client.get_exchange_status()
+rounds = client.get_rounds(limit=5)
+order = client.place_order(
+    client_order_id="42",
+    market_id=66,
+    side="buy",
+    outcome="yes",
+    type="limit",
+    tick=47,
+    qty=10,
+    tif="gtc",
+    post_only=True,
+)
+```
+
+## Prerequisites
+
+1. Sign in at [omnibook.xyz](https://omnibook.xyz).
+2. Deposit USDC (bot keys cannot withdraw).
+3. Create a key under **Settings → API keys**. Copy the **API key** and **secret**
+   (the secret is shown once).
+
+Docs: [docs.omnibook.xyz/sdk/python](https://docs.omnibook.xyz/sdk/python)
+
+## Environments
+
+| Env | REST | WebSocket |
+| --- | --- | --- |
+| Production (default) | `https://api.omnibook.xyz` | `wss://api.omnibook.xyz/v1/ws` |
+| Local | `http://127.0.0.1:9104` | `ws://127.0.0.1:9105/v1/ws` |
+
+```python
+client = Client(
+    api_key="...",
+    api_secret="...",
+    base_url="http://127.0.0.1:9104",
+    ws_url="ws://127.0.0.1:9105/v1/ws",
+)
+```
+
+## Sync and async
+
+```python
+from omnibook import Client, AsyncClient
+
+# Sync
+with Client(api_key=..., api_secret=...) as client:
+    print(client.get_balance())
+
+# Async
+async with AsyncClient(api_key=..., api_secret=...) as client:
+    print(await client.get_balance())
+```
+
+## WebSocket
+
+```python
+from omnibook import Client
+
+with Client(api_key=..., api_secret=...) as client:
+    with client.websocket() as ws:
+        ws.subscribe(channels=["rounds", "oracle", "user"])
+        ws.subscribe(channels=["orderbook_delta", "trades"], market_ids=[66])
+        for msg in ws:
+            print(msg)
+```
+
+## Auth note
+
+Every request is HMAC-SHA256 signed. Settings hands you a **64-character hex**
+secret (32 raw bytes). Pass that string (or a legacy base64 secret) to
+`api_secret` — the SDK hex-/base64-decodes it to the raw HMAC key for you.
+
+## Tests
+
+```bash
+pip install -e ".[dev]"
+pytest                     # unit tests (mocked)
+OMNIBOOK_RUN_INTEGRATION=1 \
+  OMNIBOOK_API_KEY=... \
+  OMNIBOOK_API_SECRET=... \
+  pytest -m integration    # live venue
+```
+
+## License
+
+MIT

omnibook-1.1.0/examples/place_order.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""Place a small post-only limit order on the current trading round."""
+
+from __future__ import annotations
+
+import os
+import sys
+import time
+
+from omnibook import Client
+from omnibook.errors import OmnibookAPIError
+
+
+def main() -> int:
+    key = os.environ.get("OMNIBOOK_API_KEY")
+    secret = os.environ.get("OMNIBOOK_API_SECRET")
+    if not key or not secret:
+        print("Set OMNIBOOK_API_KEY and OMNIBOOK_API_SECRET", file=sys.stderr)
+        return 1
+
+    base = os.environ.get("OMNIBOOK_BASE_URL", "https://api.omnibook.xyz")
+    with Client(api_key=key, api_secret=secret, base_url=base) as client:
+        rounds = client.get_rounds(limit=5)
+        items = rounds.get("rounds") or []
+        if not items:
+            print("No rounds returned", file=sys.stderr)
+            return 1
+        market_id = int(items[0]["market_id"])
+        client_order_id = str(int(time.time() * 1000))
+        print(f"Placing post-only buy YES on market_id={market_id} id={client_order_id}")
+        try:
+            result = client.place_order(
+                client_order_id=client_order_id,
+                market_id=market_id,
+                side="buy",
+                outcome="yes",
+                type="limit",
+                tick=1,
+                qty=1,
+                tif="gtc",
+                post_only=True,
+            )
+        except OmnibookAPIError as exc:
+            print(f"Place failed: {exc}", file=sys.stderr)
+            return 1
+        print(result)
+        order_id = result.get("order_id")
+        if order_id:
+            canceled = client.cancel_order(str(order_id))
+            print("canceled:", canceled)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

omnibook-1.1.0/examples/stream_user.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+"""Stream private user channel + rounds until Ctrl-C."""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from omnibook import Client
+
+
+def main() -> int:
+    key = os.environ.get("OMNIBOOK_API_KEY")
+    secret = os.environ.get("OMNIBOOK_API_SECRET")
+    if not key or not secret:
+        print("Set OMNIBOOK_API_KEY and OMNIBOOK_API_SECRET", file=sys.stderr)
+        return 1
+
+    base = os.environ.get("OMNIBOOK_BASE_URL", "https://api.omnibook.xyz")
+    ws_url = os.environ.get("OMNIBOOK_WS_URL", "wss://api.omnibook.xyz/v1/ws")
+
+    with Client(api_key=key, api_secret=secret, base_url=base, ws_url=ws_url) as client:
+        with client.websocket() as ws:
+            ws.subscribe(channels=["user", "rounds", "oracle"])
+            print("subscribed; waiting for messages…")
+            for msg in ws:
+                print(msg)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

omnibook-1.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "omnibook"
+version = "1.1.0"
+description = "Official Python SDK for the Omnibook prediction market exchange"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Raeth AI", email = "devs@omnibook.xyz" }]
+keywords = ["omnibook", "exchange", "prediction-markets", "trading", "sdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27",
+    "websockets>=12.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "respx>=0.21",
+]
+
+[project.urls]
+Homepage = "https://omnibook.xyz"
+Documentation = "https://docs.omnibook.xyz/sdk/python"
+Repository = "https://github.com/OmniBook-HQ/python-sdk-v1"
+Issues = "https://github.com/OmniBook-HQ/python-sdk-v1/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/omnibook"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+markers = [
+    "integration: live venue tests (require OMNIBOOK_RUN_INTEGRATION=1 and API credentials)",
+]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

omnibook-1.1.0/src/omnibook/__init__.py

@@ -0,0 +1,34 @@
+"""Official Python SDK for the Omnibook prediction market exchange."""
+
+from __future__ import annotations
+
+from .async_client import AsyncClient
+from .auth import DEFAULT_BASE_URL, DEFAULT_WS_URL
+from .client import Client
+from .errors import (
+    OmnibookAPIError,
+    OmnibookAuthError,
+    OmnibookError,
+    OmnibookRateLimitError,
+    OmnibookTimeoutError,
+    OmnibookWSError,
+)
+from .ws import AsyncWebSocketClient, WebSocketClient
+
+__all__ = [
+    "AsyncClient",
+    "AsyncWebSocketClient",
+    "Client",
+    "DEFAULT_BASE_URL",
+    "DEFAULT_WS_URL",
+    "OmnibookAPIError",
+    "OmnibookAuthError",
+    "OmnibookError",
+    "OmnibookRateLimitError",
+    "OmnibookTimeoutError",
+    "OmnibookWSError",
+    "WebSocketClient",
+    "__version__",
+]
+
+__version__ = "1.1.0"

omnibook-1.1.0/src/omnibook/_base.py

@@ -0,0 +1,61 @@
+"""Shared REST helpers used by sync and async clients."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+from urllib.parse import urlparse
+
+from .auth import DEFAULT_BASE_URL, DEFAULT_WS_URL, decode_secret, signed_headers
+from .errors import raise_for_response
+from .models import JsonDict, compact_json_bytes, path_with_query
+
+
+class BaseClient:
+    """Credential + URL configuration shared by Client and AsyncClient."""
+
+    def __init__(
+        self,
+        api_key: str | int,
+        api_secret: str | bytes,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        ws_url: str = DEFAULT_WS_URL,
+        timeout: float = 30.0,
+    ) -> None:
+        self.api_key = str(api_key)
+        self._secret = decode_secret(api_secret)
+        self.base_url = base_url.rstrip("/")
+        self.ws_url = ws_url
+        self.timeout = timeout
+        parsed = urlparse(self.base_url)
+        if not parsed.scheme or not parsed.netloc:
+            raise ValueError(f"invalid base_url: {base_url!r}")
+
+    def _prepare(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: dict[str, Any] | None = None,
+        json_body: JsonDict | list[Any] | None = None,
+    ) -> tuple[str, bytes, dict[str, str]]:
+        target = path_with_query(path, params)
+        body = b""
+        if json_body is not None:
+            body = compact_json_bytes(json_body)
+        headers = signed_headers(self.api_key, self._secret, method, target, body)
+        return target, body, headers
+
+    @staticmethod
+    def _parse_response(status_code: int, text: str, header_map: dict[str, str]) -> Any:
+        data: Any
+        if not text:
+            data = None
+        else:
+            try:
+                data = json.loads(text)
+            except json.JSONDecodeError:
+                data = text
+        raise_for_response(status_code, data, header_map)
+        return data