Find top traders and read their record

export VIKE_API_KEY=...
python hl-top-traders.py             # real run: needs the key
python hl-top-traders.py --dry-run   # prints the requests it would make, calls nothing

"""Rank Hyperliquid traders by 30-day realized PnL, then look inside the best one's record.

Run:  VIKE_API_KEY=... python hl-top-traders.py        (--dry-run lists the requests and makes none)
"""
import os
import sys
from urllib.parse import urlencode

NAME = "hl-top-traders"
BASE = "https://data.vike.io"
DRY = "--dry-run" in sys.argv


def fail(why):
    sys.exit(f"{NAME}: {why}")


def call(path, method="GET", **params):
    url = BASE + path + ("?" + urlencode(params) if params else "")
    if DRY:
        print(method, url)
        return None
    key = os.environ.get("VIKE_API_KEY") or fail("set VIKE_API_KEY")
    import requests

    r = requests.request(method, url, headers={"X-API-Key": key}, timeout=60)
    if r.status_code != 200:
        fail(f"{method} {path} answered HTTP {r.status_code}: {r.text[:200]}")
    return r.json()


def main():
    # /traders returns one page of at most 20 and has no cursor; three is plenty here.
    board = call("/v1/hyperliquid/traders", window="30d", sort="pnl", size=3)
    wallet = "0x25773676902085225ae5751075e4161369334897"  # --dry-run has no response to read
    if not DRY:
        if not board["traders"]:
            fail("/traders returned no traders")
        for t in board["traders"]:
            print(f"{t['address']}  pnl ${t['total_realized_pnl']:,.0f}  win rate {t['win_rate_pct']}%  trades {t['trade_count']}")
        wallet = board["traders"][0]["address"]

    summary = call(f"/v1/hyperliquid/wallets/{wallet}/trades/summary", window="30d")
    if DRY:
        return
    o = summary["overall"]
    if not o["trade_count"]:
        fail(f"{wallet} has no trades in the window")
    # One outsized trade drags a mean far from the typical trade, so read the median beside it.
    print(f"{wallet}: {o['trade_count']} trades, net ${o['net_pnl']:,.0f}")
    print(f"  gain   mean ${o['avg_gain']:,.2f}  median ${o['median_gain']:,.2f}")
    print(f"  loss   mean ${o['avg_loss']:,.2f}  median ${o['median_loss']:,.2f}")


if __name__ == "__main__":
    try:
        main()
    except Exception as e:  # a shape the recipe does not expect fails by name, not by traceback
        fail(f"{type(e).__name__}: {e}")