Hyperliquid whale tracker: whale positions, wallets and PnL

import os
import requests

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

# the 20 biggest open BTC positions, longs and shorts together, largest first
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&sort=size&limit=20",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the 500 biggest BTC positions
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&sort=size&limit=500",
    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 BTC longs and how many times their account value each one holds on BTC
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&sort=size&limit=500",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.positions[] | select(.direction == "long") | {wallet, size_usd, account_value, x_equity: (if (.account_value // 0) > 0 then .size_usd / .account_value else null end)}] | .[:20]'

import os
import requests

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

# every open BTC position: the first page of 5,000, ordered by wallet address, not by size
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&limit=5000",
    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 open xyz:TSLA positions
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=xyz:TSLA&sort=size&limit=20",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# who holds a 5x BTC short entered at 76,327.4
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions/match?symbol=BTC&side=short&leverage=5&entry_price=76327.4&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 same card, ranked by the mark price it shows as a tie-break
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions/match?symbol=BTC&side=short&leverage=5&entry_price=76327.4&mark_price=80260.1&limit=10",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# up to 50 matches here; limit takes up to 500
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions/match?symbol=BTC&side=short&leverage=5&entry_price=76327.4&limit=50",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# BTC positions hour by hour on 2026-10-20, kept when they fit the card
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&start=2026-10-20T00:00:00Z&end=2026-10-21T00:00:00Z&resolution=1h&limit=5000",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.positions[] | select(.direction == "short" and .leverage >= 4.5 and .leverage <= 5.5 and .entry_price >= 76289.2 and .entry_price <= 76365.6) | {wallet, snapshot_ts, size_usd, entry_price}] | unique_by(.wallet)'

import os
import requests

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

# ask for the link and download the current open positions of every wallet in one step
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/archive/url?dataset=positions&date=latest&redirect=1",
    headers={"X-API-Key": API_KEY},
)
with open("positions-latest.parquet", "wb") as f:
    f.write(r.content)

import os
import requests

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

# everything one wallet holds right now
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0x25773676902085225ae5751075e4161369334897&limit=200",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# snapshot time, write time, rows and bytes of the latest positions file
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/archive/datasets",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.latest.positions | {snapshot_ts, generated_at, rows, bytes, assets}'

import os
import requests

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

# one wallet's positions at the end of every hour for 30 days
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0x25773676902085225ae5751075e4161369334897&start=2026-09-24T00:00:00Z&end=2026-10-24T00:00:00Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# every snapshot of the wallet over 48 hours
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0x25773676902085225ae5751075e4161369334897&start=2026-10-22T00:00:00Z&end=2026-10-24T00:00:00Z&resolution=5m&limit=5000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the wallet's BTC position, hour by hour
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0x25773676902085225ae5751075e4161369334897&symbol=BTC&start=2026-09-24T00:00:00Z&end=2026-10-24T00:00:00Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the next page of the month: NEXT is the first page's nextCursor; keep the same start, end and resolution
first = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0x25773676902085225ae5751075e4161369334897&start=2026-09-24T00:00:00Z&end=2026-10-24T00:00:00Z&limit=5000",
    headers={"X-API-Key": API_KEY},
).json()
NEXT = first["nextCursor"]  # the first page's cursor, passed back verbatim
r = requests.get(
    f"https://data.vike.io/v1/hyperliquid/positions?wallet=0x25773676902085225ae5751075e4161369334897&start=2026-09-24T00:00:00Z&end=2026-10-24T00:00:00Z&limit=5000&cursor={NEXT}",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# a temporary link to every 5-minute position snapshot of one UTC day, as Parquet
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/archive/url?dataset=positions&date=2026-10-23",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the newest closed round trips of one wallet
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06/trades?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

# win rate, median and average hold, and net PnL over 30 days
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06/trades/summary?window=30d",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.overall | {trade_count, closed_trade_count, win_rate, median_duration, avg_duration, net_pnl}'

import os
import requests

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

# the worst and the best coin of the last 30 days by net PnL
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06/trades/summary?window=30d",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.by_symbol | sort_by(.net_pnl) | [first, last] | map({symbol, net_pnl, trade_count, win_rate, median_duration})'

import os
import requests

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

# every closed BTC round trip of the wallet in October
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06/trades?symbol=BTC&start=2026-10-01T00:00:00Z&limit=1000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the wallet's newest ledger events
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x7fdafde5cfb5465924316eced2d3715494c517d1/ledger?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

# bridge deposits into the wallet
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x7fdafde5cfb5465924316eced2d3715494c517d1/ledger?event_type=deposit&limit=100",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# withdrawals out of the wallet
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x7fdafde5cfb5465924316eced2d3715494c517d1/ledger?event_type=withdraw&limit=100",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# lifetime deposits, withdrawals and per-type totals
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x7fdafde5cfb5465924316eced2d3715494c517d1",
    headers={"X-API-Key": API_KEY},
)
# then: jq '{lifetime, ledger_by_type}'

import os
import requests

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

# the newest fills of one wallet; repeat with /funding and /ledger
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff/fills?limit=3",
    headers={"X-API-Key": API_KEY},
)

import csv
import os

import requests

H = {"X-API-Key": os.environ["VIKE_API_KEY"]}
WALLET = "0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff"
BASE = f"https://data.vike.io/v1/hyperliquid/wallets/{WALLET}"
WINDOW = {"start": "2026-01-01T00:00:00Z", "end": "2026-12-31T23:59:59Z"}

def rows(kind):
    params = {**WINDOW, "limit": 5000}
    while True:
        r = requests.get(f"{BASE}/{kind}", params=params, headers=H, timeout=60)
        r.raise_for_status()
        body = r.json()
        yield from body["items"]
        if not body["nextCursor"]:
            return
        params["cursor"] = body["nextCursor"]

for kind in ("fills", "funding", "ledger"):
    items = list(rows(kind))
    if not items:
        continue
    with open(f"{WALLET}-{kind}.csv", "w", newline="") as f:
        w = csv.DictWriter(f, fieldnames=list(items[0]), extrasaction="ignore")
        w.writeheader()
        w.writerows(items)
    print(kind, len(items))

import os
import requests

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

# BTC fills of the wallet in the tax year, the largest page
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff/fills?symbol=BTC&start=2026-01-01T00:00:00Z&end=2026-12-31T23:59:59Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# one kind of ledger event, here the wallet's sends in the tax year (deposit and withdraw work the same way)
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff/ledger?event_type=send&start=2026-01-01T00:00:00Z&end=2026-12-31T23:59:59Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# net funding per coin over one page of payments
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff/funding?start=2026-01-01T00:00:00Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.items | group_by(.symbol) | map({symbol: .[0].symbol, payment_usd: (map(.payment_usd) | add)})'

import os
import requests

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

# the user's spot transfers, where the Core and EVM moves sit
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xbf49ffdc3008791900bb96ebccb61118f70c1bc9/ledger?event_type=spotTransfer&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

# spot transfers to or from a system address, newest 1000
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xbf49ffdc3008791900bb96ebccb61118f70c1bc9/ledger?event_type=spotTransfer&limit=1000",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.items[] | select((.counterparty // "") | test("^0x(2{40}|20{35}[0-9a-f]{4})$"))] | map({ts, token, amount_usd, counterparty, direction: (if .amount_usd > 0 then "evm_to_core" else "core_to_evm" end)})'

import os
import requests

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

# the user's send events, to filter the same way
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xbf49ffdc3008791900bb96ebccb61118f70c1bc9/ledger?event_type=send&limit=1000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# HyperEVM transfers of the same address over 90 days
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xbf49ffdc3008791900bb96ebccb61118f70c1bc9/transactions?chain=hyperevm&days=90&limit=100",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# wallet A's BTC fills in a three-second window
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x53136b4a7c432585f28903b77c7816a723e0271f/fills?symbol=BTC&start=2026-10-24T17:13:32Z&end=2026-10-24T17:13:35Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# wallet B's BTC fills in the same window
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xb371766bcdcd556ce6b6cf164be6019d01441042/fills?symbol=BTC&start=2026-10-24T17:13:32Z&end=2026-10-24T17:13:35Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# next page of a one-month read: NEXT is the first page's nextCursor, passed back verbatim
first = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x53136b4a7c432585f28903b77c7816a723e0271f/fills?symbol=BTC&start=2026-10-01T00:00:00Z&end=2026-10-24T00:00:00Z&limit=5000",
    headers={"X-API-Key": API_KEY},
).json()
NEXT = first["nextCursor"]  # the first page's cursor, passed back verbatim
r = requests.get(
    f"https://data.vike.io/v1/hyperliquid/wallets/0x53136b4a7c432585f28903b77c7816a723e0271f/fills?symbol=BTC&start=2026-10-01T00:00:00Z&end=2026-10-24T00:00:00Z&limit=5000&cursor={NEXT}",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# a temporary link to every fill of one UTC day, as Parquet
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/archive/url?dataset=fills&date=2026-10-23",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# size of the month's fills files, before you ask for any link
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/archive/datasets",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.dates[] | select(.date | startswith("2026-09")) | .streams.fills.bytes] | {days: length, gb: (add / 1e9)}'

import os
import requests

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

# one day of every fill; repeat per date of the month
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/archive/url?dataset=fills&date=2026-09-01&redirect=1",
    headers={"X-API-Key": API_KEY},
)
with open("fills-2026-09-01.parquet", "wb") as f:
    f.write(r.content)

import polars as pl

by_wallet = (
    pl.scan_parquet("fills-2026-09-*.parquet")  # the month's 30 files, read as one table
    .filter(pl.col("asset") == "BTC")
    .group_by("wallet")
    .agg(
        bought=pl.col("size_token").filter(pl.col("side") == "buy").sum(),
        sold=pl.col("size_token").filter(pl.col("side") == "sell").sum(),
        bought_usd=pl.col("size_usd").filter(pl.col("side") == "buy").sum(),
        sold_usd=pl.col("size_usd").filter(pl.col("side") == "sell").sum(),
    )
    .with_columns(net=pl.col("bought") - pl.col("sold"))
    .collect()
)
print(by_wallet.sort("net", descending=True).head(10))  # top net buyers
print(by_wallet.sort("net").head(10))                    # top net sellers
# by USD instead of coins: sort on bought_usd - sold_usd to compare across coins
print(by_wallet.with_columns(net_usd=pl.col("bought_usd") - pl.col("sold_usd")).sort("net_usd", descending=True).head(10))
# takers only: who crossed the spread to buy, as opposed to whose resting orders were hit
takers = pl.scan_parquet("fills-2026-09-*.parquet").filter((pl.col("asset") == "BTC") & ~pl.col("is_maker"))

import os
import requests

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

# the sample hour's top buyer
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x5986347c1d0133d02d307f08bb1efd44c2eb89d9",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the newest BTC fills of $50,000 or more
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/large-fills?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 newest HYPE spot fills of $50,000 or more
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/@107/large-fills?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

# XYZ gold fills of $100,000 or more in the last 6 hours
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/xyz:GOLD/large-fills?min_usd=100000&hours=6",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# every BTC trade in a pinned three-second window
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/ohlcv?symbol=BTC&interval=1t&start=2026-10-21T00:00:00Z&end=2026-10-21T00:00:03Z&limit=10",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# a temporary download link for one day of every fill
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/archive/url?dataset=fills&date=2026-10-23",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the three biggest HYPE holders, spot plus staked
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/hype/holders?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

# holders 501 to 1,000: NEXT is the first page's nextCursor, passed back verbatim
first = requests.get(
    "https://data.vike.io/v1/hyperliquid/hype/holders?limit=500",
    headers={"X-API-Key": API_KEY},
).json()
NEXT = first["nextCursor"]  # the first page's cursor, passed back verbatim
r = requests.get(
    f"https://data.vike.io/v1/hyperliquid/hype/holders?limit=500&cursor={NEXT}",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the share of the top 100's HYPE held by its ten largest holders
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/hype/holders?limit=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.holders | (map(.total_amount) | add) as $all | ((.[:10] | map(.total_amount) | add) / $all)'

import os
import requests

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

# top-100 holders whose realized-PnL label contains "smart"
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/hype/holders?limit=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.holders[] | select((.pnl_cohort // "") | test("smart")) | {wallet, rank, total_amount, pnl_cohort}'