@tigeropenapi/tigeropen 0.5.0 → 0.5.4

package/dist/cjs/client/api-response.js

@@ -7,29 +7,33 @@ exports.unmarshalData = unmarshalData;
  */
 const errors_1 = require("./errors");
 /**
- * Replace bare integers (not inside JSON string values) that exceed
- * Number.MAX_SAFE_INTEGER (> 15 digits) with quoted string equivalents,
- * so that int64 order IDs survive JSON.parse without precision loss.
+ * Replaces bare int64 values (≥17 digits, not part of a float) with quoted
+ * strings so they survive JSON.parse without precision loss.
+ * 17+ digits are guaranteed to exceed Number.MAX_SAFE_INTEGER (≈9.007e15),
+ * so 16-digit microsecond timestamps remain as numbers.
  */
 function patchLargeIntegers(text) {
-    // Mask all existing JSON string values so their content isn't touched.
     const strings = [];
     const masked = text.replace(/"(?:[^"\\]|\\.)*"/g, (match) => {
         strings.push(match);
         return '\x01' + (strings.length - 1) + '\x01';
     });
-    // Quote any bare integer with >15 digits.
-    const patched = masked.replace(/-?\d{16,}/g, (m) => '"' + m + '"');
-    // Restore original string values.
+    // Match bare integers preceded by a JSON structural character or line start,
+    // not followed by decimal point or exponent (avoids matching float components).
+    // The `m` flag makes `^` match line-start for multi-line JSON.
+    const patched = masked.replace(/([:,\[{]|^)\s*(-?\d{17,})(?![.\deE])/gm, (full, prefix, num) => {
+        return prefix + '"' + num + '"';
+    });
     return patched.replace(/\x01(\d+)\x01/g, (_, i) => strings[parseInt(i, 10)]);
 }
 /**
- * Parse the raw HTTP response body.
- * Throws TigerError when code != 0.
- * Large integers in the outer envelope are not an issue (only inner `data` contains int64 IDs).
+ * Parse the raw HTTP response body. Throws TigerError when code != 0.
+ *
+ * patchLargeIntegers is applied before JSON.parse to preserve int64 order IDs
+ * (e.g. 28868646234578944) as strings rather than losing precision.
  */
 function parseApiResponse(body) {
-    const resp = JSON.parse(body);
+    const resp = JSON.parse(patchLargeIntegers(body));
     if (resp.code !== 0) {
         throw new errors_1.TigerError(resp.code, resp.message);
     }
@@ -37,15 +41,13 @@ function parseApiResponse(body) {
 }
 /**
  * Decode an ApiResponse.data payload into a typed value.
- * Handles the server's occasional double-encoded JSON (where `data` is a
- * JSON string that itself wraps JSON), seen on some trade endpoints.
+ * Handles double-encoded JSON (where `data` is a JSON string wrapping JSON),
+ * seen on some trade endpoints.
  */
 function unmarshalData(data) {
     if (data == null)
         return undefined;
     if (typeof data === 'string') {
-        // Attempt to parse JSON string (double-encoded case).
-        // Patch large integers before parsing so int64 IDs survive as strings.
         try {
             return JSON.parse(patchLargeIntegers(data));
         }

package/dist/cjs/client/token-methods.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryToken = queryToken;
+exports.refreshToken = refreshToken;
+exports.startTokenAutoRefresh = startTokenAutoRefresh;
+/**
+ * Call the `user_token_refresh` API and return the new token string.
+ * Read-only: does NOT update the stored token.
+ * Use `refreshToken()` to also update the in-memory config and optionally persist.
+ */
+async function queryToken(httpClient) {
+    return httpClient.queryToken();
+}
+/**
+ * Refresh the token: call the API, update the in-memory config token, and
+ * optionally persist via the provided TokenManager (file + writer callback).
+ *
+ * @param httpClient - The underlying HTTP client
+ * @param tokenManager - optional TokenManager for file persistence and writer callback
+ */
+async function refreshToken(httpClient, tokenManager) {
+    return httpClient.refreshToken(tokenManager);
+}
+/**
+ * Start background token auto-refresh. Returns a TokenManager that can be
+ * used to stop the background task via `tm.stopAutoRefresh()`.
+ *
+ * @param httpClient - The underlying HTTP client
+ * @param refreshDurationSecs - Refresh threshold in seconds (minimum 30).
+ *   When the token age exceeds this value the refresh is triggered.
+ * @param checkIntervalMs - How often to check whether a refresh is needed,
+ *   in milliseconds. Defaults to 300 000 ms (5 minutes).
+ * @param tokenWriter - Optional callback invoked with the new token string
+ *   after each successful refresh.
+ */
+function startTokenAutoRefresh(httpClient, refreshDurationSecs, checkIntervalMs, tokenWriter) {
+    return httpClient.startTokenAutoRefresh(null, {
+        refreshDuration: refreshDurationSecs,
+        refreshInterval: checkIntervalMs,
+        tokenWriter,
+    });
+}

package/dist/cjs/config/client-config.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SANDBOX_TIGER_PUBLIC_KEY = void 0;
 exports.loadPropertiesFile = loadPropertiesFile;
 exports.createClientConfig = createClientConfig;
 /**
@@ -26,6 +27,10 @@ const DEFAULT_TIMEOUT = 15;
 const DEFAULT_SERVER_URL = 'https://openapi.tigerfintech.com/gateway';
 /** Tiger public key for response signature verification (Base64-encoded) */
 const TIGER_PUBLIC_KEY = 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDNF3G8SoEcCZh2rshUbayDgLLrj6rKgzNMxDL2HSnKcB0+GPOsndqSv+a4IBu9+I3fyBp5hkyMMG2+AXugd9pMpy6VxJxlNjhX1MYbNTZJUT4nudki4uh+LMOkIBHOceGNXjgB+cXqmlUnjlqha/HgboeHSnSgpM3dKSJQlIOsDwIDAQAB';
+/** Sandbox / QA tiger public key for response signature verification */
+exports.SANDBOX_TIGER_PUBLIC_KEY = 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCbm21i11hgAENGd3/f280PSe4g9YGkS3TEXBYMidihTvHHf' +
+    '+tJ0PYD0o3PruI0hl3qhEjHTAxb75T5YD3SGK4IBhHn/Rk6mhqlGgI+bBrBVYaXixmHfRo75RpUUuWACyeqQk' +
+    'ZckgR0McxuW9xRMIa2cXZOoL1E4SL4lXKGhKoWbwIDAQAB';
 /** Environment variable names */
 const ENV_TIGER_ID = 'TIGEROPEN_TIGER_ID';
 const ENV_PRIVATE_KEY = 'TIGEROPEN_PRIVATE_KEY';
@@ -33,6 +38,9 @@ const ENV_ACCOUNT = 'TIGEROPEN_ACCOUNT';
 const ENV_SECRET_KEY = 'TIGEROPEN_SECRET_KEY';
 const ENV_TOKEN = 'TIGEROPEN_TOKEN';
 const ENV_TOKEN_FILE = 'TIGEROPEN_TOKEN_FILE';
+const ENV_TIGER_PUBLIC_KEY = 'TIGEROPEN_TIGER_PUBLIC_KEY';
+const ENV_SERVER_URL = 'TIGEROPEN_SERVER_URL';
+const ENV_QUOTE_SERVER_URL = 'TIGEROPEN_QUOTE_SERVER_URL';
 /**
  * Load and parse a Java-style properties file.
  *
@@ -105,23 +113,32 @@ function createClientConfig(options) {
     const opts = options ?? {};
     // Load properties: explicit path > auto-discovery
     let fileProps = {};
+    let configFileDir;
     if (opts.propertiesFilePath) {
         // Support both directory path and full file path
         let filePath = opts.propertiesFilePath;
         if ((0, fs_1.existsSync)(filePath) && (0, fs_1.statSync)(filePath).isDirectory()) {
+            configFileDir = filePath;
             filePath = (0, path_1.join)(filePath, CONFIG_FILE_NAME);
         }
         else if (!(0, fs_1.existsSync)(filePath) && !filePath.endsWith('.properties')) {
             // Path doesn't exist as-is; try treating it as a directory
             const asDir = (0, path_1.join)(filePath, CONFIG_FILE_NAME);
-            if ((0, fs_1.existsSync)(asDir))
+            if ((0, fs_1.existsSync)(asDir)) {
+                configFileDir = filePath;
                 filePath = asDir;
+            }
+        }
+        else {
+            // It's a file path: derive directory from it
+            configFileDir = (0, path_1.dirname)(filePath);
         }
         fileProps = loadPropertiesFile(filePath);
     }
     else {
         const discovered = discoverConfigFile();
         if (discovered) {
+            configFileDir = (0, path_1.dirname)(discovered);
             fileProps = loadPropertiesFile(discovered);
         }
     }
@@ -134,12 +151,15 @@ function createClientConfig(options) {
     const license = opts.license || fileProps['license'];
     const language = opts.language || fileProps['language'] || DEFAULT_LANGUAGE;
     const timezone = opts.timezone || fileProps['timezone'];
+    // tiger_public_key from properties file (e.g. for QA/sandbox environments)
+    let tigerPublicKey = opts.tigerPublicKey || fileProps['tiger_public_key'] || TIGER_PUBLIC_KEY;
     // Environment variables override everything
     const envTigerId = process.env[ENV_TIGER_ID];
     const envPrivateKey = process.env[ENV_PRIVATE_KEY];
     const envAccount = process.env[ENV_ACCOUNT];
     const envSecretKey = process.env[ENV_SECRET_KEY];
     const envToken = process.env[ENV_TOKEN];
+    const envTigerPublicKey = process.env[ENV_TIGER_PUBLIC_KEY];
     if (envTigerId) {
         tigerId = envTigerId;
     }
@@ -155,6 +175,9 @@ function createClientConfig(options) {
     if (envToken) {
         token = envToken;
     }
+    if (envTigerPublicKey) {
+        tigerPublicKey = envTigerPublicKey;
+    }
     // Token loading priority: env TIGEROPEN_TOKEN > tokenLoader > token file (TIGEROPEN_TOKEN_FILE or default)
     if (!token) {
         if (opts.tokenLoader) {
@@ -175,8 +198,9 @@ function createClientConfig(options) {
             }
         }
         else {
-            // Load from token file: TIGEROPEN_TOKEN_FILE env var > default file
-            const tokenFilePath = process.env[ENV_TOKEN_FILE] || 'tiger_openapi_token.properties';
+            // Load from token file: TIGEROPEN_TOKEN_FILE env var > config dir > default
+            const tokenFilePath = process.env[ENV_TOKEN_FILE]
+                || (configFileDir ? (0, path_1.join)(configFileDir, 'tiger_openapi_token.properties') : 'tiger_openapi_token.properties');
             const tm = new token_manager_1.TokenManager({ filePath: tokenFilePath });
             try {
                 token = tm.loadTokenSync();
@@ -193,29 +217,53 @@ function createClientConfig(options) {
     if (!privateKey) {
         throw new Error(`privateKey is required. Set it via options.privateKey, a config file, or the ${ENV_PRIVATE_KEY} environment variable.`);
     }
-    // Resolve server URL: explicit > dynamic domain > default
+    // Resolve server URL: env var > explicit opts > file > dynamic domain > default
     const enableDynamicDomain = opts.enableDynamicDomain ?? true;
     let serverUrl;
     let quoteServerUrl;
     // Query dynamic domains once (may spawn a child process); reuse for both URLs.
     let domainConf = {};
-    if (enableDynamicDomain && (!opts.serverUrl || !opts.quoteServerUrl)) {
+    const envServerUrl = process.env[ENV_SERVER_URL];
+    const envQuoteServerUrl = process.env[ENV_QUOTE_SERVER_URL];
+    const needServerUrl = !envServerUrl && !opts.serverUrl && !fileProps['server_url'];
+    const needQuoteServerUrl = !envQuoteServerUrl && !opts.quoteServerUrl && !fileProps['quote_server_url'];
+    if (enableDynamicDomain && (needServerUrl || needQuoteServerUrl)) {
         domainConf = (0, domain_1.queryDomains)(license);
     }
-    if (opts.serverUrl) {
+    if (envServerUrl) {
+        serverUrl = envServerUrl;
+    }
+    else if (opts.serverUrl) {
         serverUrl = opts.serverUrl;
     }
+    else if (fileProps['server_url']) {
+        serverUrl = fileProps['server_url'];
+    }
     else {
         const dynamicUrl = (0, domain_1.resolveDynamicServerUrl)(domainConf, license);
         serverUrl = dynamicUrl || DEFAULT_SERVER_URL;
     }
-    // Resolve quote server URL: explicit > dynamic domain > serverUrl fallback
-    if (opts.quoteServerUrl) {
+    // Resolve quote server URL: env var > explicit opts > file > dynamic domain > serverUrl fallback
+    if (envQuoteServerUrl) {
+        quoteServerUrl = envQuoteServerUrl;
+    }
+    else if (opts.quoteServerUrl) {
         quoteServerUrl = opts.quoteServerUrl;
     }
+    else if (fileProps['quote_server_url']) {
+        quoteServerUrl = fileProps['quote_server_url'];
+    }
     else {
-        const dynamicQuoteUrl = (0, domain_1.resolveDynamicQuoteServerUrl)(domainConf, license);
-        quoteServerUrl = dynamicQuoteUrl || serverUrl;
+        // Only use dynamic domain if serverUrl itself came from dynamic resolution (not pinned by env/opts/file).
+        // When serverUrl is pinned, prefer it as the quote fallback to avoid mixing environments.
+        const serverUrlPinned = !!(envServerUrl || opts.serverUrl || fileProps['server_url']);
+        if (!serverUrlPinned) {
+            const dynamicQuoteUrl = (0, domain_1.resolveDynamicQuoteServerUrl)(domainConf, license);
+            quoteServerUrl = dynamicQuoteUrl || serverUrl;
+        }
+        else {
+            quoteServerUrl = serverUrl;
+        }
     }
     return {
         tigerId,
@@ -234,7 +282,7 @@ function createClientConfig(options) {
         serverUrl,
         quoteServerUrl,
         deviceId: detectDeviceId(),
-        tigerPublicKey: opts.tigerPublicKey ?? TIGER_PUBLIC_KEY,
+        tigerPublicKey,
     };
 }
 /**

package/dist/cjs/config/config-parser.js

@@ -70,34 +70,34 @@ function parsePropertiesString(content) {
     let continuation = false;
     for (const rawLine of lines) {
         if (continuation) {
-            // 续行：去除前导空格后拼接
             const trimmedLeft = rawLine.replace(/^[ \t]+/, '');
-            if (trimmedLeft.endsWith('\\')) {
+            if (trimmedLeft === '' || trimmedLeft.startsWith('#') || trimmedLeft.startsWith('!')) {
+                continuation = false;
+            }
+            else if (endsWithContinuation(trimmedLeft)) {
                 currentLine += trimmedLeft.slice(0, -1);
                 continue;
             }
-            currentLine += trimmedLeft;
-            continuation = false;
+            else {
+                currentLine += trimmedLeft;
+                continuation = false;
+            }
         }
         else {
             const trimmed = rawLine.trim();
-            // 跳过空行
             if (trimmed === '') {
                 continue;
             }
-            // 跳过注释行
             if (trimmed.startsWith('#') || trimmed.startsWith('!')) {
                 continue;
             }
-            // 检查续行
-            if (trimmed.endsWith('\\')) {
+            if (endsWithContinuation(trimmed)) {
                 currentLine = trimmed.slice(0, -1);
                 continuation = true;
                 continue;
             }
             currentLine = trimmed;
         }
-        // 解析键值对
         const result = parseKeyValue(currentLine);
         if (result) {
             props[result[0]] = result[1];
@@ -113,6 +113,16 @@ function parsePropertiesString(content) {
     }
     return props;
 }
+/**
+ * 判断一行是否以续行标记结尾（奇数个末尾反斜杠）。
+ */
+function endsWithContinuation(line) {
+    let count = 0;
+    for (let i = line.length - 1; i >= 0 && line[i] === '\\'; i--) {
+        count++;
+    }
+    return count % 2 === 1;
+}
 /**
  * 解析单行键值对，支持 = 和 : 分隔符。
  * 值中可以包含 = 或 :，只按第一个分隔符拆分。

package/dist/cjs/config/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveDynamicQuoteServerUrl = exports.resolveDynamicServerUrl = exports.queryDomains = exports.TokenManager = exports.loadPropertiesFile = exports.createClientConfig = exports.parsePropertiesString = exports.parsePropertiesFile = void 0;
+exports.resolveDynamicQuoteServerUrl = exports.resolveDynamicServerUrl = exports.queryDomains = exports.TokenManager = exports.SANDBOX_TIGER_PUBLIC_KEY = exports.loadPropertiesFile = exports.createClientConfig = exports.parsePropertiesString = exports.parsePropertiesFile = void 0;
 /**
  * 配置层导出
  */
@@ -10,6 +10,7 @@ Object.defineProperty(exports, "parsePropertiesString", { enumerable: true, get:
 var client_config_1 = require("./client-config");
 Object.defineProperty(exports, "createClientConfig", { enumerable: true, get: function () { return client_config_1.createClientConfig; } });
 Object.defineProperty(exports, "loadPropertiesFile", { enumerable: true, get: function () { return client_config_1.loadPropertiesFile; } });
+Object.defineProperty(exports, "SANDBOX_TIGER_PUBLIC_KEY", { enumerable: true, get: function () { return client_config_1.SANDBOX_TIGER_PUBLIC_KEY; } });
 var token_manager_1 = require("./token-manager");
 Object.defineProperty(exports, "TokenManager", { enumerable: true, get: function () { return token_manager_1.TokenManager; } });
 var domain_1 = require("./domain");

package/dist/cjs/index.js

@@ -16,7 +16,7 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.orderStatusCode = exports.BarPeriod = exports.License = exports.Language = exports.FinancialReportPeriod = exports.OptionAnalysisPeriod = exports.SortDirection = exports.IndustryLevel = exports.CorporateActionType = exports.OrderSortBy = exports.SegmentType = exports.QuoteRight = exports.Currency = exports.Market = exports.TimeInForce = exports.OrderType = exports.SecurityType = exports.OrderStatus = exports.normalizeOrderStatus = exports.stopLimitOrder = exports.stopOrder = exports.limitOrder = exports.marketOrder = exports.SubjectType = exports.ConnectionState = exports.PushClient = exports.TradeClient = exports.parseOptionIdentifier = exports.QuoteClient = exports.classifyErrorCode = exports.TigerError = exports.HttpClient = exports.TokenManager = exports.loadPropertiesFile = exports.createClientConfig = exports.VERSION = void 0;
+exports.orderStatusCode = exports.BarPeriod = exports.License = exports.Language = exports.FinancialReportPeriod = exports.OptionAnalysisPeriod = exports.SortDirection = exports.IndustryLevel = exports.CorporateActionType = exports.OrderSortBy = exports.SegmentType = exports.QuoteRight = exports.Currency = exports.Market = exports.TimeInForce = exports.OrderType = exports.SecurityType = exports.OrderStatus = exports.normalizeOrderStatus = exports.stopLimitOrder = exports.stopOrder = exports.limitOrder = exports.marketOrder = exports.SubjectType = exports.ConnectionState = exports.PushClient = exports.TradeClient = exports.parseOptionIdentifier = exports.QuoteClient = exports.classifyErrorCode = exports.TigerError = exports.HttpClient = exports.TokenManager = exports.SANDBOX_TIGER_PUBLIC_KEY = exports.loadPropertiesFile = exports.createClientConfig = exports.VERSION = void 0;
 /** SDK 版本号 */
 var version_1 = require("./version");
 Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.SDK_VERSION; } });
@@ -24,6 +24,7 @@ Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () {
 var config_1 = require("./config");
 Object.defineProperty(exports, "createClientConfig", { enumerable: true, get: function () { return config_1.createClientConfig; } });
 Object.defineProperty(exports, "loadPropertiesFile", { enumerable: true, get: function () { return config_1.loadPropertiesFile; } });
+Object.defineProperty(exports, "SANDBOX_TIGER_PUBLIC_KEY", { enumerable: true, get: function () { return config_1.SANDBOX_TIGER_PUBLIC_KEY; } });
 var config_2 = require("./config");
 Object.defineProperty(exports, "TokenManager", { enumerable: true, get: function () { return config_2.TokenManager; } });
 // Transport

package/dist/cjs/model/enums.js

@@ -150,6 +150,7 @@ var TimeInForce;
 (function (TimeInForce) {
     TimeInForce["DAY"] = "DAY";
     TimeInForce["GTC"] = "GTC";
+    TimeInForce["GTD"] = "GTD";
     TimeInForce["OPG"] = "OPG";
 })(TimeInForce || (exports.TimeInForce = TimeInForce = {}));
 /** 订单排序字段 */
@@ -172,6 +173,9 @@ var CorporateActionType;
     CorporateActionType["Split"] = "split";
     CorporateActionType["Dividend"] = "dividend";
     CorporateActionType["Earning"] = "earning";
+    CorporateActionType["SymbolChange"] = "symbol_change";
+    CorporateActionType["Delisting"] = "delisting";
+    CorporateActionType["IPO"] = "ipo";
 })(CorporateActionType || (exports.CorporateActionType = CorporateActionType = {}));
 /** 行业级别 (1~4 级) */
 var IndustryLevel;

package/dist/cjs/model/order-helpers.js

@@ -9,8 +9,14 @@ exports.auctionLimitOrder = auctionLimitOrder;
 exports.auctionMarketOrder = auctionMarketOrder;
 exports.algoOrder = algoOrder;
 exports.icebergOrder = icebergOrder;
-exports.icebergOrderFull = icebergOrderFull;
 exports.orderLeg = orderLeg;
+exports.marketOrderByAmount = marketOrderByAmount;
+exports.limitOrderByAmount = limitOrderByAmount;
+exports.trailOrderByPrice = trailOrderByPrice;
+exports.limitOrderWithLegs = limitOrderWithLegs;
+exports.comboOrder = comboOrder;
+exports.ocaOrder = ocaOrder;
+exports.contractLeg = contractLeg;
 const enums_1 = require("./enums");
 /** Market order */
 function marketOrder(account, symbol, secType, action, quantity) {
@@ -101,26 +107,11 @@ function algoOrder(account, symbol, secType, action, quantity, limitPrice, algoT
     };
 }
 /**
- * Iceberg order (basic) — only displaySize required.
- */
-function icebergOrder(account, symbol, secType, action, quantity, limitPrice, displaySize) {
-    return {
-        account, symbol, secType, action,
-        orderType: enums_1.OrderType.ICEBERG,
-        totalQuantity: quantity,
-        limitPrice,
-        timeInForce: enums_1.TimeInForce.DAY,
-        outsideRth: false,
-        displaySize,
-        priceType: enums_1.PriceType.LIMIT_PRICE,
-    };
-}
-/**
- * Iceberg order (full params).
- * Pass `priceType` as empty string to use server default (LIMIT_PRICE).
+ * Iceberg order. `displaySize` is required; all other parameters are optional.
+ * Pass `priceType` as empty string to use the server default (LIMIT_PRICE).
  * Pass `startTime` / `endTime` as 0 to omit the time window.
  */
-function icebergOrderFull(account, symbol, secType, action, quantity, limitPrice, displaySize, minDisplaySize, checkIntervals, priceType, startTime, endTime) {
+function icebergOrder(account, symbol, secType, action, quantity, limitPrice, displaySize, minDisplaySize, checkIntervals, priceType, startTime, endTime) {
     const req = {
         account, symbol, secType, action,
         orderType: enums_1.OrderType.ICEBERG,
@@ -129,13 +120,12 @@ function icebergOrderFull(account, symbol, secType, action, quantity, limitPrice
         timeInForce: enums_1.TimeInForce.DAY,
         outsideRth: false,
         displaySize,
+        priceType: priceType || enums_1.PriceType.LIMIT_PRICE,
     };
     if (minDisplaySize !== undefined && minDisplaySize > 0)
         req.minDisplaySize = minDisplaySize;
     if (checkIntervals !== undefined && checkIntervals > 0)
         req.checkIntervals = checkIntervals;
-    if (priceType)
-        req.priceType = priceType;
     if (startTime && startTime > 0)
         req.startTime = startTime;
     if (endTime && endTime > 0)
@@ -146,3 +136,118 @@ function icebergOrderFull(account, symbol, secType, action, quantity, limitPrice
 function orderLeg(legType, price, timeInForce) {
     return { legType, price, timeInForce };
 }
+/**
+ * Market order by cash amount (instead of quantity).
+ * Server uses `isQuantityByAmount=true` + `amount` field.
+ */
+function marketOrderByAmount(account, symbol, secType, action, amount) {
+    return {
+        account, symbol, secType, action,
+        orderType: enums_1.OrderType.MKT,
+        totalQuantity: 0,
+        cashAmount: amount,
+        timeInForce: enums_1.TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * Limit order by cash amount (instead of quantity).
+ */
+function limitOrderByAmount(account, symbol, secType, action, amount, limitPrice) {
+    return {
+        account, symbol, secType, action,
+        orderType: enums_1.OrderType.LMT,
+        totalQuantity: 0,
+        cashAmount: amount,
+        limitPrice,
+        timeInForce: enums_1.TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * Trailing stop order using a fixed price offset (auxPrice) instead of a percentage.
+ * Use `trailOrder()` for percentage-based trailing stops.
+ */
+function trailOrderByPrice(account, symbol, secType, action, quantity, auxPrice) {
+    return {
+        account, symbol, secType, action,
+        orderType: enums_1.OrderType.TRAIL,
+        totalQuantity: quantity,
+        auxPrice,
+        timeInForce: enums_1.TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * Limit order with attached profit/loss legs (bracket order).
+ * At most 2 legs are supported.
+ *
+ * @param orderLegs - Array of `OrderLegRequest` (use `orderLeg()` helper)
+ */
+function limitOrderWithLegs(account, symbol, secType, action, quantity, limitPrice, orderLegs) {
+    if (orderLegs.length === 0) {
+        throw new Error('At least 1 order leg is required for a bracket order');
+    }
+    if (orderLegs.length > 2) {
+        throw new Error('At most 2 order legs are supported');
+    }
+    return {
+        account, symbol, secType, action,
+        orderType: enums_1.OrderType.LMT,
+        totalQuantity: quantity,
+        limitPrice,
+        orderLegs,
+        timeInForce: enums_1.TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * Multi-leg (combo/MLEG) order for options combos.
+ *
+ * @param contractLegs - Array of `ContractLegRequest` (use `contractLeg()` helper)
+ * @param comboType - e.g. `'MLEG'`
+ */
+function comboOrder(account, action, quantity, orderType, contractLegs, comboType = 'MLEG', limitPrice, auxPrice, trailingPercent) {
+    return {
+        account,
+        symbol: '', // not used for combo orders
+        secType: 'MLEG',
+        action,
+        orderType,
+        totalQuantity: quantity,
+        limitPrice,
+        auxPrice,
+        trailingPercent,
+        contractLegs,
+        comboType,
+        timeInForce: enums_1.TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * OCA (One-Cancels-All) order.
+ * Server expects `orderType: 'OCA'` and an `ocaOrders` list.
+ *
+ * @param ocaOrders - The contained orders (use any order helper to build each)
+ */
+function ocaOrder(account, symbol, secType, action, quantity, ocaOrders) {
+    return {
+        account, symbol, secType, action,
+        orderType: enums_1.OrderType.OCA,
+        totalQuantity: quantity,
+        ocaOrders,
+        timeInForce: enums_1.TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * Build a single leg for a multi-leg (MLEG / combo) order.
+ *
+ * @param symbol   - Underlying symbol
+ * @param secType  - Security type (e.g. `'OPT'`)
+ * @param action   - `'BUY'` or `'SELL'`
+ * @param ratio    - Number of contracts for this leg
+ */
+function contractLeg(symbol, secType, action, ratio, expiry, strike, right) {
+    return { symbol, secType, action, ratio, expiry, strike, right };
+}