Last updated: November 2026. This guide now also covers what our earlier post on real-time wallet alerts did.
The goal: a message the moment a wallet you respect opens a position on Polymarket, while the market has not moved yet. There are two ways to get it. Take the ready-made version, or build a small bot on the public API. Both are below, including the part where "profitable" turns out to be the hard word in the sentence.
The short answer
Open the whale alerts feed. It shows every Polymarket trade of 500 dollars or more as it happens, read from OrcaLayer's own index of the Polygon chain, with filters for category, side and size. To get pinged about specific wallets instead of watching the firehose, follow them on OrcaLayer and pick where the alerts go:
- Telegram. The personal OrcaLayer bot, from the Pro tier: 25 followed wallets on Pro, 100 on Premium.
- Discord. Your own channels, from the Pro tier: 1 channel on Pro, up to 5 on Premium with advanced filters (price range, maximum size, Smart Money only, specific wallets), up to 20 on Business. Without a plan, the free OrcaLayer Whale Alerts bot posts a curated feed to any server with a 15-minute delay.
- Webhooks. Signed pushes to your own server: the trades of up to 100 wallets you watch and market resolution events (proposed, disputed, resolved, reopened) on Premium, every Smart Money trade and 100 wallets per webhook on Business.
Two surfaces: motion and weight
The alerts page tracks smart money two different ways, and the difference matters.
Live Fills. Single trades of 500 dollars or more, streamed as they happen. This is motion: what is being bought and sold right now, by whom, at what price.
Big Positions. Accumulated holdings of 500,000 dollars or more, as they currently stand. A whale that built a position from 50 small fills never shows up as one big trade, but it shows up here. This is weight: where the money is actually sitting.
A single 800 dollar fill can be noise. A 700,000 dollar accumulated position is a statement. Use Live Fills to catch moves and Big Positions to see conviction.
Picking wallets worth following
An alert is only as good as the wallet behind it, and this is the step most bots get wrong. Judge a wallet by its record on resolved markets, not by single trades: win rate per market, a real sample of ten or more resolved markets, and positive total P&L.
The trap is that a naive "highest win rate" list is mostly fake. Among wallets with a 90 percent or higher win rate, 57,110 of 88,080, about 65 percent, are farmers (measured 18 November 2026): wallets that buy outcomes already at 95 cents or higher and collect the last few cents at settlement. A farmer buys Yes at 96 cents, it settles at 1 dollar, and the win rate chart looks elite while predicting nothing.
Every ranking on OrcaLayer is farmer-filtered by default: wallets with an average buy price above 95 cents, bot-pattern wallets and Polymarket's own router contracts are removed before you see a list. Pick from the leaderboard, open a wallet profile, check its resolved-market record, and follow it. The filter logic is on the Farmer Filter page.
Build it yourself
Data API v2. Polymarket retired Data API v1 on 3 November 2026: the old paths now answer
{"error": "Data API v1 has been retired"}. The examples below use v2 (https://data-api.polymarket.com/v2/...): rows come in adataenvelope, the next page ispagination.next_cursor, and fields are snake_case.
Step 1: vet the wallets
Any wallet's full history is one GET away:
curl "https://data-api.polymarket.com/v2/activity?user=0xWALLET&limit=500"
The feed carries every TRADE and, critically, every REDEEM with usdc_size, so you can reconstruct realized outcomes. Compute win rate by resolved markets, require ten or more of them, and drop any wallet whose average buy price sits at or above 95 cents.
Step 2: poll their activity on a loop
With a clean watchlist the alert loop is genuinely simple. Keep the last seen timestamp per wallet and diff:
import time, requests
WATCHLIST = ["0xWALLET_1", "0xWALLET_2"]
last_seen: dict[str, int] = {}
def new_events(wallet: str) -> list[dict]:
rows = requests.get(
"https://data-api.polymarket.com/v2/activity",
params={"user": wallet, "limit": 50},
timeout=30,
).json()["data"]
fresh = [r for r in rows if r["timestamp"] > last_seen.get(wallet, 0)]
if rows:
last_seen[wallet] = max(r["timestamp"] for r in rows)
return fresh
while True:
for w in WATCHLIST:
for ev in new_events(w):
if ev.get("type") == "TRADE" and ev.get("usdc_size", 0) >= 500:
notify(ev) # step 3
time.sleep(60)
Two practical notes. First, be a polite client: one request per wallet per minute is fine, hammering the endpoint from a loop with no sleep will get your IP throttled. Second, seed last_seen on the first run instead of alerting on history.
Step 3: push to Telegram or Discord
For Telegram, create a bot with @BotFather, grab the token and your chat id, and notify is four lines:
def notify(ev: dict) -> None:
text = (f'{ev["proxy_wallet"][:10]} {ev["side"]} '
f'${ev.get("usdc_size", 0):,.0f} in {ev.get("title", "?")[:60]}')
requests.get(
f"https://api.telegram.org/bot{TOKEN}/sendMessage",
params={"chat_id": CHAT_ID, "text": text},
timeout=10,
)
For Discord, create a webhook in the channel settings (Integrations, Webhooks) and post the same text: requests.post(WEBHOOK_URL, json={"content": text}, timeout=10).
That is the whole bot. Cron it, or run it under systemd with a restart policy, and you have wallet alerts.
Step 4: cut the noise
The first day you will love it; the first week you will mute it. Three filters keep it useful:
- Size floor. Alert from 500 dollars up, or whatever makes a move meaningful for the wallet's own bankroll.
- Deduplicate fills. One logical order fills as several rows in the same transaction. Group by transaction hash before alerting or every big order rings five times.
- Side context. A SELL closing a winner and a SELL cutting a loss read the same in the feed. Without position context you cannot tell which alert you got.
Where DIY breaks
The loop above works. What it cannot do by itself:
Latency. Polling gives you a floor of about a minute. Real time needs the WebSocket stream plus reconnect and stall-detection logic, which is its own small service to operate. Our tutorial on monitoring smart money flows covers that stream.
"Profitable" drifts. A wallet you vetted in January can be a farmer by March, or start hedging, and your static watchlist will not notice. Keeping the classification honest means recomputing win rates, farmer fingerprints and hedge patterns across each wallet's whole history as it grows. At index scale that is 1.5B+ fills, with NegRisk-corrected P&L so multi-outcome markets do not double-count, and every redemption counted into the wallet's net position, so a position held to settlement is not mistaken for a loss. The details are in our methodology.
Discovery. Your bot only watches wallets you already know. The profitable wallet that starts printing next week is not on your list, and nothing in this loop will add it.
For developers
OrcaLayer runs this pipeline as a product on its own index. The REST API on the Premium tier serves wallet, trade and market endpoints at 600 requests per minute, plus a real-time SSE stream of whale trades: one authenticated connection instead of a polling fleet. The same data is in the Python SDK and the MCP server for AI agents. On Premium, signed webhooks push the trades of up to 100 wallets you watch to your server, so the alerts land without polling at all; Business adds a webhook for every Smart Money trade.
Build it yourself to understand it; that knowledge transfers. Run ours when you want the classification, the discovery and the uptime to be someone else's job.
Frequently asked questions
How can I get alerts when a profitable Polymarket wallet trades? Follow the wallet on OrcaLayer and get its trades in the Telegram bot or in your own Discord channel, both from the Pro tier; on Premium the same trades can go to your server as signed webhooks (up to 100 wallets). To build it yourself, poll the public Data API v2 activity endpoint for each wallet every minute, keep the last seen timestamp, and push anything new to a Telegram bot.
Can I get Polymarket whale alerts in Discord? Yes. On paid plans you paste a Discord channel webhook in Settings and choose what goes there: 1 channel on Pro, up to 5 on Premium with advanced filters, up to 20 on Business. Without a plan you can add the free OrcaLayer Whale Alerts bot to any server; it posts a curated feed with a 15-minute delay.
How do I find profitable Polymarket wallets to follow? Judge a wallet by its record on resolved markets, not by single trades: win rate per market, about ten or more resolved markets, positive total P&L. Then remove farmers: among wallets with a 90 percent or higher win rate, about 65 percent buy near-decided outcomes at 95 cents or more and predict nothing. OrcaLayer's leaderboard applies that filter by default.
What is the difference between Live Fills and Big Positions? Live Fills shows single trades of 500 dollars or more as they happen, which is motion. Big Positions shows accumulated holdings of 500,000 dollars or more, even if built from dozens of small fills, which is weight.
Why do my copied trades from a profitable wallet lose money? Three usual reasons: the wallet is a farmer whose win rate is manufactured on near-decided markets, the wallet is hedged and its profit is structure rather than directional edge, or your alert arrived after the price already moved.
Are Polymarket wallet alerts free? The whale alerts feed on orcalayer.com is free to browse, and the free Discord bot posts a delayed feed to any server. Personal alerts on wallets you follow, in Telegram or your own Discord channel, start at the Pro tier. The API and its real-time stream are on Premium.
How fast do the alerts arrive? OrcaLayer reads trades from its own index of the Polygon chain. A trade shows up there a median of about half a minute after the block that settles it, and 9 in 10 within a minute; Discord alerts and webhooks check for new trades every 5 seconds (measured 18 November 2026). A DIY polling bot has a floor of about a minute.
Is there a wallet alerts API? Yes. The REST API on the Premium tier serves wallet, trade and market data at 600 requests per minute, plus a real-time SSE stream of whale trades. Premium also pushes the trades of up to 100 wallets you watch to your server as signed webhooks; Business adds a webhook for every Smart Money trade.