> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# User Non-Funding Ledger Updates

> Endpoint providing non-funding ledger updates by user address

This endpoint provides non-funding ledger updates for Hyperliquid user addresses, such as deposits, withdrawals, transfers, liquidations, and other ledger events.

<Info>
  **Drop-in Replacement**

  This endpoint is a 1-1 replacement for the `userNonFundingLedgerUpdates` endpoint in Hyperliquid.
</Info>

<Expandable title="cURL Example">
  ```bash theme={null}
  curl --request POST \
    --url https://api.allium.so/api/v1/developer/trading/hyperliquid/info/events \
    --header 'Content-Type: application/json' \
    --header 'X-API-KEY: KEY' \
    --data '{
      "type": "userNonFundingLedgerUpdates",
      "user": "0xfb67615bff54078322e758efbeb5db27fdf873d8"
  }'
  ```
</Expandable>

<Expandable title="Response Example">
  ```json theme={null}
  [
    {
      "time": 1765783154804,
      "hash": "0xccc0b2a216c30ddf1415a50100e15f965142d9c86a66249e171e43f53d46f285",
      "delta": {
        "type": "deposit",
        "usdc": "17.0"
      }
    },
    {
      "time": 1765782864157,
      "hash": "0xdad0c3a43d5b929c756ae0cd2b253b8d26d744afa5ca71f7cac7efea39c565d7",
      "delta": {
        "type": "withdraw",
        "usdc": "17.0",
        "nonce": 1765782606864000,
        "fee": "1.0"
      }
    },
    {
      "time": 1771619923327,
      "hash": "0xe1915962351b995de30b0435af88530201720047d01eb82f855a04b4f41f7348",
      "delta": {
        "type": "send",
        "user": "0x8e80c4b533dd977cf716b5c24fd9223129272804",
        "destination": "0xad0d614bed719fed42cf5bfeccb75e47256da754",
        "sourceDex": "",
        "destinationDex": "",
        "token": "USDC",
        "amount": "10966.0",
        "usdcValue": "10966.0",
        "fee": "0.0",
        "nativeTokenFee": "0.0",
        "nonce": 1771619892789,
        "feeToken": ""
      }
    },
    {
      "time": 1753769520340,
      "hash": "0x88bb8650f9fbe02fc57a042873871f012f00f201fe77be1a38468362c806c620",
      "delta": {
        "type": "subAccountTransfer",
        "usdc": "1100.0",
        "user": "0x7839e2f2c375dd2935193f2736167514efff9916",
        "destination": "0x5483dd0f8b7d2544a6ac14ba8659988178fd9f4a"
      }
    },
    {
      "time": 1753695433888,
      "hash": "0xab0a3aa159bae50db8d30428652b28011900d7e971925acde050286ca0cb509d",
      "delta": {
        "type": "accountClassTransfer",
        "usdc": "10000.0",
        "toPerp": true
      }
    },
    {
      "time": 1753695223324,
      "hash": "0xdc722dd809923add1f040428652060015500f702c2ce8ce7bdb7a637e6d23c09",
      "delta": {
        "type": "spotTransfer",
        "token": "USDC",
        "amount": "10000.0",
        "usdcValue": "10000.0",
        "user": "0x7839e2f2c375dd2935193f2736167514efff9916",
        "destination": "0x5483dd0f8b7d2544a6ac14ba8659988178fd9f4a",
        "fee": "0.0",
        "nativeTokenFee": "0.0",
        "nonce": null,
        "feeToken": ""
      }
    }
  ]
  ```
</Expandable>


## OpenAPI

````yaml /_openapi/go-src-api.json POST /api/v1/developer/trading/hyperliquid/info/events
openapi: 3.0.3
info:
  title: Hyperliquid API Server
  description: API server for Hyperliquid trading data including orders and fills
  version: 1.0.0
servers:
  - url: https://api.allium.so
    description: Production server
security: []
paths:
  /api/v1/developer/trading/hyperliquid/info/events:
    post:
      summary: Get user events
      description: Retrieve funding and non-funding ledger update events for a user
      operationId: getUserEvents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HyperliquidGetEventsRequest'
            example:
              type: userFunding
              user: '0x1cd84cc81f7ec9e14362681d606d00a526e388eb'
      responses:
        '200':
          description: Events retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HyperliquidEvent'
        '400':
          description: Bad request - Invalid type or missing required fields
          content:
            text/plain:
              schema:
                type: string
        '500':
          description: Internal server error
          content:
            text/plain:
              schema:
                type: string
      security:
        - APIKeyBearer: []
components:
  schemas:
    HyperliquidGetEventsRequest:
      type: object
      required:
        - type
        - user
      properties:
        type:
          type: string
          enum:
            - userFunding
            - userNonFundingLedgerUpdates
          description: Type of events to retrieve.
        user:
          type: string
          description: User's wallet address (hex string).
    HyperliquidEvent:
      type: object
      properties:
        time:
          type: integer
          format: int64
          description: Event timestamp (Unix timestamp in milliseconds)
        hash:
          type: string
          description: Transaction hash
        delta:
          description: Event payload. Structure varies by request type and event type.
          oneOf:
            - $ref: '#/components/schemas/HyperliquidFundingDelta'
            - $ref: '#/components/schemas/HyperliquidDepositDelta'
            - $ref: '#/components/schemas/HyperliquidWithdrawDelta'
            - $ref: '#/components/schemas/HyperliquidSendDelta'
            - $ref: '#/components/schemas/HyperliquidSubAccountTransferDelta'
            - $ref: '#/components/schemas/HyperliquidAccountClassTransferDelta'
            - $ref: '#/components/schemas/HyperliquidSpotTransferDelta'
    HyperliquidFundingDelta:
      type: object
      description: Funding event delta (userFunding)
      properties:
        type:
          type: string
          enum:
            - funding
          description: Always 'funding'
        coin:
          type: string
          description: Asset symbol (e.g., BTC, ETH)
        usdc:
          type: string
          description: >-
            USDC funding payment amount. Negative means paid, positive means
            received.
        szi:
          type: string
          description: Signed size of the position at the time of funding
        fundingRate:
          type: string
          description: Funding rate applied
        nSamples:
          type: integer
          nullable: true
          description: Number of samples
    HyperliquidDepositDelta:
      type: object
      description: Deposit event
      properties:
        type:
          type: string
          enum:
            - deposit
          description: Always 'deposit'
        usdc:
          type: string
          description: USDC amount deposited
    HyperliquidWithdrawDelta:
      type: object
      description: Withdrawal event
      properties:
        type:
          type: string
          enum:
            - withdraw
          description: Always 'withdraw'
        usdc:
          type: string
          description: USDC amount withdrawn
        nonce:
          type: integer
          format: int64
          description: Withdrawal nonce
        fee:
          type: string
          description: Withdrawal fee
    HyperliquidSendDelta:
      type: object
      description: Send/transfer event
      properties:
        type:
          type: string
          enum:
            - send
          description: Always 'send'
        user:
          type: string
          description: Source user address
        destination:
          type: string
          description: Destination user address
        sourceDex:
          type: string
          description: Source DEX
        destinationDex:
          type: string
          description: Destination DEX
        token:
          type: string
          description: Token symbol
        amount:
          type: string
          description: Transfer amount
        usdcValue:
          type: string
          description: USD value of the transfer
        fee:
          type: string
          description: Fee amount
        nativeTokenFee:
          type: string
          description: Native token fee
        nonce:
          type: integer
          format: int64
          description: Nonce value
        feeToken:
          type: string
          description: Token used for fee payment
    HyperliquidSubAccountTransferDelta:
      type: object
      description: Sub-account transfer event
      properties:
        type:
          type: string
          enum:
            - subAccountTransfer
          description: Always 'subAccountTransfer'
        usdc:
          type: string
          description: USDC amount transferred
        user:
          type: string
          description: Source user address
        destination:
          type: string
          description: Destination user address
    HyperliquidAccountClassTransferDelta:
      type: object
      description: Account class transfer event
      properties:
        type:
          type: string
          enum:
            - accountClassTransfer
          description: Always 'accountClassTransfer'
        usdc:
          type: string
          description: USDC amount transferred
        toPerp:
          type: boolean
          description: Whether the transfer is to the perp account
    HyperliquidSpotTransferDelta:
      type: object
      description: Spot transfer event
      properties:
        type:
          type: string
          enum:
            - spotTransfer
          description: Always 'spotTransfer'
        token:
          type: string
          description: Token symbol
        amount:
          type: string
          description: Transfer amount
        usdcValue:
          type: string
          description: USD value of the transfer
        user:
          type: string
          description: Source user address
        destination:
          type: string
          description: Destination user address
        fee:
          type: string
          description: Fee amount
        nativeTokenFee:
          type: string
          description: Native token fee
        nonce:
          nullable: true
          description: Nonce value
        feeToken:
          type: string
          description: Token used for fee payment
  securitySchemes:
    APIKeyBearer:
      type: apiKey
      in: header
      name: X-API-KEY

````