Build whale-tracking bots on clean Polymarket data

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

import requests

WALLET = "0x7f3c8979d0afa00007bae4747d5347122af05613"
API_KEY = "your_premium_key"  # Premium tier; public endpoints don't need auth

r = requests.get(
    f"https://orcalayer.com/api/v2/wallet/{WALLET}",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
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

# Hot markets ranked by volume + whale activity
r = requests.get("https://orcalayer.com/api/v2/markets/hot")
markets = r.json()

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

Poll whale trades — bot loop

import requests
import time

API_KEY = "your_premium_key"
SEEN = set()

while True:
    r = requests.get(
        "https://orcalayer.com/api/v2/whales/recent-trades",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )

    for trade in r.json():
        key = trade["tx_hash"]
        if key in SEEN:
            continue
        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