vike

Recipe 21 of 65

Hyperliquid wallet ledger: deposits, withdrawals, transfers

/wallets/{address}/ledger lists the wallet's deposits, withdrawals, transfers and vault events newest first, with a USD amount, the token and the counterparty; event_type filters to one kind.

GET /v1/hyperliquid/wallets/{address}/ledger answers it in one call: every non-trading balance movement recorded for the wallet, newest first, from bridge deposits and withdrawals, sends, and transfers between its spot and perp balances to sub-account moves and vault events. Each row has event_type, amount_usd, token, counterparty and the transaction hash. Pass event_type for one kind. The full parameter list is on Wallet ledger.

Quick answer

Put the address in the path.

cURL
# the wallet's newest ledger events
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897/ledger?limit=5"

Example response

Captured from the live API on 2026-10-24 at 17:17 UTC, trimmed to 3 of 5 rows.

Small USDC spot transfers in from one address. On transfer events the sign is the direction: positive came into the wallet, negative left it. deposit and withdraw rows are both positive, and the event_type says which way. amount_usd is USD.

Example response
{
  "wallet": "0x25773676902085225ae5751075e4161369334897",
  "items": [
    {
      "ts": "2026-10-24T12:03:36.201000+00:00",
      "event_type": "spotTransfer",
      "amount_usd": 3.290431,
      "fee": 0.0,
      "token": "USDC",
      "counterparty": "0xe11a405e62cff89a4148a6d5c345be8646705b8d",
      "hash": "0xb8046206c5056248b97e044741f68d02032700ec6008811a5bcd0d5984093c33"
    },
    {
      "ts": "2026-10-24T12:02:33.720000+00:00",
      "event_type": "spotTransfer",
      "amount_usd": 2.290327,
      "fee": 0.0,
      "token": "USDC",
      "counterparty": "0xe11a405e62cff89a4148a6d5c345be8646705b8d",
      "hash": "0x468de170efb53b3f4807044741f31d02013a00568ab85a11ea568cc3aeb91529"
    },
    {
      "ts": "2026-10-24T11:54:56.085000+00:00",
      "event_type": "spotTransfer",
      "amount_usd": 8.301742,
      "fee": 0.0,
      "token": "USDC",
      "counterparty": "0xe11a405e62cff89a4148a6d5c345be8646705b8d",
      "hash": "0x8b6bdc43b664f8a38ce5044741da6402013a0029516817752f3487967568d28e"
    }
  ],
  "nextCursor": "eyJoIjoiMHhlYmNkZWU5ZmI4MDllNTBhZWQ0NzA0NDc0MWQxZGYwMjAxYmQwMDg1NTMwZDAzZGM4Zjk2OTlmMjc3MGRiZWY1IiwidCI6IjIwMjYtMTAtMjQgMTE6NTI6MTkuODM0In0"
}

Variations

Deposits only. event_type=deposit keeps the bridge deposits.

cURL — deposits
# bridge deposits into the wallet
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897/ledger?event_type=deposit&limit=100"

Withdrawals only. event_type=withdraw keeps the withdrawals.

cURL — withdrawals
# withdrawals out of the wallet
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897/ledger?event_type=withdraw&limit=100"

Lifetime totals by type. /wallets/{address} sums the whole ledger: total deposits, withdrawals, net deposits and a count per event type.

cURL — totals
# lifetime deposits, withdrawals and per-type totals
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/wallets/0x25773676902085225ae5751075e4161369334897" \
  | jq '{lifetime, ledger_by_type}'

Before you rely on it

send is one-sided and the newest hour can be missing

A send is sometimes recorded only on the sender's side, so a wallet's sends can look like money leaving with no matching arrival elsewhere; do not net sends across wallets. Events are loaded in hourly batches, so the newest hour can be missing. event_type must be one of accountClassTransfer, borrowLend, deposit, internalTransfer, rewardsClaim, send, spotTransfer, subAccountTransfer, vaultCreate, vaultDeposit, vaultDistribution, vaultLeaderCommission, vaultWithdraw or withdraw; anything else is a 400.

Ask your agent

Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words. The hl_wallet_activity tool answers with view: ledger, and event_type for one kind, at 1 credit a call.

Ask your agent
Show the deposits and withdrawals of Hyperliquid wallet 0x25773676902085225ae5751075e4161369334897

How much funding did this wallet pay or receive, per market?

Recipe 20

HyperCore ↔ HyperEVM transfers of a user

Recipe 22

Example response
{  "wallet": "0x25773676902085225ae5751075e4161369334897",  "items": [    {      "ts": "2026-10-24T12:03:36.201000+00:00",      "event_type": "spotTransfer",      "amount_usd": 3.290431,      "fee": 0.0,      "token": "USDC",      "counterparty": "0xe11a405e62cff89a4148a6d5c345be8646705b8d",      "hash": "0xb8046206c5056248b97e044741f68d02032700ec6008811a5bcd0d5984093c33"    },    {      "ts": "2026-10-24T12:02:33.720000+00:00",      "event_type": "spotTransfer",      "amount_usd": 2.290327,      "fee": 0.0,      "token": "USDC",      "counterparty": "0xe11a405e62cff89a4148a6d5c345be8646705b8d",      "hash": "0x468de170efb53b3f4807044741f31d02013a00568ab85a11ea568cc3aeb91529"    },    {      "ts": "2026-10-24T11:54:56.085000+00:00",      "event_type": "spotTransfer",      "amount_usd": 8.301742,      "fee": 0.0,      "token": "USDC",      "counterparty": "0xe11a405e62cff89a4148a6d5c345be8646705b8d",      "hash": "0x8b6bdc43b664f8a38ce5044741da6402013a0029516817752f3487967568d28e"    }  ],  "nextCursor": "eyJoIjoiMHhlYmNkZWU5ZmI4MDllNTBhZWQ0NzA0NDc0MWQxZGYwMjAxYmQwMDg1NTMwZDAzZGM4Zjk2OTlmMjc3MGRiZWY1IiwidCI6IjIwMjYtMTAtMjQgMTE6NTI6MTkuODM0In0"}