predigy-edge-sdk 2.0.0__tar.gz

predigy_edge_sdk-2.0.0/PKG-INFO

@@ -0,0 +1,289 @@
+Metadata-Version: 2.4
+Name: predigy-edge-sdk
+Version: 2.0.0
+Summary: Official Python SDK for the EDGE by Predigy prediction market API (retail, parlay, compliance/MICS, LP)
+Author: Predigy LLC
+License: MIT
+Project-URL: Homepage, https://edge-by-predigy.netlify.app
+Project-URL: Repository, https://github.com/predigy/edge
+Project-URL: Documentation, https://edge-production-7b77.up.railway.app/docs
+Project-URL: Bug Tracker, https://github.com/predigy/edge/issues
+Keywords: edge,predigy,prediction-market,lmsr,sdk,retail,parlay,compliance,mics,liquidity-provider
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+
+# EDGE Python SDK
+
+Official Python SDK for the [EDGE by Predigy](https://edge-by-predigy.netlify.app) prediction market API.
+
+EDGE is a prediction market pricing engine that integrates with sportsbook platforms. This SDK provides a fully-typed async client for all API operations.
+
+---
+
+## Installation
+
+```bash
+pip install edge-sdk
+```
+
+**Requirements:** Python 3.11+
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+from edge_sdk import EdgeClient
+
+async def main():
+    async with EdgeClient(
+        base_url="https://edge-production-7b77.up.railway.app",
+        api_key="your-api-key",
+    ) as client:
+        # List open markets
+        result = await client.list_markets(status="OPEN")
+        for market in result.markets:
+            print(f"{market.title}: YES={market.prices.yes:.1%}, NO={market.prices.no:.1%}")
+
+        # Get a quote before trading
+        quote = await client.get_quote("mkt_abc123", side="YES", amount=50.0)
+        print(f"Cost: ${quote.total_cost:.2f} for {quote.contracts:.1f} contracts")
+
+        # Execute the trade
+        trade = await client.execute_trade("mkt_abc123", side="YES", amount=50.0)
+        print(f"Trade {trade.trade_id} executed! New balance: ${trade.new_balance:.2f}")
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+Every request requires an API key passed in the `X-API-Key` header. The SDK handles this automatically:
+
+```python
+client = EdgeClient(
+    base_url="https://edge-production-7b77.up.railway.app",
+    api_key="your-api-key",
+)
+```
+
+You receive your API key when your operator account is created by the Predigy team.
+
+---
+
+## API Reference
+
+### Markets
+
+```python
+# List markets with optional filters
+markets = await client.list_markets(status="OPEN", category="NBA", limit=10)
+
+# Get a single market by external ID
+market = await client.get_market("mkt_abc123")
+
+# Create a new market (admin)
+market = await client.create_market(
+    title="Lakers vs Celtics — Lakers Win",
+    category="NBA",
+    description="Will the Lakers win tonight's game?",
+    b_base=5000.0,
+    initial_price_yes=0.55,
+)
+```
+
+### Quotes and Trades
+
+```python
+# Get a price quote (does not execute a trade)
+quote = await client.get_quote("mkt_abc123", side="YES", amount=100.0)
+print(f"Contracts: {quote.contracts}")
+print(f"Avg price: ${quote.avg_fill_price:.4f}")
+print(f"Fee: ${quote.fee:.2f} ({quote.fee_rate:.2%})")
+print(f"Total cost: ${quote.total_cost:.2f}")
+
+# Execute a trade
+trade = await client.execute_trade("mkt_abc123", side="YES", amount=100.0)
+
+# Execute with slippage protection
+trade = await client.execute_trade(
+    "mkt_abc123", side="YES", amount=100.0,
+    max_avg_price=0.60,  # Reject if avg price exceeds $0.60
+)
+
+# Sell (cash out) contracts from an existing position
+sell = await client.sell_position("mkt_abc123", side="YES", contracts=50.0)
+print(f"Net payout: ${sell.net_payout:.2f}")
+```
+
+### Portfolio
+
+```python
+portfolio = await client.get_portfolio()
+print(f"Balance: ${portfolio.balance:.2f}")
+print(f"Unrealized P&L: ${portfolio.total_unrealized_pnl:.2f}")
+
+for pos in portfolio.positions:
+    print(f"  {pos.market_title} ({pos.side}): {pos.contracts} contracts, P&L: ${pos.unrealized_pnl:.2f}")
+```
+
+### Admin Operations
+
+```python
+# Get platform statistics
+stats = await client.get_stats()
+print(f"Total markets: {stats.total_markets}")
+print(f"Total volume: ${stats.total_volume:,.2f}")
+
+# Settle a market
+result = await client.settle_market("mkt_abc123", outcome="YES")
+
+# Reset sandbox data
+await client.reset_sandbox()
+```
+
+### Webhooks
+
+```python
+# Register a webhook endpoint
+webhook = await client.create_webhook(
+    url="https://your-app.com/webhook",
+    events=["trade.executed", "market.settled"],
+    description="Production trade notifications",
+)
+print(f"Webhook ID: {webhook.webhook.external_id}")
+print(f"Secret: {webhook.secret}")  # Store this — shown only once!
+
+# List webhooks
+webhooks = await client.list_webhooks()
+
+# Delete a webhook
+await client.delete_webhook("whk_abc123")
+```
+
+### Health Check
+
+```python
+health = await client.health_check()
+print(health)  # {"status": "healthy"}
+```
+
+---
+
+## Error Handling
+
+The SDK raises typed exceptions for different error scenarios:
+
+```python
+from edge_sdk.exceptions import (
+    EdgeAPIError,       # Base class for all API errors
+    EdgeAuthError,      # 401 — Invalid or missing API key
+    EdgeRateLimitError, # 429 — Too many requests
+    EdgeValidationError,# 422 — Invalid request data
+)
+
+try:
+    trade = await client.execute_trade("mkt_abc123", side="YES", amount=100.0)
+except EdgeAuthError as e:
+    print(f"Authentication failed: {e.detail}")
+except EdgeRateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except EdgeValidationError as e:
+    print(f"Invalid request: {e.detail}")
+except EdgeAPIError as e:
+    print(f"API error {e.status_code}: {e.detail}")
+    print(f"Request ID: {e.request_id}")  # Useful for support
+```
+
+All exceptions include a `request_id` field that you can reference when contacting support.
+
+---
+
+## Webhook Verification
+
+When receiving webhook deliveries, verify the HMAC-SHA256 signature to ensure the payload is authentic:
+
+```python
+from edge_sdk import verify_signature
+
+# In your webhook handler (e.g., FastAPI)
+@app.post("/webhook")
+async def handle_webhook(request: Request):
+    body = await request.body()
+    signature = request.headers.get("X-Edge-Signature", "")
+
+    if not verify_signature(body, signature, WEBHOOK_SECRET):
+        raise HTTPException(401, "Invalid signature")
+
+    event = json.loads(body)
+    print(f"Received event: {event['event_type']}")
+    # Process event...
+```
+
+The `X-Edge-Signature` header format is `sha256=<hex_digest>`.
+
+**Webhook event types:**
+- `trade.executed` — A trade was placed
+- `market.created` — A new market was created
+- `market.settled` — A market was settled with an outcome
+- `market.suspended` — A market was suspended
+- `surge.activated` — Surge pricing was triggered
+- `liquidity.adjusted` — Dynamic liquidity parameter changed
+
+---
+
+## Advanced Usage
+
+### Custom HTTP Client
+
+You can provide your own `httpx.AsyncClient` for custom timeouts, proxies, or connection pooling:
+
+```python
+import httpx
+
+custom_client = httpx.AsyncClient(
+    base_url="https://edge-production-7b77.up.railway.app",
+    timeout=60.0,
+    headers={"X-API-Key": "your-api-key", "Content-Type": "application/json"},
+    limits=httpx.Limits(max_connections=20),
+)
+
+client = EdgeClient(
+    base_url="https://edge-production-7b77.up.railway.app",
+    api_key="your-api-key",
+    http_client=custom_client,
+)
+```
+
+### Type Safety
+
+The SDK is fully typed with Pydantic models. All responses are validated and provide IDE autocompletion. The `py.typed` marker (PEP 561) enables type checking in tools like mypy and pyright.
+
+---
+
+## Links
+
+- **API Documentation:** [docs/API.md](../../docs/API.md)
+- **Integration Guide:** [docs/EDGE_INTEGRATION_GUIDE.md](../../docs/EDGE_INTEGRATION_GUIDE.md)
+- **Live API (Swagger):** [edge-production-7b77.up.railway.app/docs](https://edge-production-7b77.up.railway.app/docs)
+- **Frontend Demo:** [edge-by-predigy.netlify.app](https://edge-by-predigy.netlify.app)
+
+---
+
+## License
+
+Proprietary. Copyright Predigy LLC. All rights reserved.

predigy_edge_sdk-2.0.0/README.md

@@ -0,0 +1,264 @@
+# EDGE Python SDK
+
+Official Python SDK for the [EDGE by Predigy](https://edge-by-predigy.netlify.app) prediction market API.
+
+EDGE is a prediction market pricing engine that integrates with sportsbook platforms. This SDK provides a fully-typed async client for all API operations.
+
+---
+
+## Installation
+
+```bash
+pip install edge-sdk
+```
+
+**Requirements:** Python 3.11+
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+from edge_sdk import EdgeClient
+
+async def main():
+    async with EdgeClient(
+        base_url="https://edge-production-7b77.up.railway.app",
+        api_key="your-api-key",
+    ) as client:
+        # List open markets
+        result = await client.list_markets(status="OPEN")
+        for market in result.markets:
+            print(f"{market.title}: YES={market.prices.yes:.1%}, NO={market.prices.no:.1%}")
+
+        # Get a quote before trading
+        quote = await client.get_quote("mkt_abc123", side="YES", amount=50.0)
+        print(f"Cost: ${quote.total_cost:.2f} for {quote.contracts:.1f} contracts")
+
+        # Execute the trade
+        trade = await client.execute_trade("mkt_abc123", side="YES", amount=50.0)
+        print(f"Trade {trade.trade_id} executed! New balance: ${trade.new_balance:.2f}")
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+Every request requires an API key passed in the `X-API-Key` header. The SDK handles this automatically:
+
+```python
+client = EdgeClient(
+    base_url="https://edge-production-7b77.up.railway.app",
+    api_key="your-api-key",
+)
+```
+
+You receive your API key when your operator account is created by the Predigy team.
+
+---
+
+## API Reference
+
+### Markets
+
+```python
+# List markets with optional filters
+markets = await client.list_markets(status="OPEN", category="NBA", limit=10)
+
+# Get a single market by external ID
+market = await client.get_market("mkt_abc123")
+
+# Create a new market (admin)
+market = await client.create_market(
+    title="Lakers vs Celtics — Lakers Win",
+    category="NBA",
+    description="Will the Lakers win tonight's game?",
+    b_base=5000.0,
+    initial_price_yes=0.55,
+)
+```
+
+### Quotes and Trades
+
+```python
+# Get a price quote (does not execute a trade)
+quote = await client.get_quote("mkt_abc123", side="YES", amount=100.0)
+print(f"Contracts: {quote.contracts}")
+print(f"Avg price: ${quote.avg_fill_price:.4f}")
+print(f"Fee: ${quote.fee:.2f} ({quote.fee_rate:.2%})")
+print(f"Total cost: ${quote.total_cost:.2f}")
+
+# Execute a trade
+trade = await client.execute_trade("mkt_abc123", side="YES", amount=100.0)
+
+# Execute with slippage protection
+trade = await client.execute_trade(
+    "mkt_abc123", side="YES", amount=100.0,
+    max_avg_price=0.60,  # Reject if avg price exceeds $0.60
+)
+
+# Sell (cash out) contracts from an existing position
+sell = await client.sell_position("mkt_abc123", side="YES", contracts=50.0)
+print(f"Net payout: ${sell.net_payout:.2f}")
+```
+
+### Portfolio
+
+```python
+portfolio = await client.get_portfolio()
+print(f"Balance: ${portfolio.balance:.2f}")
+print(f"Unrealized P&L: ${portfolio.total_unrealized_pnl:.2f}")
+
+for pos in portfolio.positions:
+    print(f"  {pos.market_title} ({pos.side}): {pos.contracts} contracts, P&L: ${pos.unrealized_pnl:.2f}")
+```
+
+### Admin Operations
+
+```python
+# Get platform statistics
+stats = await client.get_stats()
+print(f"Total markets: {stats.total_markets}")
+print(f"Total volume: ${stats.total_volume:,.2f}")
+
+# Settle a market
+result = await client.settle_market("mkt_abc123", outcome="YES")
+
+# Reset sandbox data
+await client.reset_sandbox()
+```
+
+### Webhooks
+
+```python
+# Register a webhook endpoint
+webhook = await client.create_webhook(
+    url="https://your-app.com/webhook",
+    events=["trade.executed", "market.settled"],
+    description="Production trade notifications",
+)
+print(f"Webhook ID: {webhook.webhook.external_id}")
+print(f"Secret: {webhook.secret}")  # Store this — shown only once!
+
+# List webhooks
+webhooks = await client.list_webhooks()
+
+# Delete a webhook
+await client.delete_webhook("whk_abc123")
+```
+
+### Health Check
+
+```python
+health = await client.health_check()
+print(health)  # {"status": "healthy"}
+```
+
+---
+
+## Error Handling
+
+The SDK raises typed exceptions for different error scenarios:
+
+```python
+from edge_sdk.exceptions import (
+    EdgeAPIError,       # Base class for all API errors
+    EdgeAuthError,      # 401 — Invalid or missing API key
+    EdgeRateLimitError, # 429 — Too many requests
+    EdgeValidationError,# 422 — Invalid request data
+)
+
+try:
+    trade = await client.execute_trade("mkt_abc123", side="YES", amount=100.0)
+except EdgeAuthError as e:
+    print(f"Authentication failed: {e.detail}")
+except EdgeRateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except EdgeValidationError as e:
+    print(f"Invalid request: {e.detail}")
+except EdgeAPIError as e:
+    print(f"API error {e.status_code}: {e.detail}")
+    print(f"Request ID: {e.request_id}")  # Useful for support
+```
+
+All exceptions include a `request_id` field that you can reference when contacting support.
+
+---
+
+## Webhook Verification
+
+When receiving webhook deliveries, verify the HMAC-SHA256 signature to ensure the payload is authentic:
+
+```python
+from edge_sdk import verify_signature
+
+# In your webhook handler (e.g., FastAPI)
+@app.post("/webhook")
+async def handle_webhook(request: Request):
+    body = await request.body()
+    signature = request.headers.get("X-Edge-Signature", "")
+
+    if not verify_signature(body, signature, WEBHOOK_SECRET):
+        raise HTTPException(401, "Invalid signature")
+
+    event = json.loads(body)
+    print(f"Received event: {event['event_type']}")
+    # Process event...
+```
+
+The `X-Edge-Signature` header format is `sha256=<hex_digest>`.
+
+**Webhook event types:**
+- `trade.executed` — A trade was placed
+- `market.created` — A new market was created
+- `market.settled` — A market was settled with an outcome
+- `market.suspended` — A market was suspended
+- `surge.activated` — Surge pricing was triggered
+- `liquidity.adjusted` — Dynamic liquidity parameter changed
+
+---
+
+## Advanced Usage
+
+### Custom HTTP Client
+
+You can provide your own `httpx.AsyncClient` for custom timeouts, proxies, or connection pooling:
+
+```python
+import httpx
+
+custom_client = httpx.AsyncClient(
+    base_url="https://edge-production-7b77.up.railway.app",
+    timeout=60.0,
+    headers={"X-API-Key": "your-api-key", "Content-Type": "application/json"},
+    limits=httpx.Limits(max_connections=20),
+)
+
+client = EdgeClient(
+    base_url="https://edge-production-7b77.up.railway.app",
+    api_key="your-api-key",
+    http_client=custom_client,
+)
+```
+
+### Type Safety
+
+The SDK is fully typed with Pydantic models. All responses are validated and provide IDE autocompletion. The `py.typed` marker (PEP 561) enables type checking in tools like mypy and pyright.
+
+---
+
+## Links
+
+- **API Documentation:** [docs/API.md](../../docs/API.md)
+- **Integration Guide:** [docs/EDGE_INTEGRATION_GUIDE.md](../../docs/EDGE_INTEGRATION_GUIDE.md)
+- **Live API (Swagger):** [edge-production-7b77.up.railway.app/docs](https://edge-production-7b77.up.railway.app/docs)
+- **Frontend Demo:** [edge-by-predigy.netlify.app](https://edge-by-predigy.netlify.app)
+
+---
+
+## License
+
+Proprietary. Copyright Predigy LLC. All rights reserved.

predigy_edge_sdk-2.0.0/edge_sdk/__init__.py

@@ -0,0 +1,35 @@
+"""
+EDGE by Predigy — Official Python SDK
+
+Usage:
+    from edge_sdk import EdgeClient
+
+    async with EdgeClient(base_url="...", api_key="...") as client:
+        markets = await client.list_markets()                      # 1.x flat
+        ticket = await client.retail.mint_ticket(...)              # 2.x grouped
+        parlay = await client.parlay.create_parlay(...)            # 2.x grouped
+        report = await client.compliance.daily_results(...)        # 2.x grouped
+        lp = await client.lp.designate_lp(...)                     # 2.x grouped
+"""
+
+__version__ = "2.0.0"
+
+from edge_sdk.client import EdgeClient
+from edge_sdk.compliance import ComplianceClient
+from edge_sdk.lp import LPClient
+from edge_sdk.parlay import ParlayClient
+from edge_sdk.retail import RetailClient
+from edge_sdk.webhook import verify_signature
+from edge_sdk.exceptions import EdgeAPIError, EdgeAuthError, EdgeRateLimitError
+
+__all__ = [
+    "EdgeClient",
+    "RetailClient",
+    "ParlayClient",
+    "ComplianceClient",
+    "LPClient",
+    "verify_signature",
+    "EdgeAPIError",
+    "EdgeAuthError",
+    "EdgeRateLimitError",
+]

predigy_edge_sdk-2.0.0/edge_sdk/_http.py

@@ -0,0 +1,69 @@
+"""
+Internal HTTP client for EdgeClient and all 2.0 sub-clients.
+
+Kept in a leading-underscore module so it stays private. Sub-clients
+receive an instance via constructor injection. Same status-code -> typed
+error mapping the 1.x EdgeClient._request used, now shareable.
+"""
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from edge_sdk.exceptions import (
+    EdgeAPIError,
+    EdgeAuthError,
+    EdgeRateLimitError,
+    EdgeValidationError,
+)
+
+
+class HttpClient:
+    def __init__(self, client: httpx.AsyncClient) -> None:
+        self._client = client
+
+    @property
+    def raw(self) -> httpx.AsyncClient:
+        """Raw httpx client — exposed so EdgeClient.close() can reach it."""
+        return self._client
+
+    async def request(
+        self,
+        method: str,
+        path: str,
+        json: dict | None = None,
+        params: dict | None = None,
+    ) -> Any:
+        """Make an authenticated API request with typed-error mapping."""
+        if params:
+            params = {k: v for k, v in params.items() if v is not None}
+
+        response = await self._client.request(method, path, json=json, params=params)
+        request_id = response.headers.get("x-request-id")
+
+        if response.status_code == 401:
+            raise EdgeAuthError(self._detail(response), request_id)
+        if response.status_code == 429:
+            retry_after = response.headers.get("retry-after")
+            raise EdgeRateLimitError(
+                self._detail(response),
+                int(retry_after) if retry_after else None,
+                request_id,
+            )
+        if response.status_code == 422:
+            raise EdgeValidationError(self._detail(response), request_id)
+        if response.status_code >= 400:
+            raise EdgeAPIError(response.status_code, self._detail(response), request_id)
+
+        if response.status_code == 204:
+            return None
+        return response.json()
+
+    @staticmethod
+    def _detail(response: httpx.Response) -> str:
+        try:
+            body = response.json()
+            return body.get("detail", response.reason_phrase or "Unknown error")
+        except Exception:
+            return response.reason_phrase or "Unknown error"