User Non-Funding Ledger Updates

{
  "channel": "userNonFundingLedgerUpdates",
  "data": {
    "user": "0x1111111111111111111111111111111111111111",
    "isSnapshot": true,
    "blockNumber": 123,
    "nonFundingLedgerUpdates": [
      {
        "id": "opaque-projection-row-id",
        "time": 1792108800000,
        "hash": "0xabc",
        "delta": {
          "type": "deposit",
          "coin": "USDC",
          "usdc": "1000.00",
          "szi": "0"
        },
        "transfer": {
          "source": "Hyperliquid Perps",
          "destination": "Notional",
          "txHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
        }
      }
    ]
  }
}

HyperliquidPolymarket

{
  "method": "subscribe",
  "subscription": {
    "type": "userNonFundingLedgerUpdates",
    "user": "0x1111111111111111111111111111111111111111"
  }
}

Response

{
  "channel": "userNonFundingLedgerUpdates",
  "data": {
    "user": "0x1111111111111111111111111111111111111111",
    "isSnapshot": true,
    "blockNumber": 123,
    "nonFundingLedgerUpdates": [
      {
        "id": "opaque-projection-row-id",
        "time": 1792108800000,
        "hash": "0xabc",
        "delta": {
          "type": "deposit",
          "coin": "USDC",
          "usdc": "1000.00",
          "szi": "0"
        },
        "transfer": {
          "source": "Hyperliquid Perps",
          "destination": "Notional",
          "txHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
        }
      }
    ]
  }
}

Response Fields

string

Always userNonFundingLedgerUpdates.

string

Account owner’s wallet address, normalized to lowercase.

boolean

true for the initial snapshot, including an empty one; false for live updates.

number

Latest committed Notional block covered by this message.

object

Ledger rows for deposit, withdrawal, rewards, split, merge, and redemption. The initial snapshot contains the latest 100 matching rows, oldest first. Live batches contain at most 100 new or changed rows. Interest is delivered by User Borrow/Lend Interest.

Show child attributes

string

Opaque stable row identity for upserts. A terminal withdrawal retains its pending row’s ID even if its hash or time changes. Outcome operations also retain their identity through lifecycle changes. Preserve terminal rows when an older pending row arrives.

number

Ledger time in Unix milliseconds.

string

Committed event hash. Separate rows from one transaction have distinct IDs; do not deduplicate by hash or timestamp alone.

object

Activity details, including type, coin, usdc, and szi. Deposits and withdrawals retain native asset units in usdc. USDC supplier distributions classified as rewards are included here.

string

Optional pending, complete, or failed status.

object

Optional deposit or withdrawal details, including source, destination, and available transaction hash, fee, net amount, and requested transaction ID.

object

Split, merge, or redemption details, including operation identity, market, status, and exact signed native-unit assetDeltas. Unavailable movements remain null, not zero.

Start Here

Info

Exchange

WebSocket

User Non-Funding Ledger Updates

Response

Response Fields

​Subscribe

​Response

​Response Fields

Subscribe

Response

Response Fields