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.

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 find markets by topic and surface ones with heavy smart-money interest. 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).

Recent trades by smart-money whales — a live alerts feed (Premium).

Returns whale trades in the last minutes over min_usd in size: who traded, buy/sell, side, amount, price and the market.

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).