@tigeropenapi/tigeropen 0.5.0 → 0.5.3

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

@@ -22,6 +22,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 */
+export const 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';
@@ -29,6 +33,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.
  *
@@ -130,12 +137,15 @@ export 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;
     }
@@ -151,6 +161,9 @@ export 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) {
@@ -189,29 +202,53 @@ export 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 = 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 = 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 = 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 = resolveDynamicQuoteServerUrl(domainConf, license);
+            quoteServerUrl = dynamicQuoteUrl || serverUrl;
+        }
+        else {
+            quoteServerUrl = serverUrl;
+        }
     }
     return {
         tigerId,
@@ -230,7 +267,7 @@ export function createClientConfig(options) {
         serverUrl,
         quoteServerUrl,
         deviceId: detectDeviceId(),
-        tigerPublicKey: opts.tigerPublicKey ?? TIGER_PUBLIC_KEY,
+        tigerPublicKey,
     };
 }
 /**

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

@@ -33,34 +33,34 @@ export 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];
@@ -76,6 +76,16 @@ export 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/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/quote/quote-client.js

@@ -151,8 +151,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 +163,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 +192,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 +534,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

@@ -42,7 +42,16 @@ export class TradeClient {
         return new TradeClient(new HttpClient(config), account, secretKey);
     }
     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 +84,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 +133,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/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.d.ts

@@ -139,8 +139,52 @@ export interface OrderRequest {
     startTime?: number;
     /** 冰山单：生效结束时间（epoch ms） */
     endTime?: number;
+    /** GTD 到期时间（epoch ms） */
+    expireTime?: number;
+    /** 盘后委托价格 */
+    afterHoursPrice?: number;
+    /** 批次号 */
+    batchNo?: number;
+    /** 资金类型（CASH / MARGIN） */
+    segType?: string;
+    /** 按金额下单：委托金额 */
+    amount?: number;
+    /** 是否按金额下单 */
+    isQuantityByAmount?: boolean;
+    /** 账户分配列表（机构账户） */
+    allocAccounts?: string[];
+    /** 各账户分配份额（与 allocAccounts 一一对应） */
+    allocShares?: number[];
+    /** 下单来源 */
+    source?: string;
+    /** 下单渠道 */
+    channel?: string;
+    /** 虚拟订单类型 */
+    virtualOrderType?: string;
+    /** 虚拟订单 ID */
+    virtualId?: string;
+    /** 止盈订单 ID（bracket 关联） */
+    profitTakerOrderId?: number;
+    /** 止损订单 ID（bracket 关联） */
+    stopLossOrderId?: number;
+    /** 本地流水号 */
+    localNo?: string;
+    /** OCA 订单组（One-Cancels-All） */
+    ocaOrders?: OrderRequest[];
+    /** 多腿期权各腿（MLEG） */
+    contractLegs?: ContractLegRequest[];
+}
+/** Single leg of a multi-leg option order (MLEG) */
+export interface ContractLegRequest {
+    symbol?: string;
+    secType?: string;
+    expiry?: string;
+    strike?: string;
+    right?: string;
+    action?: string;
+    ratio?: number;
 }
-/** Attached leg for request side */
+/** Attached profit/loss leg for order request side */
 export interface OrderLegRequest {
     legType: string;
     price?: number;

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

@@ -121,6 +121,26 @@ export interface OptionChainRow {
     put?: OptionLeg;
     call?: OptionLeg;
 }
+/** Range filter, serialized as { min, max } — corresponds to Java Range<T> */
+export interface Range {
+    min?: number;
+    max?: number;
+}
+/** Greeks range filters for option_chain (corresponds to Java OptionChainFilterModel.Greeks) */
+export interface OptionChainFilterGreeks {
+    delta?: Range;
+    gamma?: Range;
+    vega?: Range;
+    theta?: Range;
+    rho?: Range;
+}
+/** Option chain filter (corresponds to Java OptionChainFilterModel) */
+export interface OptionChainFilter {
+    inTheMoney?: boolean;
+    impliedVolatility?: Range;
+    openInterest?: Range;
+    greeks?: OptionChainFilterGreeks;
+}
 export interface OptionChain {
     symbol: string;
     expiry: number;
@@ -217,6 +237,42 @@ export interface CorporateAction {
     fromFactor?: number;
     toFactor?: number;
 }
+export interface CorporateSymbolChange {
+    symbol: string;
+    market?: string;
+    exchange?: string;
+    executeDate?: string;
+    actionType?: string;
+    oldSymbol?: string;
+    /** newSymbol is the ticker after the rename; same as symbol. */
+    newSymbol?: string;
+}
+export interface CorporateDelisting {
+    symbol: string;
+    market?: string;
+    exchange?: string;
+    executeDate?: string;
+    actionType?: string;
+    announcedDate?: string;
+    reason?: string;
+}
+export interface CorporateIPO {
+    symbol: string;
+    market?: string;
+    exchange?: string;
+    executeDate?: string;
+    actionType?: string;
+    ipoName?: string;
+    listingDate?: string;
+    listingPrice?: number;
+    sharesOutstanding?: number;
+    sharesFloat?: number;
+    offerAmount?: number;
+    priceRange?: string;
+    currency?: string;
+    minPurchaseQuantity?: number;
+    leverageRatio?: number;
+}
 export interface CapitalFlowItem {
     time: string;
     timestamp: number;