pmwallets-copytrade 0.1.0__tar.gz

pmwallets_copytrade-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: ci
+on:
+  push:
+    branches: [main]
+  pull_request:
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: pip install -e '.[dev]'
+      - run: pytest -q

pmwallets_copytrade-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+# Publishes to PyPI through a Trusted Publisher (OIDC): no token is stored anywhere.
+# Release = push a tag v<version> matching pyproject.toml.
+name: publish
+on:
+  push:
+    tags: ["v*"]
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: tag must match the package version
+        run: |
+          v=$(python -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          test "v$v" = "$GITHUB_REF_NAME" || { echo "tag $GITHUB_REF_NAME != v$v"; exit 1; }
+      - run: pip install build && python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

pmwallets_copytrade-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.egg-info/
+.venv/
+.pytest_cache/
+build/
+dist/
+.env
+config.yaml
+pmw-data/

pmwallets_copytrade-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PMWallets
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pmwallets_copytrade-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.5
+Name: pmwallets-copytrade
+Version: 0.1.0
+Summary: Ready-to-run Polymarket copy-trading bot: follows the wallets you subscribe to on PMWallets and mirrors their trades on the Polymarket CLOB, with dry-run, risk caps and exactly-once fill handling.
+Project-URL: Homepage, https://pmwallets.com/copy-trading
+Project-URL: Repository, https://github.com/polymarketwallets/polymarket-copy-trading-bot-python
+Project-URL: Issues, https://github.com/polymarketwallets/polymarket-copy-trading-bot-python/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: copy-trading,copytrade,pmwallets,polymarket,prediction-markets,trading-bot
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pmwallets>=0.1.0
+Requires-Dist: py-clob-client-v2>=1.1.0
+Requires-Dist: pyyaml>=6
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Polymarket copy-trading bot (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/pmwallets-copytrade.svg)](https://pypi.org/project/pmwallets-copytrade/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+A **ready-to-run Polymarket copy-trading bot** built on [PMWallets](https://pmwallets.com/copy-trading): it follows the
+traders you subscribe to and mirrors their fills on the Polymarket CLOB with your own account, inside the limits you set.
+
+[`pmwallets-copytrade` on PyPI](https://pypi.org/project/pmwallets-copytrade/) · [中文说明](README.zh.md) · Node.js version: [polymarket-copy-trading-bot](https://github.com/polymarketwallets/polymarket-copy-trading-bot) ·
+SDK: [pmwallets-python](https://github.com/polymarketwallets/pmwallets-python)
+
+## What the bot does
+
+1. **You pick the traders** on [pmwallets.com](https://pmwallets.com): filter the board by the lower bound of the
+   win-rate confidence interval, profit without the single best market, activity and style, then subscribe.
+2. **The bot receives every fill** of those traders over the PMWallets WebSocket, typically within a second of the
+   block ([measured latency](https://pmwallets.com/latency)). Missed frames are detected (`session`/`seq`) and
+   replayed from the last fill handled, including everything that happened while the bot was down.
+3. **It mirrors them on Polymarket** with your own account, inside the limits you set. Your keys never leave your
+   machine; PMWallets never sees them and never places orders.
+
+## Quick start
+
+```bash
+# Python ≥ 3.10
+pip install pmwallets-copytrade
+pmwallets-copytrade init            # writes config.yaml
+export PMW_API_KEY=pmw_...          # https://pmwallets.com/keys
+pmwallets-copytrade run             # dry-run: logs every decision, trades nothing
+```
+
+When the dry-run log looks right, switch to live:
+
+```yaml
+mode: live
+polymarket:
+  privateKey: ${POLY_PRIVATE_KEY}        # signs your orders
+  signatureType: 2                       # 0 plain wallet · 1 email/Magic login · 2 browser-wallet login
+  funderAddress: ${POLY_FUNDER_ADDRESS}  # your Polymarket profile address (holds the USDC)
+```
+
+`pmwallets-copytrade status` prints open positions, today's spend and any order still being confirmed. If the bot
+cannot establish by itself whether an order filled, it keeps the order's reservation (no further BUY can exceed
+your limits because of it) and asks you: check polymarket.com and run
+`pmwallets-copytrade reconcile <key> --none` or `--filled <shares> --usdc <usdc>` with the bot stopped. Every decision — including each skip and its
+reason — is appended to `pmw-data/decisions.<mode>.jsonl`.
+
+## How it decides
+
+The rules come from a copy-trading bot that ran live on Polymarket; each one is there because of a lost trade or a
+rejected order.
+
+**BUY** (the trader bought)
+- skip fills older than `maxFillAgeSec` (a replay after downtime must not buy history), below
+  `minTargetNotionalUsdc`, or from a role you excluded;
+- one copy per trader transaction, one position per (trader, outcome), at most `maxBuysPerOutcome` buys into it
+  (DCA), `maxOpenPositionsPerTarget` / `maxOpenPositions` / `maxDailySpendUsdc` caps;
+- the market must be open, accepting orders and not settle within `minSecondsToEndDate`;
+- the best ask must sit in `[minPrice, maxPrice]`, be at most `maxSlippage` above what the trader paid, and the
+  book must hold `minBookDepthUsdc`;
+- order: **fill-or-kill for an exact number of shares** at the best ask (`orderSizeUsdc` / ask), rounded so the
+  CLOB accepts it. Share-denominated on purpose — a USDC-budget market order can overfill.
+
+**SELL** (the trader sold)
+- `sellMode: all` exits everything the bot bought following **that** trader in that outcome. Shares booked to
+  another trader in the same outcome are never sold: the most it sells is your token balance minus what the other
+  traders hold. If that comes to nothing, it stops and asks you to reconcile;
+- the exit is saved and retried (with backoff, across restarts) until the position is gone. Freshness does not
+  apply: if the trader left while the bot was down, it still gets out;
+- order: **fill-and-kill** at the best bid — a partial exit beats none, and the rest is retried.
+
+**Safety**
+- **dry-run by default**; live needs an explicit `mode: live`;
+- **at most once**: a fill is marked decided in the state file *before* any order is sent, so a crash can miss a
+  copy but never place it twice. One bot per data directory: a second instance refuses to start;
+- **no lost fills**: every order is saved as *pending* before it is sent. An order the exchange reports as killed
+  (such replies have carried real partial fills) is looked up again by its order id with backoff until its fill —
+  or its absence — is certain, even across restarts. One that got no answer at all has no id to look up: if a
+  matching trade appears, the bot does not guess whose it is (it could be yours by hand, or another trader's copy)
+  and hands it to you to `reconcile`;
+- resolved markets are swept every 10 minutes so they stop counting against the caps.
+
+**One stream per account.** PMWallets allows one WebSocket per account and the newest connection wins, so the bot
+and the live-feed page on pmwallets.com (or a second bot) will take the stream from each other. Run one consumer
+per account.
+
+## Development
+
+```bash
+pip install -e '.[dev]'   # or: uv pip install -e . pytest pytest-asyncio
+pytest
+```
+
+The same `config.yaml`, state files and lock file work with the Node.js version. `testdata/` holds the
+contract cases both implementations must pass — keep it identical in both repositories.
+
+## Resources
+
+- [Polymarket smart-money leaderboard](https://pmwallets.com) — profitable Polymarket traders scored from the Polygon chain, with win-rate confidence intervals
+- [Polymarket copy trading guide](https://pmwallets.com/copy-trading) — which wallets are worth following and how to get their fills in time
+- [How to learn from Polymarket smart money](https://pmwallets.com/learn) — reading a trader's record: confidence intervals, maker vs taker, market specialism
+- [PMWallets API documentation](https://pmwallets.com/docs) — WebSocket and webhook fill push, fills replay, trade-history exports
+- [Measured fill-push latency](https://pmwallets.com/latency) — block-to-push p50 / p95, published live
+- [Ways to follow Polymarket wallets, compared](https://pmwallets.com/compare) — official leaderboard, free trackers, SQL dashboards
+- [FAQ](https://pmwallets.com/faq) · [中文站](https://pmwallets.com/zh)
+
+## Proxies
+
+`HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY` are honoured for the PMWallets API, the WebSocket and the Polymarket CLOB.
+
+## Disclaimer
+
+This software places real orders with real money when `mode: live`. A copied order is not the trader's order: the
+price may have moved, fees apply and liquidity is shared. Past results do not predict future ones. PMWallets
+provides data about what traders did, not advice. Use at your own risk; see [LICENSE](LICENSE) (MIT).

pmwallets_copytrade-0.1.0/README.md

@@ -0,0 +1,114 @@
+# Polymarket copy-trading bot (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/pmwallets-copytrade.svg)](https://pypi.org/project/pmwallets-copytrade/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+A **ready-to-run Polymarket copy-trading bot** built on [PMWallets](https://pmwallets.com/copy-trading): it follows the
+traders you subscribe to and mirrors their fills on the Polymarket CLOB with your own account, inside the limits you set.
+
+[`pmwallets-copytrade` on PyPI](https://pypi.org/project/pmwallets-copytrade/) · [中文说明](README.zh.md) · Node.js version: [polymarket-copy-trading-bot](https://github.com/polymarketwallets/polymarket-copy-trading-bot) ·
+SDK: [pmwallets-python](https://github.com/polymarketwallets/pmwallets-python)
+
+## What the bot does
+
+1. **You pick the traders** on [pmwallets.com](https://pmwallets.com): filter the board by the lower bound of the
+   win-rate confidence interval, profit without the single best market, activity and style, then subscribe.
+2. **The bot receives every fill** of those traders over the PMWallets WebSocket, typically within a second of the
+   block ([measured latency](https://pmwallets.com/latency)). Missed frames are detected (`session`/`seq`) and
+   replayed from the last fill handled, including everything that happened while the bot was down.
+3. **It mirrors them on Polymarket** with your own account, inside the limits you set. Your keys never leave your
+   machine; PMWallets never sees them and never places orders.
+
+## Quick start
+
+```bash
+# Python ≥ 3.10
+pip install pmwallets-copytrade
+pmwallets-copytrade init            # writes config.yaml
+export PMW_API_KEY=pmw_...          # https://pmwallets.com/keys
+pmwallets-copytrade run             # dry-run: logs every decision, trades nothing
+```
+
+When the dry-run log looks right, switch to live:
+
+```yaml
+mode: live
+polymarket:
+  privateKey: ${POLY_PRIVATE_KEY}        # signs your orders
+  signatureType: 2                       # 0 plain wallet · 1 email/Magic login · 2 browser-wallet login
+  funderAddress: ${POLY_FUNDER_ADDRESS}  # your Polymarket profile address (holds the USDC)
+```
+
+`pmwallets-copytrade status` prints open positions, today's spend and any order still being confirmed. If the bot
+cannot establish by itself whether an order filled, it keeps the order's reservation (no further BUY can exceed
+your limits because of it) and asks you: check polymarket.com and run
+`pmwallets-copytrade reconcile <key> --none` or `--filled <shares> --usdc <usdc>` with the bot stopped. Every decision — including each skip and its
+reason — is appended to `pmw-data/decisions.<mode>.jsonl`.
+
+## How it decides
+
+The rules come from a copy-trading bot that ran live on Polymarket; each one is there because of a lost trade or a
+rejected order.
+
+**BUY** (the trader bought)
+- skip fills older than `maxFillAgeSec` (a replay after downtime must not buy history), below
+  `minTargetNotionalUsdc`, or from a role you excluded;
+- one copy per trader transaction, one position per (trader, outcome), at most `maxBuysPerOutcome` buys into it
+  (DCA), `maxOpenPositionsPerTarget` / `maxOpenPositions` / `maxDailySpendUsdc` caps;
+- the market must be open, accepting orders and not settle within `minSecondsToEndDate`;
+- the best ask must sit in `[minPrice, maxPrice]`, be at most `maxSlippage` above what the trader paid, and the
+  book must hold `minBookDepthUsdc`;
+- order: **fill-or-kill for an exact number of shares** at the best ask (`orderSizeUsdc` / ask), rounded so the
+  CLOB accepts it. Share-denominated on purpose — a USDC-budget market order can overfill.
+
+**SELL** (the trader sold)
+- `sellMode: all` exits everything the bot bought following **that** trader in that outcome. Shares booked to
+  another trader in the same outcome are never sold: the most it sells is your token balance minus what the other
+  traders hold. If that comes to nothing, it stops and asks you to reconcile;
+- the exit is saved and retried (with backoff, across restarts) until the position is gone. Freshness does not
+  apply: if the trader left while the bot was down, it still gets out;
+- order: **fill-and-kill** at the best bid — a partial exit beats none, and the rest is retried.
+
+**Safety**
+- **dry-run by default**; live needs an explicit `mode: live`;
+- **at most once**: a fill is marked decided in the state file *before* any order is sent, so a crash can miss a
+  copy but never place it twice. One bot per data directory: a second instance refuses to start;
+- **no lost fills**: every order is saved as *pending* before it is sent. An order the exchange reports as killed
+  (such replies have carried real partial fills) is looked up again by its order id with backoff until its fill —
+  or its absence — is certain, even across restarts. One that got no answer at all has no id to look up: if a
+  matching trade appears, the bot does not guess whose it is (it could be yours by hand, or another trader's copy)
+  and hands it to you to `reconcile`;
+- resolved markets are swept every 10 minutes so they stop counting against the caps.
+
+**One stream per account.** PMWallets allows one WebSocket per account and the newest connection wins, so the bot
+and the live-feed page on pmwallets.com (or a second bot) will take the stream from each other. Run one consumer
+per account.
+
+## Development
+
+```bash
+pip install -e '.[dev]'   # or: uv pip install -e . pytest pytest-asyncio
+pytest
+```
+
+The same `config.yaml`, state files and lock file work with the Node.js version. `testdata/` holds the
+contract cases both implementations must pass — keep it identical in both repositories.
+
+## Resources
+
+- [Polymarket smart-money leaderboard](https://pmwallets.com) — profitable Polymarket traders scored from the Polygon chain, with win-rate confidence intervals
+- [Polymarket copy trading guide](https://pmwallets.com/copy-trading) — which wallets are worth following and how to get their fills in time
+- [How to learn from Polymarket smart money](https://pmwallets.com/learn) — reading a trader's record: confidence intervals, maker vs taker, market specialism
+- [PMWallets API documentation](https://pmwallets.com/docs) — WebSocket and webhook fill push, fills replay, trade-history exports
+- [Measured fill-push latency](https://pmwallets.com/latency) — block-to-push p50 / p95, published live
+- [Ways to follow Polymarket wallets, compared](https://pmwallets.com/compare) — official leaderboard, free trackers, SQL dashboards
+- [FAQ](https://pmwallets.com/faq) · [中文站](https://pmwallets.com/zh)
+
+## Proxies
+
+`HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY` are honoured for the PMWallets API, the WebSocket and the Polymarket CLOB.
+
+## Disclaimer
+
+This software places real orders with real money when `mode: live`. A copied order is not the trader's order: the
+price may have moved, fees apply and liquidity is shared. Past results do not predict future ones. PMWallets
+provides data about what traders did, not advice. Use at your own risk; see [LICENSE](LICENSE) (MIT).

pmwallets_copytrade-0.1.0/README.zh.md

@@ -0,0 +1,108 @@
+# Polymarket 跟单机器人（Python）
+
+[![PyPI](https://img.shields.io/pypi/v/pmwallets-copytrade.svg)](https://pypi.org/project/pmwallets-copytrade/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+基于 [PMWallets](https://pmwallets.com/zh/copy-trading) 的**开箱即用 Polymarket 跟单机器人**：跟随你订阅的交易者，
+用你自己的账户在 Polymarket CLOB 上按你设定的限制跟单。
+
+[`pmwallets-copytrade` on PyPI](https://pypi.org/project/pmwallets-copytrade/) · [English](README.md) · Node.js 版：[polymarket-copy-trading-bot](https://github.com/polymarketwallets/polymarket-copy-trading-bot) ·
+SDK：[pmwallets-python](https://github.com/polymarketwallets/pmwallets-python)
+
+## 它做什么
+
+1. **你来挑交易者**：在 [pmwallets.com](https://pmwallets.com/zh) 按胜率置信区间下限、去掉最赚一场后的盈利、
+   活跃度与风格筛选，然后订阅。
+2. **机器人接收他们的每一笔成交**：走 PMWallets 的 WebSocket，通常在出块后一秒内到达
+   （[实测延迟](https://pmwallets.com/zh/latency)）。漏掉的帧通过 `session`/`seq` 发现，并从最后处理的那笔
+   开始补发 —— 机器人停机期间发生的也会补上。
+3. **在 Polymarket 上用你自己的账户跟单**，严格限制在你设定的范围内。私钥只在你本机，PMWallets 看不到，
+   也从不代你下单。
+
+## 快速开始
+
+```bash
+# Python ≥ 3.10
+pip install pmwallets-copytrade
+pmwallets-copytrade init            # 生成 config.yaml
+export PMW_API_KEY=pmw_...          # 在 https://pmwallets.com/keys 创建
+pmwallets-copytrade run             # 默认 dry-run：记录每个决策，不下任何单
+```
+
+dry-run 日志确认没问题后再切到实盘：
+
+```yaml
+mode: live
+polymarket:
+  privateKey: ${POLY_PRIVATE_KEY}        # 用来签名订单
+  signatureType: 2                       # 0 普通钱包 · 1 邮箱/Magic 登录 · 2 浏览器钱包登录
+  funderAddress: ${POLY_FUNDER_ADDRESS}  # 你的 Polymarket 主页地址（USDC 在这里）
+```
+
+`pmwallets-copytrade status` 显示持仓、今日花费和仍在确认中的订单。如果机器人自己无法确认某笔订单是否成交，
+它会保留这笔订单的额度预留（后续买入不会因此突破你的上限），并请你到 polymarket.com 核对后，在机器人停止时运行
+`pmwallets-copytrade reconcile <key> --none` 或 `--filled <股数> --usdc <金额>`。每一个决策（包括每次跳过及原因）都追加写入
+`pmw-data/decisions.<mode>.jsonl`。
+
+## 决策规则
+
+这些规则来自一个在 Polymarket 上实盘跑过的跟单机器人，每一条都对应一次丢单或一次被拒的订单。
+
+**买入**（交易者买了）
+- 跳过：超过 `maxFillAgeSec` 的旧成交（停机后的补发不能拿历史去买入）、低于 `minTargetNotionalUsdc` 的小单、
+  你排除掉的角色（挂单/吃单）；
+- 每笔交易者交易只跟一次；每个（交易者，结果）一个仓位，最多加仓 `maxBuysPerOutcome` 次；另有
+  `maxOpenPositionsPerTarget` / `maxOpenPositions` / `maxDailySpendUsdc` 上限；
+- 市场必须开放、接受订单，且不会在 `minSecondsToEndDate` 内结算；
+- 最优卖价必须在 `[minPrice, maxPrice]` 内、比交易者成交价高出不超过 `maxSlippage`，盘口深度至少
+  `minBookDepthUsdc`；
+- 下单：在最优卖价按**固定股数 FOK**（`orderSizeUsdc` / 卖价），按 CLOB 的精度规则取整。故意按股数而不是按
+  USDC 预算下单 —— 按预算的市价单会超额成交。
+
+**卖出**（交易者卖了）
+- `sellMode: all`：卖掉跟着**这位**交易者在该结果上买入的全部仓位。记在其他交易者名下的同一结果绝不动：
+  最多卖「账户持有量 − 其他交易者的账面仓位」；如果算下来为零，就停下来提示你对账；
+- 退出指令会落盘，按退避重试（重启后继续），直到仓位清掉。新鲜度限制不适用于卖出：交易者在机器人停机时
+  退出了，机器人照样要退；
+- 下单：在最优买价 **FAK**（能成交多少算多少）—— 部分退出好过完全退不出，剩下的继续重试。
+
+**安全**
+- **默认 dry-run**，实盘必须显式写 `mode: live`；
+- **最多执行一次**：一笔成交在发出任何订单**之前**就写进状态文件标记为已决策，崩溃最多漏跟一次，绝不会重复下单。
+  一个数据目录只能跑一个机器人，第二个实例会拒绝启动；
+- **不漏记成交**：每笔订单发出前先落盘为「待确认」。交易所回报「被取消」的（这类回报曾带着真实的部分成交），
+  会按订单号退避反复查询，直到确认成交或确认没有成交 —— 重启后也会继续。根本没收到回报的订单没有订单号可查：
+  如果出现形状相符的成交，机器人不会去猜它属于谁（可能是你手动下的，也可能是跟另一位交易者的单），而是交给你
+  `reconcile`；
+- 每 10 分钟清理一次已结算的市场，让它们不再占用仓位上限。
+
+**每个账户只有一条推送流。** PMWallets 每个账户只允许一条 WebSocket，后连上的会顶掉先连的 —— 所以机器人
+和 pmwallets.com 上的实时推送页（或者第二个机器人）会互相踢。一个账户只跑一个消费者。
+
+## 开发
+
+```bash
+pip install -e '.[dev]'   # or: uv pip install -e . pytest pytest-asyncio
+pytest
+```
+
+`config.yaml`、状态文件和锁文件与 Node.js 版通用。`testdata/` 是两个实现都必须通过的契约用例 —— 两个仓库里保持一致。
+
+## 相关链接
+
+- [Polymarket 聪明钱排行榜](https://pmwallets.com/zh) —— 从 Polygon 链上计算的 Polymarket 盈利交易者，胜率带置信区间
+- [Polymarket 跟单指南](https://pmwallets.com/zh/copy-trading) —— 哪些钱包值得跟，以及怎样及时拿到他们的成交
+- [怎样向 Polymarket 聪明钱学习](https://pmwallets.com/zh/learn) —— 读懂一份战绩：置信区间、挂单与吃单、擅长的市场
+- [PMWallets API 文档](https://pmwallets.com/zh/docs) —— WebSocket 与 Webhook 成交推送、补发接口、交易历史导出
+- [成交推送实测延迟](https://pmwallets.com/zh/latency) —— 出块到推送的 p50 / p95，实时公布
+- [追踪 Polymarket 钱包的几种做法对比](https://pmwallets.com/zh/compare) —— 官方榜单、免费追踪器、SQL 看板
+- [常见问题](https://pmwallets.com/zh/faq) · [English site](https://pmwallets.com)
+
+## 代理
+
+PMWallets API、WebSocket 与 Polymarket CLOB 都会读取 `HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY`。
+
+## 免责声明
+
+`mode: live` 时本软件会用真金白银下真实订单。跟出去的单不是交易者的那一单：价格可能已经变了、有手续费、
+流动性是共享的。过往结果不预示未来。PMWallets 提供的是交易者做了什么的数据，不是投资建议。风险自负；
+许可证见 [LICENSE](LICENSE)（MIT）。

pmwallets_copytrade-0.1.0/config.example.yaml

@@ -0,0 +1,45 @@
+# pmwallets-copytrade — copy the Polymarket traders you follow on PMWallets.
+#
+# 1. Create an API key on https://pmwallets.com/keys and subscribe to the traders you want to copy.
+# 2. Run in dry-run first (the default): every decision is logged, nothing is traded.
+# 3. When the log looks right, set `mode: live` and fill in the polymarket section.
+#
+# ${NAME} is read from the environment — keep secrets out of this file.
+
+mode: dry-run            # dry-run | live
+
+pmwallets:
+  apiKey: ${PMW_API_KEY}
+
+polymarket:
+  # only needed for live mode
+  # privateKey: ${POLY_PRIVATE_KEY}       # the key that signs your Polymarket orders
+  # signatureType: 2                       # 0 = plain EOA wallet, 1 = email/Magic login, 2 = browser-wallet login
+  # funderAddress: ${POLY_FUNDER_ADDRESS}  # your Polymarket profile address (holds the USDC)
+
+# Leave empty to copy every entity your PMWallets account subscribes to.
+targets: []
+#  - entity: "0x9d84ce0306f8551e02efef1680475fc0f1dc1344"
+#    orderSizeUsdc: 20        # override per target
+#  - entity: "7KQ2MF9X4B1C"   # a handle works once you subscribe to it
+
+copy:
+  orderSizeUsdc: 10          # USDC per mirrored BUY
+  roles: [taker, maker]      # which of the target's fills to act on
+  maxBuysPerOutcome: 3       # follow up to 3 BUYs into one outcome (DCA), then hold
+  maxOpenPositions: 20
+  maxOpenPositionsPerTarget: 5
+  maxFillAgeSec: 60          # older fills (e.g. replayed after downtime) are not copied
+  minTargetNotionalUsdc: 25  # ignore the target's small fills
+  minPrice: 0.05             # only BUY when the best ask is inside this band
+  maxPrice: 0.95
+  maxSlippage: 0.03          # skip if the ask is more than 3 cents above what the target paid
+  minBookDepthUsdc: 50
+  minSecondsToEndDate: 600   # don't enter a market that settles within 10 minutes
+  maxSecondsToEndDate: 0     # 0 = no upper limit
+  sellMode: all              # all = exit when the target sells; none = hold to settlement
+
+risk:
+  maxDailySpendUsdc: 200     # total BUYs per UTC day; 0 = no limit
+
+dataDir: ./pmw-data          # state, stream cursor and decisions.<mode>.jsonl

pmwallets_copytrade-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pmwallets-copytrade"
+version = "0.1.0"
+description = "Ready-to-run Polymarket copy-trading bot: follows the wallets you subscribe to on PMWallets and mirrors their trades on the Polymarket CLOB, with dry-run, risk caps and exactly-once fill handling."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+keywords = ["polymarket", "copy-trading", "copytrade", "trading-bot", "prediction-markets", "pmwallets"]
+dependencies = ["pmwallets>=0.1.0", "py-clob-client-v2>=1.1.0", "pyyaml>=6", "httpx>=0.27"]
+
+[project.scripts]
+pmwallets-copytrade = "pmwallets_copytrade.cli:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-asyncio>=0.23"]
+
+[project.urls]
+Homepage = "https://pmwallets.com/copy-trading"
+Repository = "https://github.com/polymarketwallets/polymarket-copy-trading-bot-python"
+Issues = "https://github.com/polymarketwallets/polymarket-copy-trading-bot-python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pmwallets_copytrade"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"config.example.yaml" = "pmwallets_copytrade/config.example.yaml"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

pmwallets_copytrade-0.1.0/scripts/live_readonly_smoke.py

@@ -0,0 +1,34 @@
+"""Manual smoke test against the real, public Polymarket CLOB (read-only). Not part of pytest:
+    python scripts/live_readonly_smoke.py
+"""
+import asyncio
+
+import httpx
+
+from pmwallets_copytrade.config import build_config
+from pmwallets_copytrade.filters import book_gate, market_gate
+from pmwallets_copytrade.log import ConsoleLogger
+from pmwallets_copytrade.polymarket import PolymarketGateway
+from pmwallets_copytrade.units import from_micro
+
+
+async def main() -> None:
+    cfg = build_config({"pmwallets": {"apiKey": "pmw_x_y"}})
+    pm = PolymarketGateway(cfg.polymarket, ConsoleLogger())
+    async with httpx.AsyncClient(timeout=15) as http:
+        sample = (await http.get("https://clob.polymarket.com/sampling-markets")).json()
+    for m in sample["data"][:3]:
+        token_id = m["tokens"][0]["token_id"]
+        cid = await pm.condition_id_for(token_id)
+        market = await pm.market(cid)
+        book = await pm.orderbook(token_id)
+        print({
+            "question": market.question[:50], "cidMatches": cid == m["condition_id"], "endDate": market.endDate,
+            "bestAsk": book.asks and from_micro(book.asks[0].price), "bestBid": book.bids and from_micro(book.bids[0].price),
+            "sorted": all(a.price <= b.price for a, b in zip(book.asks, book.asks[1:])) and all(a.price >= b.price for a, b in zip(book.bids, book.bids[1:])),
+            "tick": book.tickSize and from_micro(book.tickSize), "minOrder": book.minOrderSize and from_micro(book.minOrderSize),
+            "marketGate": market_gate(market, "buy", cfg.copy), "bookGate": book_gate(book, "buy", cfg.copy),
+        })
+
+
+asyncio.run(main())

pmwallets_copytrade-0.1.0/src/pmwallets_copytrade/__init__.py

@@ -0,0 +1,3 @@
+"""pmwallets-copytrade — copy the Polymarket wallets you follow on PMWallets."""
+
+__version__ = "0.1.0"