@tigeropenapi/tigeropen 0.4.5 → 0.4.7

package/README.md

@@ -312,7 +312,7 @@ const { createClientConfig } = require('@tigeropenapi/tigeropen');
 ## References
 
 - [TypeScript SDK Documentation](https://docs.itigerup.com/docs/typescript)
-- [Tiger Brokers OpenAPI Docs](https://quant.itigerup.com/openapi/zh/python/overview/introduction.html)
+- [Tiger Brokers OpenAPI Docs](https://docs-en.itigerup.com/docs/)
 - [npm package](https://www.npmjs.com/package/@tigeropenapi/tigeropen)
 
 ## License
@@ -635,7 +635,7 @@ const { createClientConfig } = require('@tigeropenapi/tigeropen');
 ## 参考链接
 
 - [TypeScript SDK 文档](https://docs.itigerup.com/docs/typescript)
-- [老虎证券 OpenAPI 文档](https://quant.itigerup.com/openapi/zh/python/overview/introduction.html)
+- [老虎证券 OpenAPI 文档](https://docs.itigerup.com/docs/)
 - [npm 包](https://www.npmjs.com/package/@tigeropenapi/tigeropen)
 
 ## 许可证

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

@@ -6,9 +6,27 @@ exports.unmarshalData = unmarshalData;
  * API response parsing.
  */
 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.
+ */
+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.
+    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).
  */
 function parseApiResponse(body) {
     const resp = JSON.parse(body);
@@ -26,9 +44,10 @@ function unmarshalData(data) {
     if (data == null)
         return undefined;
     if (typeof data === 'string') {
-        // Attempt to parse JSON string (double-encoded case)
+        // Attempt to parse JSON string (double-encoded case).
+        // Patch large integers before parsing so int64 IDs survive as strings.
         try {
-            return JSON.parse(data);
+            return JSON.parse(patchLargeIntegers(data));
         }
         catch {
             return data;

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

@@ -30,6 +30,7 @@ const TIGER_PUBLIC_KEY = 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDNF3G8SoEcCZh2rs
 const ENV_TIGER_ID = 'TIGEROPEN_TIGER_ID';
 const ENV_PRIVATE_KEY = 'TIGEROPEN_PRIVATE_KEY';
 const ENV_ACCOUNT = 'TIGEROPEN_ACCOUNT';
+const ENV_SECRET_KEY = 'TIGEROPEN_SECRET_KEY';
 const ENV_TOKEN = 'TIGEROPEN_TOKEN';
 const ENV_TOKEN_FILE = 'TIGEROPEN_TOKEN_FILE';
 /**
@@ -128,6 +129,7 @@ function createClientConfig(options) {
     let tigerId = opts.tigerId || fileProps['tiger_id'] || '';
     let privateKey = opts.privateKey || resolvePrivateKey(fileProps) || '';
     let account = opts.account || fileProps['account'] || '';
+    let secretKey = opts.secretKey || fileProps['secret_key'] || undefined;
     let token = opts.token || fileProps['token'];
     const license = opts.license || fileProps['license'];
     const language = opts.language || fileProps['language'] || DEFAULT_LANGUAGE;
@@ -136,6 +138,7 @@ function createClientConfig(options) {
     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];
     if (envTigerId) {
         tigerId = envTigerId;
@@ -146,6 +149,9 @@ function createClientConfig(options) {
     if (envAccount) {
         account = envAccount;
     }
+    if (envSecretKey) {
+        secretKey = envSecretKey;
+    }
     if (envToken) {
         token = envToken;
     }
@@ -215,6 +221,7 @@ function createClientConfig(options) {
         tigerId,
         privateKey,
         account,
+        secretKey: secretKey || undefined,
         license,
         language,
         timezone,

package/dist/cjs/index.js

@@ -18,7 +18,7 @@
 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;
 /** SDK 版本号 */
-exports.VERSION = '0.4.4';
+exports.VERSION = '0.4.6';
 // Config
 var config_1 = require("./config");
 Object.defineProperty(exports, "createClientConfig", { enumerable: true, get: function () { return config_1.createClientConfig; } });

package/dist/cjs/model/enums.js

@@ -4,7 +4,7 @@
  * 所有枚举值与 API JSON 保持一致
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FinancialReportPeriod = exports.OptionAnalysisPeriod = exports.SortDirection = exports.IndustryLevel = exports.CorporateActionType = exports.SegmentType = exports.OrderSortBy = exports.TimeInForce = exports.License = exports.QuoteRight = exports.Language = exports.BarPeriod = exports.OrderStatus = exports.OrderType = exports.Currency = exports.SecurityType = exports.Market = void 0;
+exports.FinancialReportPeriod = exports.OptionAnalysisPeriod = exports.SortDirection = exports.IndustryLevel = exports.CorporateActionType = exports.SegmentType = exports.OrderSortBy = exports.TimeInForce = exports.License = exports.QuoteRight = exports.Language = exports.BarPeriod = exports.OrderStatus = exports.PriceType = exports.OrderType = exports.Currency = exports.SecurityType = exports.Market = void 0;
 exports.orderStatusCode = orderStatusCode;
 /** 市场枚举 */
 var Market;
@@ -51,7 +51,20 @@ var OrderType;
     OrderType["TWAP"] = "TWAP";
     OrderType["VWAP"] = "VWAP";
     OrderType["OCA"] = "OCA";
+    OrderType["ICEBERG"] = "ICEBERG";
 })(OrderType || (exports.OrderType = OrderType = {}));
+/** 冰山单价格类型 */
+var PriceType;
+(function (PriceType) {
+    /** 限价 */
+    PriceType["LIMIT_PRICE"] = "LIMIT_PRICE";
+    /** 卖一价 */
+    PriceType["ASK_PRICE"] = "ASK_PRICE";
+    /** 买一价 */
+    PriceType["BID_PRICE"] = "BID_PRICE";
+    /** 最新价 */
+    PriceType["LATEST_PRICE"] = "LATEST_PRICE";
+})(PriceType || (exports.PriceType = PriceType = {}));
 /**
  * 订单状态枚举。对齐 Java SDK OrderStatus 定义。
  *

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

@@ -8,6 +8,8 @@ exports.trailOrder = trailOrder;
 exports.auctionLimitOrder = auctionLimitOrder;
 exports.auctionMarketOrder = auctionMarketOrder;
 exports.algoOrder = algoOrder;
+exports.icebergOrder = icebergOrder;
+exports.icebergOrderFull = icebergOrderFull;
 exports.orderLeg = orderLeg;
 const enums_1 = require("./enums");
 /** Market order */
@@ -98,6 +100,48 @@ function algoOrder(account, symbol, secType, action, quantity, limitPrice, algoT
         outsideRth: false,
     };
 }
+/**
+ * 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).
+ * Pass `startTime` / `endTime` as 0 to omit the time window.
+ */
+function icebergOrderFull(account, symbol, secType, action, quantity, limitPrice, displaySize, minDisplaySize, checkIntervals, priceType, startTime, endTime) {
+    const req = {
+        account, symbol, secType, action,
+        orderType: enums_1.OrderType.ICEBERG,
+        totalQuantity: quantity,
+        limitPrice,
+        timeInForce: enums_1.TimeInForce.DAY,
+        outsideRth: false,
+        displaySize,
+    };
+    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)
+        req.endTime = endTime;
+    return req;
+}
 /** Attached profit / loss leg */
 function orderLeg(legType, price, timeInForce) {
     return { legType, price, timeInForce };

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

@@ -25,9 +25,10 @@ function withAccount(req, account) {
 }
 /** Trading client wrapping all trade-related APIs. */
 class TradeClient {
-    constructor(httpClient, account) {
+    constructor(httpClient, account, secretKey) {
         this.httpClient = httpClient;
         this.account = account;
+        this.secretKey = secretKey;
     }
     async callInto(method, bizParams) {
         const request = (0, api_request_1.createApiRequest)(method, bizParams);
@@ -63,16 +64,26 @@ class TradeClient {
     }
     // === Order operations ===
     async placeOrder(order) {
-        return this.callInto('place_order', { ...order, account: this.account });
+        const params = { ...order, account: this.account };
+        if (!params.secretKey && this.secretKey)
+            params.secretKey = this.secretKey;
+        return this.callInto('place_order', params);
     }
     async previewOrder(order) {
         return this.callInto('preview_order', { ...order, account: this.account });
     }
     async modifyOrder(id, order) {
-        return this.callInto('modify_order', { ...order, account: this.account, id });
-    }
-    async cancelOrder(id) {
-        return this.callInto('cancel_order', { account: this.account, id });
+        const params = { ...order, account: this.account, id };
+        if (!params.secretKey && this.secretKey)
+            params.secretKey = this.secretKey;
+        return this.callInto('modify_order', params);
+    }
+    async cancelOrder(id, secretKey) {
+        const sk = secretKey ?? this.secretKey;
+        const params = { account: this.account, id };
+        if (sk)
+            params.secretKey = sk;
+        return this.callInto('cancel_order', params);
     }
     // === Order queries (BREAKING v0.4.0) ===
     /**

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

@@ -2,9 +2,27 @@
  * API response parsing.
  */
 import { TigerError } from './errors.js';
+/**
+ * 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.
+ */
+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.
+    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).
  */
 export function parseApiResponse(body) {
     const resp = JSON.parse(body);
@@ -22,9 +40,10 @@ export function unmarshalData(data) {
     if (data == null)
         return undefined;
     if (typeof data === 'string') {
-        // Attempt to parse JSON string (double-encoded case)
+        // Attempt to parse JSON string (double-encoded case).
+        // Patch large integers before parsing so int64 IDs survive as strings.
         try {
-            return JSON.parse(data);
+            return JSON.parse(patchLargeIntegers(data));
         }
         catch {
             return data;

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

@@ -26,6 +26,7 @@ const TIGER_PUBLIC_KEY = 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDNF3G8SoEcCZh2rs
 const ENV_TIGER_ID = 'TIGEROPEN_TIGER_ID';
 const ENV_PRIVATE_KEY = 'TIGEROPEN_PRIVATE_KEY';
 const ENV_ACCOUNT = 'TIGEROPEN_ACCOUNT';
+const ENV_SECRET_KEY = 'TIGEROPEN_SECRET_KEY';
 const ENV_TOKEN = 'TIGEROPEN_TOKEN';
 const ENV_TOKEN_FILE = 'TIGEROPEN_TOKEN_FILE';
 /**
@@ -124,6 +125,7 @@ export function createClientConfig(options) {
     let tigerId = opts.tigerId || fileProps['tiger_id'] || '';
     let privateKey = opts.privateKey || resolvePrivateKey(fileProps) || '';
     let account = opts.account || fileProps['account'] || '';
+    let secretKey = opts.secretKey || fileProps['secret_key'] || undefined;
     let token = opts.token || fileProps['token'];
     const license = opts.license || fileProps['license'];
     const language = opts.language || fileProps['language'] || DEFAULT_LANGUAGE;
@@ -132,6 +134,7 @@ export function createClientConfig(options) {
     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];
     if (envTigerId) {
         tigerId = envTigerId;
@@ -142,6 +145,9 @@ export function createClientConfig(options) {
     if (envAccount) {
         account = envAccount;
     }
+    if (envSecretKey) {
+        secretKey = envSecretKey;
+    }
     if (envToken) {
         token = envToken;
     }
@@ -211,6 +217,7 @@ export function createClientConfig(options) {
         tigerId,
         privateKey,
         account,
+        secretKey: secretKey || undefined,
         license,
         language,
         timezone,

package/dist/esm/index.js

@@ -15,7 +15,7 @@
  * @packageDocumentation
  */
 /** SDK 版本号 */
-export const VERSION = '0.4.4';
+export const VERSION = '0.4.6';
 // Config
 export { createClientConfig, loadPropertiesFile } from './config/index.js';
 export { TokenManager } from './config/index.js';

package/dist/esm/model/enums.js

@@ -47,7 +47,20 @@ export var OrderType;
     OrderType["TWAP"] = "TWAP";
     OrderType["VWAP"] = "VWAP";
     OrderType["OCA"] = "OCA";
+    OrderType["ICEBERG"] = "ICEBERG";
 })(OrderType || (OrderType = {}));
+/** 冰山单价格类型 */
+export var PriceType;
+(function (PriceType) {
+    /** 限价 */
+    PriceType["LIMIT_PRICE"] = "LIMIT_PRICE";
+    /** 卖一价 */
+    PriceType["ASK_PRICE"] = "ASK_PRICE";
+    /** 买一价 */
+    PriceType["BID_PRICE"] = "BID_PRICE";
+    /** 最新价 */
+    PriceType["LATEST_PRICE"] = "LATEST_PRICE";
+})(PriceType || (PriceType = {}));
 /**
  * 订单状态枚举。对齐 Java SDK OrderStatus 定义。
  *

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

@@ -1,4 +1,4 @@
-import { OrderType, TimeInForce } from './enums.js';
+import { OrderType, TimeInForce, PriceType } from './enums.js';
 /** Market order */
 export function marketOrder(account, symbol, secType, action, quantity) {
     return {
@@ -87,6 +87,48 @@ export function algoOrder(account, symbol, secType, action, quantity, limitPrice
         outsideRth: false,
     };
 }
+/**
+ * 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).
+ * 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) {
+    const req = {
+        account, symbol, secType, action,
+        orderType: OrderType.ICEBERG,
+        totalQuantity: quantity,
+        limitPrice,
+        timeInForce: TimeInForce.DAY,
+        outsideRth: false,
+        displaySize,
+    };
+    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)
+        req.endTime = endTime;
+    return req;
+}
 /** Attached profit / loss leg */
 export function orderLeg(legType, price, timeInForce) {
     return { legType, price, timeInForce };

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

@@ -22,9 +22,10 @@ function withAccount(req, account) {
 }
 /** Trading client wrapping all trade-related APIs. */
 export class TradeClient {
-    constructor(httpClient, account) {
+    constructor(httpClient, account, secretKey) {
         this.httpClient = httpClient;
         this.account = account;
+        this.secretKey = secretKey;
     }
     async callInto(method, bizParams) {
         const request = createApiRequest(method, bizParams);
@@ -60,16 +61,26 @@ export class TradeClient {
     }
     // === Order operations ===
     async placeOrder(order) {
-        return this.callInto('place_order', { ...order, account: this.account });
+        const params = { ...order, account: this.account };
+        if (!params.secretKey && this.secretKey)
+            params.secretKey = this.secretKey;
+        return this.callInto('place_order', params);
     }
     async previewOrder(order) {
         return this.callInto('preview_order', { ...order, account: this.account });
     }
     async modifyOrder(id, order) {
-        return this.callInto('modify_order', { ...order, account: this.account, id });
-    }
-    async cancelOrder(id) {
-        return this.callInto('cancel_order', { account: this.account, id });
+        const params = { ...order, account: this.account, id };
+        if (!params.secretKey && this.secretKey)
+            params.secretKey = this.secretKey;
+        return this.callInto('modify_order', params);
+    }
+    async cancelOrder(id, secretKey) {
+        const sk = secretKey ?? this.secretKey;
+        const params = { account: this.account, id };
+        if (sk)
+            params.secretKey = sk;
+        return this.callInto('cancel_order', params);
     }
     // === Order queries (BREAKING v0.4.0) ===
     /**

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

@@ -14,6 +14,7 @@ export interface ApiResponse {
 /**
  * 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).
  */
 export declare function parseApiResponse(body: string): ApiResponse;
 /**

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

@@ -3,6 +3,8 @@ export interface ClientConfig {
     tigerId: string;
     privateKey: string;
     account: string;
+    /** Institution secret key for trade authentication (institution accounts only) */
+    secretKey?: string;
     license?: string;
     language: string;
     timezone?: string;
@@ -27,6 +29,8 @@ export interface ClientConfigOptions {
     tigerId?: string;
     privateKey?: string;
     account?: string;
+    /** Institution secret key for trade authentication (institution accounts only) */
+    secretKey?: string;
     license?: string;
     language?: string;
     timezone?: string;

package/dist/types/index.d.ts

@@ -15,7 +15,7 @@
  * @packageDocumentation
  */
 /** SDK 版本号 */
-export declare const VERSION = "0.4.4";
+export declare const VERSION = "0.4.6";
 export { createClientConfig, loadPropertiesFile } from './config';
 export type { ClientConfig, ClientConfigOptions } from './config';
 export { TokenManager } from './config';

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

@@ -42,7 +42,19 @@ export declare enum OrderType {
     AL = "AL",
     TWAP = "TWAP",
     VWAP = "VWAP",
-    OCA = "OCA"
+    OCA = "OCA",
+    ICEBERG = "ICEBERG"
+}
+/** 冰山单价格类型 */
+export declare enum PriceType {
+    /** 限价 */
+    LIMIT_PRICE = "LIMIT_PRICE",
+    /** 卖一价 */
+    ASK_PRICE = "ASK_PRICE",
+    /** 买一价 */
+    BID_PRICE = "BID_PRICE",
+    /** 最新价 */
+    LATEST_PRICE = "LATEST_PRICE"
 }
 /**
  * 订单状态枚举。对齐 Java SDK OrderStatus 定义。

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

@@ -3,6 +3,7 @@
  * All helpers return an `OrderRequest` with sensible defaults.
  */
 import type { OrderRequest, OrderLegRequest, AlgoParamsRequest } from './order';
+import { PriceType } from './enums';
 /** Market order */
 export declare function marketOrder(account: string, symbol: string, secType: string, action: string, quantity: number): OrderRequest;
 /** Limit order */
@@ -19,5 +20,15 @@ export declare function auctionLimitOrder(account: string, symbol: string, secTy
 export declare function auctionMarketOrder(account: string, symbol: string, secType: string, action: string, quantity: number): OrderRequest;
 /** 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).
+ * 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;
 /** Attached profit / loss leg */
 export declare function orderLeg(legType: string, price: number, timeInForce: string): OrderLegRequest;

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

@@ -22,8 +22,9 @@ export interface AlgoParams {
 /** Order response model (returned by order query methods). */
 export interface Order {
     account?: string;
-    id?: number;
-    orderId?: number;
+    /** int64 order ID — may be a string when it exceeds Number.MAX_SAFE_INTEGER */
+    id?: number | string;
+    orderId?: number | string;
     externalId?: string;
     action?: string;
     orderType?: string;
@@ -82,6 +83,8 @@ export interface OrderRequest {
     account?: string;
     /** Global order ID (required for modify) */
     id?: number;
+    /** Institutional account trading key (client fills it in automatically if set) */
+    secretKey?: string;
     /** Account-level order ID */
     orderId?: number;
     /** BUY / SELL */
@@ -124,6 +127,18 @@ export interface OrderRequest {
     remark?: string;
     /** User mark */
     userMark?: string;
+    /** 冰山单：展示数量 */
+    displaySize?: number;
+    /** 冰山单：最小展示数量 */
+    minDisplaySize?: number;
+    /** 冰山单：价检间隔（秒） */
+    checkIntervals?: number;
+    /** 冰山单：价格类型（LIMIT_PRICE / ASK_PRICE / BID_PRICE / LATEST_PRICE） */
+    priceType?: string;
+    /** 冰山单：生效开始时间（epoch ms） */
+    startTime?: number;
+    /** 冰山单：生效结束时间（epoch ms） */
+    endTime?: number;
 }
 /** Attached leg for request side */
 export interface OrderLegRequest {

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

@@ -84,14 +84,16 @@ export interface PreviewResult {
     message?: string;
 }
 export interface PlaceOrderResult {
-    id: number;
+    /** int64 order ID — may be a string when it exceeds Number.MAX_SAFE_INTEGER */
+    id: number | string;
     /** Account-level order ID; the server returns snake_case `order_id` */
-    order_id?: number;
-    subIds?: number[];
+    order_id?: number | string;
+    subIds?: (number | string)[];
     orders?: Order[];
 }
 export interface OrderIdResult {
-    id: number;
+    /** int64 order ID — may be a string when it exceeds Number.MAX_SAFE_INTEGER */
+    id: number | string;
 }
 export interface Transaction {
     id?: number;

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

@@ -17,7 +17,8 @@ import type { OrdersRequest, GetOrderRequest, OrderTransactionsRequest, Position
 export declare class TradeClient {
     private httpClient;
     private account;
-    constructor(httpClient: HttpClient, account: string);
+    private secretKey?;
+    constructor(httpClient: HttpClient, account: string, secretKey?: string);
     private callInto;
     /** Strip `{items: [...]}` envelope used by most trade read endpoints. */
     private callIntoItems;
@@ -30,8 +31,8 @@ export declare class TradeClient {
     getQuoteContract(symbol: string, secType: string, expiry: string): Promise<Contract[]>;
     placeOrder(order: OrderRequest): Promise<PlaceOrderResult | undefined>;
     previewOrder(order: OrderRequest): Promise<PreviewResult | undefined>;
-    modifyOrder(id: number, order: OrderRequest): Promise<OrderIdResult | undefined>;
-    cancelOrder(id: number): Promise<OrderIdResult | undefined>;
+    modifyOrder(id: number | string, order: OrderRequest): Promise<OrderIdResult | undefined>;
+    cancelOrder(id: number | string, secretKey?: string): Promise<OrderIdResult | undefined>;
     /**
      * Query all historical orders. v0.4.0: optional OrdersRequest for filtering.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tigeropenapi/tigeropen",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "Tiger Brokers OpenAPI TypeScript SDK for market data, trading, and real-time push",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -50,6 +50,7 @@
     "@types/node": "^25.6.0",
     "fast-check": "^3.15.0",
     "ts-proto": "^2.11.6",
+    "tsx": "^4.22.4",
     "typescript": "^5.3.0",
     "vitest": "^1.2.0"
   },