---
title: "Get user events"
method: POST
path: "/api/v1/developer/trading/hyperliquid/info/events"
---

# Get user events

`POST /api/v1/developer/trading/hyperliquid/info/events`

Retrieve funding and non-funding ledger update events for a user

## Request body

- HyperliquidGetEventsRequest
  - `type` 'userFunding' | 'userNonFundingLedgerUpdates', required — Type of events to retrieve.
  - `user` string, required — User's wallet address (hex string).

## Response `200`

Events retrieved successfully

- HyperliquidEvent[]
  - `time` integer — Event timestamp (Unix timestamp in milliseconds)
  - `hash` string — Transaction hash
  - `delta` union — Event payload. Structure varies by request type and event type.
    - HyperliquidFundingDelta — Funding event delta (userFunding)
      - `type` 'funding' — Always 'funding'
      - `coin` string — Asset symbol (e.g., BTC, ETH)
      - `usdc` string — USDC funding payment amount. Negative means paid, positive means received.
      - `szi` string — Signed size of the position at the time of funding
      - `fundingRate` string — Funding rate applied
      - `nSamples` integer, nullable — Number of samples
    - HyperliquidDepositDelta — Deposit event
      - `type` 'deposit' — Always 'deposit'
      - `usdc` string — USDC amount deposited
    - HyperliquidWithdrawDelta — Withdrawal event
      - `type` 'withdraw' — Always 'withdraw'
      - `usdc` string — USDC amount withdrawn
      - `nonce` integer — Withdrawal nonce
      - `fee` string — Withdrawal fee
    - HyperliquidSendDelta — Send/transfer event
      - `type` 'send' — Always 'send'
      - `user` string — Source user address
      - `destination` string — Destination user address
      - `sourceDex` string — Source DEX
      - `destinationDex` string — Destination DEX
      - `token` string — Token symbol
      - `amount` string — Transfer amount
      - `usdcValue` string — USD value of the transfer
      - `fee` string — Fee amount
      - `nativeTokenFee` string — Native token fee
      - `nonce` integer — Nonce value
      - `feeToken` string — Token used for fee payment
    - HyperliquidSubAccountTransferDelta — Sub-account transfer event
      - `type` 'subAccountTransfer' — Always 'subAccountTransfer'
      - `usdc` string — USDC amount transferred
      - `user` string — Source user address
      - `destination` string — Destination user address
    - HyperliquidAccountClassTransferDelta — Account class transfer event
      - `type` 'accountClassTransfer' — Always 'accountClassTransfer'
      - `usdc` string — USDC amount transferred
      - `toPerp` boolean — Whether the transfer is to the perp account
    - HyperliquidSpotTransferDelta — Spot transfer event
      - `type` 'spotTransfer' — Always 'spotTransfer'
      - `token` string — Token symbol
      - `amount` string — Transfer amount
      - `usdcValue` string — USD value of the transfer
      - `user` string — Source user address
      - `destination` string — Destination user address
      - `fee` string — Fee amount
      - `nativeTokenFee` string — Native token fee
      - `nonce` unknown
      - `feeToken` string — Token used for fee payment

## Other responses

- `400` — Bad request - Invalid type or missing required fields
- `500` — Internal server error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)