pmwallets 0.1.2__tar.gz → 0.2.0__tar.gz

{pmwallets-0.1.2 → pmwallets-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pmwallets
-Version: 0.1.2
+Version: 0.2.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
@@ -69,7 +69,20 @@ asyncio.run(main())
 
 One stream per account. An API-key connection takes priority over the pmwallets.com feed page (the page never takes the stream from it); between two API connections the newest wins, so run one consumer per account. `HTTPS_PROXY` is honoured.
 
-PMWallets' servers are in the United Kingdom: a consumer hosted in the UK or elsewhere in Europe receives fills soonest.
+PMWallets' servers are in the United Kingdom. A consumer that also trades on Polymarket should run from Ireland (AWS eu-west-1): Polymarket does not accept API orders from the UK, the US and several EU countries.
+
+## Trade-history exports
+
+A purchase is access to files: one zstd-compressed CSV per wallet per UTC day, downloadable at once and again later.
+
+```python
+order = client.create_export(["0x…"], "2026-09-01", "2026-09-30")
+for f in client.export_files(order["id"])["files"]:
+    data = client.download_export_file(f["wallet"], f["day"])  # .csv.zst
+    # pandas: pd.read_csv(io.BytesIO(data), compression="zstd")
+```
+
+`export_file_url(wallet, day)` returns the short-lived link instead; the API key is never sent to the storage host.
 
 ## Resources
 

{pmwallets-0.1.2 → pmwallets-0.2.0}/README.md

@@ -51,7 +51,20 @@ asyncio.run(main())
 
 One stream per account. An API-key connection takes priority over the pmwallets.com feed page (the page never takes the stream from it); between two API connections the newest wins, so run one consumer per account. `HTTPS_PROXY` is honoured.
 
-PMWallets' servers are in the United Kingdom: a consumer hosted in the UK or elsewhere in Europe receives fills soonest.
+PMWallets' servers are in the United Kingdom. A consumer that also trades on Polymarket should run from Ireland (AWS eu-west-1): Polymarket does not accept API orders from the UK, the US and several EU countries.
+
+## Trade-history exports
+
+A purchase is access to files: one zstd-compressed CSV per wallet per UTC day, downloadable at once and again later.
+
+```python
+order = client.create_export(["0x…"], "2026-09-01", "2026-09-30")
+for f in client.export_files(order["id"])["files"]:
+    data = client.download_export_file(f["wallet"], f["day"])  # .csv.zst
+    # pandas: pd.read_csv(io.BytesIO(data), compression="zstd")
+```
+
+`export_file_url(wallet, day)` returns the short-lived link instead; the API key is never sent to the storage host.
 
 ## Resources
 

{pmwallets-0.1.2 → pmwallets-0.2.0}/README.zh.md

@@ -26,7 +26,20 @@ pip install pmwallets     # Python ≥ 3.10
 
 每个账户只有一条推送流。API key 建立的连接优先于 pmwallets.com 的推送页；两条 API 连接之间仍是后连的顶掉先连的。支持 `HTTPS_PROXY`。
 
-PMWallets 的服务器在英国：消费者部署在英国或欧洲其他地区，收到成交最快。
+PMWallets 的服务器在英国。若还要在 Polymarket 下单，请部署在爱尔兰（AWS eu-west-1）：Polymarket 不接受来自英国、美国及部分欧盟国家的 API 订单。
+
+## 历史成交导出
+
+购买得到的是文件的访问权:每个钱包每个 UTC 日一个 zstd 压缩的 CSV,付款后立即可下载,之后也能再下。
+
+```python
+order = client.create_export(["0x…"], "2026-09-01", "2026-09-30")
+for f in client.export_files(order["id"])["files"]:
+    data = client.download_export_file(f["wallet"], f["day"])  # .csv.zst
+    # pandas: pd.read_csv(io.BytesIO(data), compression="zstd")
+```
+
+`export_file_url(wallet, day)` 只返回短时效链接;API key 不会发给存储服务。
 
 ## 相关链接
 

{pmwallets-0.1.2 → pmwallets-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pmwallets"
-version = "0.1.2"
+version = "0.2.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.1.2 → pmwallets-0.2.0}/src/pmwallets/__init__.py

@@ -10,4 +10,4 @@ __all__ = [
     "FileStateStore", "FillMeta", "FillStream", "MemoryStateStore", "StreamState", "UpgradeRefused", "websockets_connector",
     "Fill", "FillCursor", "FillsPage", "verify_webhook",
 ]
-__version__ = "0.1.2"
+__version__ = "0.2.0"

{pmwallets-0.1.2 → pmwallets-0.2.0}/src/pmwallets/client.py

@@ -63,6 +63,15 @@ class _Base:
             raise PmwError(res.status_code, body)
         return body if text else None
 
+    @classmethod
+    def _location(cls, res: httpx.Response) -> str:
+        """The redirect target of a purchased-file request; anything else is raised as PmwError."""
+        loc = res.headers.get("location")
+        if 300 <= res.status_code < 400 and loc:
+            return loc
+        cls._parse(res)
+        raise PmwError(res.status_code, res.text, "expected a redirect to the file")
+
     @staticmethod
     def _fills_query(since_block: int, since_log_index: int, limit: int) -> dict[str, Any]:
         return {"sinceBlock": since_block, "sinceLogIndex": since_log_index, "limit": limit}
@@ -154,9 +163,22 @@ class Client(_Base):
     def get_export(self, export_id: str) -> dict[str, Any]:
         return self.request("GET", f"/v1/account/exports/{_q(export_id)}")
 
-    def export_download(self, export_id: str) -> dict[str, Any]:
-        """A presigned download URL, valid 15 minutes."""
-        return self.request("GET", f"/v1/account/exports/{_q(export_id)}/download")
+    def export_files(self, export_id: str) -> dict[str, Any]:
+        """The daily files an export grants: one per wallet per UTC day."""
+        return self.request("GET", f"/v1/account/exports/{_q(export_id)}/files")
+
+    def export_file_url(self, wallet: str, day: str) -> str:
+        """A short-lived (5 minute) link to one purchased daily file. The redirect is read, not followed,
+        so the API key is never sent to the storage host."""
+        res = self._http.request("GET", self.base_url + f"/v1/account/data/{_q(wallet)}/{_q(day)}", headers=self._headers, follow_redirects=False)
+        return self._location(res)
+
+    def download_export_file(self, wallet: str, day: str) -> bytes:
+        """One purchased daily file: zstd-compressed CSV bytes (.csv.zst)."""
+        res = self._http.get(self.export_file_url(wallet, day), timeout=max(self.timeout, 60.0))
+        if res.status_code != 200:
+            raise PmwError(res.status_code, res.text)
+        return res.content
 
 
 class AsyncClient(_Base):
@@ -233,5 +255,15 @@ class AsyncClient(_Base):
     async def get_export(self, export_id: str) -> dict[str, Any]:
         return await self.request("GET", f"/v1/account/exports/{_q(export_id)}")
 
-    async def export_download(self, export_id: str) -> dict[str, Any]:
-        return await self.request("GET", f"/v1/account/exports/{_q(export_id)}/download")
+    async def export_files(self, export_id: str) -> dict[str, Any]:
+        return await self.request("GET", f"/v1/account/exports/{_q(export_id)}/files")
+
+    async def export_file_url(self, wallet: str, day: str) -> str:
+        res = await self._http.request("GET", self.base_url + f"/v1/account/data/{_q(wallet)}/{_q(day)}", headers=self._headers, follow_redirects=False)
+        return self._location(res)
+
+    async def download_export_file(self, wallet: str, day: str) -> bytes:
+        res = await self._http.get(await self.export_file_url(wallet, day), timeout=max(self.timeout, 60.0))
+        if res.status_code != 200:
+            raise PmwError(res.status_code, res.text)
+        return res.content

{pmwallets-0.1.2 → pmwallets-0.2.0}/tests/test_client.py

@@ -56,3 +56,38 @@ def test_verify_webhook():
     assert not verify_webhook(body, sig, "other")
     assert not verify_webhook(body, "zz", "sec")
     assert not verify_webhook(body, None, "sec")
+
+
+W = "0x" + "ab" * 20
+
+
+def _file_transport(calls):
+    def handler(req: httpx.Request):
+        calls.append(req)
+        if req.url.host == "api.example.com":
+            return httpx.Response(302, headers={"location": "https://r2.example/signed"})
+        return httpx.Response(200, content=b"\x01\x02\x03")
+    return httpx.MockTransport(handler)
+
+
+def test_download_reads_the_redirect_and_never_sends_the_key_to_storage():
+    calls = []
+    c = Client("pmw_a_b", "https://api.example.com", http=httpx.Client(transport=_file_transport(calls)))
+    assert c.download_export_file(W, "2026-09-25") == b"\x01\x02\x03"
+    assert str(calls[0].url) == f"https://api.example.com/v1/account/data/{W}/2026-09-25"
+    assert str(calls[1].url) == "https://r2.example/signed"
+    assert "x-api-key" not in calls[1].headers
+
+
+async def test_async_download_reads_the_redirect():
+    calls = []
+    c = AsyncClient("pmw_a_b", "https://api.example.com", http=httpx.AsyncClient(transport=_file_transport(calls)))
+    assert await c.download_export_file(W, "2026-09-25") == b"\x01\x02\x03"
+    assert "x-api-key" not in calls[1].headers
+
+
+def test_no_purchased_file_is_pmw_error():
+    c = Client("k", http=httpx.Client(transport=transport([{"statusCode": 404, "message": "no purchased file for this wallet and day"}], 404)))
+    with pytest.raises(PmwError) as e:
+        c.export_file_url(W, "2026-09-25")
+    assert e.value.status == 404