Build whale-tracking bots on clean Polymarket data

Track a specific whale (full profile + smart-money flag)

import requests

WALLET = "0x7f3c8979d0afa00007bae4747d5347122af05613"

# /api/v2/wallet/{addr} is a public endpoint — no API key required
r = requests.get(f"https://orcalayer.com/api/v2/wallet/{WALLET}")
data = r.json()

# Response is composed: profile / overview / stats / categories
profile = data["profile"]
stats = data["stats"]
overview = data["overview"]

print(f"Name: {profile['name'] or profile['pseudonym']}")
print(f"Total PnL: ${stats['total_pnl']:,.0f}")
print(f"Win rate: {stats['win_rate']:.1%}")
print(f"Smart Money flag: {stats['is_smart']}")
print(f"Markets traded: {overview['total_markets']}")
print(f"Median hold: {overview['median_hold_days']} days")

List hot markets with whale skew

import requests

# Markets with whale positioning (public endpoint — no key needed)
r = requests.get("https://orcalayer.com/api/v2/markets/search?limit=10")
markets = r.json()["markets"]

for m in markets:
    skew = m["whales_yes"] - m["whales_no"]
    print(
        f"{m['question'][:60]:60s} "
        f"YES={m['price_yes']:.2f}  "
        f"whales={m['whales_yes'] + m['whales_no']:4d}  "
        f"skew={skew:+d}"
    )

Poll whale trades — bot loop

import requests
import time
from collections import deque

API_KEY = "your_premium_key"   # premium /api/v2 endpoints use the X-API-Key header

# Bounded de-dup: remember the last 10k tx hashes, not every hash forever.
seen = set()
seen_order = deque(maxlen=10_000)

while True:
    try:
        r = requests.get(
            "https://orcalayer.com/api/v2/whales/recent-trades",
            headers={"X-API-Key": API_KEY},
            timeout=15,
        )
        r.raise_for_status()
        trades = r.json()
    except requests.RequestException as exc:
        print(f"request failed, retrying in 30s: {exc}")
        time.sleep(30)
        continue

    for trade in trades:
        key = trade["tx_hash"]
        if key in seen:
            continue
        if len(seen_order) == seen_order.maxlen:
            seen.discard(seen_order[0])   # evict oldest as the ring rolls over
        seen_order.append(key)
        seen.add(key)

        # Filter: $50K+ trades from named whales
        if trade["size_usd"] >= 50_000 and trade.get("whale_name"):
            print(
                f"WHALE: {trade['whale_name']} "
                f"${trade['size_usd']:,.0f} {trade['side']} "
                f"@ {trade['price']:.2f} on '{trade['question'][:50]}'"
            )
            # → forward to Discord / Telegram / Slack webhook

    time.sleep(30)  # Premium tier — well under 600 req/min budget

Live indexed trade stream — MINT/MERGE events (SSE, Premium)

# Connect with your existing Premium API key — no extra setup.
# types filter: mint, merge, complementary; omit for all classified fills.
curl -N -H "Authorization: Bearer YOUR_PREMIUM_KEY" \
  "https://orcalayer.com/api/public/v1/live/trades-indexed?types=mint,merge"

# Each event: entry_type, maker, taker, price, usd_amount, market metadata.
# A MINT with SELL on YES = the wallet ENTERED NO — not an exit.
# Live-only (no replay on reconnect) — keep a REST poll as fallback.
# Typical latency: 20-45s after on-chain confirmation.