# πŸ† Winning Wallet Finder Find Polymarket wallets with a **real, statistically-verifiable edge**, test whether copying them actually makes money, **get pinged the moment they trade**, and watch a **live $1,000 paper portfolio** follow them in real time. This started as "copy the smart money." Along the way we tested β€” and ruled out β€” six systematic public-data strategies, and found that the *only* signal that holds up is **statistical improbability**: wallets that win far more than the prices they paid imply. This repo is the tooling for finding and watching those wallets, plus an honest record of everything that didn't work. > **Read [`FINDINGS.md`](FINDINGS.md) for the full story.** TL;DR: detection of > edge wallets works; *profitably copying them* is unproven (it survived a naive > backtest but collapsed to one-wallet variance out-of-sample). Treat this as a > research + monitoring tool, not a money printer. --- ## The core idea: z-score, not win rate Every Polymarket bet has an entry price that *is* the market's estimate of its odds (a YES at 30Β’ β‡’ market thinks 30%). If you have no edge, over many bets you win about the **sum of your entry prices** β€” call it *expected wins*. ``` z = (actual wins βˆ’ expected wins) / standard deviation ``` - **z = 0** β†’ you won exactly what your prices implied β†’ no edge. - **z = 3** β†’ ~1-in-740 by luck. **z = 5** β†’ ~1-in-3.5M. **z = 9** β†’ astronomical. - **`p(luck)`** is z as a probability: the chance a no-edge bettor does this well by chance. Why this beats win rate: a wallet that bets longshots and **wins 14% when the odds implied 8%** has a huge edge (high z) despite a low win rate. A wallet buying 90Β’ favorites and winning 90% has zβ‰ˆ0 β€” no edge, just paying for favorites. **z measures beating the prices you paid.** Two refinements separate signal from noise: - **Lifetime trade count** β€” high z + tens of thousands of trades = a market-maker bot, not an insider. Real edge wallets have *concentrated* edge over a few thousand trades. - **Pre-resolution timing + fresh wallet** β€” entering minutes/hours before resolution on a new account is the insider fingerprint (the Bubblemaps / *60 Minutes* pattern). --- ## How the pieces fit ``` data layer detection hunting validation live system ────────── ───────── ─────── ────────── ─────────── smart_money.py ─▢ insider.py ──▢ hunt.py / huntwide β–Ά copyback / oos.py β–Ά webhook_receiver.py ─▢ Discord ping (Polymarket API, (z-score, timing, (sweep markets, (does copying them (Alchemy webhook) true win rate) freshness, funding surface edge actually pay? in- & trading/ (paper) ────▢ live $1k clustering) wallets) out-of-sample) jaxperro.com/trading portfolio ``` | File | Role | |------|------| | `insider.py` | **The detector.** z-score/p-value, pre-resolution timing, fresh-wallet & sizing flags, and Alchemy funding-cluster ring detection. `--scan` / `--market` / `--wallet`. | | `smart_money.py` | Data foundation + dashboard. Survivorship-corrected **true** win rate. | | `hunt.py` | Ring-hunt sweep over a fixed list of news-driven event markets. | | `huntwide.py` | Wide sweep β€” source wallets from ~100 markets, score each, tier by z. | | `copyback.py` | Backtest: copy edge wallets' entries from a date, weighted, compounding. | | `oos.py` | **Out-of-sample test** β€” select wallets on pre-period data, copy forward. The honesty gate. | | `webhook_receiver.py` | Push-based live watcher: Alchemy on-chain webhook β†’ enrich β†’ Discord. | | `watch.json` | The tracked wallet set + edge weights (shared by the watcher and the tracker). | | paper tracker | Client-side `$1,000` running portfolio β†’ [jaxperro.com/trading](https://jaxperro.com/trading) (page lives in the personal site repo). | | **`live/`** | **The current scanner** β€” find & track the skilled ~3% from the live API at scale: enumerate β†’ cache β†’ 5-gate skill funnel β†’ dashboard β†’ daily refresh. Caches ~26k wallets / 12.5M bets locally so every re-score is seconds. ([live/README](live/README.md)) | | `wide/` | Bulk subgraphβ†’DuckDB scanner: survivorship-bias-free over all 1.76M wallets, but the public subgraph is **frozen at Jan 2026**, so it's a historical tool only. ([wide/README](wide/README.md)) | | `archive/` | The six strategies that didn't work, kept for reference ([details](archive/README.md)). | --- ## Quickstart Zero dependencies β€” Python 3 stdlib only (no `pip install`). macOS python.org builds lack CA certs, so the code falls back to unverified SSL for these public read-only APIs. ```bash git clone https://github.com/jaxperro/winning-wallet-finder cd winning-wallet-finder cp config.example.json config.json # then edit (see Config below) python3 insider.py --scan 40 # score the top-40 leaderboard wallets python3 insider.py --market # score a market's traders + detect rings python3 insider.py --wallet 0xABC… # deep-profile one wallet python3 huntwide.py # wide sweep β†’ huntwide.csv (tiered by z) python3 oos.py # the out-of-sample copy test python3 smart_money.py # dashboard at http://localhost:8899 ``` ### Config (`config.json`, gitignored β€” holds your secrets) ```jsonc { "discord_webhook": "https://discord.com/api/webhooks/…", // alerts "alchemy_key": "…", // Polygon RPC for funding-cluster detection "alchemy_signing_key": "…", // verifies inbound webhook POSTs (live watcher) "watch": [ {"wallet": "0x…", "name": "Famecesgoal"}, … ] // wallets to track } ``` --- ## Data sources | Source | Used for | |--------|----------| | `data-api.polymarket.com` | positions, trades, leaderboard, activity, true win rate | | `gamma-api.polymarket.com` | market metadata, resolution times, best bid/ask | | `clob.polymarket.com` | order books, prices, liquidity-reward configs | | `api.elections.kalshi.com` | Kalshi prices (cross-venue arb research) | | Alchemy (Polygon) | on-chain USDC funding traces + the live trade webhook | --- ## The live system Two always-on pieces, both running on near-zero infrastructure cost. The wallets they track live in `watch.json` (currently the **4 sharpest, followable** wallets β€” high z, not bots, not in-game β€” re-weighted by z). ### 1. Discord watcher β€” pinged on every trade (`webhook_receiver.py`) Push-based, no polling. The instant a tracked wallet's proxy transacts on Polygon (~2–5s), Alchemy POSTs the receiver, which enriches the trade via the data-API and pings Discord: `🟒 Famecesgoal BUY Yes @ 0.34 ($120) β€” `. It's a tiny stdlib HTTP server that idles at ~zero CPU between trades. 1. **Discord webhook** β†’ set `DISCORD_WEBHOOK` env (or `config.json`). 2. **Deploy** the receiver to an always-on host (Railway / Fly / a $5 VPS β€” *not* Render free, it sleeps). `Procfile`, `requirements.txt`, `nixpacks.toml` included; binds to `$PORT`, exposes `/alchemy` (POST) and `/health` (GET). 3. **Alchemy** β†’ create an *Address Activity* webhook (Polygon mainnet), add the `watch.json` addresses, point it at `https://your-host/alchemy`, set the signing key as `ALCHEMY_SIGNING_KEY` (turns on HMAC verification). Keep the two wallet lists in sync: Alchemy's address list (what *triggers*) and `watch.json` (what *names* the alert). ### 2. Live paper portfolio β€” `trading/` β†’ [jaxperro.com/trading](https://jaxperro.com/trading) A **$1,000 paper account that behaves like real money**: it mirrors each followed wallet's **conviction** bets (top 20% of their own stake sizes) at $50/trade, **enters when they enter** (if there's cash), holds to resolution, then settles and frees the cash. Shows **Liquid**, **Invested**, **Realized**, a **Current Bets** table, and **Missed P&L** (profit skipped when the bankroll was fully deployed β€” the cost of a small account). It's now **precomputed server-side off the cache** (`live/portfolio.py` β†’ `portfolio.json`) rather than replayed in the browser: the cache stores each bet's resolution time, so capital **recycles at the true resolution moment** (the client replay used to phantom-lock capital when the data-api lacked resolution dates). The page is a static renderer of `portfolio.json` + `watch_sharps.json`, with the old client-side replay kept as a fallback. > **What the tracker taught us:** $1,000 across many hyperactive wallets saturates > instantly β€” concentrate on a few wallets that fit the bankroll. And **win% lies > about copyability**: judge candidates by **Copy P&L** (the sharps table's headline > column β€” actual flat-$50 copy result, scalpers exposed), not win rate. *Actually > placing* the trades is a separate in-progress system (`copybot.py`); this repo is > selection + paper tracking. --- ## The skilled-wallet scanner (`live/`) The newest pipeline operationalizes the [LBS/Yale finding](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=5910522) that ~3% of accounts are genuinely skilled. It scans the **live** data-api at scale and tracks the survivors forward. **The 5-gate funnel** β€” a wallet is "skilled" only if it clears all five: `n β‰₯ 15 resolved bets` β†’ `z > 0` (beats its entry prices) β†’ `Benjamini–Hochberg FDR @5%` β†’ `split-half out-of-sample persists` β†’ `not a market-maker/bot`. Win rate is never a gate. **The cache makes it cheap.** Each wallet's full resolved-bet history is pulled once into `cache.duckdb` (~26k wallets / 12.5M bets), keyed with per-bet resolution times β€” so any cutoff (pre-June-1, full-window, archetypes) re-scores in **seconds** instead of hours of API pulls. **The clean out-of-sample result (June 2026).** Copying the "favorite-rider" skilled wallets, $1000, no execution lag: | Selection | Win rate | Forward P&L (June 1+) | |-----------|----------|-----------------------| | In-sample (peeks at test window) | 99% | **+23.6%** | | **Clean (pre-June-1 data only)** | 68% | **βˆ’7.4%** (βˆ’19% on settled) | The +23.6% was pure selection bias. Selected honestly, the favorites **lose** β€” exactly the paper's "~60% of lucky winners become losers out-of-sample." High win rate β‰  edge, again. (The `value`/longshot archetype β€” wallets that beat *underdog* prices β€” is the one worth testing next.) Full pipeline in [`live/README.md`](live/README.md). **What does work (the repeatable find).** Scoring wallets on their **high- conviction bets β€” the top 20% by stake size (per-wallet p80, not a flat $200)** β€” which win 70–80% on genuinely-uncertain (~0.4–0.6) markets β€” trained pre-June and validated June: **62/83 stayed profitable forward (pβ‰ˆ0)**. A lead-time gate (`validate_timing.py`) then drops wallets whose wins come too close to resolution to mirror β€” "last-minute" entries (median lead <24h), which may be genuine insiders or just fast-market specialists β€” plus anyone inactive >30d, leaving **~31 validated copyable sharps** (`watch_sharps.json`), surfaced live on [jaxperro.com/trading](https://jaxperro.com/trading). **The catch β€” position win% β‰  copyability.** A high conviction win% (a position snapshot) doesn't mean you profit copying the wallet: a scalper buys ~$0.50 and sells for ~+$1, which the snapshot scores as a "win" though he never held to resolution. So the feed also precomputes **Copy P&L** β€” the authoritative flat-$50 copy result (replay entries, mirror exits, settle held bets at clob resolution). It's the real signal: `ArbTraderRookie` shows ~100% win but **βˆ’$790** to copy; of the ~31, only a few are copy-positive (`Kruto2027 +$1,184`, `fortuneking +$430` β€” true holders). The live tracker follows those two. Execution lag/fees and ongoing forward validation still gate turning it into real money. --- ## The honest verdict - **Detection works.** z-score + timing + funding-cluster reliably surfaces statistically anomalous wallets (the 60-Minutes use case). - **Copying them is not proven.** In-sample a weighted, compounding copy returned +545%; out-of-sample (select pre-May, copy forward) it was +168% β€” but driven entirely by *one* longshot lottery wallet, with the strongest signals contributing nothing. That's variance, not a durable, fundable edge. - **No turnkey public-data edge survived** β€” copy-trading, win-rate ranking, LP reward farming, binary/multi-outcome arb, and cross-venue arb all came back efficient or illusory. See [`FINDINGS.md`](FINDINGS.md). Use this to **find and watch** edge wallets and gather forward data β€” not as a green light to bet size on copying them.