Hyperliquid Leaderboard & Vaults Scraper

A high-performance scraper for Hyperliquid, designed to extract leaderboard trader data and vault performance metrics in real time.

Ideal for quantitative research, DeFi analytics, copy-trading insights, and performance monitoring.

✨ Features

🏆 Leaderboard Data Extraction

Ethereum wallet address (trader identity)

Total account value

Performance metrics across multiple time windows:

• Daily

• Weekly

• Monthly

• All-time

• Profit & loss (PnL)

• Return on investment (ROI)

• Trading volume

• Prize / reward tracking

• Display name (when available)

🏦 Vaults Performance Tracking

• Vault APR (annualized performance)

• PnL evolution by time window:

• Day

• Week

• Month

• All-time

• Historical PnL arrays (time-series ready)

Vault metadata:

• Vault name

• Vault smart contract address

• Vault leader (manager)

• Total value locked (TVL)

• Vault creation timestamp

• Vault status (open / closed)

• Relationship type

⚡ Clean & Structured Output

Machine-readable JSON

Ready for dashboards, backtesting, and analytics pipelines

Consistent formatting across leaderboard and vault endpoints

OUTPUT

Leaderboard

{
  "ethAddress": "0x87f9cd15f5050a9283b8896300f7c8cf69ece2cf",
  "accountValue": "69764490.9519940019",
  "windowPerformances": [
    [
      "day",
      {
        "pnl": "-398708.748678",
        "roi": "-0.0075682189",
        "vlm": "1384010873.9200003147"
      }
    ],
    [
      "week",
      {
        "pnl": "3519996.7125540008",
        "roi": "0.0657411562",
        "vlm": "10677150125.5999984741"
      }
    ],
    [
      "month",
      {
        "pnl": "12405873.3943120018",
        "roi": "0.1736486167",
        "vlm": "54530304198.8899993896"
      }
    ],
    [
      "allTime",
      {
        "pnl": "20027698.5457659885",
        "roi": "0.1895275427",
        "vlm": "330081046602.6299438477"
      }
    ]
  ],
  "prize": 0,
  "displayName": null
}

Vaults

{
    "apr": -0.11227691371786401,
    "pnls": [
      [
        "day",
        [
          "0.0",
          "-15.179475",
          "-6.545924",
          "-26.114403",
          "-48.535606",
          "-35.910138",
          "24.038044",
          "32.175826",
          "40.253118",
          "86.749624",
          "78.095844",
          "49.017541",
          "-142.698386",
          "-172.938386"
        ]
      ],
      [
        "week",
        [
          "0.0",
          "15.20466",
          "346.265234",
          "390.078736",
          "114.968574",
          "212.837287",
          "-25.511373",
          "17.456759",
          "-27.319001",
          "20.0363",
          "-185.077912"
        ]
      ],
      [
        "month",
        [
          "0.0",
          "-84.216398",
          "-606.945094",
          "-232.726851",
          "-243.225882",
          "-87.85932",
          "-165.218459",
          "181.046775",
          "8.617726",
          "-175.825284",
          "-183.903909",
          "-350.296371"
        ]
      ],
      [
        "allTime",
        [
          "0.0",
          "162.302413",
          "100.559992",
          "-5.720534",
          "-152.492299",
          "715.201694",
          "641.621139",
          "1892.966344",
          "2755.112289",
          "2968.751647",
          "1914.049441",
          "1785.854266",
          "1694.165941"
        ]
      ]
    ],
    "summary": {
      "name": "OnDitMerciQui?",
      "vaultAddress": "0x057236927e2e2c8b3cd595746a051687ba40d1cc",
      "leader": "0x671ac0f3cd0f450b12c50c5b0891dbc4dac80d73",
      "tvl": "2769.875941",
      "isClosed": false,
      "relationship": {
        "type": "normal"
      },
      "createTimeMillis": 1733950212812
    }
  },

🚀 Use Cases

📊 DeFi performance analytics

🧠 Top trader discovery & ranking

🤖 Copy-trading strategy research

📈 PnL & ROI time-series analysis

🏦 Vault comparison & risk assessment

🔔 Monitoring high-value wallets

🧪 Backtesting Hyperliquid strategies

📉 APR & drawdown tracking

💡 Notes

Data is sourced from public Hyperliquid endpoints

Financial metrics may fluctuate rapidly

APR values can be positive or negative

Vault PnL arrays are suitable for charting

Not financial advice — analytics use only

🛟 SUPPORT

Share your runs with the developer team and create issues on error to help us improve actor quality.

You might discover edge case we didn't test yet

We stay available anytime