@tigeropenapi/tigeropen 0.5.0 → 0.5.4

package/dist/esm/config/index.js

@@ -2,6 +2,6 @@
  * 配置层导出
  */
 export { parsePropertiesFile, parsePropertiesString } from './config-parser.js';
-export { createClientConfig, loadPropertiesFile } from './client-config.js';
+export { createClientConfig, loadPropertiesFile, SANDBOX_TIGER_PUBLIC_KEY } from './client-config.js';
 export { TokenManager } from './token-manager.js';
 export { queryDomains, resolveDynamicServerUrl, resolveDynamicQuoteServerUrl } from './domain.js';

package/dist/esm/index.js

@@ -17,7 +17,7 @@
 /** SDK 版本号 */
 export { SDK_VERSION as VERSION } from './version.js';
 // Config
-export { createClientConfig, loadPropertiesFile } from './config/index.js';
+export { createClientConfig, loadPropertiesFile, SANDBOX_TIGER_PUBLIC_KEY } from './config/index.js';
 export { TokenManager } from './config/index.js';
 // Transport
 export { HttpClient } from './client/index.js';

package/dist/esm/model/enums.js

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

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

@@ -88,26 +88,11 @@ export function algoOrder(account, symbol, secType, action, quantity, limitPrice
     };
 }
 /**
- * Iceberg order (basic) — only displaySize required.
- */
-export function icebergOrder(account, symbol, secType, action, quantity, limitPrice, displaySize) {
-    return {
-        account, symbol, secType, action,
-        orderType: OrderType.ICEBERG,
-        totalQuantity: quantity,
-        limitPrice,
-        timeInForce: TimeInForce.DAY,
-        outsideRth: false,
-        displaySize,
-        priceType: 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.
  */
-export function icebergOrderFull(account, symbol, secType, action, quantity, limitPrice, displaySize, minDisplaySize, checkIntervals, priceType, startTime, endTime) {
+export function icebergOrder(account, symbol, secType, action, quantity, limitPrice, displaySize, minDisplaySize, checkIntervals, priceType, startTime, endTime) {
     const req = {
         account, symbol, secType, action,
         orderType: OrderType.ICEBERG,
@@ -116,13 +101,12 @@ export function icebergOrderFull(account, symbol, secType, action, quantity, lim
         timeInForce: TimeInForce.DAY,
         outsideRth: false,
         displaySize,
+        priceType: priceType || 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)
@@ -133,3 +117,118 @@ export function icebergOrderFull(account, symbol, secType, action, quantity, lim
 export function orderLeg(legType, price, timeInForce) {
     return { legType, price, timeInForce };
 }
+/**
+ * Market order by cash amount (instead of quantity).
+ * Server uses `isQuantityByAmount=true` + `amount` field.
+ */
+export function marketOrderByAmount(account, symbol, secType, action, amount) {
+    return {
+        account, symbol, secType, action,
+        orderType: OrderType.MKT,
+        totalQuantity: 0,
+        cashAmount: amount,
+        timeInForce: TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * Limit order by cash amount (instead of quantity).
+ */
+export function limitOrderByAmount(account, symbol, secType, action, amount, limitPrice) {
+    return {
+        account, symbol, secType, action,
+        orderType: OrderType.LMT,
+        totalQuantity: 0,
+        cashAmount: amount,
+        limitPrice,
+        timeInForce: TimeInForce.DAY,
+        outsideRth: false,
+    };
+}
+/**
+ * Trailing stop order using a fixed price offset (auxPrice) instead of a percentage.
+ * Use `trailOrder()` for percentage-based trailing stops.
+ */
+export function trailOrderByPrice(account, symbol, secType, action, quantity, auxPrice) {
+    return {
+        account, symbol, secType, action,
+        orderType: OrderType.TRAIL,
+        totalQuantity: quantity,
+        auxPrice,
+        timeInForce: 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)
+ */
+export 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: OrderType.LMT,
+        totalQuantity: quantity,
+        limitPrice,
+        orderLegs,
+        timeInForce: 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'`
+ */
+export 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: 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)
+ */
+export function ocaOrder(account, symbol, secType, action, quantity, ocaOrders) {
+    return {
+        account, symbol, secType, action,
+        orderType: OrderType.OCA,
+        totalQuantity: quantity,
+        ocaOrders,
+        timeInForce: 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
+ */
+export function contractLeg(symbol, secType, action, ratio, expiry, strike, right) {
+    return { symbol, secType, action, ratio, expiry, strike, right };
+}

package/dist/esm/quote/quote-client.js

@@ -8,6 +8,7 @@
 import { HttpClient } from '../client/http-client.js';
 import { createApiRequest } from '../client/api-request.js';
 import { unmarshalData } from '../client/api-response.js';
+import * as tokenMethods from '../client/token-methods.js';
 /**
  * resolveOptionTimezone returns the timezone string to use for expiry conversion.
  * Explicit tz takes precedence; otherwise infer from symbol (.HK suffix → Asia/Hong_Kong, else America/New_York).
@@ -90,6 +91,25 @@ export class QuoteClient {
     static fromConfig(config) {
         return new QuoteClient(new HttpClient(config, undefined, { useQuoteServerUrl: true }));
     }
+    // ── Token management ──────────────────────────────────────────────────────
+    /** Call the `user_token_refresh` API and return the new token. Read-only. */
+    async queryToken() {
+        return tokenMethods.queryToken(this.httpClient);
+    }
+    /** Refresh the token and update the in-memory config token. */
+    async refreshToken(tokenManager) {
+        return tokenMethods.refreshToken(this.httpClient, tokenManager);
+    }
+    /**
+     * Start background token auto-refresh. Returns a TokenManager to stop with `tm.stopAutoRefresh()`.
+     *
+     * @param refreshDurationSecs - Refresh threshold in seconds (minimum 30).
+     * @param checkIntervalMs - How often to check, in milliseconds (default 300 000 / 5 min).
+     * @param tokenWriter - Optional callback invoked after each successful refresh.
+     */
+    startTokenAutoRefresh(refreshDurationSecs, checkIntervalMs, tokenWriter) {
+        return tokenMethods.startTokenAutoRefresh(this.httpClient, refreshDurationSecs, checkIntervalMs, tokenWriter);
+    }
     async callInto(method, bizParams, version) {
         const request = createApiRequest(method, bizParams, version);
         const response = await this.httpClient.executeRequest(request);
@@ -151,8 +171,10 @@ export class QuoteClient {
      *
      * @param timezone - Optional IANA timezone for expiry conversion (e.g. 'America/New_York').
      *   If omitted, defaults to America/New_York for US symbols and Asia/Hong_Kong for .HK symbols.
+     * @param returnGreekValue - Whether to return Greeks (delta/gamma/theta/vega/rho).
+     * @param optionFilter - Optional filter for in-the-money status, IV range, open interest range, Greeks ranges.
      */
-    async getOptionChain(items, timezone) {
+    async getOptionChain(items, timezone, returnGreekValue, optionFilter) {
         const optionBasic = items.map(([symbol, expiry]) => {
             if (!/^\d{4}-\d{2}-\d{2}$/.test(expiry)) {
                 throw new Error(`invalid expiry date, expected YYYY-MM-DD: ${expiry}`);
@@ -161,37 +183,27 @@ export class QuoteClient {
             const expiryMs = localMidnightMs(expiry, tz);
             return { symbol, expiry: expiryMs };
         });
-        return this.callInto('option_chain', { option_basic: optionBasic }, '3.0');
-    }
-    /**
-     * Real-time option quotes by OCC-style identifier.
-     *
-     * @param timezone - Optional IANA timezone for expiry conversion (e.g. 'America/New_York').
-     *   If omitted, defaults to America/New_York for US symbols and Asia/Hong_Kong for .HK symbols.
-     */
-    async getOptionQuote(identifiers, timezone) {
-        const optionBasic = identifiers.map((id) => {
-            const p = parseOptionIdentifier(id, timezone);
-            return { symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike };
-        });
-        return this.callInto('option_brief', { option_basic: optionBasic }, '2.0');
-    }
-    /** @deprecated Use getOptionQuote instead. */
-    async getOptionBrief(identifiers) {
-        return this.getOptionQuote(identifiers);
+        const body = { option_basic: optionBasic };
+        if (returnGreekValue !== undefined)
+            body['return_greek_value'] = returnGreekValue;
+        if (optionFilter !== undefined)
+            body['option_filter'] = optionFilter;
+        return this.callInto('option_chain', body, '3.0');
     }
     /**
      * Option K-line by OCC-style identifier.
      *
      * @param timezone - Optional IANA timezone for expiry conversion (e.g. 'America/New_York').
      *   If omitted, defaults to America/New_York for US symbols and Asia/Hong_Kong for .HK symbols.
+     * @param limit - Maximum number of bars to return.
+     * @param sortDir - Sort direction ('asc' or 'desc').
      */
-    async getOptionKline(identifiers, period, beginTime = -1, endTime = -1, timezone) {
+    async getOptionKline(identifiers, period, beginTime = -1, endTime = -1, timezone, limit, sortDir) {
         const resolvedBegin = beginTime === 0 ? -1 : beginTime;
         const resolvedEnd = endTime === 0 ? -1 : endTime;
         const optionQuery = identifiers.map((id) => {
             const p = parseOptionIdentifier(id, timezone);
-            return {
+            const entry = {
                 symbol: p.symbol,
                 expiry: p.expiryMs,
                 right: p.right,
@@ -200,9 +212,31 @@ export class QuoteClient {
                 begin_time: resolvedBegin,
                 end_time: resolvedEnd,
             };
+            if (limit !== undefined && limit > 0)
+                entry['limit'] = limit;
+            if (sortDir !== undefined && sortDir !== '')
+                entry['sort_dir'] = sortDir;
+            return entry;
         });
         return this.callInto('option_kline', { option_query: optionQuery }, '2.0');
     }
+    /**
+     * Real-time option quotes by OCC-style identifier.
+     *
+     * @param timezone - Optional IANA timezone for expiry conversion (e.g. 'America/New_York').
+     *   If omitted, defaults to America/New_York for US symbols and Asia/Hong_Kong for .HK symbols.
+     */
+    async getOptionQuote(identifiers, timezone) {
+        const optionBasic = identifiers.map((id) => {
+            const p = parseOptionIdentifier(id, timezone);
+            return { symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike };
+        });
+        return this.callInto('option_brief', { option_basic: optionBasic }, '2.0');
+    }
+    /** @deprecated Use getOptionQuote instead. */
+    async getOptionBrief(identifiers) {
+        return this.getOptionQuote(identifiers);
+    }
     // === Futures ===
     async getFutureExchange() {
         return this.callInto('future_exchange', { secType: 'FUT' });
@@ -520,6 +554,30 @@ export class QuoteClient {
             return [];
         return Object.values(grouped).flat();
     }
+    /** Corporate symbol change (flattened). wire: corporate_action (action_type=symbol_change) */
+    async getCorporateSymbolChange(req) {
+        const body = { ...req, actionType: 'symbol_change' };
+        const grouped = await this.callInto('corporate_action', body);
+        if (!grouped || typeof grouped !== 'object')
+            return [];
+        return Object.values(grouped).flat();
+    }
+    /** Corporate delisting (flattened). wire: corporate_action (action_type=delisting) */
+    async getCorporateDelisting(req) {
+        const body = { ...req, actionType: 'delisting' };
+        const grouped = await this.callInto('corporate_action', body);
+        if (!grouped || typeof grouped !== 'object')
+            return [];
+        return Object.values(grouped).flat();
+    }
+    /** Corporate IPO (flattened). wire: corporate_action (action_type=ipo) */
+    async getCorporateIPO(req) {
+        const body = { ...req, actionType: 'ipo' };
+        const grouped = await this.callInto('corporate_action', body);
+        if (!grouped || typeof grouped !== 'object')
+            return [];
+        return Object.values(grouped).flat();
+    }
     /** Financial currency per symbol. wire: financial_currency */
     async getFinancialCurrency(req) {
         return this.callInto('financial_currency', req);

package/dist/esm/trade/trade-client.js

@@ -10,6 +10,7 @@
 import { HttpClient } from '../client/http-client.js';
 import { createApiRequest } from '../client/api-request.js';
 import { unmarshalData } from '../client/api-response.js';
+import * as tokenMethods from '../client/token-methods.js';
 import { normalizeOrderStatus } from '../model/order-status.js';
 /** Normalize `Order.status` field in-place (handles int → string). */
 function normalizeOrderInPlace(o) {
@@ -41,8 +42,42 @@ export class TradeClient {
     static fromConfig(config, account, secretKey) {
         return new TradeClient(new HttpClient(config), account, secretKey);
     }
+    // ── Token management ──────────────────────────────────────────────────────
+    /** Call the `user_token_refresh` API and return the new token. Read-only. */
+    async queryToken() {
+        return tokenMethods.queryToken(this.httpClient);
+    }
+    /**
+     * Refresh the token: call the API, update the in-memory config token, and
+     * optionally persist via the provided TokenManager (file + writer callback).
+     *
+     * @param tokenManager - optional TokenManager for file persistence and writer callback
+     */
+    async refreshToken(tokenManager) {
+        return tokenMethods.refreshToken(this.httpClient, tokenManager);
+    }
+    /**
+     * Start background token auto-refresh. Returns a TokenManager that can be
+     * used to stop the background task via `tm.stopAutoRefresh()`.
+     *
+     * @param refreshDurationSecs - Refresh threshold in seconds (minimum 30).
+     * @param checkIntervalMs - How often to check, in milliseconds (default 300 000 / 5 min).
+     * @param tokenWriter - Optional callback invoked after each successful refresh.
+     */
+    startTokenAutoRefresh(refreshDurationSecs, checkIntervalMs, tokenWriter) {
+        return tokenMethods.startTokenAutoRefresh(this.httpClient, refreshDurationSecs, checkIntervalMs, tokenWriter);
+    }
     async callInto(method, bizParams) {
-        const request = createApiRequest(method, bizParams);
+        // Inject secretKey into every request when available (institution accounts require it).
+        // Individual methods that already set secretKey will not be overwritten (|| not &&).
+        let params = bizParams;
+        if (this.secretKey && params !== null && typeof params === 'object' && !Array.isArray(params)) {
+            const p = params;
+            if (p['secretKey'] == null && p['secret_key'] == null) {
+                params = { ...p, secretKey: this.secretKey };
+            }
+        }
+        const request = createApiRequest(method, params);
         const response = await this.httpClient.executeRequest(request);
         return unmarshalData(response.data);
     }
@@ -75,25 +110,18 @@ export class TradeClient {
     }
     // === Order operations ===
     async placeOrder(order) {
-        const params = { ...order, account: this.account };
-        if (!params.secretKey && this.secretKey)
-            params.secretKey = this.secretKey;
-        return this.callInto('place_order', params);
+        return this.callInto('place_order', { ...order, account: this.account });
     }
     async previewOrder(order) {
         return this.callInto('preview_order', { ...order, account: this.account });
     }
     async modifyOrder(id, order) {
-        const params = { ...order, account: this.account, id };
-        if (!params.secretKey && this.secretKey)
-            params.secretKey = this.secretKey;
-        return this.callInto('modify_order', params);
+        return this.callInto('modify_order', { ...order, account: this.account, id });
     }
     async cancelOrder(id, secretKey) {
-        const sk = secretKey ?? this.secretKey;
         const params = { account: this.account, id };
-        if (sk)
-            params.secretKey = sk;
+        if (secretKey !== undefined)
+            params.secretKey = secretKey; // per-call override takes precedence; undefined means use config default
         return this.callInto('cancel_order', params);
     }
     // === Order queries (BREAKING v0.4.0) ===
@@ -131,14 +159,11 @@ export class TradeClient {
     }
     /**
      * Get a single order by ID (v0.4.0 new).
-     * Wire method: `orders` with id/order_id param; server returns a single Order object
-     * (not `{items:[]}` envelope).
-     *
      * Returns `undefined` if no match.
      */
     async getOrder(req) {
         const merged = withAccount(req, this.account);
-        const out = await this.callInto('orders', merged);
+        const out = await this.callInto('order_no', merged);
         if (!out || (!out.id && !out.orderId))
             return undefined;
         normalizeOrderInPlace(out);

package/dist/types/client/api-response.d.ts

@@ -12,14 +12,15 @@ export interface ApiResponse {
     sign?: string;
 }
 /**
- * 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.
  */
 export declare function parseApiResponse(body: string): ApiResponse;
 /**
  * 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.
  */
 export declare function unmarshalData<T>(data: unknown): T | undefined;

package/dist/types/client/token-methods.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared token management methods for TradeClient and QuoteClient.
+ * Both clients delegate to the underlying HttpClient; this module
+ * centralises the JSDoc so each client stays in sync automatically.
+ */
+import type { HttpClient } from './http-client';
+import type { TokenManager } from '../config/token-manager';
+/**
+ * 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.
+ */
+export declare function queryToken(httpClient: HttpClient): Promise<string>;
+/**
+ * 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
+ */
+export declare function refreshToken(httpClient: HttpClient, tokenManager?: TokenManager | null): Promise<void>;
+/**
+ * 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.
+ */
+export declare function startTokenAutoRefresh(httpClient: HttpClient, refreshDurationSecs: number, checkIntervalMs?: number, tokenWriter?: (token: string) => void): TokenManager;

package/dist/types/config/client-config.d.ts

@@ -1,3 +1,5 @@
+/** Sandbox / QA tiger public key for response signature verification */
+export declare const SANDBOX_TIGER_PUBLIC_KEY: string;
 /** Client configuration interface */
 export interface ClientConfig {
     tigerId: string;

package/dist/types/config/index.d.ts

@@ -2,7 +2,7 @@
  * 配置层导出
  */
 export { parsePropertiesFile, parsePropertiesString } from './config-parser';
-export { createClientConfig, loadPropertiesFile } from './client-config';
+export { createClientConfig, loadPropertiesFile, SANDBOX_TIGER_PUBLIC_KEY } from './client-config';
 export type { ClientConfig, ClientConfigOptions } from './client-config';
 export { TokenManager } from './token-manager';
 export type { TokenManagerOptions, RefreshFn } from './token-manager';

package/dist/types/index.d.ts

@@ -16,7 +16,7 @@
  */
 /** SDK 版本号 */
 export { SDK_VERSION as VERSION } from './version';
-export { createClientConfig, loadPropertiesFile } from './config';
+export { createClientConfig, loadPropertiesFile, SANDBOX_TIGER_PUBLIC_KEY } from './config';
 export type { ClientConfig, ClientConfigOptions } from './config';
 export { TokenManager } from './config';
 export type { TokenManagerOptions, RefreshFn } from './config';
@@ -27,13 +27,13 @@ export { QuoteClient, parseOptionIdentifier } from './quote';
 export { TradeClient } from './trade';
 export { PushClient, ConnectionState, SubjectType } from './push';
 export type { PushClientOptions } from './push';
-export type { Order, OrderRequest } from './model/order';
+export type { Order, OrderRequest, ContractLegRequest } from './model/order';
 export { marketOrder, limitOrder, stopOrder, stopLimitOrder } from './model/order-helpers';
 export { normalizeOrderStatus } from './model/order-status';
 export type { Contract } from './model/contract';
 export type { Position } from './model/position';
 export type { Asset, AssetSegment, PrimeAsset, PreviewResult, PlaceOrderResult, OrderIdResult, Transaction, ManagedAccount, AnalyticsAsset, AggregateAssets, EstimateTradableQuantity, ForexOrderResult, SegmentFund, SegmentFundAvailableItem, SegmentFundHistoryItem, FundDetails, FundingHistoryItem, PositionTransferRecord, PositionTransferDetail, PositionTransferExternalRecord, OptionExerciseCheckResult, OptionExercisePositionPageResult, OptionExerciseRecordPageResult, } from './model/trade';
 export type { OrdersRequest, GetOrderRequest, OrderTransactionsRequest, PositionsRequest, AssetsRequest, ManagedAccountsRequest, DerivativeContractsRequest, AnalyticsAssetRequest, AggregateAssetsRequest, EstimateTradableQuantityRequest, ForexOrderRequest, SegmentFundRequest, FundDetailsRequest, FundingHistoryRequest, PositionTransferRequest, PositionTransferRecordsRequest, PositionTransferDetailRequest, PositionTransferExternalRecordsRequest, OptionExerciseCheckRequest, OptionExercisePositionRequest, OptionExerciseSubmitRequest, OptionExerciseRecordsRequest, OptionExerciseCancelRequest, } from './model/trade-requests';
-export type { MarketState, Brief, Kline, KlineItem, Timeline, TimelineItem, TradeTick, TradeTickItem, Depth, DepthLevel, OptionExpiration, OptionChain, OptionChainRow, OptionSymbol, FutureExchange, FutureContractInfo, FutureQuote, FutureKline, FutureKlineItem, FutureDepth, FutureTradeTickItem, FutureTradingTime, FinancialDailyItem, FinancialReportItem, CorporateAction, CapitalFlow, CapitalFlowItem, CapitalDistribution, ScannerResult, ScannerResultItem, QuotePermission, SymbolName, TradeMeta, StockDetail, StockBroker, StockBrokerItem, ShortInterest, StockIndustry, IndustryItem, IndustryStock, WarrantBrief, WarrantFilterResult, FundContractInfo, FundQuote, FundHistoryQuote, QuoteOvernight, KlineQuota, MarketScannerTag, MarketScannerTags, OptionAnalysis, OptionLeg, OptionVolatilityPoint, ExchangeRate, FinancialCurrency, BrokerDetail, TradingCalendarItem, FutureMainContractHistory, } from './model/quote';
+export type { MarketState, Brief, Kline, KlineItem, Timeline, TimelineItem, TradeTick, TradeTickItem, Depth, DepthLevel, OptionExpiration, OptionChain, OptionChainRow, OptionSymbol, OptionChainFilter, OptionChainFilterGreeks, Range, FutureExchange, FutureContractInfo, FutureQuote, FutureKline, FutureKlineItem, FutureDepth, FutureTradeTickItem, FutureTradingTime, FinancialDailyItem, FinancialReportItem, CorporateAction, CorporateSymbolChange, CorporateDelisting, CorporateIPO, CapitalFlow, CapitalFlowItem, CapitalDistribution, ScannerResult, ScannerResultItem, QuotePermission, SymbolName, TradeMeta, StockDetail, StockBroker, StockBrokerItem, ShortInterest, StockIndustry, IndustryItem, IndustryStock, WarrantBrief, WarrantFilterResult, FundContractInfo, FundQuote, FundHistoryQuote, QuoteOvernight, KlineQuota, MarketScannerTag, MarketScannerTags, OptionAnalysis, OptionLeg, OptionVolatilityPoint, ExchangeRate, FinancialCurrency, BrokerDetail, TradingCalendarItem, FutureMainContractHistory, } from './model/quote';
 export type { BriefRequest, DepthQuoteRequest, TradeTickRequest, KlineRequest, KlineByPageRequest, FutureBriefRequest, FutureKlineRequest, FutureKlineByPageRequest, FutureTradeTicksRequest, FutureDepthRequest, FutureContractSingleRequest, FutureContinuousContractsRequest, FutureHistoryMainContractRequest, FutureTradingTimesRequest, AllFutureContractsRequest, OptionTradeTicksRequest, OptionTimelineRequest, OptionDepthRequest, OptionSymbolsRequest, OptionAnalysisRequest, OptionQueryItem, ShortInterestRequest, StockBrokerRequest, StockDetailsRequest, StockFundamentalRequest, StockIndustryRequest, StockDelayBriefsRequest, SymbolsRequest, TradeMetasRequest, TradeRankRequest, TimelineHistoryRequest, TradingCalendarRequest, KlineQuotaRequest, QuotePermissionRequest, QuoteOvernightRequest, IndustryListRequest, IndustryStocksRequest, FundSymbolsRequest, FundContractsRequest, FundQuoteRequest, FundHistoryQuoteRequest, WarrantBriefsRequest, WarrantFilterRequest, MarketScannerTagsRequest, FinancialCurrencyRequest, FinancialExchangeRateRequest, } from './model/quote-requests';
 export { OrderStatus, SecurityType, OrderType, TimeInForce, Market, Currency, QuoteRight, SegmentType, OrderSortBy, CorporateActionType, IndustryLevel, SortDirection, OptionAnalysisPeriod, FinancialReportPeriod, Language, License, BarPeriod, orderStatusCode, } from './model/enums';

package/dist/types/model/enums.d.ts

@@ -115,6 +115,7 @@ export declare enum License {
 export declare enum TimeInForce {
     DAY = "DAY",
     GTC = "GTC",
+    GTD = "GTD",
     OPG = "OPG"
 }
 /** 订单排序字段 */
@@ -133,7 +134,10 @@ export declare enum SegmentType {
 export declare enum CorporateActionType {
     Split = "split",
     Dividend = "dividend",
-    Earning = "earning"
+    Earning = "earning",
+    SymbolChange = "symbol_change",
+    Delisting = "delisting",
+    IPO = "ipo"
 }
 /** 行业级别 (1~4 级) */
 export declare enum IndustryLevel {

package/dist/types/model/order-helpers.d.ts

@@ -2,7 +2,7 @@
  * Order construction helpers.
  * All helpers return an `OrderRequest` with sensible defaults.
  */
-import type { OrderRequest, OrderLegRequest, AlgoParamsRequest } from './order';
+import type { OrderRequest, OrderLegRequest, AlgoParamsRequest, ContractLegRequest } from './order';
 import { PriceType } from './enums';
 /** Market order */
 export declare function marketOrder(account: string, symbol: string, secType: string, action: string, quantity: number): OrderRequest;
@@ -21,14 +21,54 @@ export declare function auctionMarketOrder(account: string, symbol: string, secT
 /** Algo order (TWAP / VWAP) */
 export declare function algoOrder(account: string, symbol: string, secType: string, action: string, quantity: number, limitPrice: number, algoType: string, params: AlgoParamsRequest): OrderRequest;
 /**
- * Iceberg order (basic) — only displaySize required.
- */
-export declare function icebergOrder(account: string, symbol: string, secType: string, action: string, quantity: number, limitPrice: number, displaySize: number): OrderRequest;
-/**
- * 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.
  */
-export declare function icebergOrderFull(account: string, symbol: string, secType: string, action: string, quantity: number, limitPrice: number, displaySize: number, minDisplaySize?: number, checkIntervals?: number, priceType?: PriceType | string, startTime?: number, endTime?: number): OrderRequest;
+export declare function icebergOrder(account: string, symbol: string, secType: string, action: string, quantity: number, limitPrice: number, displaySize: number, minDisplaySize?: number, checkIntervals?: number, priceType?: PriceType | string, startTime?: number, endTime?: number): OrderRequest;
 /** Attached profit / loss leg */
 export declare function orderLeg(legType: string, price: number, timeInForce: string): OrderLegRequest;
+/**
+ * Market order by cash amount (instead of quantity).
+ * Server uses `isQuantityByAmount=true` + `amount` field.
+ */
+export declare function marketOrderByAmount(account: string, symbol: string, secType: string, action: string, amount: number): OrderRequest;
+/**
+ * Limit order by cash amount (instead of quantity).
+ */
+export declare function limitOrderByAmount(account: string, symbol: string, secType: string, action: string, amount: number, limitPrice: number): OrderRequest;
+/**
+ * Trailing stop order using a fixed price offset (auxPrice) instead of a percentage.
+ * Use `trailOrder()` for percentage-based trailing stops.
+ */
+export declare function trailOrderByPrice(account: string, symbol: string, secType: string, action: string, quantity: number, auxPrice: number): OrderRequest;
+/**
+ * Limit order with attached profit/loss legs (bracket order).
+ * At most 2 legs are supported.
+ *
+ * @param orderLegs - Array of `OrderLegRequest` (use `orderLeg()` helper)
+ */
+export declare function limitOrderWithLegs(account: string, symbol: string, secType: string, action: string, quantity: number, limitPrice: number, orderLegs: OrderLegRequest[]): OrderRequest;
+/**
+ * Multi-leg (combo/MLEG) order for options combos.
+ *
+ * @param contractLegs - Array of `ContractLegRequest` (use `contractLeg()` helper)
+ * @param comboType - e.g. `'MLEG'`
+ */
+export declare function comboOrder(account: string, action: string, quantity: number, orderType: string, contractLegs: ContractLegRequest[], comboType?: string, limitPrice?: number, auxPrice?: number, trailingPercent?: number): OrderRequest;
+/**
+ * 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)
+ */
+export declare function ocaOrder(account: string, symbol: string, secType: string, action: string, quantity: number, ocaOrders: OrderRequest[]): OrderRequest;
+/**
+ * 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
+ */
+export declare function contractLeg(symbol: string, secType: string, action: string, ratio: number, expiry?: string, strike?: string, right?: string): ContractLegRequest;