> For the complete documentation index, see [llms.txt](https://nktkas.gitbook.io/hyperliquid/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nktkas.gitbook.io/hyperliquid/api-reference/info-methods/usernonfundingledgerupdates.md).

# userNonFundingLedgerUpdates

## POST /info

> Request user non-funding ledger updates.

```json
{"openapi":"3.1.1","info":{"title":"Hyperliquid API - info/userNonFundingLedgerUpdates","version":"1.0.0"},"tags":[{"name":"userNonFundingLedgerUpdates"}],"servers":[{"url":"https://api.hyperliquid.xyz","description":"Mainnet"},{"url":"https://api.hyperliquid-testnet.xyz","description":"Testnet"}],"paths":{"/info":{"post":{"tags":["userNonFundingLedgerUpdates"],"description":"Request user non-funding ledger updates.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"description":"Type of request.","enum":["userNonFundingLedgerUpdates"]},"user":{"type":"string","pattern":"^0[xX][0-9a-fA-F]+$","minLength":42,"maxLength":42,"description":"User address."},"startTime":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Start time (in ms since epoch)."},"endTime":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"End time (in ms since epoch).","nullable":true}],"description":"End time (in ms since epoch)."}},"required":["type","user"],"description":"Request user non-funding ledger updates."}}},"required":true},"responses":{"200":{"description":"Array of user's non-funding ledger update.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"time":{"type":"number","description":"Timestamp of the update (in ms since epoch)."},"hash":{"type":"string","description":"L1 transaction hash.","pattern":"^0x[a-fA-F0-9]{64}$"},"delta":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["accountClassTransfer"]},"usdc":{"type":"string","description":"Amount transferred in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"toPerp":{"type":"boolean","description":"Indicates if the transfer is to the perpetual account."}},"required":["type","usdc","toPerp"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["deposit"]},"usdc":{"type":"string","description":"Amount deposited in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","usdc"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["internalTransfer"]},"usdc":{"type":"string","description":"Amount transferred in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"user":{"type":"string","description":"Initiator address.","pattern":"^0x[a-fA-F0-9]{40}$"},"destination":{"type":"string","description":"Destination address.","pattern":"^0x[a-fA-F0-9]{40}$"},"fee":{"type":"string","description":"Transfer fee.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","usdc","user","destination","fee"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["liquidation"]},"liquidatedNtlPos":{"type":"string","description":"Total notional value of liquidated positions.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"accountValue":{"type":"string","description":"Account value at liquidation time.","pattern":"^-?[0-9]+(\\.[0-9]+)?$"},"leverageType":{"type":"string","enum":["Cross","Isolated"],"description":"Leverage type for liquidated positions."},"liquidatedPositions":{"type":"array","items":{"type":"object","properties":{"coin":{"type":"string","description":"Asset symbol of the liquidated position."},"szi":{"type":"string","description":"Signed position size liquidated.","pattern":"^-?[0-9]+(\\.[0-9]+)?$"}},"required":["coin","szi"],"additionalProperties":false},"description":"Details of each liquidated position."}},"required":["type","liquidatedNtlPos","accountValue","leverageType","liquidatedPositions"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["rewardsClaim"]},"amount":{"type":"string","description":"Amount of rewards claimed.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"token":{"type":"string","description":"Token symbol (e.g., USDC)."}},"required":["type","amount","token"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["spotTransfer"]},"token":{"type":"string","description":"Token symbol (e.g., USDC)."},"amount":{"type":"string","description":"Amount transferred.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"usdcValue":{"type":"string","description":"Equivalent USDC value.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"user":{"type":"string","description":"Initiator address.","pattern":"^0x[a-fA-F0-9]{40}$"},"destination":{"type":"string","description":"Destination address.","pattern":"^0x[a-fA-F0-9]{40}$"},"fee":{"type":"string","description":"Transfer fee.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"nativeTokenFee":{"type":"string","description":"Fee in native token.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"nonce":{"type":"number","description":"Nonce of the transfer.","nullable":true},"feeToken":{"type":"string","description":"Token in which the fee is denominated (e.g., USDC)."}},"required":["type","token","amount","usdcValue","user","destination","fee","nativeTokenFee","nonce","feeToken"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["subAccountTransfer"]},"usdc":{"type":"string","description":"Amount transferred in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"user":{"type":"string","description":"Initiator address.","pattern":"^0x[a-fA-F0-9]{40}$"},"destination":{"type":"string","description":"Destination address.","pattern":"^0x[a-fA-F0-9]{40}$"}},"required":["type","usdc","user","destination"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["vaultCreate"]},"vault":{"type":"string","description":"Address of the created vault.","pattern":"^0x[a-fA-F0-9]{40}$"},"usdc":{"type":"string","description":"Initial allocated amount in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"fee":{"type":"string","description":"Vault creation fee.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","vault","usdc","fee"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["vaultDeposit"]},"vault":{"type":"string","description":"Address of the target vault.","pattern":"^0x[a-fA-F0-9]{40}$"},"usdc":{"type":"string","description":"Amount deposited in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","vault","usdc"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["vaultDistribution"]},"vault":{"type":"string","description":"Address of the vault distributing funds.","pattern":"^0x[a-fA-F0-9]{40}$"},"usdc":{"type":"string","description":"Amount distributed in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","vault","usdc"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["vaultWithdraw"]},"vault":{"type":"string","description":"Vault address.","pattern":"^0x[a-fA-F0-9]{40}$"},"user":{"type":"string","description":"Address of the user withdrawing funds.","pattern":"^0x[a-fA-F0-9]{40}$"},"requestedUsd":{"type":"string","description":"Withdrawal request amount in USD.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"commission":{"type":"string","description":"Withdrawal commission fee.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"closingCost":{"type":"string","description":"Closing cost associated with positions.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"basis":{"type":"string","description":"Basis value for withdrawal calculation.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"netWithdrawnUsd":{"type":"string","description":"Net withdrawn amount in USD after fees and costs.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","vault","user","requestedUsd","commission","closingCost","basis","netWithdrawnUsd"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["withdraw"]},"usdc":{"type":"string","description":"Amount withdrawn in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"nonce":{"type":"number","description":"Nonce (timestamp in ms) used to prevent replay attacks."},"fee":{"type":"string","description":"Withdrawal fee.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","usdc","nonce","fee"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["send"]},"user":{"type":"string","description":"Address of the sender.","pattern":"^0x[a-fA-F0-9]{40}$"},"destination":{"type":"string","description":"Destination address.","pattern":"^0x[a-fA-F0-9]{40}$"},"sourceDex":{"type":"string","description":"Source DEX (\"\" for default USDC perp DEX, \"spot\" for spot)."},"destinationDex":{"type":"string","description":"Destination DEX (\"\" for default USDC perp DEX, \"spot\" for spot)."},"token":{"type":"string","description":"Token symbol (e.g., USDC)."},"amount":{"type":"string","description":"Amount to send (not in wei).","pattern":"^[0-9]+(\\.[0-9]+)?$"},"usdcValue":{"type":"string","description":"Equivalent USDC value.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"fee":{"type":"string","description":"Transfer fee.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"nativeTokenFee":{"type":"string","description":"Fee in native token.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"nonce":{"type":"number","description":"Nonce of the transfer."},"feeToken":{"type":"string","description":"Token in which the fee is denominated (e.g., USDC)."}},"required":["type","user","destination","sourceDex","destinationDex","token","amount","usdcValue","fee","nativeTokenFee","nonce","feeToken"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["deployGasAuction"]},"token":{"type":"string","description":"Token symbol (e.g., USDC)."},"amount":{"type":"string","description":"Amount in the specified token.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","token","amount"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["cStakingTransfer"]},"token":{"type":"string","description":"Token symbol (e.g., USDC)."},"amount":{"type":"string","description":"Amount in the specified token.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"isDeposit":{"type":"boolean","description":"`true` for deposit, `false` for withdrawal."}},"required":["type","token","amount","isDeposit"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["borrowLend"]},"token":{"type":"string","description":"Token symbol (e.g., USDC)."},"operation":{"type":"string","enum":["supply","withdraw","repay","borrow"],"description":"Operation type."},"amount":{"type":"string","description":"Amount in the specified token.","pattern":"^[0-9]+(\\.[0-9]+)?$"},"interestAmount":{"type":"string","description":"Interest amount in the specified token.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","token","operation","amount","interestAmount"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["spotGenesis"]},"token":{"type":"string","description":"Token symbol (e.g., USDC)."},"amount":{"type":"string","description":"Amount in the specified token.","pattern":"^-?[0-9]+(\\.[0-9]+)?$"}},"required":["type","token","amount"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["activateDexAbstraction"]},"dex":{"type":"string","description":"DEX name (empty string for main dex)."},"token":{"type":"string","description":"Token symbol (e.g., USDC)."},"amount":{"type":"string","description":"Amount in the specified token.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","dex","token","amount"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","description":"Update type.","enum":["vaultLeaderCommission"]},"user":{"type":"string","description":"Address of the leader.","pattern":"^0x[a-fA-F0-9]{40}$"},"usdc":{"type":"string","description":"Amount earned in USDC.","pattern":"^[0-9]+(\\.[0-9]+)?$"}},"required":["type","user","usdc"],"additionalProperties":false}],"description":"Update details."}},"required":["time","hash","delta"],"additionalProperties":false},"description":"Array of user's non-funding ledger update."}}}},"422":{"description":"Failed to deserialize the JSON body into the target type","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"null"}}}}}}}}}
```