pax-api 2.0.0__tar.gz

pax_api-2.0.0/LICENSE

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

pax_api-2.0.0/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: pax-api
+Version: 2.0.0
+Summary: Official Python SDK for the PredictAsiaX Trader Track API — Web3-native prediction markets
+Author-email: PredictAsiaX <support@predictasiax.com>
+License: MIT
+Project-URL: Homepage, https://predictasiax.com/developer
+Project-URL: Documentation, https://docs.predictasiax.com
+Project-URL: Repository, https://github.com/predictasiax/pax-python-sdk
+Project-URL: Issues, https://github.com/predictasiax/pax-python-sdk/issues
+Project-URL: Changelog, https://docs.predictasiax.com/changelog
+Keywords: predictasiax,pax,prediction-market,trading-api,web3,hmac,polymarket-compatible
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Requires-Dist: websocket-client>=1.5
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov>=4; extra == "dev"
+Requires-Dist: responses>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: mypy>=1; extra == "dev"
+Requires-Dist: build>=1; extra == "dev"
+Requires-Dist: twine>=4; extra == "dev"
+Dynamic: license-file
+
+# pax-api — Official Python SDK for PredictAsiaX
+
+Web3-native prediction market REST + WebSocket API client. Polymarket-compatible HMAC signing pattern.
+
+**Version 1.0.0** · MIT license · Python 3.8+
+
+- **Docs**: https://docs.predictasiax.com
+- **Developer landing**: https://predictasiax.com/developer
+- **Get API key**: https://predictasiax.com/settings/api-keys
+- **Support**: support@predictasiax.com
+
+## Install
+
+```bash
+# Direct install from PredictAsiaX-hosted wheel
+pip install https://docs.predictasiax.com/downloads/sdk/python/pax_api-1.0.0-py3-none-any.whl
+
+# Or download tarball + install locally
+curl -O https://docs.predictasiax.com/downloads/sdk/python/pax_api-1.0.0.tar.gz
+pip install pax_api-1.0.0.tar.gz
+```
+
+(PyPI publish coming soon — install methods above work today.)
+
+## Quickstart (sandbox — no real money)
+
+```python
+from pax_api import PaxClient
+
+with PaxClient(api_key="sk_test_YOUR_KEY", env="sandbox") as pax:
+    faucet = pax.faucet()                          # get 10k test USDT
+    print(faucet["data"]["balance_free"])           # → "10000.000000"
+
+    templates = pax.list_templates()
+    markets   = pax.list_markets(category="crypto", limit=10)
+
+    market = pax.create_market(
+        template_id="crypto_price_binary_60s",
+        params={"asset": "BTC"},
+    )
+    print(market["data"]["market"]["market_id"])    # → "m_..."
+```
+
+## HMAC-signed requests (production)
+
+Machine-to-machine trading bots should use HMAC signing (Polymarket-compatible 5-header pattern).
+
+```python
+from pax_api import PaxClient
+
+pax = PaxClient(
+    api_key="sk_live_YOUR_KEY",
+    secret="<64-hex secret>",
+    passphrase="<passphrase>",
+    env="production",
+)
+
+pax.place_order(
+    market_id="m_...",
+    outcome_id="yes",
+    side="buy",
+    order_type="limit",
+    size="100",
+    price="0.55",
+    client_order_id="unique-per-intent-id",  # retry-safe within 24h
+)
+```
+
+## WebSocket streams
+
+```python
+from pax_api import PaxWSClient
+
+ws = PaxWSClient(
+    api_key="sk_test_...",
+    env="sandbox",
+    subscribe_on_connect=["fast_tick", "trade_executed", "account"],
+)
+ws.on("fast_tick",      lambda e: print("tick:", e))
+ws.on("trade_executed", lambda e: print("trade:", e))
+ws.on("account",        lambda e: print("balance:", e.get("balance_free")))
+ws.run_forever()                                    # blocks; Ctrl+C to exit
+```
+
+Auto-reconnect + exponential backoff built-in. All 4 client methods supported:
+`subscribe`, `unsubscribe`, `auth`, `set_locale`.
+
+## Error handling
+
+Every response error becomes a typed exception. Catch the specific type
+you want to handle:
+
+```python
+from pax_api import (
+    PaxClient,
+    PaxRateLimitError,
+    PaxReadOnlyModeError,
+    PaxValidationError,
+    PaxWrongEnvKeyError,
+    PaxError,           # base class — catch-all
+)
+
+try:
+    pax.place_order(...)
+except PaxRateLimitError as e:
+    time.sleep(e.retry_after or 5)
+    # then retry
+except PaxValidationError as e:
+    print(f"Bad request: {e.details}")             # {'field': 'size', ...}
+except PaxReadOnlyModeError:
+    print("Trading paused by ops")
+except PaxWrongEnvKeyError:
+    print("Wrong environment key")
+except PaxError as e:
+    print(f"[{e.code}] {e.message} (request_id={e.request_id})")
+```
+
+## Automatic retry
+
+Built-in exponential backoff on `429`, `500`, `502`, `504` responses. `Retry-After`
+header respected on rate limits. Non-idempotent creates are safe when you send
+`client_order_id`.
+
+```python
+pax = PaxClient(api_key="sk_test_...", env="sandbox", max_retries=5)
+# max_retries=0 disables retries entirely
+```
+
+## Environments
+
+| Env | Base URL | Keys |
+|---|---|---|
+| `production` | `https://api.predictasiax.com/v1` | `sk_live_*` |
+| `sandbox`    | `https://api.predictasiax.com/v1` | `sk_test_*` |
+
+`sk_test_*` on production returns `401 WRONG_ENV_KEY`. Same the other way. See
+[docs auth guide](https://docs.predictasiax.com/auth#env-separation).
+
+## Custom base URL
+
+```python
+pax = PaxClient(api_key="...", base_url="https://your-mirror/api")
+```
+
+## Development
+
+```bash
+# Get source (tarball)
+curl -O https://docs.predictasiax.com/downloads/sdk/python/pax_api-1.0.0.tar.gz
+tar -xzf pax_api-1.0.0.tar.gz && cd pax_api-1.0.0
+pip install -e ".[dev]"
+pytest                                              # run all tests
+ruff check src tests                                # lint
+mypy src                                            # type-check
+```
+
+## Links
+
+- [OpenAPI spec](https://docs.predictasiax.com/openapi)
+- [AsyncAPI (WebSocket) spec](https://docs.predictasiax.com/asyncapi)
+- [Auth guide](https://docs.predictasiax.com/auth)
+- [Error codes](https://docs.predictasiax.com/errors)
+- [Rate limits](https://docs.predictasiax.com/rate-limits)
+- [FAQ](https://docs.predictasiax.com/faq)
+- [API Terms](https://docs.predictasiax.com/api-terms)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

pax_api-2.0.0/README.md

@@ -0,0 +1,169 @@
+# pax-api — Official Python SDK for PredictAsiaX
+
+Web3-native prediction market REST + WebSocket API client. Polymarket-compatible HMAC signing pattern.
+
+**Version 1.0.0** · MIT license · Python 3.8+
+
+- **Docs**: https://docs.predictasiax.com
+- **Developer landing**: https://predictasiax.com/developer
+- **Get API key**: https://predictasiax.com/settings/api-keys
+- **Support**: support@predictasiax.com
+
+## Install
+
+```bash
+# Direct install from PredictAsiaX-hosted wheel
+pip install https://docs.predictasiax.com/downloads/sdk/python/pax_api-1.0.0-py3-none-any.whl
+
+# Or download tarball + install locally
+curl -O https://docs.predictasiax.com/downloads/sdk/python/pax_api-1.0.0.tar.gz
+pip install pax_api-1.0.0.tar.gz
+```
+
+(PyPI publish coming soon — install methods above work today.)
+
+## Quickstart (sandbox — no real money)
+
+```python
+from pax_api import PaxClient
+
+with PaxClient(api_key="sk_test_YOUR_KEY", env="sandbox") as pax:
+    faucet = pax.faucet()                          # get 10k test USDT
+    print(faucet["data"]["balance_free"])           # → "10000.000000"
+
+    templates = pax.list_templates()
+    markets   = pax.list_markets(category="crypto", limit=10)
+
+    market = pax.create_market(
+        template_id="crypto_price_binary_60s",
+        params={"asset": "BTC"},
+    )
+    print(market["data"]["market"]["market_id"])    # → "m_..."
+```
+
+## HMAC-signed requests (production)
+
+Machine-to-machine trading bots should use HMAC signing (Polymarket-compatible 5-header pattern).
+
+```python
+from pax_api import PaxClient
+
+pax = PaxClient(
+    api_key="sk_live_YOUR_KEY",
+    secret="<64-hex secret>",
+    passphrase="<passphrase>",
+    env="production",
+)
+
+pax.place_order(
+    market_id="m_...",
+    outcome_id="yes",
+    side="buy",
+    order_type="limit",
+    size="100",
+    price="0.55",
+    client_order_id="unique-per-intent-id",  # retry-safe within 24h
+)
+```
+
+## WebSocket streams
+
+```python
+from pax_api import PaxWSClient
+
+ws = PaxWSClient(
+    api_key="sk_test_...",
+    env="sandbox",
+    subscribe_on_connect=["fast_tick", "trade_executed", "account"],
+)
+ws.on("fast_tick",      lambda e: print("tick:", e))
+ws.on("trade_executed", lambda e: print("trade:", e))
+ws.on("account",        lambda e: print("balance:", e.get("balance_free")))
+ws.run_forever()                                    # blocks; Ctrl+C to exit
+```
+
+Auto-reconnect + exponential backoff built-in. All 4 client methods supported:
+`subscribe`, `unsubscribe`, `auth`, `set_locale`.
+
+## Error handling
+
+Every response error becomes a typed exception. Catch the specific type
+you want to handle:
+
+```python
+from pax_api import (
+    PaxClient,
+    PaxRateLimitError,
+    PaxReadOnlyModeError,
+    PaxValidationError,
+    PaxWrongEnvKeyError,
+    PaxError,           # base class — catch-all
+)
+
+try:
+    pax.place_order(...)
+except PaxRateLimitError as e:
+    time.sleep(e.retry_after or 5)
+    # then retry
+except PaxValidationError as e:
+    print(f"Bad request: {e.details}")             # {'field': 'size', ...}
+except PaxReadOnlyModeError:
+    print("Trading paused by ops")
+except PaxWrongEnvKeyError:
+    print("Wrong environment key")
+except PaxError as e:
+    print(f"[{e.code}] {e.message} (request_id={e.request_id})")
+```
+
+## Automatic retry
+
+Built-in exponential backoff on `429`, `500`, `502`, `504` responses. `Retry-After`
+header respected on rate limits. Non-idempotent creates are safe when you send
+`client_order_id`.
+
+```python
+pax = PaxClient(api_key="sk_test_...", env="sandbox", max_retries=5)
+# max_retries=0 disables retries entirely
+```
+
+## Environments
+
+| Env | Base URL | Keys |
+|---|---|---|
+| `production` | `https://api.predictasiax.com/v1` | `sk_live_*` |
+| `sandbox`    | `https://api.predictasiax.com/v1` | `sk_test_*` |
+
+`sk_test_*` on production returns `401 WRONG_ENV_KEY`. Same the other way. See
+[docs auth guide](https://docs.predictasiax.com/auth#env-separation).
+
+## Custom base URL
+
+```python
+pax = PaxClient(api_key="...", base_url="https://your-mirror/api")
+```
+
+## Development
+
+```bash
+# Get source (tarball)
+curl -O https://docs.predictasiax.com/downloads/sdk/python/pax_api-1.0.0.tar.gz
+tar -xzf pax_api-1.0.0.tar.gz && cd pax_api-1.0.0
+pip install -e ".[dev]"
+pytest                                              # run all tests
+ruff check src tests                                # lint
+mypy src                                            # type-check
+```
+
+## Links
+
+- [OpenAPI spec](https://docs.predictasiax.com/openapi)
+- [AsyncAPI (WebSocket) spec](https://docs.predictasiax.com/asyncapi)
+- [Auth guide](https://docs.predictasiax.com/auth)
+- [Error codes](https://docs.predictasiax.com/errors)
+- [Rate limits](https://docs.predictasiax.com/rate-limits)
+- [FAQ](https://docs.predictasiax.com/faq)
+- [API Terms](https://docs.predictasiax.com/api-terms)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

pax_api-2.0.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pax-api"
+version = "2.0.0"
+description = "Official Python SDK for the PredictAsiaX Trader Track API — Web3-native prediction markets"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "PredictAsiaX", email = "support@predictasiax.com" },
+]
+keywords = ["predictasiax", "pax", "prediction-market", "trading-api", "web3", "hmac", "polymarket-compatible"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.28",
+    "websocket-client>=1.5",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7",
+    "pytest-cov>=4",
+    "responses>=0.23",
+    "ruff>=0.1",
+    "mypy>=1",
+    "build>=1",
+    "twine>=4",
+]
+
+[project.urls]
+Homepage = "https://predictasiax.com/developer"
+Documentation = "https://docs.predictasiax.com"
+Repository = "https://github.com/predictasiax/pax-python-sdk"
+Issues = "https://github.com/predictasiax/pax-python-sdk/issues"
+Changelog = "https://docs.predictasiax.com/changelog"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pax_api = ["py.typed"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py38"
+
+[tool.mypy]
+python_version = "3.8"
+strict = true
+warn_return_any = true
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra -q --strict-markers"
+testpaths = ["tests"]

pax_api-2.0.0/setup.cfg

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

pax_api-2.0.0/src/pax_api/__init__.py

@@ -0,0 +1,60 @@
+"""PredictAsiaX (PAX) Python SDK.
+
+Web3-native prediction market REST + WebSocket API client.
+Homepage: https://predictasiax.com/developer
+Docs: https://docs.predictasiax.com
+
+Quick start (anonymous sandbox mint in 30 sec):
+    >>> from pax_api import PaxClient
+    >>> boot = PaxClient(api_key="anonymous")
+    >>> key = boot.mint_sandbox_key(org_name="my-app")
+    >>> print(key["api_key"])   # sk_live_..., shown ONCE — save it
+    >>> client = PaxClient(api_key=key["api_key"])
+    >>> client.list_markets(category="crypto", limit=10)
+
+For HMAC signing (production trading bots):
+    >>> client = PaxClient(
+    ...     api_key="sk_live_...",
+    ...     secret="<hex-secret>",
+    ...     passphrase="<passphrase>",
+    ... )
+    >>> client.place_order(market_id="m_...", outcome_id="yes",
+    ...                    side="buy", order_type="market", size="100")
+
+Environment model: sandbox is a *tier* on the key (tier=self_serve, $10/$100
+caps), not a separate host. Same prefix, same URL — promote to production by
+upgrading the key's tier.
+"""
+
+__version__ = "2.0.0"
+
+from pax_api.client import PaxClient  # noqa: E402
+from pax_api.ws_client import PaxWSClient  # noqa: E402
+from pax_api.errors import (  # noqa: E402
+    PaxError,
+    PaxAuthError,
+    PaxRateLimitError,
+    PaxValidationError,
+    PaxNotFoundError,
+    PaxConflictError,
+    PaxServerError,
+    PaxReadOnlyModeError,
+    PaxSandboxOnlyError,
+    PaxWrongEnvKeyError,
+)
+
+__all__ = [
+    "PaxClient",
+    "PaxWSClient",
+    "PaxError",
+    "PaxAuthError",
+    "PaxRateLimitError",
+    "PaxValidationError",
+    "PaxNotFoundError",
+    "PaxConflictError",
+    "PaxServerError",
+    "PaxReadOnlyModeError",
+    "PaxSandboxOnlyError",
+    "PaxWrongEnvKeyError",
+    "__version__",
+]

pax_api-2.0.0/src/pax_api/auth.py

@@ -0,0 +1,66 @@
+"""HMAC signing helpers — Polymarket-compatible 5-header pattern.
+
+Signature construction:
+    message = timestamp_ms + method_upper + path + body
+    signature = base64(HMAC-SHA256(secret, message))
+
+Headers sent:
+    POLY_ACCESS_KEY: <key_id>
+    POLY_TIMESTAMP:  <ms epoch>
+    POLY_PASSPHRASE: <passphrase>
+    POLY_SIGNATURE:  <base64 sig>
+
+Server rejects with 401 INVALID_SIGNATURE if timestamp is more than
+±30 seconds from server clock. Sync your machine via NTP.
+"""
+
+from __future__ import annotations
+
+import base64
+import hashlib
+import hmac
+import time
+from typing import Dict, Optional
+
+
+def sign_request(
+    method: str,
+    path: str,
+    body: str,
+    key_id: str,
+    secret: str,
+    passphrase: str,
+    timestamp_ms: Optional[int] = None,
+) -> Dict[str, str]:
+    """Build the 5 POLY_* headers for an HMAC-signed request.
+
+    Args:
+        method: HTTP method (GET/POST/DELETE/etc.). Case-normalized to upper.
+        path: URL path INCLUDING leading slash and query string, e.g.
+            ``/v1/markets?category=crypto``.
+        body: Raw request body as string (empty string for GET/DELETE
+            without body). Must be the exact bytes sent on the wire.
+        key_id: Your ``sk_live_*`` key ID.
+        secret: HMAC secret (hex string) obtained at key mint time.
+        passphrase: Passphrase obtained at key mint time.
+        timestamp_ms: Override timestamp for testing. Defaults to now.
+
+    Returns:
+        Dict of 5 headers to merge into the request.
+    """
+    ts = str(timestamp_ms if timestamp_ms is not None else int(time.time() * 1000))
+    method_u = method.upper()
+    message = ts + method_u + path + (body or "")
+    digest = hmac.new(secret.encode("utf-8"), message.encode("utf-8"), hashlib.sha256).digest()
+    signature = base64.b64encode(digest).decode("ascii")
+    return {
+        "POLY_ACCESS_KEY": key_id,
+        "POLY_TIMESTAMP": ts,
+        "POLY_PASSPHRASE": passphrase,
+        "POLY_SIGNATURE": signature,
+    }
+
+
+def build_message(method: str, path: str, body: str, timestamp_ms: int) -> str:
+    """Return the canonical signing message (exposed for debugging)."""
+    return f"{timestamp_ms}{method.upper()}{path}{body or ''}"