Hyperliquid User Address Transactions Scraper

A fast and reliable scraper to track on-chain and protocol-level activity for a specific Hyperliquid user address.

It extracts transaction history, USD transfers, and account margin state, enabling deep wallet-level analytics.

Perfect for monitoring trader behavior, fund movements, and account health on Hyperliquid.

✨ Features

🔁 Transaction History Tracking

Full transaction timeline for a user address

Supports:

• USD class transfers

• Internal account movements

• Cross / subaccount transfers

• Transaction metadata:

• Timestamp

• Block number

• Transaction hash

• Chain & network info

• Action type and amount

• Nonce

Error state (success / failure)

💰 Account & Margin Information

Margin summary:

• Account value

• Total USD balance

• Margin used

• Notional exposure

• Cross-margin summary

• Withdrawable balance

• Asset positions (open or empty)

• Snapshot timestamp

⚡ Structured & Time-Series Ready

Clean JSON output

Easy to index, filter, and analyze

Compatible with dashboards, alerts, and monitoring tools

OUTPUT

Transactions

{
  "time": "2025-12-12 14:29:01.573000",
  "user": "0x87f9cd15f5050a9283b8896300f7c8cf69ece2cf",
  "action": {
    "type": "usdClassTransfer",
    "signatureChainId": "0x66eee",
    "hyperliquidChain": "Mainnet",
    "amount": "2100000 subaccount:0x7ca165f354e3260e2f8d5a7508cc9dd2fa009235",
    "toPerp": false,
    "nonce": "2025-12-12 14:28:57.645000"
  },
  "block": 826229091,
  "hash": "0x1ef8c0fcb5239321207204313f41630202cb00e25026b1f3c2c16c4f74276d0b",
  "error": null
}

Info

{
  "marginSummary": {
    "accountValue": "0.150404",
    "totalNtlPos": "0.0",
    "totalRawUsd": "0.150404",
    "totalMarginUsed": "0.0"
  },
  "crossMarginSummary": {
    "accountValue": "0.150404",
    "totalNtlPos": "0.0",
    "totalRawUsd": "0.150404",
    "totalMarginUsed": "0.0"
  },
  "crossMaintenanceMarginUsed": "0.0",
  "withdrawable": "0.150404",
  "assetPositions": [],
  "time": "2025-12-15 15:59:25.401000"
}

🚀 Use Cases

👁 Wallet activity monitoring

📊 Trader behavior analysis

🔔 Large transfer detection

🧠 Risk & exposure tracking

💰 Balance & withdrawable monitoring

🤖 Automated alerts & bots

📉 Margin health analysis

🔍 Compliance & forensic research

💡 Notes

Data is sourced from public Hyperliquid endpoints

Transactions are protocol-level (not raw Ethereum calldata)

Balance values may change rapidly

Empty assetPositions means no open positions

Not financial advice — analytics & monitoring 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