poly-position-watcher 0.3.7__tar.gz → 0.3.8__tar.gz

{poly_position_watcher-0.3.7/poly_position_watcher.egg-info → poly_position_watcher-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: poly-position-watcher
-Version: 0.3.7
+Version: 0.3.8
 Summary: polymarket proxy wallet redeem
 Home-page: https://github.com/tosmart01/polymarket-position-watcher
 Author: pinbar
@@ -27,7 +27,13 @@ Dynamic: requires-python
 
 ## Overview
 
-`poly-position-watcher` focuses on real-time position and order monitoring:
+`poly-position-watcher` is built for real trading on Polymarket, where order fills, trade updates, position sync, and sellable on-chain balance may not arrive at the same time.
+
+In practice, `order filled`, `trade confirmed`, `position updated`, and `sellable on-chain` are different states. Strategy code that reacts to only one of them can easily overestimate inventory, mis-time hedges, or place exits before the position is actually ready.
+
+This library acts as an execution reliability layer for Polymarket strategies. It helps you observe and reconcile these states in one place, so your strategy does not mistake "order filled" for "position synchronized" or "position visible" for "actually sellable".
+
+Core capabilities:
 
 - WSS real-time tracking for `TRADE` and `ORDER` (positions + orders)
 - HTTP polling fallback for reliability
@@ -35,6 +41,11 @@ Dynamic: requires-python
 - Position fields for fill checks:
   `size` (post-fee net size), `original_size` (pre-fee net size), `sellable_size` (on-chain confirmed size), `fee_amount` (accumulated fee amount)
 - Failed trades are detected and returned on positions (`has_failed`, `failed_trades`)
+- Strategy-scoped position queries by `order_ids`:
+  `get_position_by_order_ids(...)` and `get_positions_by_order_ids(...)`
+- Order-aware fill helpers:
+  `get_effective_position_size(...)`, `wait_for_orders_filled(...)`, `wait_for_orders_pos_filled(...)`
+- HTTP fallback namespaces via `group=...`, so multiple callers can share one watcher without overwriting each other's monitored order/market sets
 
 **Note: WSS disconnects are auto-detected and reconnected.**
 

{poly_position_watcher-0.3.7 → poly_position_watcher-0.3.8}/README.md

@@ -8,7 +8,13 @@
 
 ## Overview
 
-`poly-position-watcher` focuses on real-time position and order monitoring:
+`poly-position-watcher` is built for real trading on Polymarket, where order fills, trade updates, position sync, and sellable on-chain balance may not arrive at the same time.
+
+In practice, `order filled`, `trade confirmed`, `position updated`, and `sellable on-chain` are different states. Strategy code that reacts to only one of them can easily overestimate inventory, mis-time hedges, or place exits before the position is actually ready.
+
+This library acts as an execution reliability layer for Polymarket strategies. It helps you observe and reconcile these states in one place, so your strategy does not mistake "order filled" for "position synchronized" or "position visible" for "actually sellable".
+
+Core capabilities:
 
 - WSS real-time tracking for `TRADE` and `ORDER` (positions + orders)
 - HTTP polling fallback for reliability
@@ -16,6 +22,11 @@
 - Position fields for fill checks:
   `size` (post-fee net size), `original_size` (pre-fee net size), `sellable_size` (on-chain confirmed size), `fee_amount` (accumulated fee amount)
 - Failed trades are detected and returned on positions (`has_failed`, `failed_trades`)
+- Strategy-scoped position queries by `order_ids`:
+  `get_position_by_order_ids(...)` and `get_positions_by_order_ids(...)`
+- Order-aware fill helpers:
+  `get_effective_position_size(...)`, `wait_for_orders_filled(...)`, `wait_for_orders_pos_filled(...)`
+- HTTP fallback namespaces via `group=...`, so multiple callers can share one watcher without overwriting each other's monitored order/market sets
 
 **Note: WSS disconnects are auto-detected and reconnected.**
 

{poly_position_watcher-0.3.7 → poly_position_watcher-0.3.8}/poly_position_watcher/schema/position_model.py

@@ -21,12 +21,12 @@ class MakerOrder(BaseModel):
     outcome: str
     owner: str
     price: float
-    fee_rate_bps: float
+    fee_rate_bps: float | str | None = None
     outcome_index: int | None = None
     maker_address: str
     side: Side
 
-    @field_validator("fee_rate_bps", "price", "matched_amount", "size", mode="before")
+    @field_validator( "price", "matched_amount", "size", mode="before")
     @classmethod
     def validate_float(cls, v: str):
         return float(v)
@@ -59,7 +59,8 @@ class TradeMessage(BaseModel):
     last_update: int | None = None
     trade_owner: Optional[str] = None
     trader_side: Optional[Literal["MAKER", "TAKER"]] = None
-    fee_rate_bps: float
+    fee_rate_bps: float | str | None = None
+    outcome_index: int | None = None
     created_at: datetime | None = None
     market_slug: Optional[str] = ""
 
@@ -87,7 +88,7 @@ class TradeMessage(BaseModel):
             return None
         return int(v)
 
-    @field_validator("fee_rate_bps", "price", "size", mode="before")
+    @field_validator( "price", "size", mode="before")
     @classmethod
     def validate_float(cls, v: str):
         return float(v)

{poly_position_watcher-0.3.7 → poly_position_watcher-0.3.8/poly_position_watcher.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: poly-position-watcher
-Version: 0.3.7
+Version: 0.3.8
 Summary: polymarket proxy wallet redeem
 Home-page: https://github.com/tosmart01/polymarket-position-watcher
 Author: pinbar
@@ -27,7 +27,13 @@ Dynamic: requires-python
 
 ## Overview
 
-`poly-position-watcher` focuses on real-time position and order monitoring:
+`poly-position-watcher` is built for real trading on Polymarket, where order fills, trade updates, position sync, and sellable on-chain balance may not arrive at the same time.
+
+In practice, `order filled`, `trade confirmed`, `position updated`, and `sellable on-chain` are different states. Strategy code that reacts to only one of them can easily overestimate inventory, mis-time hedges, or place exits before the position is actually ready.
+
+This library acts as an execution reliability layer for Polymarket strategies. It helps you observe and reconcile these states in one place, so your strategy does not mistake "order filled" for "position synchronized" or "position visible" for "actually sellable".
+
+Core capabilities:
 
 - WSS real-time tracking for `TRADE` and `ORDER` (positions + orders)
 - HTTP polling fallback for reliability
@@ -35,6 +41,11 @@ Dynamic: requires-python
 - Position fields for fill checks:
   `size` (post-fee net size), `original_size` (pre-fee net size), `sellable_size` (on-chain confirmed size), `fee_amount` (accumulated fee amount)
 - Failed trades are detected and returned on positions (`has_failed`, `failed_trades`)
+- Strategy-scoped position queries by `order_ids`:
+  `get_position_by_order_ids(...)` and `get_positions_by_order_ids(...)`
+- Order-aware fill helpers:
+  `get_effective_position_size(...)`, `wait_for_orders_filled(...)`, `wait_for_orders_pos_filled(...)`
+- HTTP fallback namespaces via `group=...`, so multiple callers can share one watcher without overwriting each other's monitored order/market sets
 
 **Note: WSS disconnects are auto-detected and reconnected.**
 

{poly_position_watcher-0.3.7 → poly_position_watcher-0.3.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "poly-position-watcher"
-version = "0.3.7"
+version = "0.3.8"
 description = "polymarket proxy wallet redeem"
 readme = "README.md"
 requires-python = ">=3.11"