Hyperliquid leaderboard: the top traders, and how they trade

"""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 up to 100 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 example does not expect fails by name, not by traceback
        fail(f"{type(e).__name__}: {e}")

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# wallets with 30+ closed trades and a 60%+ win rate over 30 days, biggest PnL first
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&min_trades=30&min_win_rate=0.6&sort=pnl&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the same filter ranked by win rate
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&min_trades=30&min_win_rate=0.6&sort=win_rate&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# 60%+ win rate, 30+ trades and at least $10M of volume over 30 days
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&min_trades=30&min_win_rate=0.6&min_volume=10000000&sort=win_rate&limit=25",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the /traders form: 60 means 60% here
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/traders?window=30d&sort=win_rate&min_trades=30&min_win_rate=60&size=20",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# today's top earners by realized PnL
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=1d&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the number one wallet's metrics over 30 days
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06?window=30d",
    headers={"X-API-Key": API_KEY},
)
# then: jq '{window, metrics_updated_at, metrics}'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the same wallet over 7 days
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06?window=7d",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.metrics | {total_realized_pnl, trade_count, win_rate, profit_factor, max_drawdown_pct}'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the 30-day board, wallet, rank and PnL only
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&limit=500",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.traders | map({wallet, rank, total_realized_pnl, trade_count})'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# best Calmar ratio over 365 days among $1M-$2.5M accounts with 50+ closed trades
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=all&sort=calmar&min_trades=50&axis=size&cohort=whale&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# highest profit factor among $1M-$2.5M accounts with 50+ closed trades
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=all&sort=profit_factor&min_trades=50&axis=size&cohort=whale&limit=25",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# best Calmar among accounts over $10M with 50+ closed trades
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=all&sort=calmar&min_trades=50&axis=size&cohort=4x_whale&limit=25",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the unfiltered Calmar board, led by near-empty accounts
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=all&sort=calmar&min_trades=50&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the biggest PnL per closed trade over 7 days, wallets with as little as one trade
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=7d&sort=expectancy&min_trades=1&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# how many trades the number one wallet has ever closed, and when it started
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x615a2071e01b28093e65d81be32cea6e173d69d5/trades/summary?window=all",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.overall | {trade_count, closed_trade_count, fill_count, net_pnl, max_trade_size_usd, median_duration, first_trade_ts, last_close_ts}'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the ROI board, dominated by near-zero accounts
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&sort=roi&min_trades=0&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# biggest PnL per trade among wallets with 30+ closed trades in 7 days
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=7d&sort=expectancy&min_trades=30&limit=25",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# today's top earners from trading, with flows and the full risk set beside each
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard/flow-adjusted?window=1d&limit=3",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the 30-day board, ranked the same way
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard/flow-adjusted?window=30d&limit=25",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# today's board without lifetime losers and without unreliable flow attribution
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard/flow-adjusted?window=1d&limit=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.traders[] | select(.cum_realized_pnl > 0 and (.flow_unbalanced | not)) | {wallet, rank, total_realized_pnl, trade_count, profit_factor, cum_realized_pnl, pnl_cohort}'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# today's board, wallets with at least 20 closed trades
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard/flow-adjusted?window=1d&min_trades=20&limit=25",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the bottom-5% cohort's longest losing streaks over 30 days, wallets with 30+ closed trades
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&axis=pnl&cohort=3x_rekt&sort=loss_streak&min_trades=30&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the top-1% cohort's longest losing streaks, same window and floor
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&axis=pnl&cohort=3x_smart&sort=loss_streak&min_trades=30&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# median hold time, losing streak and win rate over one 500-row page of the bottom cohort
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&axis=pnl&cohort=3x_rekt&min_trades=30&limit=500",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.traders | {n: length, median_hold_s: (map(.avg_duration_seconds) | sort | .[length/2|floor]), median_loss_streak: (map(.max_loss_streak) | sort | .[length/2|floor]), median_win_rate: (map(.win_rate) | sort | .[length/2|floor])}'

import os
import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment

# the bottom cohort's 25 biggest open BTC positions
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&axis=pnl&cohort=3x_rekt&sort=size&limit=25",
    headers={"X-API-Key": API_KEY},
)