Crypto data API. Free. All of it.

import os
from datetime import datetime, timedelta, timezone

import requests

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

SINCE = (datetime.now(timezone.utc) - timedelta(hours=24)).strftime("%Y-%m-%dT%H:%M:%SZ")  # 24 hours ago, UTC

# 1. what the top 1% of Hyperliquid wallets by realized PnL hold right now, long against short
cohort = requests.get(
    "https://data.vike.io/v1/hl-cohorts/segments/3x_smart/summary?axis=pnl",
    headers={"X-API-Key": API_KEY},
).json()
# 2. the liquidations of the last 24 hours, newest first
liqs = requests.get(
    f"https://data.vike.io/v1/hyperliquid/liquidations?start={SINCE}&limit=3",
    headers={"X-API-Key": API_KEY},
).json()["liquidations"]
# 3. Polymarket markets with the largest net buying by its smart-money cohort over 24 hours
smart = requests.get(
    "https://data.vike.io/v1/polymarket/smart_money?mode=flows&hours=24&limit=3",
    headers={"X-API-Key": API_KEY},
).json()
# 4. Ethereum tokens ranked by the net inflow of smart wallets
tokens = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?window=24h&sort=smart_inflow&limit=3",
    headers={"X-API-Key": API_KEY},
).json()

print(f"3x smart: ${cohort['total_long_usd']:,.0f} long, ${cohort['total_short_usd']:,.0f} short, bias {cohort['bias']:+.2f}")
for x in liqs:
    print("liquidated:", x["liq_ts"], x["symbol"], x["side"], f"${x['size_usd']:,.0f}")
for m in smart:
    print("smart money:", m["title"], f"${m['net_inflow']:,.0f}")
print("smart wallets bought:", [t["symbol"] or t["token_address"] for t in tokens])

import os

import requests

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

# smart-money flows inside Polymarket's Crypto category (category names are exact)
r = requests.get(
    "https://data.vike.io/v1/polymarket/smart_money?mode=flows&category=Crypto&hours=24&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

# every coin against every cohort of the realized-PnL ladder, in one call
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/heatmap?axis=pnl",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# what could be liquidated next: the share of each coin's open interest near its liquidation price
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations/risk?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

# Base tokens by plain net inflow (sort=smart_inflow is Ethereum only; any other chain is a 400)
r = requests.get(
    "https://data.vike.io/v1/onchain/tokens/screener?chain=base&sort=net_inflow&window=24h&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

WALLET = "0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36"

# 1. is it a whale? equity and cohorts on Hyperliquid
hl = requests.get(
    f"https://data.vike.io/v1/hyperliquid/wallets/{WALLET}?window=30d",
    headers={"X-API-Key": API_KEY},
).json()
# 2. the earliest inbound HYPE and token transfers of the same address on HyperEVM, with the sender
ff = requests.get(
    f"https://data.vike.io/v1/onchain/wallets/{WALLET}/first-funder?chain=hyperevm",
    headers={"X-API-Key": API_KEY},
).json()

print(hl["cohorts"]["size"], f"${hl['equity']['account_value']:,.0f}")
if ff["found"]:
    first = ff["first_native_in"]
    print("first HYPE from", first["from"], first["wallet_type"], first["time"])
else:
    print("no HyperEVM activity under this address")

import os

import requests

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

# the ten largest Hyperliquid accounts, each asked who first funded it on HyperEVM
top = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&sort=account_value&limit=10",
    headers={"X-API-Key": API_KEY},
).json()["traders"]
for t in top:
    wallet = t["wallet"]
    ff = requests.get(
        f"https://data.vike.io/v1/onchain/wallets/{wallet}/first-funder?chain=hyperevm",
        headers={"X-API-Key": API_KEY},
    ).json()
    first = ff["first_native_in"] or {}
    print(wallet, f"${t['account_value']:,.0f}", ff["found"], first.get("from"), first.get("wallet_type"))

import os

import requests

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

# the earliest inbound ETH and token transfers of the same address on Ethereum (the default chain)
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36/first-funder",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# the very first inbound HYPE, however small (by default below 0.0001 HYPE is skipped)
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36/first-funder?chain=hyperevm&min_native=0",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# when money reached the Hyperliquid account: its bridge deposits, newest first
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/wallets/0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36/ledger?event_type=deposit&limit=100",
    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

def iso(t):
    return t.strftime("%Y-%m-%dT%H:%M:%SZ")


now = datetime.now(timezone.utc).replace(minute=0, second=0, microsecond=0)
# 1. BTC hourly candles over the last 30 days, and the hour with the largest drop
candles = requests.get(
    f"https://data.vike.io/v1/hyperliquid/ohlcv?symbol=BTC&interval=1h&start={iso(now - timedelta(days=30))}&end={iso(now)}&limit=720",
    headers={"X-API-Key": API_KEY},
).json()["candles"]
worst = min(candles, key=lambda c: c["close"] / c["open"])
hour = datetime.fromtimestamp(worst["ts"] / 1000, timezone.utc)
print(iso(hour), worst["open"], "->", worst["close"])
# 2. the longs liquidated on BTC inside that hour (up to 5,000 a page; nextCursor says there is more)
liqs = requests.get(
    f"https://data.vike.io/v1/hyperliquid/liquidations?symbol=BTC&direction=long&start={iso(hour)}&end={iso(hour + timedelta(hours=1))}&limit=5000",
    headers={"X-API-Key": API_KEY},
).json()["liquidations"]
print(len(liqs), "longs liquidated,", f"${sum(x['size_usd'] or 0 for x in liqs):,.0f}")
# 3. every size cohort's BTC positioning, hour by hour, in the six hours before
before = requests.get(
    f"https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&start={iso(hour - timedelta(hours=6))}&end={iso(hour - timedelta(hours=1))}&hours=7",
    headers={"X-API-Key": API_KEY},
).json()["metrics"]
for row in before:
    if row["cohort"] in ("4x whale", "shrimp"):
        print(row["ts"], row["cohort"], f"bias {row['bias']:+.2f}", f"${row['total_position_value']:,.0f}")

import os

import requests

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

# the realized-PnL ladder before the 2026-10-29 20:00 UTC drop, each hour's label as it stood then
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=pnl&labelBasis=point_in_time&start=2026-10-29T14:00:00Z&end=2026-10-29T19:00:00Z&hours=7",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# BTC daily candles of the last 30 days: find the day first
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/ohlcv?symbol=BTC&interval=1d&limit=30",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# every long liquidated on BTC in the 2026-10-29 20:00 UTC hour, page by page: pass nextCursor back as cursor
URL = "https://data.vike.io/v1/hyperliquid/liquidations?symbol=BTC&direction=long&start=2026-10-29T20:00:00Z&end=2026-10-29T21:00:00Z&limit=1000"
rows, cursor = [], ""
while True:
    page = requests.get(
        URL + (f"&cursor={cursor}" if cursor else ""),
        headers={"X-API-Key": API_KEY},
    ).json()
    rows += page["liquidations"]
    cursor = page["nextCursor"]
    if not cursor:
        break
print(len(rows), "longs,", f"${sum(x['size_usd'] or 0 for x in rows):,.0f}")

import os

import requests

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

# shorts liquidated on BTC inside the same hour (a squeeze liquidates shorts instead)
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/liquidations?symbol=BTC&direction=short&start=2026-10-29T20:00:00Z&end=2026-10-29T21:00:00Z&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

ADDRESS = "0xf3dcaeb909d3d17318c0908a1ec0ca31321e1672"

# 1. everything held on the address in one call: chains, labels, its Hyperliquid account, the Polymarket accounts it owns
check = requests.get(
    f"https://data.vike.io/v1/onchain/wallets/{ADDRESS}/check",
    headers={"X-API-Key": API_KEY},
).json()
print("\n".join(check["summary"]))
# 2. the address on Hyperliquid: cohorts, 30-day metrics, lifetime flows
hl = requests.get(
    f"https://data.vike.io/v1/hyperliquid/wallets/{ADDRESS}?window=30d",
    headers={"X-API-Key": API_KEY},
).json()
# 3. on Polymarket a trader is its proxy wallet: the account this address owns
proxy = check["polymarket"]["owned"][0]["address"]
pm = requests.get(
    f"https://data.vike.io/v1/polymarket/wallets/{proxy}?window=30d",
    headers={"X-API-Key": API_KEY},
).json()
# 4. the address on the EVM chains: volume, flows and transfer counts in five windows
evm = requests.get(
    f"https://data.vike.io/v1/onchain/wallets/{ADDRESS}",
    headers={"X-API-Key": API_KEY},
).json()

print("Hyperliquid:", hl["cohorts"], f"30-day volume ${hl['metrics']['total_volume']:,.0f}")
print("Polymarket:", proxy, f"volume ${pm['volume_all_usd']:,.0f}, {pm['markets_count']} markets")
print("EVM:", evm["chain"], evm["all"]["tx_count"], "transfers since", evm["all"]["first_seen"])

import os

import requests

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

# the other way round: who owns a Polymarket account (polymarket.account.owner)
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xb1a279adb096d316b1b168993e8ed976d3cd372a/check",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# start from Polymarket's top Crypto traders by realized P&L, then check each proxy_wallet
r = requests.get(
    "https://data.vike.io/v1/polymarket/leaderboard?category=Crypto&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 address on HyperEVM only (without chain, the route picks Ethereum or BSC first)
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xf3dcaeb909d3d17318c0908a1ec0ca31321e1672?chain=hyperevm",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# what it holds now on Ethereum, BSC, Base and HyperEVM, read from the chains at request time
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xf3dcaeb909d3d17318c0908a1ec0ca31321e1672/balances",
    headers={"X-API-Key": API_KEY},
)

import os
from datetime import datetime, timezone

import requests

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

CONDITION = "0x6f9a955c14d5a37eeb59d02ac17a72072a5140ad607df0954f56afd92ac0c567"  # Bitcoin Up or Down on November 3?

# 1. the market's outcomes and token ids, in the same order (an array of 0 or 1 rows)
market = requests.get(
    f"https://data.vike.io/v1/polymarket/settlements/{CONDITION}",
    headers={"X-API-Key": API_KEY},
).json()[0]
up = market["token_ids"][market["outcomes"].index("Up")]
# 2. hourly candles of the Up token from 13:00 to 17:00 UTC: the close is the probability of Up
odds = requests.get(
    f"https://data.vike.io/v1/polymarket/ohlcv?token_id={up}&interval=1h&from=1793710800000&to=1793725200000&limit=24",
    headers={"X-API-Key": API_KEY},
).json()
# 3. BTC hourly candles from Hyperliquid fills over the same hours
btc = requests.get(
    "https://data.vike.io/v1/hyperliquid/ohlcv?symbol=BTC&interval=1h&start=2026-11-03T13:00:00Z&end=2026-11-03T18:00:00Z&limit=24",
    headers={"X-API-Key": API_KEY},
).json()["candles"]
# 4. every size cohort's BTC long/short bias, hour by hour
cohorts = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=size&start=2026-11-03T13:00:00Z&end=2026-11-03T17:00:00Z&hours=6",
    headers={"X-API-Key": API_KEY},
).json()["metrics"]

price = {c["ts"]: c["close"] for c in btc}
whale = {r["ts"]: r["bias"] for r in cohorts if r["cohort"] == "4x whale"}
for c in odds:
    hour = datetime.fromtimestamp(c["ts"] / 1000, timezone.utc)
    print(hour.strftime("%H:%M"), "Up", c["close"], "BTC", price.get(c["ts"]), "4x whale bias", whale.get(hour.isoformat()))
print("resolved:", market["winning_outcome"])

import os

import requests

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

# daily Bitcoin Up or Down markets by slug (the list has condition_id and token_ids, not outcome names)
r = requests.get(
    "https://data.vike.io/v1/polymarket/markets?query=bitcoin-up-or-down-on-november&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

# every settled Bitcoin Up or Down market since 2026-10-29 00:00 UTC, oldest resolution first
r = requests.get(
    "https://data.vike.io/v1/polymarket/settlements/bulk?slug_prefix=bitcoin-up-or-down-on-&from_ms=1793232000000&limit=30",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# 5-minute candles of the Up token in its last trading hour
r = requests.get(
    "https://data.vike.io/v1/polymarket/ohlcv?token_id=95158707236219321968836069579689552308763368946434445401112860333517064530135&interval=5m&from=1793721600000&to=1793725200000&limit=12",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# the realized-PnL ladder over the same hours, each hour's label as it stood then
r = requests.get(
    "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=pnl&labelBasis=point_in_time&start=2026-11-03T13:00:00Z&end=2026-11-03T17:00:00Z&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

# 1. the 100 Hyperliquid wallets with the most realized PnL over 30 days
top = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&limit=100",
    headers={"X-API-Key": API_KEY},
).json()["traders"]
# 2. entity and wallet type of all 100 on Ethereum, in one call
labels = requests.post(
    f"https://data.vike.io/v1/onchain/labels/batch?chain=ethereum&addresses={','.join(t['wallet'] for t in top)}",
    headers={"X-API-Key": API_KEY},
).json()

for t, label in zip(top, labels):
    if label["found"]:
        print(t["rank"], t["wallet"], label["entity"], label["wallet_type"], f"${t['total_realized_pnl']:,.0f}")

import os

import requests

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

# the same 100 against the HyperEVM labels, where a Hyperliquid account also lives
top = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&limit=100",
    headers={"X-API-Key": API_KEY},
).json()["traders"]
labels = requests.post(
    f"https://data.vike.io/v1/onchain/labels/batch?chain=hyperevm&addresses={','.join(t['wallet'] for t in top)}",
    headers={"X-API-Key": API_KEY},
).json()
print(sum(label["found"] for label in labels), "of", len(labels), "labelled on HyperEVM")

import os

import requests

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

# biggest by size instead: the 25 largest accounts with at least 3 trades closed in the window
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/leaderboard?window=30d&sort=account_value&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

# who says so: every source's claim about one labelled wallet
r = requests.get(
    "https://data.vike.io/v1/onchain/labels/0x020ca66c30bec2c4fe3861a94e4db4a498a35872/provenance",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# the whole /v1 surface as one OpenAPI file, saved to disk
r = requests.get(
    "https://data.vike.io/v1/openapi.json",
    headers={"X-API-Key": API_KEY},
)
with open("openapi.json", "wb") as f:
    f.write(r.content)

import os

import requests

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

# every /v1 path, one per line: a short list that fits in any prompt
r = requests.get(
    "https://data.vike.io/v1/openapi.json",
    headers={"X-API-Key": API_KEY},
)
print("\n".join(sorted(r.json()["paths"])))

import os

import requests

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

# one product only: paths start with its namespace (onchain, hyperliquid, hl-cohorts, polymarket)
r = requests.get(
    "https://data.vike.io/v1/openapi.json",
    headers={"X-API-Key": API_KEY},
)
paths = {p: v for p, v in r.json()["paths"].items() if p.split("/")[2] == "polymarket"}
print(len(paths), "Polymarket routes")

import os

import requests

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

# one route in full: give the assistant only the route it is working on
r = requests.get(
    "https://data.vike.io/v1/openapi.json",
    headers={"X-API-Key": API_KEY},
)
paths = r.json()["paths"]
print(paths[next(p for p in paths if p.endswith("/first-funder"))])

import requests

# the published copy, no key needed: for an assistant that fetches URLs on its own
r = requests.get("https://vike.io/data/openapi.json")
print(r.json()["info"]["title"], len(r.json()["paths"]), "paths")

import os

import requests

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

# 1. the largest builder by 30-day volume
builder = requests.get(
    "https://data.vike.io/v1/hyperliquid/builders?window=30d&sort=volume&limit=1",
    headers={"X-API-Key": API_KEY},
).json()["builders"][0]["builder"]
# 2. its top 10 users by 30-day volume
users = requests.get(
    f"https://data.vike.io/v1/hyperliquid/builders/{builder}/users?window=30d&limit=10",
    headers={"X-API-Key": API_KEY},
).json()["users"]
# 3. each user's transfer activity: Ethereum and BSC, then Base and HyperEVM if those know nothing
for u in users:
    wallet = u["wallet"]
    s = requests.get(
        f"https://data.vike.io/v1/onchain/wallets/{wallet}",
        headers={"X-API-Key": API_KEY},
    ).json()
    print(wallet, f"builder volume ${u['volume_usd']:,.0f}", s["chain"], s["all"]["tx_count"], s["all"]["first_seen"])

import os

import requests

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

# what one of those users holds now on Ethereum, BSC, Base and HyperEVM
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xbf732ea04197942783e34730ed6e0f6099575d58/balances",
    headers={"X-API-Key": API_KEY},
)

import os

import requests

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

# which tokens it moved on Ethereum in the last 90 days, newest first
r = requests.get(
    "https://data.vike.io/v1/onchain/wallets/0xbf732ea04197942783e34730ed6e0f6099575d58/transactions?chain=ethereum&days=90&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

# the builder's most profitable users over 30 days (their own realized result through it)
r = requests.get(
    "https://data.vike.io/v1/hyperliquid/builders/0xe966a12bf7b93838096e4519a684519ab22df618/users?window=30d&sort=pnl&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 next page of users: pass the first page's nextCursor back as cursor
URL = "https://data.vike.io/v1/hyperliquid/builders/0xe966a12bf7b93838096e4519a684519ab22df618/users?window=30d&limit=10"
first = requests.get(URL, headers={"X-API-Key": API_KEY}).json()
r = requests.get(
    URL + f"&cursor={first['nextCursor']}",
    headers={"X-API-Key": API_KEY},
)