Hyperliquid Pro Scraper — Traders, Vaults & Markets

Real-time data from Hyperliquid, the leading on-chain perpetual DEX with $1B+ daily volume. Extract the leaderboard of top traders, wallet positions and trade history, vault performance, and a full perpetual markets snapshot — all from Hyperliquid's public API. No login, no proxy, no API key required.

How to scrape Hyperliquid in 3 easy steps

1. Go to Hyperliquid Pro Scraper on Apify Store and click "Try for free"
2. Choose your mode — leaderboard, wallet positions, trade history, vault details, or market overview
3. Click Run and download your data in JSON, CSV, Excel, or XML

No coding required. Works with Apify's free plan.

Why this scraper?

• Pure HTTP, no browser: runs in 256 MB RAM, fast, cheap, no anti-bot to fight
• 5 modes in one Actor: leaderboard, wallet state, trade history, vaults, markets
• Filterable leaderboard: rank by day / week / month / all-time PnL, filter by minimum account value
• Full position breakdown: per-asset positions with leverage, entry price, unrealized PnL, liquidation price
• Cross-margin & isolated detail: distinguishes cross-margin equity from isolated positions
• Vault analytics: APR, TVL, top depositors, follower-count metrics
• Real-time market state: mid, mark, oracle prices, funding rates, open interest, 24h volume per perp

Modes

Mode	What you get	Best for
Leaderboard	Top traders ranked by PnL, with day/week/month/all-time metrics	Copy-trading research, trader-of-the-week studies
User State	Account equity + per-asset positions for wallet addresses	Wallet tracking, whale watching, alpha leaks
User Fills	Trade execution history for wallet addresses	Strategy reverse-engineering, backtesting datasets
Vault Details	Vault metadata, APR, TVL, top depositors	Vault discovery, performance comparison
Market Overview	Snapshot of every perp market: prices, funding, OI, volume	Market scanners, arbitrage signals, dashboards

Data fields

Leaderboard entry

• address, displayName, accountValue (USD)
• performance: day / week / month / allTime → {pnl, roi, vlm}
• primaryWindow (the window you sorted by)
• profileUrl, scrapedAt

User state (per wallet)

• address, accountValue, totalNotionalPosition, totalMarginUsed, withdrawable
• crossMarginAccountValue, crossMaintenanceMarginUsed
• openPositionsCount, positions[] (coin, size, entryPx, positionValue, unrealizedPnl, marginUsed, liquidationPx, leverage, type)
• profileUrl, scrapedAt

User fill (trade execution)

• coin, side (B/A), size, price, value, fee, closedPnl
• direction (open / close), orderId, timestamp, hash, tid
• scrapedAt

Vault details

• vaultAddress, name, description, leader, apr, tvl, followerCount
• followers[] (user, vaultEquity, pnl, daysFollowing)
• vaultUrl, scrapedAt

Market (per perp)

• coin, maxLeverage, szDecimals
• midPrice, markPrice, oraclePrice, openInterest, fundingRate, premium
• dayVolume (notional USD), dayBaseVolume (base asset units)
• scrapedAt

Input examples

Top 50 traders by all-time PnL, accounts > $50K

{
    "mode": "leaderboard",
    "leaderboardWindow": "allTime",
    "minAccountValue": 50000,
    "maxResults": 50
}

Whale-watch: track positions of specific wallets

{
    "mode": "user_state",
    "wallets": [
        "0x1234567890abcdef1234567890abcdef12345678",
        "0xabcdef1234567890abcdef1234567890abcdef12"
    ],
    "includeFills": true,
    "maxFillsPerWallet": 200
}

Pull every fill from a single wallet

{
    "mode": "user_fills",
    "wallets": ["0x1234567890abcdef1234567890abcdef12345678"],
    "maxFillsPerWallet": 2000
}

Vault performance comparison

{
    "mode": "vault_details",
    "vaultAddresses": [
        "0x0000000000000000000000000000000000000001",
        "0x0000000000000000000000000000000000000002"
    ]
}

Real-time market snapshot (all perps)

{
    "mode": "market_overview"
}

Output sample — leaderboard entry

{
    "mode": "leaderboard_entry",
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "displayName": "PerpKing",
    "accountValue": 824150.42,
    "primaryWindow": "month",
    "performance": {
        "day": {"pnl": 18420.1, "roi": 0.022, "vlm": 5840000},
        "week": {"pnl": 142800.5, "roi": 0.18, "vlm": 38400000},
        "month": {"pnl": 612300.0, "roi": 1.84, "vlm": 152000000},
        "allTime": {"pnl": 4820000.0, "roi": 9.45, "vlm": 1840000000}
    },
    "profileUrl": "https://app.hyperliquid.xyz/explorer/address/0x...",
    "scrapedAt": "2026-05-06T03:00:00Z"
}

Pricing

Pay-per-event:

Event	Price
Per leaderboard entry	$0.02
Per wallet state snapshot	$0.05
Per individual trade fill	$0.005
Per vault detail record	$0.10
Per market snapshot (one row per perp)	$0.005

Typical costs:

• Top 50 traders snapshot: ~$1.00
• Track 10 whale wallets daily: ~$0.50/run
• Full trade history of 1 trader (up to 2,000 fills): ~$10
• All Hyperliquid perp markets snapshot (~150 markets): ~$0.75
• 5 vault performance comparison: ~$0.50

Apify platform compute is included — you only pay for the scraped items above, never for run duration.

Free trial: $3 of credits for 7 days. Enough to track 60 wallets, snapshot top 150 traders, or compare 30 vaults.

Use cases

• Copy-trading research: identify consistently profitable traders, analyze their strategy via fill history
• Whale watching / alpha leaks: track known smart-money wallets, detect entries before the crowd
• Quant signal generation: cross-reference funding rates, open interest, leaderboard PnL momentum
• Vault performance dashboards: rank vaults by APR + TVL + drawdown for selection
• Market scanners: real-time snapshot of every perp's funding, OI, volume — feed into your own strategy
• Backtesting datasets: pull months of fills from top performers as training data

Scrape Hyperliquid with Python, JavaScript, or no code

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("zhorex/hyperliquid-scraper").call(run_input={
    "mode": "leaderboard",
    "leaderboardWindow": "month",
    "minAccountValue": 100000,
    "maxResults": 100,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['displayName']:20s}  PnL(month)={item['performance']['month']['pnl']:>12,.0f}")

JavaScript

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('zhorex/hyperliquid-scraper').call({
    mode: 'market_overview'
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

FAQ

Does it require a Hyperliquid account or API key? No. The Actor uses Hyperliquid's public read-only API (no auth, no signing, no key).

Can I track wallets in real time? Schedule the Actor to run every N minutes via Apify Schedules. Each run is a fresh snapshot — store dataset versions for time-series analysis.

What's the leaderboard time-window granularity? Hyperliquid exposes 4 windows: 24h (day), 7d (week), 30d (month), and allTime. The Actor returns metrics for ALL four windows on every entry; pick which one drives the sort with leaderboardWindow.

Can I get historical OHLCV / candles? Not in this Actor — it focuses on trader and market state. Hyperliquid's candleSnapshot endpoint can be added on request; open an issue if you need it.

What about spot markets? This v1 covers perpetuals (the bulk of Hyperliquid volume). Spot data can be added — open an issue if you need spot tickers.

Are the wallet addresses I provide stored anywhere? No. The Actor only forwards them to Hyperliquid's public API. Apify retains the input on the run record (you control retention via Apify Console).

Is scraping Hyperliquid legal? Yes — Hyperliquid publishes their /info endpoint as a public read-only API explicitly intended for third-party tools and analytics. No ToS bypass, no auth, no rate-limit gaming.

Integrations & data export

Export results in JSON, CSV, Excel, or XML. Integrate with:

• Google Sheets — automatic dashboards
• Zapier / Make / n8n — alert flows when a wallet opens a position
• REST API — programmatic access from any language
• Webhooks — real-time triggers on run completion

Other scrapers by Zhorex

DeFi & Markets:

• Hyperliquid Pro Scraper — (this Actor)
• Solana DEX Scraper — Raydium + Orca normalized swap stream (dev-grade schema)
• TradingView Multi-Market Scraper — Stocks, crypto, forex, indices

AI & Search:

• Perplexity AI Search Scraper — AI-powered search results

Chinese Digital Intelligence Suite:

• Weibo Scraper — China's Twitter (580M+ users)
• Bilibili Scraper — China's YouTube (300M+ users)
• RedNote (Xiaohongshu) Scraper — Posts, profiles, comments, videos
• RedNote Shop Scraper — Xiaohongshu e-commerce
• Douban Scraper — Long-form reviews (movies, books, music)

B2B Review Intelligence:

• G2 Reviews Scraper
• Capterra Reviews Scraper
• Booking.com Reviews Scraper

---

Your Review Matters ⭐

If this Actor helped your trading or research, a 30-second review helps a lot:

1. Go to the Hyperliquid Pro Scraper page
2. Click the star rating
3. Optionally leave a one-line note (e.g. "tracked top 100 traders for a month")

Why it matters: reviews are the #1 signal Apify users check before trying a scraper. The first 5-10 reviews dramatically improve discovery for everyone.

Found a bug or want a new metric? Open an issue — typically fixed within 48 hours.

---

🏢 Running a quant fund or copy-trading platform?

If your pipeline ingests 1,000+ wallet snapshots per day or runs continuous leaderboard / vault polling, I offer:

• Custom output schemas matching your warehouse / data lake format
• Dedicated proxy infrastructure for sub-second latency
• Schema stability SLA — no breaking changes without 30-day notice
• Volume pricing above 50K events/month
• Spot markets, OHLCV candles, funding history — built on request

DM me on Apify, open an Issue with subject "Enterprise inquiry", or email samimassis2002@gmail.com.

---

Last updated: May 2026 · Actively maintained · Built by the developer of Weibo, Bilibili, RedNote, and the G2 Reviews scrapers.