@tria-sdk/hyperliquid-core 0.1.0 → 6.44.0-beta

package/dist/api.js

@@ -12,6 +12,64 @@ const CANDLE_LOOKBACK = 200;
 // ============================================================================
 // Helper Functions
 // ============================================================================
+/**
+ * Maps a raw asset position entry to a typed HyperliquidPosition.
+ * Shared between fetchUserPositions and fetchUserState to avoid duplication.
+ */
+const mapRawAssetPositionToPosition = (entry) => {
+    const pos = entry.position;
+    const posLeverage = pos.leverage;
+    const leverageObj = typeof posLeverage === "number"
+        ? { value: posLeverage, type: undefined }
+        : posLeverage || entry.leverage;
+    const leverageType = leverageObj?.type;
+    const isCross = leverageType === "cross" || (!leverageType && true);
+    return {
+        coin: pos.coin ?? "",
+        szi: pos.szi ?? "0",
+        entryPx: pos.entryPx || "0",
+        positionValue: pos.positionValue || "0",
+        unrealizedPnl: pos.unrealizedPnl || "0",
+        returnOnEquity: pos.returnOnEquity || "0",
+        liquidationPx: pos.liquidationPx || null,
+        marginUsed: pos.marginUsed || "0",
+        leverage: leverageObj?.value || 1,
+        isCross,
+    };
+};
+/**
+ * Maps a raw user fill entry to a typed HyperliquidUserFill.
+ * Shared between fetchUserFills and fetchUserFillsByTime to avoid duplication.
+ */
+const mapRawUserFill = (fill) => ({
+    coin: String(fill.coin ?? ""),
+    px: String(fill.px ?? fill.price ?? "0"),
+    sz: String(fill.sz ?? fill.size ?? "0"),
+    side: String(fill.side ?? ""),
+    time: Number(fill.time ?? Date.now()),
+    fee: fill.fee ? String(fill.fee) : undefined,
+    feeToken: fill.feeToken ? String(fill.feeToken) : undefined,
+    hash: fill.hash ? String(fill.hash) : undefined,
+    oid: typeof fill.oid === "number" ? fill.oid : undefined,
+    tid: typeof fill.tid === "number" ? fill.tid : undefined,
+    cloid: fill.cloid ? String(fill.cloid) : undefined,
+    startPosition: fill.startPosition ? String(fill.startPosition) : undefined,
+    dir: fill.dir ? String(fill.dir) : undefined,
+    closedPnl: fill.closedPnl ? String(fill.closedPnl) : undefined,
+    crossed: typeof fill.crossed === "boolean" ? fill.crossed : undefined,
+    liquidation: fill.liquidation ?? undefined,
+    twapId: typeof fill.twapId === "number" ? fill.twapId : undefined,
+});
+/**
+ * Filters raw asset position entries to only include non-zero positions.
+ */
+const filterNonZeroPositions = (entry) => {
+    const pos = entry?.position;
+    if (!pos)
+        return false;
+    const size = parseFloat(pos.szi || "0");
+    return size !== 0;
+};
 const ensureSpotSymbol = (symbol) => {
     const trimmed = symbol?.trim();
     if (!trimmed) {
@@ -122,7 +180,7 @@ const pickValidPrice = (...values) => {
             return value;
         }
     }
-    return "0";
+    return null;
 };
 // ============================================================================
 // Public API Functions
@@ -131,495 +189,494 @@ const pickValidPrice = (...values) => {
  * Retrieves raw spot metadata from Hyperliquid public API
  */
 export async function fetchSpotMeta(network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        return await client.spotMeta();
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    return client.spotMeta();
 }
 /**
  * Fetches token details for a specific token
  */
 export async function fetchTokenDetails(tokenId, network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const details = await client.tokenDetails({ tokenId });
-        return {
-            name: details.name,
-            maxSupply: details.maxSupply,
-            totalSupply: details.totalSupply,
-            circulatingSupply: details.circulatingSupply,
-            szDecimals: details.szDecimals,
-            weiDecimals: details.weiDecimals,
-            genesis: details.genesis,
-            deployer: details.deployer || undefined,
-            deployGas: details.deployGas || undefined,
-            deployTime: details.deployTime || undefined,
-            seededUsdc: details.seededUsdc,
-            futureEmissions: details.futureEmissions,
-        };
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    const details = await client.tokenDetails({ tokenId });
+    return {
+        name: details.name,
+        maxSupply: details.maxSupply,
+        totalSupply: details.totalSupply,
+        circulatingSupply: details.circulatingSupply,
+        szDecimals: details.szDecimals,
+        weiDecimals: details.weiDecimals,
+        genesis: details.genesis,
+        deployer: details.deployer || undefined,
+        deployGas: details.deployGas || undefined,
+        deployTime: details.deployTime || undefined,
+        seededUsdc: details.seededUsdc,
+        futureEmissions: details.futureEmissions,
+    };
 }
 /**
  * Fetches all mid prices
  */
 export async function fetchAllMids(network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        return await client.allMids();
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    return client.allMids();
 }
 /**
  * Fetches spot metadata and asset contexts
  */
 export async function fetchSpotMetaAndAssetCtxs(network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        return await client.spotMetaAndAssetCtxs();
+    const client = getHyperliquidInfoClient(network);
+    return client.spotMetaAndAssetCtxs();
+}
+/**
+ * Remaps token symbol for display purposes.
+ * Tokens with fullName starting with "Unit " are Unit tokens (e.g., UBTC → BTC)
+ * These are wrapped versions on HyperCore, but should display as the underlying asset.
+ */
+function getDisplayName(symbol, fullName) {
+    // If fullName starts with "Unit ", this is a Unit token
+    // Remove the "U" prefix from the symbol for display (UBTC → BTC, UETH → ETH)
+    if (fullName?.startsWith("Unit ") && symbol.startsWith("U")) {
+        return symbol.slice(1);
     }
-    catch (error) {
-        throw error;
+    return symbol;
+}
+/**
+ * Normalizes quote token names for display.
+ * Hyperliquid uses versioned tokens (e.g., USDT0) but we want to display them as USDT.
+ */
+function normalizeQuoteToken(symbol) {
+    // USDT0 → USDT (Hyperliquid's versioned USDT)
+    if (symbol === "USDT0") {
+        return "USDT";
     }
+    return symbol;
 }
 /**
  * Fetches spot tokens with market data
  */
 export async function fetchSpotTokensWithMarketData(network = "testnet") {
-    try {
-        const [[spotMeta, spotCtxs], allMids] = await Promise.all([
-            fetchSpotMetaAndAssetCtxs(network),
-            fetchAllMids(network),
-        ]);
-        if (!spotMeta?.tokens || !Array.isArray(spotCtxs)) {
-            return [];
-        }
-        return spotMeta.tokens
-            .map((token, index) => {
-            const assetCtx = spotCtxs[index];
-            const currentPrice = pickValidPrice(allMids[token.name], assetCtx?.midPx, assetCtx?.markPx);
-            const lastPrice = pickValidPrice(assetCtx?.markPx, assetCtx?.midPx, assetCtx?.prevDayPx, allMids[token.name]);
-            let change24h = "0.00";
-            if (assetCtx?.prevDayPx) {
-                const prevPx = parseFloat(assetCtx.prevDayPx);
-                const nowPx = parseFloat(currentPrice);
-                if (prevPx > 0 && Number.isFinite(nowPx)) {
-                    change24h = (((nowPx - prevPx) / prevPx) * 100).toFixed(2);
-                }
-            }
-            return {
-                name: token.name,
-                szDecimals: token.szDecimals,
-                fullName: token.fullName || undefined,
-                price: currentPrice,
-                lastPrice,
-                midPrice: assetCtx?.midPx,
-                markPrice: assetCtx?.markPx,
-                change24h,
-                volume24h: assetCtx?.dayBaseVlm || "0",
-                circulatingSupply: assetCtx?.circulatingSupply || "0",
-            };
-        })
-            .filter((token) => {
-            const price = parseFloat(token.price || "0");
-            const volume = parseFloat(token.volume24h || "0");
-            return Number.isFinite(price) && price > 0 && volume > 0;
-        });
+    const [[spotMeta, spotCtxs], allMids] = await Promise.all([
+        fetchSpotMetaAndAssetCtxs(network),
+        fetchAllMids(network),
+    ]);
+    if (!spotMeta?.tokens || !Array.isArray(spotCtxs)) {
+        return [];
     }
-    catch (error) {
-        throw error;
+    return spotMeta.tokens
+        .map((token, index) => {
+        const assetCtx = spotCtxs[index];
+        const currentPrice = pickValidPrice(allMids[token.name], assetCtx?.midPx, assetCtx?.markPx);
+        const lastPrice = pickValidPrice(assetCtx?.markPx, assetCtx?.midPx, assetCtx?.prevDayPx, allMids[token.name]);
+        let change24h = null;
+        if (assetCtx?.prevDayPx && currentPrice) {
+            const prevPx = parseFloat(assetCtx.prevDayPx);
+            const nowPx = parseFloat(currentPrice);
+            if (prevPx > 0 && Number.isFinite(nowPx) && nowPx > 0) {
+                change24h = (((nowPx - prevPx) / prevPx) * 100).toFixed(2);
+            }
+        }
+        return {
+            name: token.name,
+            szDecimals: token.szDecimals,
+            fullName: token.fullName || undefined,
+            price: currentPrice,
+            lastPrice,
+            midPrice: assetCtx?.midPx ?? null,
+            markPrice: assetCtx?.markPx ?? null,
+            change24h,
+            volume24h: assetCtx?.dayBaseVlm ?? null,
+            circulatingSupply: assetCtx?.circulatingSupply ?? null,
+        };
+    })
+        .filter((token) => {
+        const price = parseFloat(token.price || "0");
+        const volume = parseFloat(token.volume24h || "0");
+        return Number.isFinite(price) && price > 0 && volume > 0;
+    });
+}
+/**
+ * Fetches spot trading pairs with market data using universe pairs
+ * This properly aligns pair data with asset contexts using pair.index
+ *
+ * Important: spotCtxs is indexed by pair.index (from universe), NOT by array position
+ * Each pair in universe has an 'index' field that corresponds to spotCtxs[index]
+ */
+export async function fetchSpotPairsWithMarketData(network = "testnet") {
+    const [spotMeta, spotCtxs] = await fetchSpotMetaAndAssetCtxs(network);
+    if (!spotMeta?.universe || !spotMeta?.tokens || !Array.isArray(spotCtxs)) {
+        return [];
     }
+    // Create a token lookup by token index
+    const tokensByIndex = new Map();
+    spotMeta.tokens.forEach((token) => {
+        if (token.index !== undefined) {
+            tokensByIndex.set(token.index, token);
+        }
+    });
+    return spotMeta.universe
+        .map((pair) => {
+        // CRITICAL: Use pair.index to access spotCtxs, NOT array position
+        const pairIndex = pair.index;
+        const assetCtx = spotCtxs[pairIndex];
+        // Extract base and quote token indices from the pair
+        // tokens array is [baseTokenIndex, quoteTokenIndex]
+        const [baseTokenIndex, quoteTokenIndex] = pair.tokens || [];
+        const baseToken = tokensByIndex.get(baseTokenIndex);
+        const quoteToken = tokensByIndex.get(quoteTokenIndex);
+        if (!baseToken) {
+            return null;
+        }
+        const baseTokenName = baseToken.name;
+        const rawQuoteTokenName = (quoteToken?.name || "USDC");
+        // Normalize quote token for display (e.g., USDT0 → USDT)
+        const quoteTokenName = normalizeQuoteToken(rawQuoteTokenName);
+        const baseFullName = baseToken.fullName;
+        // Get display name (remaps Unit tokens like UBTC → BTC)
+        const displayName = getDisplayName(baseTokenName, baseFullName);
+        // Use pair name from API (e.g., "PURR/USDC" or "@1" for non-canonical)
+        // This is the identifier needed for API calls like l2Book and trades
+        const pairName = pair.name;
+        // Construct the API coin identifier:
+        // - For PURR (canonical pair with USDC), use "PURR/USDC"
+        // - For all other spot tokens, use the @{index} format
+        // NOTE: Use raw quote token name for API calls (USDT0 not USDT)
+        const apiCoin = pairName.startsWith("@")
+            ? pairName
+            : `${baseTokenName}/${rawQuoteTokenName}`;
+        // For display, construct a readable pair name using remapped display name
+        const displayPairName = `${displayName}/${quoteTokenName}`;
+        // Price data comes directly from assetCtx which is aligned by pair.index
+        const midPrice = assetCtx?.midPx ?? null;
+        const markPrice = assetCtx?.markPx ?? null;
+        const prevDayPrice = assetCtx?.prevDayPx ?? null;
+        // Use assetCtx prices as primary source (they are properly aligned)
+        const currentPrice = pickValidPrice(midPrice, markPrice);
+        const lastPrice = pickValidPrice(markPrice, midPrice, prevDayPrice);
+        // Calculate 24h change only if we have valid prices
+        let change24h = null;
+        if (prevDayPrice && currentPrice) {
+            const prevPx = parseFloat(prevDayPrice);
+            const nowPx = parseFloat(currentPrice);
+            if (prevPx > 0 && Number.isFinite(nowPx) && nowPx > 0) {
+                change24h = (((nowPx - prevPx) / prevPx) * 100).toFixed(2);
+            }
+        }
+        // Volume - return null if no data
+        const volume24h = assetCtx?.dayNtlVlm ?? null;
+        // Market cap - requires circulating supply which isn't in bulk API
+        // Will be null until we have circulating supply data
+        const marketCap = null;
+        // Token ID (hex address) and index for explorer links
+        const tokenId = baseToken.tokenId;
+        const tokenIndex = baseToken.index;
+        return {
+            pairName: displayPairName,
+            apiCoin,
+            baseToken: baseTokenName,
+            displayName,
+            // Return raw quote token name for API calls (USDT0, not USDT)
+            quoteToken: rawQuoteTokenName,
+            szDecimals: baseToken.szDecimals,
+            fullName: baseFullName,
+            price: currentPrice,
+            lastPrice,
+            midPrice,
+            markPrice,
+            change24h,
+            volume24h,
+            marketCap,
+            isCanonical: pair.isCanonical,
+            tokenId,
+            index: tokenIndex,
+        };
+    })
+        .filter((pair) => {
+        return pair !== null;
+    });
 }
 /**
  * Fetches spot order book for a token
  */
 export async function fetchSpotOrderBook(tokenName, network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const coin = ensureSpotSymbol(tokenName);
-        return await client.l2Book({ coin });
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    const coin = ensureSpotSymbol(tokenName);
+    return client.l2Book({ coin });
 }
 /**
  * Fetches order book snapshot with normalized levels
  */
 export async function fetchOrderBook(symbol, depth = 25, network = "testnet") {
     const { coin, market } = parseSymbolForBook(symbol);
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const response = (await client.l2Book({ coin }));
-        const levels = Array.isArray(response?.levels)
-            ? response.levels
-            : [];
-        const [rawBids = [], rawAsks = []] = levels;
-        const bids = normalizeOrderBookLevels(rawBids, depth);
-        const asks = normalizeOrderBookLevels(rawAsks, depth);
-        const bestBid = bids[0]?.price ?? null;
-        const bestAsk = asks[0]?.price ?? null;
-        const midPrice = bestBid !== null && bestAsk !== null
-            ? (bestBid + bestAsk) / 2
-            : bestBid ?? bestAsk ?? null;
-        const spread = bestBid !== null && bestAsk !== null
-            ? Math.max(bestAsk - bestBid, 0)
-            : null;
-        return {
-            symbol,
-            coin,
-            market,
-            bids,
-            asks,
-            bestBid,
-            bestAsk,
-            midPrice,
-            spread,
-            lastUpdated: typeof response?.time === "number" ? response.time : Date.now(),
-        };
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    const response = (await client.l2Book({ coin }));
+    const levels = Array.isArray(response?.levels)
+        ? response.levels
+        : [];
+    const [rawBids = [], rawAsks = []] = levels;
+    const bids = normalizeOrderBookLevels(rawBids, depth);
+    const asks = normalizeOrderBookLevels(rawAsks, depth);
+    const bestBid = bids[0]?.price ?? null;
+    const bestAsk = asks[0]?.price ?? null;
+    const midPrice = bestBid !== null && bestAsk !== null
+        ? (bestBid + bestAsk) / 2
+        : bestBid ?? bestAsk ?? null;
+    const spread = bestBid !== null && bestAsk !== null
+        ? Math.max(bestAsk - bestBid, 0)
+        : null;
+    return {
+        symbol,
+        coin,
+        market,
+        bids,
+        asks,
+        bestBid,
+        bestAsk,
+        midPrice,
+        spread,
+        lastUpdated: typeof response?.time === "number" ? response.time : Date.now(),
+    };
 }
 /**
  * Fetches recent trades for a coin
  */
 export async function fetchRecentTrades(coin, limit = 20, network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const anyClient = client;
-        let trades = [];
-        if (typeof anyClient.tradesSnapshot === "function") {
-            trades = await anyClient.tradesSnapshot({ coin, limit });
-        }
-        else if (typeof anyClient.trades === "function") {
-            trades = await anyClient.trades({ coin, limit });
-        }
-        else if (typeof anyClient.tradeHistory === "function") {
-            trades = await anyClient.tradeHistory({ coin, limit });
-        }
-        else if (typeof anyClient.recentTrades === "function") {
-            trades = await anyClient.recentTrades({ coin, limit });
-        }
-        return trades.map((trade) => {
-            const price = trade.p ?? trade.px ?? "0";
-            const size = trade.s ?? trade.sz ?? "0";
-            const timestamp = trade.time ?? Date.now();
-            return {
-                price: String(price),
-                size: String(size),
-                side: typeof trade.side === "string" ? trade.side : undefined,
-                time: typeof timestamp === "number"
-                    ? timestamp
-                    : Number(timestamp) || Date.now(),
-            };
-        });
-    }
-    catch (error) {
-        return [];
+    const transport = getHyperliquidTransport(network);
+    const trades = await transport.request("info", {
+        type: "recentTrades",
+        coin,
+        limit,
+    });
+    if (!Array.isArray(trades)) {
+        throw new Error(`Unexpected API response for recentTrades: expected array, got ${typeof trades}`);
     }
+    return trades.map((trade) => {
+        const price = trade.px ?? trade.p ?? "0";
+        const size = trade.sz ?? trade.s ?? "0";
+        const timestamp = trade.time ?? Date.now();
+        return {
+            price: String(price),
+            size: String(size),
+            side: typeof trade.side === "string" ? trade.side : undefined,
+            time: typeof timestamp === "number"
+                ? timestamp
+                : Number(timestamp) || Date.now(),
+        };
+    });
 }
 /**
  * Fetches perp metadata
  */
 export async function fetchPerpMeta(network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        return await client.meta();
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    return client.meta();
 }
 /**
  * Fetches perp metadata and asset contexts
  */
 export async function fetchPerpMetaAndAssetCtxs(network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        return await client.metaAndAssetCtxs();
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    return client.metaAndAssetCtxs();
 }
 /**
  * Fetches funding history for a coin
  */
 export async function fetchFundingHistory(coin, startTime, network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        return await client.fundingHistory({ coin, startTime });
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    return client.fundingHistory({ coin, startTime });
 }
 /**
  * Fetches user fills (trade history)
  */
 export async function fetchUserFills(params) {
     const { user, aggregateByTime = false, limit = 100, network = "testnet", } = params;
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const payload = { user, aggregateByTime };
-        let fills = [];
-        if (typeof client.userFills === "function") {
-            fills = await client.userFills(payload);
-        }
-        else if (typeof client.userFillsByTime === "function") {
-            const now = Date.now();
-            fills = await client.userFillsByTime({
-                ...payload,
-                startTime: now - 30 * 24 * 60 * 60 * 1000,
-                endTime: now,
-            });
-        }
-        return Array.isArray(fills)
-            ? fills.slice(0, limit).map((fill) => ({
-                coin: String(fill.coin ?? ""),
-                px: String(fill.px ?? fill.price ?? "0"),
-                sz: String(fill.sz ?? fill.size ?? "0"),
-                side: fill.side ?? "",
-                time: Number(fill.time ?? Date.now()),
-                fee: fill.fee ? String(fill.fee) : undefined,
-                feeToken: fill.feeToken ? String(fill.feeToken) : undefined,
-                hash: fill.hash ? String(fill.hash) : undefined,
-                oid: typeof fill.oid === "number" ? fill.oid : undefined,
-                tid: typeof fill.tid === "number" ? fill.tid : undefined,
-                cloid: fill.cloid ? String(fill.cloid) : undefined,
-                startPosition: fill.startPosition
-                    ? String(fill.startPosition)
-                    : undefined,
-                dir: fill.dir ? String(fill.dir) : undefined,
-                closedPnl: fill.closedPnl ? String(fill.closedPnl) : undefined,
-                crossed: typeof fill.crossed === "boolean" ? fill.crossed : undefined,
-                liquidation: fill.liquidation,
-                twapId: typeof fill.twapId === "number" ? fill.twapId : undefined,
-            }))
-            : [];
-    }
-    catch (error) {
-        return [];
+    const transport = getHyperliquidTransport(network);
+    const now = Date.now();
+    const fills = await transport.request("info", {
+        type: "userFillsByTime",
+        user,
+        aggregateByTime,
+        startTime: now - 30 * 24 * 60 * 60 * 1000,
+        endTime: now,
+    });
+    if (!Array.isArray(fills)) {
+        throw new Error(`Unexpected API response for userFillsByTime: expected array, got ${typeof fills}`);
     }
+    return fills.slice(0, limit).map(mapRawUserFill);
 }
 /**
  * Fetches user fills within a time window (order history)
  */
 export async function fetchUserFillsByTime(params) {
     const { user, startTime, endTime = Date.now(), aggregateByTime = true, limit = 200, network = "testnet", } = params;
-    try {
-        const client = getHyperliquidInfoClient(network);
-        let fills = [];
-        if (typeof client.userFillsByTime === "function") {
-            fills = await client.userFillsByTime({
-                user,
-                startTime,
-                endTime,
-                aggregateByTime,
-            });
-        }
-        else if (typeof client.userFills === "function") {
-            fills = await client.userFills({ user, aggregateByTime });
-        }
-        return Array.isArray(fills)
-            ? fills
-                .filter((fill) => {
-                const t = Number(fill.time ?? 0);
-                return t >= startTime && t <= endTime;
-            })
-                .slice(0, limit)
-                .map((fill) => ({
-                coin: String(fill.coin ?? ""),
-                px: String(fill.px ?? fill.price ?? "0"),
-                sz: String(fill.sz ?? fill.size ?? "0"),
-                side: fill.side ?? "",
-                time: Number(fill.time ?? Date.now()),
-                fee: fill.fee ? String(fill.fee) : undefined,
-                feeToken: fill.feeToken ? String(fill.feeToken) : undefined,
-                hash: fill.hash ? String(fill.hash) : undefined,
-                oid: typeof fill.oid === "number" ? fill.oid : undefined,
-                tid: typeof fill.tid === "number" ? fill.tid : undefined,
-                cloid: fill.cloid ? String(fill.cloid) : undefined,
-                startPosition: fill.startPosition
-                    ? String(fill.startPosition)
-                    : undefined,
-                dir: fill.dir ? String(fill.dir) : undefined,
-                closedPnl: fill.closedPnl ? String(fill.closedPnl) : undefined,
-                crossed: typeof fill.crossed === "boolean" ? fill.crossed : undefined,
-                liquidation: fill.liquidation,
-                twapId: typeof fill.twapId === "number" ? fill.twapId : undefined,
-            }))
-            : [];
-    }
-    catch (error) {
-        return [];
-    }
+    const transport = getHyperliquidTransport(network);
+    const fills = await transport.request("info", {
+        type: "userFillsByTime",
+        user,
+        startTime,
+        endTime,
+        aggregateByTime,
+    });
+    if (!Array.isArray(fills)) {
+        throw new Error(`Unexpected API response for userFillsByTime: expected array, got ${typeof fills}`);
+    }
+    return fills
+        .filter((fill) => {
+        const t = Number(fill.time ?? 0);
+        return t >= startTime && t <= endTime;
+    })
+        .slice(0, limit)
+        .map(mapRawUserFill);
 }
 /**
  * Fetches user funding ledger updates
  */
 export async function fetchUserFunding(params) {
     const { user, startTime, endTime = null, limit = 200, network = "testnet", } = params;
-    try {
-        const client = getHyperliquidInfoClient(network);
-        let updates = [];
-        if (typeof client.userFunding === "function") {
-            updates = await client.userFunding({ user, startTime, endTime });
-        }
-        return Array.isArray(updates)
-            ? updates.slice(0, limit).map((update) => ({
-                time: Number(update.time ?? Date.now()),
-                hash: update.hash ? String(update.hash) : undefined,
-                delta: update.delta,
-            }))
-            : [];
-    }
-    catch (error) {
-        return [];
-    }
+    const transport = getHyperliquidTransport(network);
+    const updates = await transport.request("info", {
+        type: "userFunding",
+        user,
+        startTime,
+        endTime,
+    });
+    if (!Array.isArray(updates)) {
+        throw new Error(`Unexpected API response for userFunding: expected array, got ${typeof updates}`);
+    }
+    return updates.slice(0, limit).map((update) => ({
+        time: Number(update.time ?? Date.now()),
+        hash: update.hash ? String(update.hash) : undefined,
+        delta: {
+            type: "funding",
+            coin: update.delta?.coin ?? "",
+            usdc: update.delta?.usdc ?? "0",
+            szi: update.delta?.szi ?? "0",
+            fundingRate: update.delta?.fundingRate ?? "0",
+            nSamples: update.delta?.nSamples ?? 0,
+        },
+    }));
 }
 /**
  * Fetches user non-funding ledger updates (deposits, withdrawals, transfers)
  */
 export async function fetchUserNonFundingLedgerUpdates(params) {
     const { user, startTime, endTime = null, limit = 200, network = "testnet", } = params;
-    try {
-        const client = getHyperliquidInfoClient(network);
-        let updates = [];
-        if (typeof client.userNonFundingLedgerUpdates === "function") {
-            updates = await client.userNonFundingLedgerUpdates({
-                user,
-                startTime,
-                endTime,
-            });
-        }
-        return Array.isArray(updates)
-            ? updates.slice(0, limit).map((update) => ({
-                time: Number(update.time ?? Date.now()),
-                hash: update.hash ? String(update.hash) : undefined,
-                delta: update.delta,
-            }))
-            : [];
-    }
-    catch (error) {
-        return [];
-    }
+    const transport = getHyperliquidTransport(network);
+    const updates = await transport.request("info", {
+        type: "userNonFundingLedgerUpdates",
+        user,
+        startTime,
+        endTime,
+    });
+    if (!Array.isArray(updates)) {
+        throw new Error(`Unexpected API response for userNonFundingLedgerUpdates: expected array, got ${typeof updates}`);
+    }
+    return updates.slice(0, limit).map((update) => ({
+        time: Number(update.time ?? Date.now()),
+        hash: update.hash ? String(update.hash) : undefined,
+        delta: update.delta ?? { type: "" },
+    }));
 }
 /**
  * Fetches perps with market data
  */
 export async function fetchPerpsWithMarketData(network = "testnet") {
-    try {
-        const [[perpMeta, perpCtxs], allMids] = await Promise.all([
-            fetchPerpMetaAndAssetCtxs(network),
-            fetchAllMids(network),
-        ]);
-        if (!perpMeta?.universe || !Array.isArray(perpCtxs)) {
-            return [];
-        }
-        return perpMeta.universe.map((asset, index) => {
-            const assetCtx = perpCtxs[index];
-            const midPrice = allMids[asset.name] || "0";
-            let change24h = "0.00";
-            if (assetCtx?.prevDayPx && assetCtx?.midPx) {
-                const prev = parseFloat(assetCtx.prevDayPx);
-                const current = parseFloat(assetCtx.midPx);
-                if (prev > 0) {
-                    change24h = (((current - prev) / prev) * 100).toFixed(2);
-                }
-            }
-            const fundingRate = assetCtx?.funding
-                ? (parseFloat(assetCtx.funding) * 8 * 100).toFixed(4)
-                : "0.0000";
-            const now = Date.now();
-            const eightHours = 8 * 60 * 60 * 1000;
-            const nextFunding = Math.ceil(now / eightHours) * eightHours;
-            const hoursUntil = Math.max(0, Math.round((nextFunding - now) / (60 * 60 * 1000)));
-            const anyAsset = asset;
-            const anyCtx = assetCtx;
-            const levFromMeta = typeof anyAsset?.maxLeverage === "number"
-                ? anyAsset.maxLeverage
-                : typeof anyAsset?.maxLev === "number"
-                    ? anyAsset.maxLev
-                    : undefined;
-            const levFromCtx = typeof anyCtx?.risk?.maxLev === "number"
-                ? anyCtx.risk.maxLev
-                : typeof anyCtx?.maxLeverage === "number"
-                    ? anyCtx.maxLeverage
-                    : undefined;
-            const maxLeverage = levFromMeta ?? levFromCtx ?? 10;
-            const rawOi = parseFloat(assetCtx?.openInterest || "0");
-            const markPx = assetCtx?.markPx ?? assetCtx?.midPx ?? midPrice;
-            const markValue = parseFloat(String(markPx) || "0");
-            const openInterest = Number.isFinite(rawOi) && Number.isFinite(markValue)
-                ? (rawOi * markValue).toString()
-                : assetCtx?.openInterest || "0";
-            return {
-                name: asset.name,
-                price: midPrice,
-                change24h,
-                volume24h: assetCtx?.dayNtlVlm || "0",
-                openInterest,
-                fundingRate: `${fundingRate}%`,
-                nextFunding: `${hoursUntil}h`,
-                maxLeverage,
-            };
-        });
-    }
-    catch (error) {
-        throw error;
+    const [[perpMeta, perpCtxs], allMids] = await Promise.all([
+        fetchPerpMetaAndAssetCtxs(network),
+        fetchAllMids(network),
+    ]);
+    if (!perpMeta?.universe || !Array.isArray(perpCtxs)) {
+        return [];
     }
+    return perpMeta.universe.map((asset, index) => {
+        const assetCtx = perpCtxs[index];
+        const midPrice = allMids[asset.name] || "0";
+        let change24h = "0.00";
+        if (assetCtx?.prevDayPx && assetCtx?.midPx) {
+            const prev = parseFloat(assetCtx.prevDayPx);
+            const current = parseFloat(assetCtx.midPx);
+            if (prev > 0) {
+                change24h = (((current - prev) / prev) * 100).toFixed(2);
+            }
+        }
+        // The funding field from the API is the 8-hour rate as a decimal.
+        // Multiply by 100 to convert to percentage (e.g., 0.000013 -> 0.0013%)
+        const fundingRate = assetCtx?.funding
+            ? (parseFloat(assetCtx.funding) * 100).toFixed(4)
+            : "0.0000";
+        const now = Date.now();
+        const eightHours = 8 * 60 * 60 * 1000;
+        const nextFunding = Math.ceil(now / eightHours) * eightHours;
+        const hoursUntil = Math.max(0, Math.round((nextFunding - now) / (60 * 60 * 1000)));
+        const levFromMeta = typeof asset?.maxLeverage === "number" ? asset.maxLeverage : undefined;
+        const levFromCtx = typeof assetCtx?.risk?.maxLev === "number"
+            ? assetCtx.risk.maxLev
+            : typeof assetCtx?.maxLeverage === "number"
+                ? assetCtx.maxLeverage
+                : undefined;
+        const maxLeverage = levFromMeta ?? levFromCtx ?? 10;
+        const rawOi = parseFloat(assetCtx?.openInterest || "0");
+        const markPx = assetCtx?.markPx ?? assetCtx?.midPx ?? midPrice;
+        const markValue = parseFloat(String(markPx) || "0");
+        const openInterest = Number.isFinite(rawOi) && Number.isFinite(markValue)
+            ? (rawOi * markValue).toString()
+            : assetCtx?.openInterest || "0";
+        return {
+            name: asset.name,
+            price: midPrice,
+            change24h,
+            volume24h: assetCtx?.dayNtlVlm || "0",
+            openInterest,
+            fundingRate: `${fundingRate}%`,
+            nextFunding: `${hoursUntil}h`,
+            maxLeverage,
+            szDecimals: asset.szDecimals ?? 0,
+        };
+    });
 }
 /**
  * Fetches candlestick data
  */
 export async function fetchCandlesticks(params) {
     const { coin, interval, startTime, endTime, network = "testnet" } = params;
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const now = Date.now();
-        const fromTime = startTime ?? now - CANDLE_LOOKBACK * intervalToMs(interval);
-        const toTime = endTime ?? now;
-        const candles = await client.candleSnapshot({
-            coin,
-            interval,
-            startTime: fromTime,
-            endTime: toTime,
-        });
-        if (!Array.isArray(candles) || candles.length === 0) {
-            throw new Error(`No candlestick data for ${coin}`);
-        }
-        return candles
-            .sort((a, b) => a.t - b.t)
-            .map((candle) => ({
-            time: Math.floor(candle.t / 1000),
-            open: parseFloat(candle.o),
-            high: parseFloat(candle.h),
-            low: parseFloat(candle.l),
-            close: parseFloat(candle.c),
-            volume: parseFloat(candle.v || "0"),
-        }))
-            .filter((candle, index, arr) => index === 0 ? true : candle.time > arr[index - 1].time);
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    const now = Date.now();
+    const fromTime = startTime ?? now - CANDLE_LOOKBACK * intervalToMs(interval);
+    const toTime = endTime ?? now;
+    const candles = await client.candleSnapshot({
+        coin,
+        interval,
+        startTime: fromTime,
+        endTime: toTime,
+    });
+    if (!Array.isArray(candles) || candles.length === 0) {
+        throw new Error(`No candlestick data for ${coin}`);
+    }
+    return candles
+        .sort((a, b) => a.t - b.t)
+        .map((candle) => ({
+        time: Math.floor(candle.t / 1000),
+        open: parseFloat(candle.o),
+        high: parseFloat(candle.h),
+        low: parseFloat(candle.l),
+        close: parseFloat(candle.c),
+        volume: parseFloat(candle.v || "0"),
+    }))
+        .filter((candle, index, arr) => index === 0 ? true : candle.time > arr[index - 1].time);
 }
 /**
  * Fetches spot candles for a token
+ * tokenName can be:
+ * - "@{index}" format (e.g., "@107") - passed directly to API
+ * - "PURR/USDC" format - passed directly to API
+ * - "PURR" format - converted to "PURR/USDC"
  */
 export async function fetchSpotCandles(params) {
     const { tokenName, interval, startTime, endTime, network } = params;
-    const coin = ensureSpotSymbol(tokenName);
+    // If tokenName starts with "@", it's already in API format - use directly
+    // Otherwise, ensure it has the /QUOTE suffix
+    const coin = tokenName.startsWith("@")
+        ? tokenName
+        : ensureSpotSymbol(tokenName);
     return fetchCandlesticks({
         coin,
         interval,
@@ -629,47 +686,24 @@ export async function fetchSpotCandles(params) {
     });
 }
 /**
- * Fetches latest price for a coin
+ * Fetches latest price for a coin.
+ * @remarks
+ * `high24h` and `low24h` are returned as null because the Hyperliquid API
+ * does not provide actual 24-hour high/low data in this endpoint.
  */
 export async function fetchLatestPrice(coin, network = "testnet") {
-    try {
-        const [[perpMeta, perpCtxs], allMids] = await Promise.all([
-            fetchPerpMetaAndAssetCtxs(network),
-            fetchAllMids(network),
-        ]);
-        const perpIndex = perpMeta?.universe?.findIndex((asset) => asset.name === coin);
-        if (perpIndex !== undefined && perpIndex > -1) {
-            const assetCtx = perpCtxs[perpIndex];
-            const currentPrice = allMids[coin] || assetCtx?.midPx || assetCtx?.markPx || "0";
-            let change24h = "0.00";
-            if (assetCtx?.prevDayPx && assetCtx?.midPx) {
-                const prev = parseFloat(assetCtx.prevDayPx);
-                const current = parseFloat(assetCtx.midPx);
-                if (prev > 0) {
-                    change24h = (((current - prev) / prev) * 100).toFixed(2);
-                }
-            }
-            return {
-                price: currentPrice,
-                change24h,
-                high24h: currentPrice,
-                low24h: currentPrice,
-                volume24h: assetCtx?.dayNtlVlm || "0",
-            };
-        }
-        const [[spotMeta, spotCtxs]] = await Promise.all([
-            fetchSpotMetaAndAssetCtxs(network),
-        ]);
-        const spotIndex = spotMeta?.tokens?.findIndex((token) => token.name === coin);
-        if (spotIndex === undefined || spotIndex === -1) {
-            throw new Error(`Coin ${coin} not found in Hyperliquid markets`);
-        }
-        const spotCtx = spotCtxs[spotIndex];
-        const currentPrice = allMids[coin] || spotCtx?.midPx || spotCtx?.markPx || "0";
+    const [[perpMeta, perpCtxs], allMids] = await Promise.all([
+        fetchPerpMetaAndAssetCtxs(network),
+        fetchAllMids(network),
+    ]);
+    const perpIndex = perpMeta?.universe?.findIndex((asset) => asset.name === coin);
+    if (perpIndex !== undefined && perpIndex > -1) {
+        const assetCtx = perpCtxs[perpIndex];
+        const currentPrice = allMids[coin] || assetCtx?.midPx || assetCtx?.markPx || "0";
         let change24h = "0.00";
-        if (spotCtx?.prevDayPx && spotCtx?.midPx) {
-            const prev = parseFloat(spotCtx.prevDayPx);
-            const current = parseFloat(spotCtx.midPx);
+        if (assetCtx?.prevDayPx && assetCtx?.midPx) {
+            const prev = parseFloat(assetCtx.prevDayPx);
+            const current = parseFloat(assetCtx.midPx);
             if (prev > 0) {
                 change24h = (((current - prev) / prev) * 100).toFixed(2);
             }
@@ -677,17 +711,40 @@ export async function fetchLatestPrice(coin, network = "testnet") {
         return {
             price: currentPrice,
             change24h,
-            high24h: currentPrice,
-            low24h: currentPrice,
-            volume24h: spotCtx?.dayBaseVlm || "0",
+            high24h: null,
+            low24h: null,
+            volume24h: assetCtx?.dayNtlVlm || "0",
         };
     }
-    catch (error) {
-        throw error;
+    const [[spotMeta, spotCtxs]] = await Promise.all([
+        fetchSpotMetaAndAssetCtxs(network),
+    ]);
+    const spotIndex = spotMeta?.tokens?.findIndex((token) => token.name === coin);
+    if (spotIndex === undefined || spotIndex === -1) {
+        throw new Error(`Coin ${coin} not found in Hyperliquid markets`);
+    }
+    const spotCtx = spotCtxs[spotIndex];
+    const currentPrice = allMids[coin] || spotCtx?.midPx || spotCtx?.markPx || "0";
+    let change24h = "0.00";
+    if (spotCtx?.prevDayPx && spotCtx?.midPx) {
+        const prev = parseFloat(spotCtx.prevDayPx);
+        const current = parseFloat(spotCtx.midPx);
+        if (prev > 0) {
+            change24h = (((current - prev) / prev) * 100).toFixed(2);
+        }
     }
+    return {
+        price: currentPrice,
+        change24h,
+        high24h: null,
+        low24h: null,
+        volume24h: spotCtx?.dayBaseVlm || "0",
+    };
 }
 /**
- * Fetches user leverage mode for a specific coin
+ * Fetches user leverage mode for a specific coin.
+ * @throws Error if the API call fails - callers should implement retry logic.
+ * @returns The leverage mode, or null if the user has no position for this coin.
  */
 export async function fetchUserLeverageMode(userAddress, coin, network = "testnet") {
     try {
@@ -705,8 +762,12 @@ export async function fetchUserLeverageMode(userAddress, coin, network = "testne
             }
             const isCross = pos?.isCross ?? entry?.isCross ?? true;
             let leverage;
-            if (pos?.leverage != null) {
-                leverage = Number(pos.leverage);
+            const posLeverage = pos?.leverage;
+            if (posLeverage != null) {
+                leverage =
+                    typeof posLeverage === "number"
+                        ? posLeverage
+                        : Number(posLeverage.value ?? 1);
             }
             else if (pos?.szi &&
                 pos?.entryPx &&
@@ -722,7 +783,11 @@ export async function fetchUserLeverageMode(userAddress, coin, network = "testne
         return null;
     }
     catch (error) {
-        return null;
+        const maskedAddress = userAddress.length > 10
+            ? `${userAddress.slice(0, 6)}...${userAddress.slice(-4)}`
+            : "***";
+        console.debug(`[fetchUserLeverageMode] Error fetching leverage mode for coin "${coin}" and user "${maskedAddress}":`, error);
+        throw error;
     }
 }
 /**
@@ -730,28 +795,23 @@ export async function fetchUserLeverageMode(userAddress, coin, network = "testne
  */
 export async function fetchTopOfBook(symbol, network = "testnet") {
     const { coin } = parseSymbolForBook(symbol);
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const book = (await client.l2Book({ coin }));
-        const levels = Array.isArray(book?.levels)
-            ? book.levels
-            : [];
-        const [bids = [], asks = []] = levels;
-        const bestBid = getLevelPrice(bids[0]);
-        const bestAsk = getLevelPrice(asks[0]);
-        const midPrice = bestBid !== null && bestAsk !== null
-            ? (bestBid + bestAsk) / 2
-            : bestBid ?? bestAsk ?? null;
-        return {
-            bestBid,
-            bestAsk,
-            midPrice,
-            lastUpdated: Date.now(),
-        };
-    }
-    catch (error) {
-        throw error;
-    }
+    const client = getHyperliquidInfoClient(network);
+    const book = (await client.l2Book({ coin }));
+    const levels = Array.isArray(book?.levels)
+        ? book.levels
+        : [];
+    const [bids = [], asks = []] = levels;
+    const bestBid = getLevelPrice(bids[0]);
+    const bestAsk = getLevelPrice(asks[0]);
+    const midPrice = bestBid !== null && bestAsk !== null
+        ? (bestBid + bestAsk) / 2
+        : bestBid ?? bestAsk ?? null;
+    return {
+        bestBid,
+        bestAsk,
+        midPrice,
+        lastUpdated: Date.now(),
+    };
 }
 // ============================================================================
 // User-Specific API Functions
@@ -760,133 +820,83 @@ export async function fetchTopOfBook(symbol, network = "testnet") {
  * Fetches user positions from clearinghouse state
  */
 export async function fetchUserPositions(userAddress, network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const state = await client.clearinghouseState({
-            user: userAddress,
-        });
-        if (!state?.assetPositions || !Array.isArray(state.assetPositions)) {
-            return [];
-        }
-        return state.assetPositions
-            .filter((entry) => {
-            const pos = entry?.position;
-            if (!pos)
-                return false;
-            const size = parseFloat(pos.szi || "0");
-            return size !== 0;
-        })
-            .map((entry) => {
-            const pos = entry.position;
-            return {
-                coin: pos.coin,
-                szi: pos.szi,
-                entryPx: pos.entryPx || "0",
-                positionValue: pos.positionValue || "0",
-                unrealizedPnl: pos.unrealizedPnl || "0",
-                returnOnEquity: pos.returnOnEquity || "0",
-                liquidationPx: pos.liquidationPx || null,
-                marginUsed: pos.marginUsed || "0",
-                leverage: entry.leverage?.value || pos.leverage?.value || 1,
-                isCross: pos.isCross ?? entry.isCross ?? true,
-            };
-        });
-    }
-    catch (error) {
-        throw error;
+    const client = getHyperliquidInfoClient(network);
+    const state = await client.clearinghouseState({
+        user: userAddress,
+    });
+    if (!state?.assetPositions || !Array.isArray(state.assetPositions)) {
+        return [];
     }
+    return state.assetPositions
+        .filter(filterNonZeroPositions)
+        .map(mapRawAssetPositionToPosition);
 }
 /**
  * Fetches user's clearinghouse state (positions + margin summary)
  */
 export async function fetchUserState(userAddress, network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const state = await client.clearinghouseState({
-            user: userAddress,
-        });
-        if (!state) {
-            return null;
-        }
-        const positions = (state.assetPositions || [])
-            .filter((entry) => {
-            const pos = entry?.position;
-            if (!pos)
-                return false;
-            const size = parseFloat(pos.szi || "0");
-            return size !== 0;
-        })
-            .map((entry) => {
-            const pos = entry.position;
-            return {
-                coin: pos.coin,
-                szi: pos.szi,
-                entryPx: pos.entryPx || "0",
-                positionValue: pos.positionValue || "0",
-                unrealizedPnl: pos.unrealizedPnl || "0",
-                returnOnEquity: pos.returnOnEquity || "0",
-                liquidationPx: pos.liquidationPx || null,
-                marginUsed: pos.marginUsed || "0",
-                leverage: entry.leverage?.value || pos.leverage?.value || 1,
-                isCross: pos.isCross ?? entry.isCross ?? true,
-            };
-        });
-        const marginSummary = state.marginSummary || {};
-        const crossMarginSummary = state.crossMarginSummary;
-        return {
-            assetPositions: positions,
-            marginSummary: {
-                accountValue: marginSummary.accountValue || "0",
-                totalNtlPos: marginSummary.totalNtlPos || "0",
-                totalRawUsd: marginSummary.totalRawUsd || "0",
-                totalMarginUsed: marginSummary.totalMarginUsed || "0",
-                withdrawable: marginSummary.withdrawable || "0",
-            },
-            crossMarginSummary: crossMarginSummary
-                ? {
-                    accountValue: crossMarginSummary.accountValue || "0",
-                    totalNtlPos: crossMarginSummary.totalNtlPos || "0",
-                    totalRawUsd: crossMarginSummary.totalRawUsd || "0",
-                    totalMarginUsed: crossMarginSummary.totalMarginUsed || "0",
-                    withdrawable: crossMarginSummary.withdrawable || "0",
-                }
-                : undefined,
-        };
-    }
-    catch (error) {
-        throw error;
+    const client = getHyperliquidInfoClient(network);
+    const state = await client.clearinghouseState({
+        user: userAddress,
+    });
+    if (!state) {
+        return null;
     }
+    const positions = (state.assetPositions || [])
+        .filter(filterNonZeroPositions)
+        .map(mapRawAssetPositionToPosition);
+    const marginSummary = state.marginSummary || {};
+    const crossMarginSummary = state.crossMarginSummary;
+    const crossMaintenanceMarginUsed = state.crossMaintenanceMarginUsed;
+    return {
+        assetPositions: positions,
+        marginSummary: {
+            accountValue: marginSummary.accountValue || "0",
+            totalNtlPos: marginSummary.totalNtlPos || "0",
+            totalRawUsd: marginSummary.totalRawUsd || "0",
+            totalMarginUsed: marginSummary.totalMarginUsed || "0",
+            withdrawable: marginSummary.withdrawable || "0",
+        },
+        crossMarginSummary: crossMarginSummary
+            ? {
+                accountValue: crossMarginSummary.accountValue || "0",
+                totalNtlPos: crossMarginSummary.totalNtlPos || "0",
+                totalRawUsd: crossMarginSummary.totalRawUsd || "0",
+                totalMarginUsed: crossMarginSummary.totalMarginUsed || "0",
+                withdrawable: crossMarginSummary.withdrawable || "0",
+            }
+            : undefined,
+        crossMaintenanceMarginUsed: crossMaintenanceMarginUsed || "0",
+    };
 }
 /**
- * Fetches user's open orders
+ * Fetches user's open orders with frontend info (includes trigger prices for TP/SL)
  */
 export async function fetchOpenOrders(userAddress, network = "testnet") {
-    try {
-        const client = getHyperliquidInfoClient(network);
-        const orders = await client.openOrders({
-            user: userAddress,
-        });
-        if (!Array.isArray(orders)) {
-            return [];
-        }
-        return orders.map((order) => ({
-            coin: order.coin,
-            oid: order.oid,
-            side: order.side,
-            limitPx: order.limitPx,
-            sz: order.sz,
-            origSz: order.origSz,
-            timestamp: order.timestamp,
-            reduceOnly: order.reduceOnly ?? false,
-            orderType: order.orderType || "limit",
-            triggerPx: order.triggerPx || undefined,
-            isPositionTpsl: order.isPositionTpsl || false,
-            cloid: order.cloid || undefined,
-        }));
-    }
-    catch (error) {
-        throw error;
+    const client = getHyperliquidInfoClient(network);
+    // Use frontendOpenOrders to get complete order info including triggerPx for TP/SL orders
+    const orders = await client.frontendOpenOrders({
+        user: userAddress,
+    });
+    if (!Array.isArray(orders)) {
+        return [];
     }
+    return orders.map((order) => ({
+        coin: String(order.coin ?? ""),
+        oid: order.oid ?? 0,
+        side: order.side === "B" || order.side === "A" ? order.side : "B",
+        limitPx: String(order.limitPx ?? "0"),
+        sz: String(order.sz ?? "0"),
+        origSz: String(order.origSz ?? order.sz ?? "0"),
+        timestamp: order.timestamp ?? Date.now(),
+        reduceOnly: order.reduceOnly ?? false,
+        orderType: order.orderType || "Limit",
+        triggerPx: order.triggerPx || undefined,
+        isTrigger: order.isTrigger ?? false,
+        triggerCondition: order.triggerCondition || "",
+        isPositionTpsl: order.isPositionTpsl || false,
+        cloid: order.cloid || undefined,
+    }));
 }
 // ============================================================================
 // Utility Functions
@@ -911,4 +921,114 @@ export async function resolveAssetIndex(coin, network = "testnet") {
     }
     return assetId;
 }
+/**
+ * Fetches user fee rates from Hyperliquid
+ * Returns taker/maker rates for perps and spot
+ */
+export async function fetchUserFees(params) {
+    const { userAddress, network = "testnet" } = params;
+    if (!userAddress) {
+        throw new Error("User address is required to fetch fees");
+    }
+    const client = getHyperliquidInfoClient(network);
+    const response = await client.userFees({
+        user: userAddress,
+    });
+    return {
+        userCrossRate: response.userCrossRate || "0",
+        userAddRate: response.userAddRate || "0",
+        userSpotCrossRate: response.userSpotCrossRate || "0",
+        userSpotAddRate: response.userSpotAddRate || "0",
+        activeReferralDiscount: response.activeReferralDiscount || "0",
+    };
+}
+/**
+ * Fetches user historical orders from Hyperliquid
+ * Returns orders with their current status (open, filled, canceled, etc.)
+ */
+export async function fetchHistoricalOrders(params) {
+    const { user, limit = 200, network = "testnet" } = params;
+    if (!user) {
+        throw new Error("User address is required to fetch historical orders");
+    }
+    const transport = getHyperliquidTransport(network);
+    const response = await transport.request("info", {
+        type: "historicalOrders",
+        user,
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.slice(0, limit).map((item) => {
+        const order = item.order ?? {};
+        return {
+            order: {
+                coin: String(order.coin ?? ""),
+                side: order.side === "B" || order.side === "A" ? order.side : "B",
+                limitPx: String(order.limitPx ?? "0"),
+                sz: String(order.sz ?? "0"),
+                oid: typeof order.oid === "number" ? order.oid : 0,
+                timestamp: typeof order.timestamp === "number" ? order.timestamp : Date.now(),
+                origSz: String(order.origSz ?? order.sz ?? "0"),
+                triggerCondition: order.triggerCondition
+                    ? String(order.triggerCondition)
+                    : undefined,
+                isTrigger: typeof order.isTrigger === "boolean" ? order.isTrigger : false,
+                triggerPx: order.triggerPx ? String(order.triggerPx) : undefined,
+                children: Array.isArray(order.children) ? order.children : [],
+                isPositionTpsl: typeof order.isPositionTpsl === "boolean"
+                    ? order.isPositionTpsl
+                    : false,
+                reduceOnly: typeof order.reduceOnly === "boolean" ? order.reduceOnly : false,
+                orderType: String(order.orderType ?? "Limit"),
+                tif: String(order.tif ?? "Gtc"),
+                cloid: order.cloid ? String(order.cloid) : undefined,
+            },
+            status: (item.status ?? "filled"),
+            statusTimestamp: typeof item.statusTimestamp === "number"
+                ? item.statusTimestamp
+                : Date.now(),
+        };
+    });
+}
+/**
+ * Fetches user frontend open orders from Hyperliquid
+ * Returns open orders with additional display information (trigger conditions, TP/SL, etc.)
+ */
+export async function fetchFrontendOpenOrders(params) {
+    const { user, network = "testnet" } = params;
+    if (!user) {
+        throw new Error("User address is required to fetch open orders");
+    }
+    const transport = getHyperliquidTransport(network);
+    const response = await transport.request("info", {
+        type: "frontendOpenOrders",
+        user,
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.map((order) => ({
+        coin: String(order.coin ?? ""),
+        side: order.side === "B" || order.side === "A" ? order.side : "B",
+        limitPx: String(order.limitPx ?? "0"),
+        sz: String(order.sz ?? "0"),
+        oid: typeof order.oid === "number" ? order.oid : 0,
+        timestamp: typeof order.timestamp === "number" ? order.timestamp : Date.now(),
+        origSz: String(order.origSz ?? order.sz ?? "0"),
+        triggerCondition: order.triggerCondition
+            ? String(order.triggerCondition)
+            : undefined,
+        isTrigger: typeof order.isTrigger === "boolean" ? order.isTrigger : false,
+        triggerPx: order.triggerPx ? String(order.triggerPx) : undefined,
+        children: (Array.isArray(order.children)
+            ? order.children
+            : []),
+        isPositionTpsl: typeof order.isPositionTpsl === "boolean" ? order.isPositionTpsl : false,
+        reduceOnly: typeof order.reduceOnly === "boolean" ? order.reduceOnly : false,
+        orderType: String(order.orderType ?? "Limit"),
+        tif: String(order.tif ?? "Gtc"),
+        cloid: order.cloid ? String(order.cloid) : undefined,
+    }));
+}
 //# sourceMappingURL=api.js.map