fix(python): tighten SDK type annotations

core/api-doc-config.generated.json

@@ -1,5 +1,5 @@
 {
-    "_generated": "Auto-generated by extract-jsdoc.js on 2026-06-02T00:34:44.916Z. Do not edit manually.",
+    "_generated": "Auto-generated by extract-jsdoc.js on 2026-06-05T14:21:50.064Z. Do not edit manually.",
     "methods": {
         "has": {
             "summary": "HTTP verb for the endpoint (e.g. GET, POST). */",
@@ -566,7 +566,7 @@
                 "type": "UnifiedEvent[]",
                 "description": "Filtered array of events"
             },
-            "source": "BaseExchange.ts:1317"
+            "source": "BaseExchange.ts:1318"
         },
         "watchOrderBook": {
             "summary": "Watch order book updates in real-time via WebSocket.",
@@ -595,7 +595,7 @@
                 "type": "OrderBook",
                 "description": "Promise that resolves with the current orderbook state"
             },
-            "source": "BaseExchange.ts:1413"
+            "source": "BaseExchange.ts:1414"
         },
         "watchOrderBooks": {
             "summary": "Watch multiple order books simultaneously via WebSocket.",
@@ -624,7 +624,7 @@
                 "type": "Record<string, OrderBook>",
                 "description": "Promise that resolves with order books keyed by ID"
             },
-            "source": "BaseExchange.ts:1426"
+            "source": "BaseExchange.ts:1427"
         },
         "unwatchOrderBook": {
             "summary": "Unsubscribe from a previously watched order book stream.",
@@ -641,7 +641,7 @@
                 "type": "void",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1454"
+            "source": "BaseExchange.ts:1455"
         },
         "watchTrades": {
             "summary": "Watch trade executions in real-time via WebSocket.",
@@ -676,7 +676,7 @@
                 "type": "Trade[]",
                 "description": "Promise that resolves with recent trades"
             },
-            "source": "BaseExchange.ts:1467"
+            "source": "BaseExchange.ts:1468"
         },
         "watchAddress": {
             "summary": "Stream activity for a public wallet address",
@@ -699,7 +699,7 @@
                 "type": "SubscribedAddressSnapshot",
                 "description": "Promise that resolves with the latest SubscribedAddressSnapshot snapshot"
             },
-            "source": "BaseExchange.ts:1481"
+            "source": "BaseExchange.ts:1482"
         },
         "unwatchAddress": {
             "summary": "Stop watching a previously registered wallet address and release its resource updates.",
@@ -716,7 +716,7 @@
                 "type": "void",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1494"
+            "source": "BaseExchange.ts:1495"
         },
         "close": {
             "summary": "Close all WebSocket connections and clean up resources.",
@@ -726,7 +726,7 @@
                 "type": "void",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1503"
+            "source": "BaseExchange.ts:1504"
         },
         "fetchMarketMatches": {
             "summary": "Find the same or related market on other venues. Two modes:",
@@ -743,7 +743,7 @@
                 "type": "MatchResult[]",
                 "description": "Array of matched markets with relation and confidence"
             },
-            "source": "BaseExchange.ts:1517"
+            "source": "BaseExchange.ts:1518"
         },
         "fetchMatches": {
             "summary": "fetchMatches",
@@ -760,7 +760,7 @@
                 "type": "MatchResult[]",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1533"
+            "source": "BaseExchange.ts:1534"
         },
         "fetchEventMatches": {
             "summary": "Find the same or related event on other venues. Two modes:",
@@ -777,7 +777,7 @@
                 "type": "EventMatchResult[]",
                 "description": "Array of matched events with market-level match details"
             },
-            "source": "BaseExchange.ts:1541"
+            "source": "BaseExchange.ts:1542"
         },
         "compareMarketPrices": {
             "summary": "Compare live prices for the same market across venues. Finds identity matches and returns side-by-side best bid/ask prices so you can spot price differences at a glance.",
@@ -794,7 +794,7 @@
                 "type": "PriceComparison[]",
                 "description": "Array of price comparisons across venues"
             },
-            "source": "BaseExchange.ts:1557"
+            "source": "BaseExchange.ts:1558"
         },
         "fetchRelatedMarkets": {
             "summary": "Find related markets across venues. Discovers subset/superset market relationships",
@@ -811,7 +811,7 @@
                 "type": "PriceComparison[]",
                 "description": "Array of subset/superset matches with live prices"
             },
-            "source": "BaseExchange.ts:1567"
+            "source": "BaseExchange.ts:1568"
         },
         "fetchMatchedMarkets": {
             "summary": "fetchMatchedMarkets",
@@ -828,7 +828,7 @@
                 "type": "MatchedMarketPair[]",
                 "description": "Result"
             },
-            "source": "BaseExchange.ts:1578"
+            "source": "BaseExchange.ts:1579"
         },
         "fetchMatchedPrices": {
             "summary": "fetchMatchedPrices",
@@ -845,7 +845,7 @@
                 "type": "MatchedPricePair[]",
                 "description": "Array of matched market pairs with prices from each venue"
             },
-            "source": "BaseExchange.ts:1586"
+            "source": "BaseExchange.ts:1587"
         },
         "fetchHedges": {
             "summary": "fetchHedges",
@@ -862,7 +862,7 @@
                 "type": "PriceComparison[]",
                 "description": "Array of subset/superset matches with live prices"
             },
-            "source": "BaseExchange.ts:1597"
+            "source": "BaseExchange.ts:1598"
         },
         "fetchArbitrage": {
             "summary": "fetchArbitrage",
@@ -879,7 +879,7 @@
                 "type": "ArbitrageOpportunity[]",
                 "description": "Array of arbitrage opportunities sorted by spread"
             },
-            "source": "BaseExchange.ts:1607"
+            "source": "BaseExchange.ts:1608"
         },
         "watchPrices": {
             "summary": "Watch AMM price updates for a market address (Limitless only).",

core/scripts/generate-python-exchanges.js

@@ -167,7 +167,7 @@ function generateClass(exchange) {
     }
     if (creds.signatureType) {
         const defaultVal = defaults['signature_type'] || 'None';
-        constructorParams.push(`signature_type: Optional[Any] = ${defaultVal}`);
+        constructorParams.push(`signature_type: Optional[str] = ${defaultVal}`);
         superArgs.push('signature_type=signature_type');
     }
     constructorParams.push('base_url: Optional[str] = None');
@@ -204,7 +204,7 @@ function generateClass(exchange) {
         indent4('def __init__('),
         indent8('self,'),
         ...constructorParams.map(p => indent8(`${p},`)),
-        indent4('):'),
+        indent4(') -> None:'),
         indent8('"""'),
         indent8(`Initialize ${className} client.`),
         '',

sdks/python/API_REFERENCE.md

@@ -1456,7 +1456,7 @@ title: str # The market title (e.g., "Will BTC close above $100k on Dec 31?").
 description: str # Long-form market description or resolution criteria.
 slug: str # URL-friendly slug for the market.
 outcomes: List[MarketOutcome] # The possible outcomes for this market.
-resolution_date: str # When the market is scheduled to resolve.
+resolution_date: str # When the market is scheduled to resolve. Optional because some venues do not publish a cutoff for every market (e.g. Opinion categorical children) — emit `undefined` rather than coercing to epoch.
 volume24h: float # Trading volume over the past 24 hours (USD).
 volume: float # Total / Lifetime volume
 liquidity: float # Current market liquidity (USD).

sdks/python/pmxt/__init__.py

@@ -100,7 +100,7 @@ class _ServerNamespace:
 
     __slots__ = ("_manager",)
 
-    def __init__(self, manager: ServerManager):
+    def __init__(self, manager: ServerManager) -> None:
         self._manager = manager
 
     def status(self) -> Dict[str, Any]:

sdks/python/pmxt/_exchanges.py

@@ -17,11 +17,11 @@ def __init__(
         passphrase: Optional[str] = None,
         private_key: Optional[str] = None,
         proxy_address: Optional[str] = None,
-        signature_type: Optional[Any] = "gnosis-safe",
+        signature_type: Optional[str] = "gnosis-safe",
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Polymarket client.
 
@@ -76,7 +76,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Limitless client.
 
@@ -120,7 +120,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Kalshi client.
 
@@ -151,7 +151,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize KalshiDemo client.
 
@@ -184,7 +184,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Probable client.
 
@@ -227,7 +227,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Baozi client.
 
@@ -256,7 +256,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Myriad client.
 
@@ -288,7 +288,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Opinion client.
 
@@ -320,7 +320,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Metaculus client.
 
@@ -349,7 +349,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Smarkets client.
 
@@ -380,7 +380,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize PolymarketUS client.
 
@@ -411,7 +411,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Hyperliquid client.
 
@@ -442,7 +442,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize GeminiTitan client.
 
@@ -478,7 +478,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize SuiBets client.
 
@@ -503,7 +503,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Mock client.
 
@@ -528,7 +528,7 @@ def __init__(
         base_url: Optional[str] = None,
         auto_start_server: Optional[bool] = None,
         pmxt_api_key: Optional[str] = None,
-    ):
+    ) -> None:
         """
         Initialize Router client.