@michaleffffff/mcp-trading-server 3.0.4 → 3.0.7

package/dist/tools/accountInfo.js

@@ -1,141 +1,9 @@
 import { z } from "zod";
 import { resolveClient, getChainId } from "../auth/resolveClient.js";
-import { getBalances, getMarginBalance } from "../services/balanceService.js";
 import { getTradeFlowTypeDesc } from "../utils/mappings.js";
-function readErrorMessage(error) {
-    if (error instanceof Error)
-        return error.message;
-    if (typeof error === "string")
-        return error;
-    if (error && typeof error === "object" && "message" in error) {
-        return String(error.message);
-    }
-    return String(error ?? "unknown error");
-}
-function assertSdkReadSuccess(result, actionName) {
-    if (!result || typeof result !== "object" || Array.isArray(result))
-        return;
-    if (!Object.prototype.hasOwnProperty.call(result, "code"))
-        return;
-    const code = Number(result.code);
-    if (!Number.isFinite(code) || code === 0)
-        return;
-    const payload = result.data;
-    const hasPayload = payload !== null &&
-        payload !== undefined &&
-        (!Array.isArray(payload) || payload.length > 0);
-    if (code > 0 && hasPayload) {
-        // Keep aligned with server-side read normalization:
-        // positive non-zero code with usable payload is warning-like.
-        return;
-    }
-    const message = String(result.msg ?? result.message ?? "unknown error");
-    throw new Error(`${actionName} failed: code=${code}, msg=${message}`);
-}
-function normalizeAccountInfo(result) {
-    if (!(result && result.code === 0 && Array.isArray(result.data))) {
-        return result;
-    }
-    const values = result.data;
-    return {
-        ...result,
-        data: {
-            freeMargin: values[0],
-            walletBalance: values[1],
-            freeBaseAmount: values[2],
-            baseProfit: values[3],
-            quoteProfit: values[4],
-            reservedAmount: values[5],
-            releaseTime: values[6],
-            tradeableMargin: (BigInt(values[0]) + BigInt(values[1]) + (BigInt(values[6]) === 0n ? BigInt(values[4]) : 0n)).toString(),
-            baseProfitStatus: "base token to be unlocked",
-            quoteProfitStatus: BigInt(values[6]) > 0n ? "quote token to be unlocked" : "quote token unlocked/available"
-        }
-    };
-}
-export const getAccountTool = {
-    name: "get_account",
-    description: "Unified account snapshot. Distinguishes wallet balance vs trading-account metrics. Provide poolId for full trading-account details.",
-    schema: {
-        poolId: z.string().optional().describe("Optional Pool ID. Required to include trading-account metrics (account info + margin)."),
-    },
-    handler: async (args) => {
-        try {
-            const { client, address } = await resolveClient();
-            const chainId = getChainId();
-            const poolId = args.poolId?.trim();
-            const overview = {
-                meta: {
-                    address,
-                    chainId,
-                    poolId: poolId ?? null,
-                    partial: false,
-                },
-                wallet: {
-                    scope: "wallet_balance",
-                    description: "On-chain wallet quote-token balance (funds not yet deposited into trading account).",
-                    quoteTokenBalance: null,
-                    raw: null,
-                    error: null,
-                },
-                tradingAccount: {
-                    scope: "trading_account_balance",
-                    description: poolId
-                        ? "Trading-account metrics for the selected pool."
-                        : "Provide poolId to include trading-account metrics (account info + margin).",
-                    poolId: poolId ?? null,
-                    accountInfo: null,
-                    marginBalance: null,
-                    error: null,
-                },
-                warnings: [],
-            };
-            try {
-                const walletBalances = await getBalances(client, address);
-                assertSdkReadSuccess(walletBalances, "getWalletQuoteTokenBalance");
-                overview.wallet.quoteTokenBalance = walletBalances?.data ?? walletBalances;
-                overview.wallet.raw = walletBalances;
-            }
-            catch (walletError) {
-                overview.meta.partial = true;
-                overview.wallet.error = readErrorMessage(walletError);
-                overview.warnings.push(`wallet section failed: ${overview.wallet.error}`);
-            }
-            if (poolId) {
-                try {
-                    const [accountInfoRaw, marginBalanceRaw] = await Promise.all([
-                        client.account.getAccountInfo(chainId, address, poolId),
-                        getMarginBalance(client, address, poolId),
-                    ]);
-                    assertSdkReadSuccess(accountInfoRaw, "getAccountInfo");
-                    assertSdkReadSuccess(marginBalanceRaw, "getAvailableMarginBalance");
-                    overview.tradingAccount.accountInfo = normalizeAccountInfo(accountInfoRaw);
-                    overview.tradingAccount.marginBalance = marginBalanceRaw;
-                }
-                catch (tradingError) {
-                    overview.meta.partial = true;
-                    overview.tradingAccount.error = readErrorMessage(tradingError);
-                    overview.warnings.push(`tradingAccount section failed: ${overview.tradingAccount.error}`);
-                }
-            }
-            if (overview.warnings.length === 0) {
-                delete overview.warnings;
-            }
-            const hasWalletData = overview.wallet.quoteTokenBalance !== null;
-            const hasTradingData = overview.tradingAccount.accountInfo !== null || overview.tradingAccount.marginBalance !== null;
-            if (!hasWalletData && !hasTradingData) {
-                throw new Error("Failed to build account snapshot: wallet and trading-account sections both unavailable.");
-            }
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: overview }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};
 export const getTradeFlowTool = {
     name: "get_trade_flow",
-    description: "Get account trade flow / transaction history.",
+    description: "[ACCOUNT] Get account trade flow / transaction history.",
     schema: {
         poolId: z.string().optional().describe("Optional pool ID filter."),
         limit: z.number().int().positive().optional().describe("Results per page (default 20)"),
@@ -145,7 +13,10 @@ export const getTradeFlowTool = {
             const { client, address } = await resolveClient();
             const chainId = getChainId();
             const query = { chainId, poolId: args.poolId, limit: args.limit ?? 20 };
-            const result = await client.account.getTradeFlow(query, address);
+            const accessToken = typeof client?.getAccessToken === "function"
+                ? (await client.getAccessToken()) || ""
+                : "";
+            const result = await client.api.getTradeFlow({ ...query, address, accessToken });
             const enhancedData = (result?.data || []).map((flow) => ({
                 ...flow,
                 typeDesc: getTradeFlowTypeDesc(flow.type)

package/dist/tools/accountTransfer.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { resolveClient, getChainId } from "../auth/resolveClient.js";
+import { resolveClient, getChainId, getQuoteToken } from "../auth/resolveClient.js";
 import { normalizeAddress } from "../utils/address.js";
 import { finalizeMutationResult } from "../utils/mutationResult.js";
 const MAX_UINT256 = "115792089237316195423570985008687907853269984665640564039457584007913129639935";
@@ -39,10 +39,10 @@ function formatUnixTimestamp(timestamp) {
 }
 export const accountDepositTool = {
     name: "account_deposit",
-    description: "Deposit funds from wallet into the MYX trading account.",
+    description: "[ACCOUNT] Deposit funds from wallet into the MYX trading account.",
     schema: {
         amount: z.union([z.string(), z.number()]).describe("Amount to deposit (human-readable or raw units)"),
-        tokenAddress: z.string().describe("Token address"),
+        tokenAddress: z.string().optional().describe("Token address (optional, default: QUOTE_TOKEN_ADDRESS)"),
         autoApprove: z.coerce.boolean().optional().describe("If true, auto-approve token allowance when needed (default false)."),
         approveMax: z.coerce.boolean().optional().describe("If autoApprove=true, approve MaxUint256 instead of exact amount."),
     },
@@ -50,7 +50,8 @@ export const accountDepositTool = {
         try {
             const { client, signer, address } = await resolveClient();
             const chainId = getChainId();
-            const tokenAddress = normalizeAddress(args.tokenAddress, "tokenAddress");
+            const tokenAddressInput = String(args.tokenAddress ?? "").trim() || getQuoteToken();
+            const tokenAddress = normalizeAddress(tokenAddressInput, "tokenAddress");
             // For deposit, we default to quote decimals (6) as it's the most common use case.
             // ensureUnits handles 'raw:' prefix if absolute precision is needed.
             const { ensureUnits } = await import("../utils/units.js");
@@ -90,7 +91,7 @@ export const accountDepositTool = {
 };
 export const accountWithdrawTool = {
     name: "account_withdraw",
-    description: "Withdraw funds from MYX trading account back to wallet.",
+    description: "[ACCOUNT] Withdraw funds from MYX trading account back to wallet.",
     schema: {
         poolId: z.string().describe("Pool ID to withdraw from"),
         amount: z.union([z.string(), z.number()]).describe("Amount to withdraw (human-readable or raw units)"),
@@ -128,13 +129,7 @@ export const accountWithdrawTool = {
                 throw new Error(`Account has locked funds until releaseTime=${formatUnixTimestamp(releaseTime)}. ` +
                     `Retry after unlock or reduce withdraw amount.`);
             }
-            const raw = await client.account.withdraw({
-                chainId,
-                receiver: address,
-                amount,
-                poolId: args.poolId,
-                isQuoteToken: args.isQuoteToken,
-            });
+            const raw = await client.account.updateAndWithdraw(address, args.poolId, Boolean(args.isQuoteToken), amount, chainId);
             const data = await finalizeMutationResult(raw, signer, "account_withdraw");
             const preflight = {
                 requestedAmountRaw: amountRaw.toString(),

package/dist/tools/adjustMargin.js

@@ -5,7 +5,7 @@ import { finalizeMutationResult } from "../utils/mutationResult.js";
 import { extractErrorMessage } from "../utils/errorMessage.js";
 export const adjustMarginTool = {
     name: "adjust_margin",
-    description: "Adjust the margin (collateral) of an open position.",
+    description: "[TRADE] Adjust the margin (collateral) of an open position.",
     schema: {
         poolId: z.string().describe("Pool ID"),
         positionId: z.string().describe("Position ID"),

package/dist/tools/cancelOrders.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+import { resolvePool } from "../services/marketService.js";
+import { finalizeMutationResult } from "../utils/mutationResult.js";
+function normalizeOrderIds(input) {
+    if (Array.isArray(input))
+        return input.map((id) => String(id).trim()).filter(Boolean);
+    if (typeof input !== "string")
+        return [];
+    const text = input.trim();
+    if (!text)
+        return [];
+    if (text.startsWith("[") && text.endsWith("]")) {
+        try {
+            const parsed = JSON.parse(text);
+            if (Array.isArray(parsed))
+                return parsed.map((id) => String(id).trim()).filter(Boolean);
+        }
+        catch { }
+    }
+    if (text.includes(","))
+        return text.split(",").map((id) => id.trim()).filter(Boolean);
+    return [text];
+}
+export const cancelOrdersTool = {
+    name: "cancel_orders",
+    description: "[TRADE] Cancel open orders. Supports specific IDs, all orders in a pool, or ALL open orders.",
+    schema: {
+        orderIds: z.union([z.array(z.string()), z.string()]).optional().describe("Specific order ID(s) to cancel."),
+        poolId: z.string().optional().describe("Pool ID or keyword to cancel all orders within."),
+        keyword: z.string().optional().describe("Market keyword (e.g. 'BTC') for pool-based cancellation."),
+        cancelAll: z.boolean().default(false).describe("If true, cancel ALL open orders for the account."),
+    },
+    handler: async (args) => {
+        try {
+            const { client, address, signer } = await resolveClient();
+            const chainId = getChainId();
+            let targetOrderIds = normalizeOrderIds(args.orderIds);
+            if (args.cancelAll || args.poolId || args.keyword) {
+                const ordersRes = await client.order.getOrders(address);
+                const allOrders = ordersRes?.data || [];
+                if (args.cancelAll) {
+                    targetOrderIds = allOrders.map((o) => o.orderId);
+                }
+                else {
+                    const poolId = await resolvePool(client, args.poolId, args.keyword);
+                    targetOrderIds = allOrders
+                        .filter((o) => String(o.poolId).toLowerCase() === poolId.toLowerCase())
+                        .map((o) => o.orderId);
+                }
+            }
+            if (targetOrderIds.length === 0) {
+                return { content: [{ type: "text", text: JSON.stringify({ status: "success", message: "No matching open orders found to cancel." }) }] };
+            }
+            const raw = await client.order.cancelAllOrders(targetOrderIds, chainId);
+            const result = await finalizeMutationResult(raw, signer, "cancel_orders");
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "success",
+                            data: { cancelledCount: targetOrderIds.length, orderIds: targetOrderIds, result }
+                        }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/checkAccountReady.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+import { resolvePool } from "../services/marketService.js";
+import { parseUserUnits } from "../utils/units.js";
+import { ethers } from "ethers";
+function toBigIntOrZero(value) {
+    try {
+        const text = String(value ?? "").trim();
+        if (!text)
+            return 0n;
+        return BigInt(text);
+    }
+    catch {
+        return 0n;
+    }
+}
+export const checkAccountReadyTool = {
+    name: "check_account_ready",
+    description: "[TRADE] Check if the account has sufficient funds (margin + wallet) for a planned trade.",
+    schema: {
+        poolId: z.string().optional().describe("Pool ID or keyword."),
+        keyword: z.string().optional().describe("Market keyword, e.g. 'BTC'."),
+        collateralAmount: z.string().describe("Planned collateral, e.g. '100'."),
+    },
+    handler: async (args) => {
+        try {
+            const { client, address } = await resolveClient();
+            const chainId = getChainId();
+            const poolId = await resolvePool(client, args.poolId, args.keyword);
+            const detailRes = await client.markets.getMarketDetail({ chainId, poolId });
+            const detail = detailRes?.data || detailRes;
+            const quoteDecimals = Number(detail?.quoteDecimals ?? 6);
+            const quoteSymbol = detail?.quoteSymbol || "USDC";
+            const marginInfo = await client.account.getAccountInfo(chainId, address, poolId);
+            let marginBalanceRaw = 0n;
+            let accountWalletBalanceRaw = 0n;
+            if (marginInfo?.code === 0 && marginInfo?.data) {
+                marginBalanceRaw = toBigIntOrZero(marginInfo.data.freeMargin);
+                accountWalletBalanceRaw = toBigIntOrZero(marginInfo.data.walletBalance);
+            }
+            const walletRes = await client.account.getWalletQuoteTokenBalance(chainId, address);
+            const walletBalanceRaw = BigInt(walletRes?.data || "0");
+            const requiredRaw = BigInt(parseUserUnits(args.collateralAmount, quoteDecimals, "required"));
+            const isReady = (marginBalanceRaw >= requiredRaw) || (marginBalanceRaw + walletBalanceRaw >= requiredRaw);
+            const deficitRaw = requiredRaw > marginBalanceRaw ? requiredRaw - marginBalanceRaw : 0n;
+            const needDepositFromWallet = deficitRaw > 0n;
+            const walletSufficient = walletBalanceRaw >= deficitRaw;
+            const format = (v) => ethers.formatUnits(v, quoteDecimals);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "success",
+                            data: {
+                                isReady,
+                                neededTotal: format(requiredRaw),
+                                currentMarginBalance: format(marginBalanceRaw),
+                                currentWalletBalance: format(walletBalanceRaw),
+                                summary: {
+                                    hasEnoughInMargin: marginBalanceRaw >= requiredRaw,
+                                    needDepositFromWallet,
+                                    walletSufficientForDeposit: walletSufficient,
+                                    accountInfoWalletBalance: format(accountWalletBalanceRaw),
+                                    quoteSymbol
+                                }
+                            }
+                        }, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/checkApproval.js

@@ -5,7 +5,7 @@ import { finalizeMutationResult } from "../utils/mutationResult.js";
 const MAX_UINT256 = "115792089237316195423570985008687907853269984665640564039457584007913129639935";
 export const checkApprovalTool = {
     name: "check_approval",
-    description: "Check if token spending approval is needed. Supports auto-approve exact amount (default) or optional unlimited approval.",
+    description: "[TRADE] Check if token spending approval is needed. Supports auto-approve exact amount (default) or optional unlimited approval.",
     schema: {
         amount: z.string().regex(/^\d+$/).describe("Amount to check approval for (token raw units)"),
         quoteToken: z.string().optional().describe("Token address to check. Uses default if omitted."),

package/dist/tools/closeAllPositions.js

@@ -1,26 +1,28 @@
 import { z } from "zod";
 import { resolveClient, getChainId, getQuoteToken } from "../auth/resolveClient.js";
-import { getOraclePrice } from "../services/marketService.js";
+import { getOraclePrice, resolvePool } from "../services/marketService.js";
 import { ensureUnits } from "../utils/units.js";
 import { finalizeMutationResult } from "../utils/mutationResult.js";
 import { normalizeSlippagePct4dpFlexible, SLIPPAGE_PCT_4DP_DESC } from "../utils/slippage.js";
 export const closeAllPositionsTool = {
     name: "close_all_positions",
-    description: "Emergency: close ALL open positions in a pool at once. Use for risk management.",
+    description: "[TRADE] Emergency: close ALL open positions in a pool at once. Use for risk management.",
     schema: {
-        poolId: z.string().describe("Pool ID to close all positions in"),
+        poolId: z.string().optional().describe("Pool ID or keyword."),
+        keyword: z.string().optional().describe("Market keyword, e.g. 'BTC'."),
         slippagePct: z.union([z.string(), z.number()]).optional().describe(`${SLIPPAGE_PCT_4DP_DESC}. Also supports human percent format like "1.0" or "1%".`),
     },
     handler: async (args) => {
         try {
             const { client, address, signer } = await resolveClient();
             const chainId = getChainId();
+            const poolId = await resolvePool(client, args.poolId, args.keyword);
             // 1) 先获取该池的所有持仓
             const posResult = await client.position.listPositions(address);
             const positions = posResult?.data || posResult || [];
             // 过滤出指定 pool 的仓位
             const poolPositions = Array.isArray(positions)
-                ? positions.filter((p) => p.poolId === args.poolId || p.pool_id === args.poolId)
+                ? positions.filter((p) => p.poolId === poolId || p.pool_id === poolId)
                 : [];
             if (poolPositions.length === 0) {
                 return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: { message: "No open positions in this pool.", closed: 0 } }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
@@ -28,14 +30,14 @@ export const closeAllPositionsTool = {
             // 2) 为每个仓位构建平仓参数
             const slippagePct = normalizeSlippagePct4dpFlexible(args.slippagePct ?? "200");
             // 3) We need actual oracle prices to avoid Revert 0x613970e0 (InvalidParameter)
-            const oraclePriceReq = await getOraclePrice(client, args.poolId).catch(() => null);
+            const oraclePriceReq = await getOraclePrice(client, poolId).catch(() => null);
             let fallbackPrice = "0";
             if (oraclePriceReq && oraclePriceReq.price) {
                 fallbackPrice = oraclePriceReq.price.toString();
             }
             else {
                 const { getMarketPrice } = await import("../services/marketService.js");
-                const marketData = await getMarketPrice(client, args.poolId).catch(() => null);
+                const marketData = await getMarketPrice(client, poolId).catch(() => null);
                 if (marketData && marketData.price) {
                     fallbackPrice = marketData.price.toString();
                 }
@@ -50,7 +52,7 @@ export const closeAllPositionsTool = {
                 return {
                     chainId,
                     address,
-                    poolId: args.poolId,
+                    poolId: poolId,
                     positionId: pos.positionId || pos.position_id || pos.id,
                     orderType: 0, // MARKET
                     triggerType: 0, // NONE

package/dist/tools/closePosition.js

@@ -5,26 +5,33 @@ import { finalizeMutationResult } from "../utils/mutationResult.js";
 import { SLIPPAGE_PCT_4DP_DESC } from "../utils/slippage.js";
 import { verifyTradeOutcome } from "../utils/verification.js";
 import { mapDirection, mapOrderType, mapTriggerType } from "../utils/mappings.js";
+import { parseUserUnits } from "../utils/units.js";
 const FULL_CLOSE_MARKERS = new Set(["ALL", "FULL", "MAX"]);
 const INTEGER_RE = /^\d+$/;
 function wantsFullCloseMarker(input) {
     const value = String(input ?? "").trim().toUpperCase();
     return FULL_CLOSE_MARKERS.has(value);
 }
-function readRawPositionField(position, primary, fallback) {
-    const first = String(position?.[primary] ?? "").trim();
-    if (INTEGER_RE.test(first))
-        return first;
-    if (fallback) {
-        const second = String(position?.[fallback] ?? "").trim();
-        if (INTEGER_RE.test(second))
-            return second;
+function readFirstPositionField(position, fields) {
+    for (const field of fields) {
+        const value = String(position?.[field] ?? "").trim();
+        if (value)
+            return value;
     }
     return "";
 }
+function resolvePositionRaw(position, rawFields, humanFields, decimals, label) {
+    const raw = readFirstPositionField(position, rawFields);
+    if (INTEGER_RE.test(raw))
+        return raw;
+    const human = readFirstPositionField(position, humanFields);
+    if (!human)
+        return "";
+    return parseUserUnits(human, decimals, label);
+}
 export const closePositionTool = {
     name: "close_position",
-    description: "Create a decrease order using SDK-native parameters.",
+    description: "[TRADE] Create a decrease order (close or reduce position) using SDK-native parameters.",
     schema: {
         poolId: z.string().describe("Pool ID"),
         positionId: z.string().describe("Position ID to close"),
@@ -67,14 +74,14 @@ export const closePositionTool = {
                     throw new Error(`Could not find live position snapshot for positionId=${preparedArgs.positionId} in poolId=${poolId}.`);
                 }
                 if (needAutoSize) {
-                    const rawSize = readRawPositionField(target, "size", "positionSize");
+                    const rawSize = resolvePositionRaw(target, ["sizeRaw", "positionSizeRaw"], ["size", "positionSize"], Number(poolData.baseDecimals ?? 18), "position.size");
                     if (!rawSize || rawSize === "0") {
                         throw new Error(`Resolved position size is empty/zero for positionId=${preparedArgs.positionId}.`);
                     }
                     preparedArgs.size = `raw:${rawSize}`;
                 }
                 if (needAutoCollateral) {
-                    const rawCollateral = readRawPositionField(target, "collateral", "collateralAmount");
+                    const rawCollateral = resolvePositionRaw(target, ["collateralRaw", "collateralAmountRaw"], ["collateral", "collateralAmount"], Number(poolData.quoteDecimals ?? 6), "position.collateralAmount");
                     if (!rawCollateral) {
                         throw new Error(`Resolved position collateral is empty for positionId=${preparedArgs.positionId}.`);
                     }

package/dist/tools/createPerpMarket.js

@@ -4,7 +4,7 @@ import { resolveClient } from "../auth/resolveClient.js";
 import { finalizeMutationResult } from "../utils/mutationResult.js";
 export const createPerpMarketTool = {
     name: "create_perp_market",
-    description: "Create a new perpetual contract pool on MYX. IMPORTANT: marketId cannot be randomly generated. It must be a valid 66-character config hash (0x...) tied to a supported quote token (like USDC). Use get_market_detail (after search_market/get_pool_list) to fetch an existing marketId if you don't have a specific newly allocated one.",
+    description: "[LIQUIDITY] Create a new perpetual contract pool on MYX. IMPORTANT: marketId cannot be randomly generated. It must be a valid 66-character config hash (0x...) tied to a supported quote token (like USDC). Use get_pool_metadata (after find_pool/list_pools) to fetch an existing marketId if you don't have a specific newly allocated one.",
     schema: {
         baseToken: z.string().describe("Base token contract address (e.g., 0xb40aaadc43...)"),
         marketId: z.string().describe("MUST be a valid 66-char config hash (e.g., existing USDC marketId: 0x7f6727d8026fd2c87ccc745846c83cd0b68e886c73e1e05a54a675bcadd8adb6). Do NOT generate randomly."),

package/dist/tools/executeTrade.js

@@ -11,12 +11,12 @@ const POSITION_ID_RE = /^$|^0x[0-9a-fA-F]{64}$/;
 const ZERO_POSITION_ID_RE = /^0x0{64}$/i;
 export const executeTradeTool = {
     name: "execute_trade",
-    description: "Create an increase order using SDK-native parameters.",
+    description: "[TRADE] Create an increase order (open or add to position) using SDK-native parameters.",
     schema: {
-        poolId: z.string().describe("Hex Pool ID, e.g. '0x14a19...'. Get via get_pool_list."),
-        positionId: z.string().refine((value) => POSITION_ID_RE.test(value), {
+        poolId: z.string().describe("Hex Pool ID, e.g. '0x14a19...'. Get via list_pools."),
+        positionId: z.string().optional().refine((value) => !value || POSITION_ID_RE.test(value), {
             message: "positionId must be empty string for new position, or a bytes32 hex string.",
-        }).describe("Position ID: Use empty string '' for NEW positions, or valid hex for INCREASING existing ones. 0x000..00 is auto-treated as NEW."),
+        }).describe("Position ID: Use empty string '' for NEW positions, or valid hex for INCREASING existing ones. 0x000..00 is auto-treated as NEW. Default is empty string."),
         orderType: z.union([z.number(), z.string()]).describe("Market/Limit/Stop. e.g. 0 or 'MARKET'."),
         triggerType: z.union([z.number(), z.string()]).optional().describe("0=None (Market), 1=GTE, 2=LTE. e.g. 'GTE'."),
         direction: z.union([z.number(), z.string()]).describe("0/LONG/BUY or 1/SHORT/SELL."),
@@ -26,7 +26,7 @@ export const executeTradeTool = {
         timeInForce: z.coerce.number().int().describe("0=GTC, 1=IOC, 2=FOK"),
         postOnly: z.coerce.boolean().describe("If true, order only executes as Maker."),
         slippagePct: z.coerce.string().default("50").describe(`${SLIPPAGE_PCT_4DP_DESC}. Default is 50 (0.5%).`),
-        executionFeeToken: z.string().describe("Address of token to pay gas/execution fees (typically USDC)."),
+        executionFeeToken: z.string().optional().describe("Address of token to pay gas/execution fees (typically USDC). Default is pool quoteToken."),
         leverage: z.coerce.number().positive().describe("Leverage multiplier, e.g., 10 for 10x."),
         tpSize: z.union([z.string(), z.number()]).optional().describe("Take Profit size. Use '0' to disable."),
         tpPrice: z.union([z.string(), z.number()]).optional().describe("Take Profit trigger price."),
@@ -35,7 +35,7 @@ export const executeTradeTool = {
         tradingFee: z.union([z.string(), z.number()]).optional().describe("Trading fee in quote token units. Supports human/raw prefix. Optional: auto-computed via get_user_trading_fee_rate."),
         assetClass: z.coerce.number().int().nonnegative().optional().describe("Optional fee lookup assetClass (default from pool config or 1)."),
         riskTier: z.coerce.number().int().nonnegative().optional().describe("Optional fee lookup riskTier (default from pool config or 1)."),
-        marketId: z.string().describe("Specific Market Config Hash. Fetch via get_market_detail (resolve poolId first with search_market/get_pool_list)."),
+        marketId: z.string().describe("Specific Market Config Hash. Fetch via get_pool_metadata (resolve poolId first with find_pool/list_pools)."),
     },
     handler: async (args) => {
         try {

package/dist/tools/findPool.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { resolveClient } from "../auth/resolveClient.js";
+import { searchMarket } from "../services/marketService.js";
+export const findPoolTool = {
+    name: "find_pool",
+    description: "[MARKET] Search for pools by keyword or symbol. Returns matched market metadata.",
+    schema: {
+        keyword: z.string().describe("Search keyword or symbol, e.g. 'BTC', 'ETH/USDC'"),
+        limit: z.number().int().positive().optional().describe("Max search results (default 10)"),
+    },
+    handler: async (args) => {
+        try {
+            const { client } = await resolveClient();
+            const results = await searchMarket(client, args.keyword, args.limit ?? 10);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ status: "success", data: results }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getAccountSnapshot.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+function unwrapData(result) {
+    if (result && typeof result === "object" && "data" in result) {
+        return result.data;
+    }
+    return result;
+}
+export const getAccountSnapshotTool = {
+    name: "get_account_snapshot",
+    description: "[ACCOUNT] Get unified account snapshot (balances, trading metrics, and VIP tier).",
+    schema: {
+        poolId: z.string().optional().describe("Pool ID for detailed trading-account metrics."),
+        chainId: z.number().int().positive().optional().describe("Optional chainId override"),
+    },
+    handler: async (args) => {
+        try {
+            const { client, address } = await resolveClient();
+            const chainId = args.chainId ?? getChainId();
+            const { getBalances, getMarginBalance } = await import("../services/balanceService.js");
+            const [vipRes, walletRes] = await Promise.all([
+                client.account.getAccountVipInfo(chainId, address).catch(() => null),
+                getBalances(client, address, chainId).catch(() => null)
+            ]);
+            let tradingAccount = null;
+            if (args.poolId) {
+                const [info, margin] = await Promise.all([
+                    client.account.getAccountInfo(chainId, address, args.poolId).catch(() => null),
+                    getMarginBalance(client, address, args.poolId, chainId).catch(() => null)
+                ]);
+                tradingAccount = {
+                    info: unwrapData(info),
+                    margin: unwrapData(margin)
+                };
+            }
+            const results = {
+                wallet: unwrapData(walletRes),
+                tradingAccount,
+                vip: unwrapData(vipRes),
+            };
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: results }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getAllTickers.js

@@ -1,7 +1,8 @@
 import { resolveClient, getChainId } from "../auth/resolveClient.js";
+import { getPoolList } from "../services/marketService.js";
 export const getAllTickersTool = {
     name: "get_all_tickers",
-    description: "Get ticker snapshots for all markets.",
+    description: "[MARKET] Get ticker snapshots for all markets.",
     schema: {},
     handler: async () => {
         try {
@@ -13,9 +14,9 @@ export const getAllTickersTool = {
             catch {
                 // Fallback for networks/environments where getAllTickers endpoint is unavailable.
                 const chainId = getChainId();
-                const poolList = await client.api.getPoolList();
-                const pools = Array.isArray(poolList?.data) ? poolList.data : [];
-                const poolIds = pools.map((p) => p.poolId).filter((id) => !!id);
+                const poolList = await getPoolList(client, chainId);
+                const pools = Array.isArray(poolList?.data) ? poolList.data : (Array.isArray(poolList) ? poolList : []);
+                const poolIds = pools.map((p) => p?.poolId ?? p?.pool_id).filter((id) => !!id);
                 if (poolIds.length === 0) {
                     throw new Error("Failed to fetch all tickers and no pools were available for fallback query.");
                 }