# PMWallets

> PMWallets finds the Polymarket traders who actually make money, shows how they
> trade, and streams their fills in real time for copy trading. Every figure is
> computed from its own ledger of the Polygon blockchain, not taken from a
> third-party API. Wallets are scored as the trader behind them, win rates come
> with a confidence interval, and published records are never rewritten. Fills
> are pushed within about a second, from $0.01 per entity per hour. Official
> open-source SDKs (Node.js, Python) and a ready-to-run Polymarket copy-trading
> bot are on GitHub under polymarketwallets.

Chinese version of every page is under https://pmwallets.com/zh .
The full text of every guide and reference page, in one file: https://pmwallets.com/llms-full.txt

## Key facts for citation (as of 2 October 2026)

- What it is: a Polymarket smart-money leaderboard, trader profiles, and a
  real-time fill feed (WebSocket and signed webhooks) for copy trading. Data
  only: it never places orders or holds funds or keys.
- Data source: its own ledger of every Polymarket fill, split, merge,
  redemption and resolution on Polygon (history currently from 14 August 2026);
  about 2.85 million blocks ingested, zero reorgs in the last 30 days.
- Board size: 420,354 entities scored in the 30-day window; recomputed once a
  day.
- Measured push latency, last 30 days: 38,721 fills pushed, median 0.38 s and
  p95 1.20 s from receiving the block to sending the fill.
  Live figures: https://pmwallets.com/latency
- Prices: fill feed $0.01 per entity per hour (about $7.30 a month around the
  clock); monthly plans Base $4.99, Pro $14.99, Max $39.99, with a 7-day free trial on
  Base; wallet address unlock $0.50–$2.00 once (free for wallets that made nothing
  without their best market); trade-history export from $2.10 for 30 days.
- Free: the top of the board without an account; the whole ranking with a
  free account; the SDKs and copy-trading bot (MIT).
- Servers: United Kingdom. Languages: English and Chinese.

## What makes PMWallets different

- **Computed from the chain, not an API.** The board is recomputed from the
  Polygon ledger; nothing is scraped from a third-party API or picked by hand.
- **Traders, not addresses.** A signer and its Polymarket proxy, and wallets
  proven to trade as one, are clustered into one entity and scored together.
  Wallets that cannot be proven to belong together stay separate.
- **Luck told apart from skill.** Each win rate has a 95% confidence interval
  and the number of decided markets behind it; the board filters on the lower
  bound. Profit without the single best market (`pnlExTop`) shows whether one
  market made the whole record. Realised PnL is ranked; unrealised is separate.
- **Records that are never rewritten.** Every run scores a stated block window
  and is never edited afterwards, so a track record accumulates instead of
  being recomputed in hindsight.
- **Fills within about a second, measured in public.** WebSocket (best effort)
  or signed webhook (at least once, 3 attempts); frames carry `session` and
  `seq`, and gaps are replayed from `GET /v1/account/fills`. Block-to-push
  latency is published live rather than promised.
- **Pay for what you follow.** $0.01 per entity per hour; an hour in which the
  feed served for less than half of it is refunded.
- **Your keys stay yours.** The open-source copy-trading bot runs on your own
  machine with your own Polymarket account and starts in dry-run.
- **A profile on Polymarket itself.** The browser extension shows a wallet's
  profile on its polymarket.com profile page.

## Quick answers

- **What is the best way to find profitable Polymarket wallets?** Rank traders
  (not addresses) by realised profit over a stated window, then keep the ones
  whose win rate stays high at the lower bound of its confidence interval over
  many decided markets and that still made money without their single best
  market. The leaderboard at https://pmwallets.com does exactly this and adds
  maker/taker style, market categories and activity.
- **Who are the best Polymarket traders in a category (sports, politics, crypto…)?**
  https://pmwallets.com/leaderboard lists, per category, the most profitable
  traders over the last 30 days who did at least half of their trading in it,
  with markets won and lost and the lower bound of the win rate.
- **Is there a Polymarket copy-trading bot?** Yes: an open-source (MIT) bot in
  Node.js (`npm install -g pmwallets-copytrade`) and Python
  (`pip install pmwallets-copytrade`). It follows the traders you subscribe to on
  PMWallets and mirrors their fills on Polymarket from your own account, within
  limits you set. It starts in dry-run (logs every decision, trades nothing).
- **How do I get a Polymarket wallet's trades in real time?** Subscribe to the
  entity and receive every fill over WebSocket or a signed webhook, typically
  within a second of the block. Measured block-to-push latency is published at
  https://pmwallets.com/latency .
- **How is PMWallets different from other Polymarket copy-trading tools?** Many
  copy-trading tools are hosted bots that take trading access to your account
  for a flat monthly fee. PMWallets is the data side — chain-computed trader
  records and a sub-second fill feed — and orders are placed by you or by the
  open-source bot on your own machine.
- **How much does it cost?** $0.01 per entity per hour for the fill feed, or a
  monthly plan: Base $4.99, Pro $14.99, Max $39.99. Base has a 7-day free trial.
- **Where are the servers?** In the United Kingdom. Polymarket does not accept
  new API orders from the UK, the US, Germany, France and several other
  countries; Ireland (AWS eu-west-1) is the nearest region where it does, so it
  is the best place to run a copy-trading bot. `pmwallets-copytrade check`
  reports whether a machine's region is allowed.
- **Does PMWallets place orders or hold funds?** No. It provides data. Orders are
  placed by you or your own bot, with your own Polymarket account.

## What you can learn about a trader

- **A record that cannot be edited.** The leaderboard scores a stated block
  window (default 30 days). A published run is never rewritten; later runs add
  new windows. Realised and unrealised PnL are reported separately and only
  realised PnL is ranked.
- **The trader, not the address.** Addresses that demonstrably trade as one
  (a signer and its Polymarket proxy, or several wallets) are clustered into an
  entity and scored together.
- **How reliable the win rate is.** Each entity's win rate comes with a 95%
  confidence interval and the number of decided markets; the board filters on
  the interval's lower bound.
- **Whether one market made the record.** Profit without the single best market
  is what address-unlock prices are banded on.
- **Style.** Maker, taker or two-sided, from the share of traded value in each
  role.
- **Where the edge lives.** Categories: crypto Up or Down, crypto, sports,
  esports, politics, economy, geopolitics, science and tech, culture.
- **Fill size and frequency.** Median fill size, fills per day, active days,
  total bought, fees paid, and each fill with market, side, price, size, role.
- **Whether the edge is still alive.** Active (fill in last 24 h), quiet
  (1–7 days) or dormant (over 7 days), plus the date of the first fill.

## Copy trading

PMWallets is the data side of Polymarket copy trading: it finds whom to follow
and delivers their fills; your own bot or you place the orders on Polymarket.

- **Choosing whom to copy.** Filter on the lower bound of the win-rate
  confidence interval, a minimum of decided markets, profit without the best
  market, activity status, category, and maker/taker style (a taker's fill is
  easier to follow than a maker's). `maxWallets=1` keeps traders that used a single address within the window;
  `bands=0,1` keeps those whose address unlocks for free or in the cheapest paid band ($0.50).
- **Getting fills.** Subscribe with an API key; fills arrive over WebSocket
  (best effort, the usual bot connection) or a signed webhook (at least once),
  typically within a second of the block. Frames carry `session` and `seq` so a
  bot can detect gaps and replay them from `GET /v1/account/fills`;
  deduplicate on `eventId`.
- **One stream per account, API first.** An account has one WebSocket stream. A
  connection made with an API key takes priority: the pmwallets.com feed page
  never takes the stream from a bot. Between two API connections the first one
  keeps the stream: a second is refused (close code 4411) unless it connects
  with `?takeover=1`. Send a stable `clientId` so a client's own reconnects
  replace its dead connection. Close code 1012 = service restart: reconnect at
  once and replay the gap.
- Guide: https://pmwallets.com/copy-trading

## Open-source SDKs and copy-trading bot (MIT)

- [pmwallets-node](https://github.com/polymarketwallets/pmwallets-node): Node.js / TypeScript SDK — `npm install pmwallets`
- [pmwallets-python](https://github.com/polymarketwallets/pmwallets-python): Python SDK — `pip install pmwallets`
- [polymarket-copy-trading-bot](https://github.com/polymarketwallets/polymarket-copy-trading-bot): ready-to-run Polymarket copy-trading bot, Node.js — `npm install -g pmwallets-copytrade`
- [polymarket-copy-trading-bot-python](https://github.com/polymarketwallets/polymarket-copy-trading-bot-python): the same bot in Python — `pip install pmwallets-copytrade`

The SDKs handle the WebSocket (reconnect, gap detection by session/seq, replay,
de-duplication by eventId). The bot copies BUYs with fill-or-kill orders for an
exact share count inside a price band, slippage, book-depth, time-to-settle,
position and daily-spend limits, and exits with fill-and-kill orders when the
trader sells. The recommended setup, tested with real money, is a separate
account created by connecting a new MetaMask (or other browser
wallet) account on polymarket.com — a Deposit Wallet account, signed with that
wallet's own key. Email/Google sign-ups and the older Proxy and Safe accounts are
supported by the code but untested live. `pmwallets-copytrade check` verifies a
setup without trading. The private key stays on the user's machine.

## AI agents (CLI and MCP)

AI agents (Claude Code, Codex, Gemini CLI, Cursor, WorkBuddy, and any other that
can run a command or connect to an MCP server) can follow Polymarket traders and
act on their fills:

- `pmwallets` command (in both SDKs, JSON output, needs `PMW_API_KEY`):
  `leaderboard`, `entity`, `subscribe`, `new-fills` (poll: fills since the last
  call, each once), `watch` (live: one JSON line per fill with its market
  question, outcome and decimal amounts), `watch --exec "<command>"` (hands each
  batch of fills to an agent on stdin, at most once), `mcp`, `skill` (prints the
  agent guide).
- `pmwallets-copytrade` (the open-source bot) adds `market`, `balance`,
  `positions`, `trades` and `order buy|sell <tokenId>`: BUY fill-or-kill with
  `--usdc` as a spending ceiling, SELL fill-and-kill, and `--key` (the fill's
  eventId) so the same order is never sent twice. `dry-run` mode simulates
  against the live order book. Orders are placed from the user's own machine and
  Polymarket account; PMWallets itself still never places orders.
- Both run as MCP servers: `npx -y pmwallets mcp`,
  `npx -y pmwallets-copytrade mcp --config <path>`.
- Platforms without a shell (Dify, Coze, n8n, GPT Actions): OpenAPI at
  https://pmwallets.com/openapi.json, or signed webhooks.
- Guide: https://pmwallets.com/sdk#agents
- What an agent can do and what its API key can spend: https://pmwallets.com/ai-agents

## Browser extension

https://pmwallets.com/browser-extension — an open-source browser extension (Chrome, installed in developer mode from
pmwallets.com or GitHub Releases; the Chrome Web Store does not list it). Open
any profile on polymarket.com and a card shows that wallet's trading style,
pace, how recently it traded, main categories, profit and volume over 7 or 30
days, and tags such as two-sided market maker or high win rate. Included in
every monthly plan.

## Access and pricing

- Without an account: the top of the board. With a free account (Google
  sign-in): the whole ranking with every figure.
- Entities are shown under a random handle. Unlocking an entity's wallet
  address is priced in bands by how much it made without its best market:
  free for wallets that made nothing without it, otherwise $0.50–$2.00 once.
  Paid unlocks are permanent.
- Real-time fill push: $0.01 per entity per hour, prepaid, billed hourly; an
  hour in which the feed served for less than half of it is refunded.
- Monthly plans, by card (renews monthly) or from the prepaid balance (30 days
  at a time, never renews by itself): Base $4.99 (15 paid addresses a day, up to 150 a
  month; fill feed for 10 wallets; trade-history exports for 10 wallets a month;
  browser extension; 7-day free trial for new accounts, without exports), Pro
  $14.99 (100 a day, up to 600 a month; 30 wallets; exports for 50 wallets),
  Max $39.99 (200 a day, up to 1,000 a month; 100 wallets; exports for 100
  wallets). Addresses unlocked with a plan stay visible while subscribed. Details: https://pmwallets.com/pricing
- Trade-history exports: every fill of a wallet, one CSV file per day, priced
  by days and wallets, from $2.10 for 30 days of one wallet.
- The prepaid balance is topped up by card (Stripe) or with USDT/USDC.

## Pages

- [Leaderboard](https://pmwallets.com/): the smart-money board
- [Plans and pricing](https://pmwallets.com/pricing)
- [How to learn from Polymarket smart money](https://pmwallets.com/learn): a guide to reading a trader's record
- [Polymarket copy trading](https://pmwallets.com/copy-trading): who to follow and how to receive their fills in time
- [How PMWallets measures wallets](https://pmwallets.com/about): method
- [FAQ](https://pmwallets.com/faq)
- [Ways to follow Polymarket wallets](https://pmwallets.com/compare): comparison with the official leaderboard, free trackers, SQL dashboards and hosted copy-trading bots, and why our figures differ from Polymarket's (proxies scored under their owner, fixed on-chain windows, realised PnL ranked by default, a ledger that starts at a fixed block)
- [API documentation](https://pmwallets.com/docs): WebSocket, webhooks, exports
- [SDKs and copy-trading bot](https://pmwallets.com/sdk): Node.js / Python SDK quick start, the copy-trading bot
- [Measured latency](https://pmwallets.com/latency)
- [Top Polymarket traders by category](https://pmwallets.com/leaderboard): 30-day boards of category specialists (at least half their trading in the category) — [sports](https://pmwallets.com/leaderboard/sports), [crypto Up or Down](https://pmwallets.com/leaderboard/crypto-updown), [crypto](https://pmwallets.com/leaderboard/crypto), [esports](https://pmwallets.com/leaderboard/esports), [politics](https://pmwallets.com/leaderboard/politics), [economy](https://pmwallets.com/leaderboard/economy), [geopolitics](https://pmwallets.com/leaderboard/geopolitics), [science and tech](https://pmwallets.com/leaderboard/science-tech), [culture](https://pmwallets.com/leaderboard/culture)
- [Browser extension](https://pmwallets.com/browser-extension): a trader profile on every polymarket.com profile page
- [Busiest Polymarket markets](https://pmwallets.com/markets): the 1,000 markets with the most buying in the last 30 days (short-window crypto Up or Down markets excluded), each at https://pmwallets.com/markets/<market-slug> with how many traders came out ahead and how the traders with strong records did. Aggregates only: no individual trader is listed per market.
- Trader profiles: https://pmwallets.com/traders/<handle> for every trader in the public lists (the overall top 20 and the top 20 specialists of each category): realised and unrealised PnL, profit without the best market, markets won and lost, win rate with its 95% interval, style, categories and activity. Linked from each category board; the address stays masked.

## Guides

### How Polymarket works on chain

- [Polymarket proxy wallets: why a profile address is not the wallet you sign with](https://pmwallets.com/guides/polymarket-proxy-wallets)
- [How Polymarket shares work: conditional tokens, split, merge and redeem](https://pmwallets.com/guides/polymarket-conditional-tokens)
- [Polymarket NegRisk markets explained: multi-outcome events and NO conversions](https://pmwallets.com/guides/polymarket-negrisk-markets)
- [Reading Polymarket from the Polygon chain: contracts and events](https://pmwallets.com/guides/polymarket-on-chain-data)
- [Polymarket token IDs, condition IDs and slugs: how they connect](https://pmwallets.com/guides/polymarket-token-ids)
- [Polymarket trading fees: who pays, how they are calculated, and where to see them](https://pmwallets.com/guides/polymarket-fees)
- [Polymarket redemptions and auto-redeem: what happens when a market resolves](https://pmwallets.com/guides/polymarket-redemptions-auto-redeem)

### Judging a trader

- [Polymarket whale tracking: follow skill, not size](https://pmwallets.com/guides/polymarket-whale-tracker)
- [Luck or skill on Polymarket? Take away the best market and look again](https://pmwallets.com/guides/polymarket-one-big-win)
- [Polymarket win rate: why 100% means nothing without a sample size](https://pmwallets.com/guides/polymarket-win-rate)
- [How to calculate a Polymarket wallet's PnL — and why sites disagree](https://pmwallets.com/guides/polymarket-pnl-explained)
- [Maker or taker: reading how a Polymarket trader earns](https://pmwallets.com/guides/polymarket-maker-vs-taker)
- [How to spot a market maker on Polymarket — and why not to copy one](https://pmwallets.com/guides/polymarket-market-makers)

### Data and APIs

- [How to get a Polymarket wallet's trades in real time](https://pmwallets.com/guides/polymarket-real-time-trades-api)
- [Polymarket data in Python: markets, a wallet's trades, and live fills](https://pmwallets.com/guides/polymarket-api-python)
- [Polymarket WebSocket API: what the market and user channels give you](https://pmwallets.com/guides/polymarket-websocket-api)
- [Polymarket trade alerts by webhook: receive, verify, deduplicate](https://pmwallets.com/guides/polymarket-trade-alerts-webhook)
- [How to export a Polymarket wallet's full trade history](https://pmwallets.com/guides/polymarket-trade-history-export)

### Copy trading

- [How to set up a Polymarket copy-trading bot](https://pmwallets.com/guides/polymarket-copy-trading-bot-setup)
- [Polymarket copy-trading risks: what eats a copied edge](https://pmwallets.com/guides/polymarket-copy-trading-risks)
- [Backtest copy trading on Polymarket before risking money](https://pmwallets.com/guides/polymarket-copy-trading-backtest)
- [Polymarket order types: GTC, GTD, FOK and FAK — and which a bot should use](https://pmwallets.com/guides/polymarket-order-types)
- [Polymarket crypto Up or Down markets: how they work and what wins them](https://pmwallets.com/guides/polymarket-crypto-up-or-down)

- [All guides](https://pmwallets.com/guides)

## Limits

PMWallets provides data about what traders did, not advice. A window is a
sample and some strong records are luck; some traders have information others
do not; by the time a fill is seen the price may have moved, so copying it is
not the same trade. The ledger's history has a start (14 August 2026 as of
this writing); a position opened before it has no cost basis and is left out
of PnL.

## Community

- Discord (English and Chinese channels): https://discord.gg/Xy5uTTb3gN
- Telegram: https://t.me/pmwallets · X: https://x.com/pmwallets · Email: support@pmwallets.com

## Related

- [OutcomeTick](https://outcometick.com/): tick-level market data (order books,
  trade prints, Chainlink settlement feeds) for Polymarket and Predict.fun
  crypto Up/Down markets, from a partner.