Hyperliquid liquidations: every liquidation, and where the next ones sit

import os
import requests

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

# every liquidation recorded for one wallet, newest first
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations?wallet=0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff&limit=5",
    headers={"X-API-Key": API_KEY},
)
print(len(r.json()["liquidations"]), "liquidations")

import os
import requests

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

# this wallet's BTC liquidations in September 2026
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations?wallet=0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff&symbol=BTC&start=2026-09-01T00:00:00Z&end=2026-10-01T00:00:00Z&limit=100",
    headers={"X-API-Key": API_KEY},
)
print(len(r.json()["liquidations"]), "BTC liquidations in September")

import os
import requests

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

# only the long positions this wallet lost to liquidation
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations?wallet=0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff&direction=long&limit=100",
    headers={"X-API-Key": API_KEY},
)
print(len(r.json()["liquidations"]), "long liquidations")

import os
import requests

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

# the wallet's open positions with liquidation price and liq_progress
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0xbf342cf5d1e4a4bb91b171c15e3cdbe82da3fcff&limit=200",
    headers={"X-API-Key": API_KEY},
)
print(len(r.json()["positions"]), "open positions")

import os
from datetime import datetime, timedelta, timezone

import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment
START = (datetime.now(timezone.utc) - timedelta(hours=1)).strftime("%Y-%m-%dT%H:%M:%SZ")  # one hour ago

# every liquidation of the last hour, newest first
r = requests.get(
    f"https://data.vike.io/v1/hyperliquid/liquidations?start={START}&limit=5",
    headers={"X-API-Key": API_KEY},
)

import os
from datetime import datetime, timedelta, timezone

import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment
START = (datetime.now(timezone.utc) - timedelta(hours=1)).strftime("%Y-%m-%dT%H:%M:%SZ")  # one hour ago

# long and short liquidation notional of the last hour, from one 5000-row page
r = requests.get(
    f"https://data.vike.io/v1/hyperliquid/liquidations?start={START}&limit=5000",
    headers={"X-API-Key": API_KEY},
)
# then: jq '{more: (.nextCursor != null), by_side: (.liquidations | group_by(.side) | map({side: .[0].side, n: length, usd: (map(.size_usd) | add)}))}'

import os
from datetime import datetime, timedelta, timezone

import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment
START = (datetime.now(timezone.utc) - timedelta(hours=1)).strftime("%Y-%m-%dT%H:%M:%SZ")  # one hour ago

# every row of the hour: follow nextCursor until it is null
rows, cursor = [], ""
while True:
    page = requests.get(
        f"https://data.vike.io/v1/hyperliquid/liquidations?start={START}&limit=5000&cursor={cursor}",
        headers={"X-API-Key": API_KEY},
    ).json()
    rows += page["liquidations"]
    cursor = page["nextCursor"]
    if not cursor:
        break
print(len(rows), "liquidations in the last hour")

import os
from datetime import datetime, timedelta, timezone

import requests

API_KEY = os.environ["VIKE_API_KEY"]  # your key, read from the environment
START = (datetime.now(timezone.utc) - timedelta(hours=24)).strftime("%Y-%m-%dT%H:%M:%SZ")  # 24 hours ago

# BTC liquidations of the last 24 hours (a quiet hour can have none on one coin)
r = requests.get(
    f"https://data.vike.io/v1/hyperliquid/liquidations?symbol=BTC&start={START}&limit=5000",
    headers={"X-API-Key": API_KEY},
)

"""Find the biggest BTC hourly move of one day, then total the liquidations that landed in that hour.

Run:  VIKE_API_KEY=... python hl-liquidations-around-move.py    (--dry-run lists the requests and makes none)
"""
import os
import sys
from datetime import datetime, timezone
from urllib.parse import urlencode

NAME = "hl-liquidations-around-move"
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 iso(ms):
    return datetime.fromtimestamp(ms / 1000, timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")


def main():
    # end is exclusive on /ohlcv: this is the 24 hourly bars of 2026-08-17.
    day = call("/v1/hyperliquid/ohlcv", symbol="BTC", interval="1h", limit=24,
               start="2026-08-17T00:00:00Z", end="2026-08-18T00:00:00Z")
    move_ts = 1786924800000  # --dry-run has no response to read
    if not DRY:
        if not day["candles"]:
            fail("no BTC candles for the day")
        biggest = max(day["candles"], key=lambda c: abs(c["close"] / c["open"] - 1))
        move_ts = biggest["ts"]
        print(f"biggest hour: {iso(move_ts)}  {biggest['close'] / biggest['open'] - 1:+.2%}  ({biggest['open']:g} -> {biggest['close']:g})")

    # /liquidations is newest-first, its bounds are whole seconds and its end is inclusive; 5000 is the most
    # one page holds. The hour's own end is passed, and a fill stamped exactly on it is dropped below.
    hour_end = move_ts + 3_600_000
    liqs = call("/v1/hyperliquid/liquidations", symbol="BTC", limit=5000, start=iso(move_ts), end=iso(hour_end))
    if DRY:
        return
    rows = [r for r in liqs["liquidations"] if datetime.fromisoformat(r["liq_ts"]).timestamp() * 1000 < hour_end]
    if not rows:
        fail("no BTC liquidations in the move's hour")
    if liqs["nextCursor"]:
        print("  (a full page: the totals below cover the newest 5000 rows of the hour only)")
    # `side` is the side of the position that was closed: "long" means longs were liquidated.
    for side in ("long", "short"):
        hit = [r for r in rows if r["side"] == side]
        print(f"  {side:5} liquidated: {len(hit):5} fills  ${sum(r['size_usd'] for r in hit):,.0f}")


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

# where open BTC positions would be liquidated, in ten price bins around the mark
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/symbols/BTC/liquidation-heatmap?bins=10",
    headers={"X-API-Key": API_KEY},
)

import os
import requests

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

# the five price bins with the most BTC notional to liquidate
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/symbols/BTC/liquidation-heatmap?bins=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '.bins | sort_by(-.liquidation_value_usd) | .[:5] | map({price_bin_start, price_bin_end, liquidation_value_usd, long_value_usd, short_value_usd})'

import os
import requests

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

# the ETH heatmap at the default 50 bins
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/symbols/ETH/liquidation-heatmap",
    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 realized BTC liquidations
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations?symbol=BTC&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

# markets ranked by the share of open notional close to liquidation
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations/risk?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 ranking restricted to markets with at least $50M open
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations/risk?limit=500",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.[] | select(.total_value_usd >= 50000000)] | .[:10]'

import os
import requests

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

# the 500 biggest BTC positions, re-sorted by how much of the liquidation buffer is used up
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 | sort_by(-.liq_progress) | .[:10] | map({wallet, direction, size_usd, entry_price, mark_price, liquidation_price, liq_progress, leverage})'

import os
import requests

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

# the risk ranking for the largest accounts only
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations/risk?axis=size&cohort=4x_whale&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

# every open position of the wallet with its liquidation price
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0xfc667adba8d4837586078f4fdcdc29804337ca06&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

# account value, unrealized PnL and exposure against equity
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06",
    headers={"X-API-Key": API_KEY},
)
# then: jq '{equity, open_positions}'

import os
import requests

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

# positions ranked by buffer used, with the distance to the liquidation price
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?wallet=0xfc667adba8d4837586078f4fdcdc29804337ca06&limit=200",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.positions[] | select(.liquidation_price > 0) | {symbol, direction, size_usd, mark_price, liquidation_price, liq_progress, distance_pct: ((.mark_price - .liquidation_price) / .mark_price * 100 | fabs)}] | sort_by(-.liq_progress) | .[:10]'

import os
import requests

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

# the 100 biggest BTC positions, ranked by position size over account value
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&sort=size&limit=100",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.positions[] | select(.account_value != null and .account_value > 0) | {wallet, direction, size_usd, account_value, exposure: (.size_usd / .account_value), leverage, liq_progress}] | sort_by(-.exposure)'

import os
import requests

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

# the most exposed wallet of the ranking: equity, open positions and exposure
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0x60468ba27448f88b19f52ed02f1a8c52f7a0b21d",
    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, those nearest liquidation first
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[] | {wallet, direction, size_usd, account_value, liq_progress, liquidation_price, mark_price}] | sort_by(-.liq_progress) | .[:10]'

import os
import requests

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

# the 100 biggest ETH positions with account values
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=ETH&sort=size&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

# open BTC positions in the hour before the 2026-10-22 01:00 UTC move
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&start=2026-10-22T00:00:00Z&end=2026-10-22T00:59:59Z&resolution=1h&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

# long and short BTC notional in the hour before the move, one page
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&start=2026-10-22T00:00:00Z&end=2026-10-22T00:59:59Z&resolution=1h&limit=5000",
    headers={"X-API-Key": API_KEY},
)
# then: jq '{more: (.nextCursor != null), by_side: (.positions | group_by(.direction) | map({direction: .[0].direction, positions: length, usd: (map(.size_usd) | add)}))}'

import os
import requests

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

# BTC notional by $1,000 liquidation-price bin, the hour before the move
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&start=2026-10-22T00:00:00Z&end=2026-10-22T00:59:59Z&resolution=1h&limit=5000",
    headers={"X-API-Key": API_KEY},
)
# then: jq '[.positions[] | select(.liquidation_price > 0)] | group_by((.liquidation_price / 1000 | floor)) | map({bin: (.[0].liquidation_price / 1000 | floor * 1000), usd: (map(.size_usd) | add)}) | sort_by(-.usd) | .[:10]'

import os
import requests

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

# BTC liquidations between 01:00 and 02:00 UTC
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations?symbol=BTC&start=2026-10-22T01:00:00Z&end=2026-10-22T02:00:00Z&limit=5000",
    headers={"X-API-Key": API_KEY},
)