pmwallets 0.3.0__tar.gz → 0.4.0__tar.gz

{pmwallets-0.3.0 → pmwallets-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pmwallets
-Version: 0.3.0
+Version: 0.4.0
 Summary: Official PMWallets SDK: Polymarket smart-money leaderboard, real-time wallet fills over WebSocket with gap replay, webhooks and exports.
 Project-URL: Homepage, https://pmwallets.com/docs
 Project-URL: Repository, https://github.com/polymarketwallets/pmwallets-python
@@ -65,7 +65,7 @@ asyncio.run(main())
 
 | | |
 |---|---|
-| `Client` / `AsyncClient` | leaderboard, entities, address unlocks, subscriptions, fills replay (`fills`, `fills_since`), trade-history exports |
+| `Client` / `AsyncClient` | leaderboard, entities, address unlocks, your unlocked addresses (`my_addresses`), subscriptions, fills replay (`fills`, `fills_since`), trade-history exports |
 | `FillStream` | asyncio WebSocket with reconnect and keep-alive; detects missed frames by `session`/`seq` and replays them from the last fill delivered; de-duplicates by `eventId`; anchors behind the chain head on first start; persisted cursor |
 | `verify_webhook(raw_body, signature, secret)` | checks `x-pmw-signature` (HMAC-SHA256 of the raw body) |
 

{pmwallets-0.3.0 → pmwallets-0.4.0}/README.md

@@ -47,7 +47,7 @@ asyncio.run(main())
 
 | | |
 |---|---|
-| `Client` / `AsyncClient` | leaderboard, entities, address unlocks, subscriptions, fills replay (`fills`, `fills_since`), trade-history exports |
+| `Client` / `AsyncClient` | leaderboard, entities, address unlocks, your unlocked addresses (`my_addresses`), subscriptions, fills replay (`fills`, `fills_since`), trade-history exports |
 | `FillStream` | asyncio WebSocket with reconnect and keep-alive; detects missed frames by `session`/`seq` and replays them from the last fill delivered; de-duplicates by `eventId`; anchors behind the chain head on first start; persisted cursor |
 | `verify_webhook(raw_body, signature, secret)` | checks `x-pmw-signature` (HMAC-SHA256 of the raw body) |
 

{pmwallets-0.3.0 → pmwallets-0.4.0}/README.zh.md

@@ -20,7 +20,7 @@ pip install pmwallets     # Python ≥ 3.10
 
 | | |
 |---|---|
-| `Client` / `AsyncClient` | 排行榜、实体、地址解锁、订阅、成交补发（`fills`、`fills_since`）、交易历史导出 |
+| `Client` / `AsyncClient` | 排行榜、实体、地址解锁、我的地址(`my_addresses`)、订阅、成交补发（`fills`、`fills_since`）、交易历史导出 |
 | `FillStream` | asyncio WebSocket，自动重连与保活；按 `session`/`seq` 发现漏帧并从最后送达的成交补发；按 `eventId` 去重；首次启动锚定在链头之后；游标持久化 |
 | `verify_webhook(raw_body, signature, secret)` | 校验 `x-pmw-signature`（原始 body 的 HMAC-SHA256） |
 

{pmwallets-0.3.0 → pmwallets-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pmwallets"
-version = "0.3.0"
+version = "0.4.0"
 description = "Official PMWallets SDK: Polymarket smart-money leaderboard, real-time wallet fills over WebSocket with gap replay, webhooks and exports."
 readme = "README.md"
 requires-python = ">=3.10"

{pmwallets-0.3.0 → pmwallets-0.4.0}/src/pmwallets/client.py

@@ -102,6 +102,13 @@ class Client(_Base):
     def leaderboard(self, **query: Any) -> Leaderboard:
         return self.request("GET", "/v1/leaderboard", query)
 
+    def my_addresses(self, **query: Any) -> Leaderboard:
+        """Every address you have unlocked (bought, free, or with your plan) as board rows. Each row has
+        `unlockedBy` ('paid' / 'free' / 'plan', or None when a free or plan unlock lapsed and is masked again)
+        and `pausedReason` when your push subscription to it is paused; `outside` (first page only) lists
+        unlocked addresses with no fill in the window. Spends no board rows."""
+        return self.request("GET", "/v1/leaderboard", {**query, "mine": 1})
+
     def entity(self, entity_id: str, period: Optional[str] = None) -> dict[str, Any]:
         """One entity by handle or address. The full address comes back only for entities you own."""
         return self.request("GET", f"/v1/entities/{_q(entity_id)}", {"period": period})
@@ -205,6 +212,10 @@ class AsyncClient(_Base):
     async def leaderboard(self, **query: Any) -> Leaderboard:
         return await self.request("GET", "/v1/leaderboard", query)
 
+    async def my_addresses(self, **query: Any) -> Leaderboard:
+        """See Client.my_addresses."""
+        return await self.request("GET", "/v1/leaderboard", {**query, "mine": 1})
+
     async def entity(self, entity_id: str, period: Optional[str] = None) -> dict[str, Any]:
         return await self.request("GET", f"/v1/entities/{_q(entity_id)}", {"period": period})
 

{pmwallets-0.3.0 → pmwallets-0.4.0}/tests/test_client.py

@@ -38,6 +38,20 @@ async def test_walks_every_page():
     assert "sinceBlock=2&sinceLogIndex=0&limit=2" in str(calls[1].url)
 
 
+def test_my_addresses_asks_the_board_for_mine():
+    calls = []
+    c = Client("k", "https://api.example.com", http=httpx.Client(transport=transport([{"periodId": "30d", "tracked": 2, "rows": []}], calls=calls)))
+    assert c.my_addresses(sort="realizedPnl", offset=15)["tracked"] == 2
+    assert str(calls[0].url) == "https://api.example.com/v1/leaderboard?sort=realizedPnl&offset=15&mine=1"
+
+
+async def test_async_my_addresses():
+    calls = []
+    c = AsyncClient("k", "https://api.example.com", http=httpx.AsyncClient(transport=transport([{"tracked": 0, "rows": []}], calls=calls)))
+    await c.my_addresses()
+    assert str(calls[0].url) == "https://api.example.com/v1/leaderboard?mine=1"
+
+
 def test_non_2xx_is_pmw_error():
     calls = []
     c = Client("k", http=httpx.Client(transport=transport([{"statusCode": 402, "message": "insufficient balance"}], 402, calls)))

{pmwallets-0.3.0 → pmwallets-0.4.0}/uv.lock

@@ -134,7 +134,7 @@ wheels = [
 
 [[package]]
 name = "pmwallets"
-version = "0.2.0"
+version = "0.3.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },