userNonFundingLedgerUpdates

Get a users' non funding ledger updates

Data available from 28-07-2025

POST Request

Field	Type	Description
type	string	Must be "userNonFundingLedgerUpdates"
user	string	Ethereum address (0x-prefixed, 42 characters)
startTime	int	Start time in ms (inclusive)
endTime	int	End time in ms (optional)

cURL

curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "userNonFundingLedgerUpdates",
    "user": "0x0000000000000000000000000000000000000000",
    "startTime": 0
  }'

Python

import requests
import os

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'userNonFundingLedgerUpdates',
        'user': '0x0000000000000000000000000000000000000000'
    },
    headers={
        'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}',
        'Content-Type': 'application/json'
    }
)

print(response.json())

Javascript

import axios from 'axios';

try {
    const response = await axios.post('https://api.hydromancer.xyz/info', {
        type: 'userNonFundingLedgerUpdates',
        user: '0x0000000000000000000000000000000000000000'
    }, {
        headers: {
            'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
            'Content-Type': 'application/json'
        }
    });

    console.log(response.data);
} catch (error) {
    console.error('Error:', error.message);
}

---

Response Fields

Field	Type	Description
time	int	Timestamp (ms)
hash	string	Transaction hash
delta	object	Ledger update details (fields vary by delta.type, see delta types below)
delta.type	string	Type of ledger update (e.g. "send", "deposit", "withdraw", "liquidation", etc.)
delta.amount	string	Transfer amount (present on most delta types)
delta.token	string	Token symbol
delta.usdc	string	USDC amount (used by some delta types instead of amount)
delta.usdcValue	string	USD value of the transfer
delta.user	string	Sender/source user address
delta.destination	string	Destination address
delta.destinationDex	string	Destination DEX (e.g. "spot")
delta.sourceDex	string	Source DEX (e.g. "spot")
delta.fee	string	Fee amount
delta.feeToken	string	Fee token symbol
delta.nativeTokenFee	string	Native token fee amount
delta.nonce	int	Transaction nonce (null if not applicable)

Response

[
    {
        "time": 1764256235694,
        "hash": "0xdc02464296095090dd7c04304bdac40205640028310c6f627fcaf195550d2a7b",
        "delta": {
            "amount": "0.00710881",
            "destination": "0x0000000000000000000000000000000000000000",
            "destinationDex": "spot",
            "fee": "",
            "feeToken": "",
            "nativeTokenFee": "",
            "nonce": null,
            "sourceDex": "spot",
            "token": "LIQUID",
            "type": "send",
            "usdcValue": "0.001473",
            "user": "0x9eff7b0c989f52003c0868b5353290d277196e6d"
        }
    }
]

All possible delta types

withdraw

{
  "type": "withdraw",
  "usdc": "1000.0",
  "nonce": 12345,
  "fee": "1.5"
}

deposit

{
  "type": "deposit",
  "usdc": "1000.0"
}

vaultCreate

{
  "type": "vaultCreate",
  "vault": "0x...",
  "usdc": "10000.0",
  "fee": "10.0"
}

vaultDeposit

{
  "type": "vaultDeposit",
  "vault": "0x...",
  "usdc": "5000.0"
}

vaultWithdraw

{
  "type": "vaultWithdraw",
  "vault": "0x...",
  "user": "0x...",
  "requestedUsd": "1000.0",
  "commission": "10.0",
  "closingCost": "5.0",
  "basis": "995.0",
  "netWithdrawnUsd": "985.0"
}

vaultDistribution

{
  "type": "vaultDistribution",
  "vault": "0x...",
  "usdc": "100.0"
}

vaultLeaderCommission

{
  "type": "vaultLeaderCommission",
  "user": "0x...",
  "usdc": "50.0"
}

liquidation

{
  "type": "liquidation",
  "liquidatedNtlPos": "10000.0",
  "accountValue": "-500.0",
  "leverageType": "Cross",
  "liquidatedPositions": [
    {
      "coin": "ETH",
      "szi": "-5.0"
    }
  ]
}

internalTransfer

{
  "type": "internalTransfer",
  "usdc": "1000.0",
  "user": "0x...",
  "destination": "0x...",
  "fee": "0.0"
}

subAccountTransfer

{
  "type": "subAccountTransfer",
  "usdc": "500.0",
  "user": "0x...",
  "destination": "0x..."
}

spotTransfer

{
  "type": "spotTransfer",
  "token": "USDC",
  "amount": "1000.0",
  "usdcValue": "1000.0",
  "user": "0x...",
  "destination": "0x...",
  "fee": "1.5",
  "nativeTokenFee": "0.1",
  "nonce": 12345,
  "feeToken": "USDC"
}

spotGenesis

{
  "type": "spotGenesis",
  "token": "HYPE",
  "amount": "1000000.0"
}

rewardsClaim

{
  "type": "rewardsClaim",
  "amount": "100.0",
  "token": "USDC"
}

accountClassTransfer

{
  "type": "accountClassTransfer",
  "usdc": "1000.0",
  "toPerp": true
}

accountActivationGas

{
  "type": "accountActivationGas",
  "amount": "0.1",
  "token": "ETH"
}

perpDexClassTransfer

{
  "type": "perpDexClassTransfer",
  "amount": "1000.0",
  "token": "USDC",
  "dex": "hyperliquid",
  "toPerp": true
}

deployGasAuction

{
  "type": "deployGasAuction",
  "token": "ETH",
  "amount": "0.5"
}

cStakingTransfer

{
  "type": "cStakingTransfer",
  "amount": "1000.0",
  "isDeposit": true,
  "token": "HYPE"
}

send

{
  "type": "send",
  "amount": "100.0",
  "destination": "0x...",
  "destinationDex": "",
  "fee": "1.0",
  "feeToken": "USDC",
  "nativeTokenFee": "0.1",
  "nonce": 12345,
  "sourceDex": "",
  "token": "USDC",
  "usdcValue": "100.0",
  "user": "0x..."
}

activateDexAbstraction

{
  "type": "activateDexAbstraction",
  "dex": "hyperliquid",
  "token": "USDC",
  "amount": "10.0"
}

borrowLend

{
  "type": "borrowLend",
  "token": "USDC",
  "operation": "supply",
  "amount": "5000.0",
  "interestAmount": "12.5"
}

borrowLendBackstopLiquidation

{
  "type": "borrowLendBackstopLiquidation",
  "token": "USDC",
  "balanceChange": "-500.0"
}