userIsolatedMarginUpdatesByTime

Paginate a user's isolated margin update history by time, oldest-first.

Returns isolated margin updates (updateIsolatedMargin and topUpIsolatedOnlyMargin 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.

Record shapes match the userIsolatedMarginUpdates WebSocket channel, so REST history and the live stream can be merged and deduplicated on (time, tx_index). For leverage change history, see userLeverageUpdatesByTime.

POST Request

Field	Type	Description
type	string	Must be "userIsolatedMarginUpdatesByTime"
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": "userIsolatedMarginUpdatesByTime",
    "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": "userIsolatedMarginUpdatesByTime",
    "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': 'userIsolatedMarginUpdatesByTime', '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 isolated margin update
    if len(page) < limit:
        break
    last = page[-1]
    params = {
        'type': 'userIsolatedMarginUpdatesByTime',
        '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: 'userIsolatedMarginUpdatesByTime', 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 isolated margin update */ }
    if (page.length < limit) break;
    const last = page[page.length - 1];
    params = {
        type: 'userIsolatedMarginUpdatesByTime',
        user,
        cursor: `${last.time}_${last.tx_index}`,
        limit,
    };
}

---

Response Fields

JSON array of isolated margin update records, ordered oldest-first by time then tx_index. update_type selects one of two record shapes; fields the shape doesn't carry are omitted.

"isolated_margin" — margin added or removed (updateIsolatedMargin)

Field	Type	Description
update_type	string	"isolated_margin"
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_buy	boolean	Position side the margin change applies to
ntli	string	Notional transfer amount (USDC); positive adds margin, negative removes
tx_index	int	Transaction index within the block — second half of the next-page cursor

"top_up_isolated_margin" — margin topped up to a target leverage (topUpIsolatedOnlyMargin)

Field	Type	Description
update_type	string	"top_up_isolated_margin"
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
target_leverage	string	Leverage the margin top-up targets
tx_index	int	Transaction index within the block — second half of the next-page cursor