polynode 0.5.5__tar.gz

polynode-0.5.5/.gitignore

@@ -0,0 +1,38 @@
+# Build artifacts
+target/
+dist/
+node_modules/
+
+# Environment files
+.env
+.env.local
+.env.production
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Redis
+*.rdb
+*.aof
+
+# Archives
+*.jsonl
+*.jsonl.zst
+
+# Secrets
+*.pem
+*.key
+
+# Embedded repos (tracked separately)
+docs/
+
+# Compiled binaries
+ob/ob
+ob/ob.bak

polynode-0.5.5/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: polynode
+Version: 0.5.5
+Summary: Python SDK for the PolyNode real-time prediction market data platform
+Project-URL: Homepage, https://polynode.dev
+Project-URL: Documentation, https://docs.polynode.dev
+Author-email: PolyNode <josh@quantish.live>
+License: MIT
+Keywords: polymarket,polynode,prediction-markets,trading,websocket
+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
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: all
+Requires-Dist: aiosqlite>=0.20; extra == 'all'
+Requires-Dist: eth-account>=0.13; extra == 'all'
+Requires-Dist: web3>=7.0; extra == 'all'
+Provides-Extra: cache
+Requires-Dist: aiosqlite>=0.20; extra == 'cache'
+Provides-Extra: trading
+Requires-Dist: eth-account>=0.13; extra == 'trading'
+Requires-Dist: web3>=7.0; extra == 'trading'
+Description-Content-Type: text/markdown
+
+# polynode
+
+Python SDK for the [PolyNode](https://polynode.dev) real-time prediction market data platform.
+
+## Install
+
+```bash
+pip install polynode
+```
+
+For trading support:
+```bash
+pip install polynode[trading]
+```
+
+## Quick Start
+
+### REST API
+
+```python
+from polynode import PolyNode
+
+with PolyNode(api_key="pn_live_...") as pn:
+    status = pn.status()
+    markets = pn.markets(count=10)
+    settlements = pn.recent_settlements(count=5)
+```
+
+### Async REST
+
+```python
+import asyncio
+from polynode import AsyncPolyNode
+
+async def main():
+    async with AsyncPolyNode(api_key="pn_live_...") as pn:
+        status = await pn.status()
+        markets = await pn.markets(count=10)
+
+asyncio.run(main())
+```
+
+### WebSocket Streaming
+
+```python
+import asyncio
+from polynode import AsyncPolyNode
+
+async def main():
+    async with AsyncPolyNode(api_key="pn_live_...") as pn:
+        sub = await pn.ws.subscribe("settlements").min_size(1000).send()
+
+        async for event in sub:
+            print(event.event_type, event.market_title, event.taker_price)
+
+asyncio.run(main())
+```
+
+### Orderbook
+
+```python
+import asyncio
+from polynode import OrderbookEngine
+
+async def main():
+    engine = OrderbookEngine(api_key="pn_live_...")
+    await engine.subscribe(["token_id_1", "token_id_2"])
+
+    engine.on("ready", lambda: print(f"Tracking {engine.size} books"))
+    engine.on("update", lambda u: print(f"{u.asset_id}: {engine.midpoint(u.asset_id)}"))
+
+asyncio.run(main())
+```
+
+### Trading
+
+```python
+import asyncio
+from polynode.trading import PolyNodeTrader, TraderConfig, OrderParams
+
+async def main():
+    trader = PolyNodeTrader(TraderConfig(polynode_key="pn_live_..."))
+    status = await trader.ensure_ready("0xYourPrivateKey...")
+
+    result = await trader.order(OrderParams(
+        token_id="...",
+        side="BUY",
+        price=0.55,
+        size=100,
+    ))
+    print(result)
+
+    trader.close()
+
+asyncio.run(main())
+```
+
+## Documentation
+
+Full docs at [docs.polynode.dev](https://docs.polynode.dev)

polynode-0.5.5/README.md

@@ -0,0 +1,100 @@
+# polynode
+
+Python SDK for the [PolyNode](https://polynode.dev) real-time prediction market data platform.
+
+## Install
+
+```bash
+pip install polynode
+```
+
+For trading support:
+```bash
+pip install polynode[trading]
+```
+
+## Quick Start
+
+### REST API
+
+```python
+from polynode import PolyNode
+
+with PolyNode(api_key="pn_live_...") as pn:
+    status = pn.status()
+    markets = pn.markets(count=10)
+    settlements = pn.recent_settlements(count=5)
+```
+
+### Async REST
+
+```python
+import asyncio
+from polynode import AsyncPolyNode
+
+async def main():
+    async with AsyncPolyNode(api_key="pn_live_...") as pn:
+        status = await pn.status()
+        markets = await pn.markets(count=10)
+
+asyncio.run(main())
+```
+
+### WebSocket Streaming
+
+```python
+import asyncio
+from polynode import AsyncPolyNode
+
+async def main():
+    async with AsyncPolyNode(api_key="pn_live_...") as pn:
+        sub = await pn.ws.subscribe("settlements").min_size(1000).send()
+
+        async for event in sub:
+            print(event.event_type, event.market_title, event.taker_price)
+
+asyncio.run(main())
+```
+
+### Orderbook
+
+```python
+import asyncio
+from polynode import OrderbookEngine
+
+async def main():
+    engine = OrderbookEngine(api_key="pn_live_...")
+    await engine.subscribe(["token_id_1", "token_id_2"])
+
+    engine.on("ready", lambda: print(f"Tracking {engine.size} books"))
+    engine.on("update", lambda u: print(f"{u.asset_id}: {engine.midpoint(u.asset_id)}"))
+
+asyncio.run(main())
+```
+
+### Trading
+
+```python
+import asyncio
+from polynode.trading import PolyNodeTrader, TraderConfig, OrderParams
+
+async def main():
+    trader = PolyNodeTrader(TraderConfig(polynode_key="pn_live_..."))
+    status = await trader.ensure_ready("0xYourPrivateKey...")
+
+    result = await trader.order(OrderParams(
+        token_id="...",
+        side="BUY",
+        price=0.55,
+        size=100,
+    ))
+    print(result)
+
+    trader.close()
+
+asyncio.run(main())
+```
+
+## Documentation
+
+Full docs at [docs.polynode.dev](https://docs.polynode.dev)

polynode-0.5.5/polynode/__init__.py

@@ -0,0 +1,41 @@
+"""PolyNode Python SDK — real-time prediction market data and trading."""
+
+from ._version import __version__
+from .client import AsyncPolyNode, PolyNode
+from .engine import EngineView, OrderbookEngine
+from .errors import ApiError, PolyNodeError, WsError
+from .orderbook import OrderbookWS
+from .orderbook_state import LocalOrderbook
+from .redemption_watcher import RedeemableAlert, RedemptionWatcher, TrackedPosition
+from .short_form import ShortFormStream
+from .subscription import Subscription, SubscriptionBuilder
+from .testing import get_active_test_wallet, get_active_test_wallets
+from .ws import PolyNodeWS
+
+__all__ = [
+    "__version__",
+    # Clients
+    "PolyNode",
+    "AsyncPolyNode",
+    # WebSocket
+    "PolyNodeWS",
+    "SubscriptionBuilder",
+    "Subscription",
+    # Orderbook
+    "OrderbookWS",
+    "LocalOrderbook",
+    "OrderbookEngine",
+    "EngineView",
+    # Streams
+    "ShortFormStream",
+    "RedemptionWatcher",
+    "RedeemableAlert",
+    "TrackedPosition",
+    # Testing
+    "get_active_test_wallet",
+    "get_active_test_wallets",
+    # Errors
+    "PolyNodeError",
+    "ApiError",
+    "WsError",
+]

polynode-0.5.5/polynode/_version.py

@@ -0,0 +1 @@
+__version__ = "0.5.5"

polynode-0.5.5/polynode/cache/__init__.py

@@ -0,0 +1,11 @@
+"""Cache module placeholder — local SQLite-backed trade/position history.
+
+This module will be implemented in a future release.
+The cache/ directory structure matches the TypeScript SDK:
+- sqlite_backend.py — SQLite storage (settlements, trades, positions)
+- watchlist.py — JSON watchlist file management
+- backfill.py — Rate-limited REST backfill orchestrator
+- query_builder.py — Fluent query builder
+- views.py — Analytical views (wallet_dashboard, leaderboard, etc.)
+- export.py — CSV/JSON export
+"""