Rank the most successful Polymarket whales (smart-money traders).

Use this to find top traders by realized profit, win rate, or volume — optionally narrowed to one market category. Returns each whale's wallet, name, total P&L, win rate, profit factor and resolved-market count.

Args: sort: Ranking key — "pnl" (default), "win_rate", "volume" or "trades". category: Restrict to one category, e.g. "Crypto", "Sports", "Politics", "Geopolitics", "Economics", "Tech/AI". None = all. filter: "smart" (curated profitable whales, default) or "all". limit: How many whales to return (1–100).

Summarize one wallet's trading profile and performance.

Wallet profit tracking for any Polymarket address: lifetime P&L, win rate, ROI-style stats (profit factor), volume and activity. Accepts a 0x wallet address or an OrcaLayer nickname. Returns a compact summary — identity, lifetime activity, and P&L stats — rather than the full raw record, so it stays readable for heavy wallets.

If the wallet's stats are still being computed server-side, this returns a {"status": "computing", "retry_after_seconds": N} notice instead of data — call the tool again after that delay.

Args: address: 0x wallet address or OrcaLayer nickname.

List a wallet's largest open positions by current value.

Accepts a 0x wallet address or an OrcaLayer nickname. Returns the positions with the largest current value first, in a compact form, plus a count of how many more are not shown.

Args: address: 0x wallet address or OrcaLayer nickname. limit: How many positions to return (1–50). The wallet may hold more; the response reports how many were omitted.

Search Polymarket markets, optionally where smart whales are clustering.

Use this to track smart money flows: find markets by topic and surface where smart money is accumulating right now. Returns each market's question, YES price, smart-whale counts on each side, volume and days left.

Args: q: Free-text query; also accepts a Polymarket URL or slug. "" browses. category: One of "Crypto", "Geopolitics", "Sports", "Politics", "Economics", "Tech/AI". None = all. min_volume: Minimum market volume in USD. min_whales: Minimum number of smart whales active in the market. limit: How many markets to return (1–100).

Smart-money consensus on one Polymarket market versus its current price.

Shows where smart money stands on a market: how many profitable smart-money whales hold YES vs NO, how much capital each side has invested, the current market price, and the divergence between smart-money positioning and that price. Use it to answer "what does smart money think about this market?" and to spot markets where smart money disagrees with the crowd.

Two consensus reads are returned side by side and can disagree: head_count (one whale = one vote) and capital_weighted (dollars invested per side). Head-count is the weaker signal — a $5 wallet counts the same as a $500K one — so when the two disagree, trust the capital split more. On cheap longshots (YES under ~15 cents) head-count skews YES structurally. Divergence from price is positioning information, not proof the market is mispriced; never present it as "the market is wrong".

Args: market: Market id, Polymarket slug or URL, or 0x condition id.

Recent trades by smart-money whales — real-time alerts on profitable wallets (Premium).

Returns whale trades in the last minutes over min_usd in size: who traded, buy/sell, side, amount, price and the market. Use it to get alerts when profitable Polymarket wallets open or close positions.

Requires a Premium API key set via the ORCALAYER_API_KEY environment variable. Without a key this returns a short notice on how to get one (it does not call the API and is not an error).

Args: minutes: Lookback window in minutes (max 1440 = 24h). min_usd: Minimum trade size in USD. category: Restrict to one market category. None = all. limit: How many alerts to return (1–100).