userLeverageUpdatesByTime

Paginate a user's leverage change history by time, oldest-first.

Returns leverage updates (updateLeverage actions) for a user with time ≥ startTime (or after a cursor), ordered oldest-first by time then tx_index.

For pagination: pass startTime for the first page, then on each subsequent page pass the cursor "{time}_{tx_index}" built from the last record of the previous response. When cursor is supplied, startTime is ignored and the boundary record is excluded from the next page (no duplicates).

New endpoint - this endpoint is not a part of original Hyperliquid API and is added by us for builder convenience.

This endpoint returns leverage changes only. The userLeverageUpdates WebSocket channel additionally interleaves isolated-margin records for backward compatibility — for that history, use userIsolatedMarginUpdatesByTime. Record shapes match the WS channel's, so REST history and the live stream can be merged and deduplicated on (time, tx_index).

POST Request

Field	Type	Description
type	string	Must be "userLeverageUpdatesByTime"
user	string	Ethereum address (0x-prefixed, 42 characters)
startTime	integer	Earliest time to include (Unix ms, inclusive). Skipped when cursor is used. Either startTime or cursor must be supplied
endTime	integer	Latest time to include (Unix ms, inclusive). Default: now (optional)
cursor	string	Composite of time and tx_index with "_" separator (e.g. "1734571490123_12"). Take from the last record of the previous response (optional)
limit	integer	Max results to return. Default 100, max 500 (optional)

cURL

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

# Next page — cursor built from the last record of the previous response
curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "userLeverageUpdatesByTime",
    "user": "0x0000000000000000000000000000000000000000",
    "cursor": "1734571490123_12",
    "limit": 100
  }'

Python

import requests
import os

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

params = {'type': 'userLeverageUpdatesByTime', 'user': user, 'startTime': 0, 'limit': limit}
while True:
    page = requests.post(url, json=params, headers=headers).json()
    if not page:
        break
    for update in page:
        ...  # process leverage update
    if len(page) < limit:
        break
    last = page[-1]
    params = {
        'type': 'userLeverageUpdatesByTime',
        'user': user,
        'cursor': f"{last['time']}_{last['tx_index']}",
        'limit': limit,
    }

Javascript

import axios from 'axios';

const url = 'https://api.hydromancer.xyz/info';
const headers = {
    'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
    'Content-Type': 'application/json',
};
const user = '0x0000000000000000000000000000000000000000';
const limit = 500;

let params = { type: 'userLeverageUpdatesByTime', user, startTime: 0, limit };
while (true) {
    const { data: page } = await axios.post(url, params, { headers });
    if (!page.length) break;
    for (const update of page) { /* process leverage update */ }
    if (page.length < limit) break;
    const last = page[page.length - 1];
    params = {
        type: 'userLeverageUpdatesByTime',
        user,
        cursor: `${last.time}_${last.tx_index}`,
        limit,
    };
}

---

Response Fields

JSON array of leverage update records, ordered oldest-first by time then tx_index.

Field	Type	Description
update_type	string	Always "leverage"
time	int	Block time when the update was made (Unix ms) — first half of the next-page cursor
user	string	Ethereum address
coin	string	Asset symbol
is_cross	boolean	true for cross margin, false for isolated margin
leverage	int	New leverage value
tx_index	int	Transaction index within the block — second half of the next-page cursor