@tigeropenapi/tigeropen 0.4.7 → 0.4.9

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

@@ -7,10 +7,9 @@ const signer_1 = require("../signer/signer");
 const errors_1 = require("./errors");
 const retry_1 = require("./retry");
 const api_response_1 = require("./api-response");
-/** SDK 版本号 */
-const SDK_VERSION = '0.4.0';
+const version_1 = require("../version");
 /** User-Agent 字符串 */
-const USER_AGENT = `openapi-typescript-sdk-${SDK_VERSION}`;
+const USER_AGENT = `openapi-typescript-sdk-${version_1.SDK_VERSION}`;
 /** 默认字符集 */
 const DEFAULT_CHARSET = 'UTF-8';
 /** 默认签名类型 */

package/dist/cjs/index.js

@@ -18,7 +18,8 @@
 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.6';
+var version_1 = require("./version");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.SDK_VERSION; } });
 // Config
 var config_1 = require("./config");
 Object.defineProperty(exports, "createClientConfig", { enumerable: true, get: function () { return config_1.createClientConfig; } });

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

@@ -64,8 +64,9 @@ const DEFAULT_RECONNECT_INTERVAL = 5000;
 const MAX_RECONNECT_INTERVAL = 60000;
 /** Default connect timeout (ms) */
 const DEFAULT_CONNECT_TIMEOUT = 30000;
+const version_1 = require("../version");
 /** SDK version identifier */
-const SDK_VERSION = 'typescript/0.4.0';
+const SDK_VERSION = `typescript/${version_1.SDK_VERSION}`;
 /** Protocol version */
 const ACCEPT_VERSION = '1.0';
 /** Default send heartbeat interval (ms) */

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

@@ -2,13 +2,59 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QuoteClient = void 0;
 exports.parseOptionIdentifier = parseOptionIdentifier;
+/**
+ * QuoteClient — market-data client.
+ *
+ * All methods return strongly-typed responses from the `model` package.
+ * Request parameters are written in camelCase in TypeScript and are
+ * converted to snake_case on the wire automatically.
+ */
+const http_client_1 = require("../client/http-client");
 const api_request_1 = require("../client/api-request");
 const api_response_1 = require("../client/api-response");
+/**
+ * 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).
+ */
+function resolveOptionTimezone(tz, symbol) {
+    if (tz)
+        return tz;
+    return symbol.toUpperCase().endsWith('.HK') ? 'Asia/Hong_Kong' : 'America/New_York';
+}
+/**
+ * Convert a "YYYY-MM-DD" date string to the Unix timestamp (ms) of local midnight
+ * in the given IANA timezone.
+ *
+ * Strategy: use Intl.DateTimeFormat to determine what UTC time corresponds to
+ * local midnight in the target timezone, correctly handling DST.
+ */
+function localMidnightMs(dateStr, timezone) {
+    const [year, month, day] = dateStr.split('-').map(Number);
+    // Use noon UTC as a safe anchor (avoids DST ambiguity right at midnight)
+    const noonUtc = new Date(Date.UTC(year, month - 1, day, 12, 0, 0));
+    // Determine what hour/minute/second UTC noon appears as in the target timezone
+    const timeParts = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    }).formatToParts(noonUtc);
+    const h = parseInt(timeParts.find(p => p.type === 'hour').value, 10);
+    const m = parseInt(timeParts.find(p => p.type === 'minute').value, 10);
+    const s = parseInt(timeParts.find(p => p.type === 'second').value, 10);
+    // UTC offset at noon = 12:00:00 UTC − local time shown for noon UTC
+    // Local midnight = noon UTC − 12h + offset = noon UTC − (h*3600+m*60+s)s
+    return noonUtc.getTime() - (h * 3600 + m * 60 + s) * 1000;
+}
 /**
  * Parse an OCC-style option identifier like "AAPL  260619C00150000"
  * into its component parts.
+ *
+ * @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.
  */
-function parseOptionIdentifier(identifier) {
+function parseOptionIdentifier(identifier, timezone) {
     const trimmed = identifier.trim();
     const spaceIdx = trimmed.indexOf(' ');
     if (spaceIdx === -1) {
@@ -25,7 +71,11 @@ function parseOptionIdentifier(identifier) {
     const yy = parseInt(datePart.substring(0, 2), 10);
     const mm = parseInt(datePart.substring(2, 4), 10);
     const dd = parseInt(datePart.substring(4, 6), 10);
-    const expiryMs = Date.UTC(2000 + yy, mm - 1, dd);
+    const resolvedTz = resolveOptionTimezone(timezone, symbol);
+    const paddedYear = String(2000 + yy).padStart(4, '0');
+    const paddedMonth = String(mm).padStart(2, '0');
+    const paddedDay = String(dd).padStart(2, '0');
+    const expiryMs = localMidnightMs(`${paddedYear}-${paddedMonth}-${paddedDay}`, resolvedTz);
     const right = rightChar === 'C' ? 'CALL' : rightChar === 'P' ? 'PUT' : '';
     if (!right)
         throw new Error(`invalid right character: ${rightChar}`);
@@ -40,6 +90,10 @@ class QuoteClient {
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
+    /** Create a QuoteClient directly from a ClientConfig — no need to construct HttpClient manually. */
+    static fromConfig(config) {
+        return new QuoteClient(new http_client_1.HttpClient(config, undefined, { useQuoteServerUrl: true }));
+    }
     async callInto(method, bizParams, version) {
         const request = (0, api_request_1.createApiRequest)(method, bizParams, version);
         const response = await this.httpClient.executeRequest(request);
@@ -67,12 +121,16 @@ class QuoteClient {
     async getMarketState(market) {
         return this.callInto('market_state', { market });
     }
-    /** Real-time stock briefs. wire: quote_real_time */
-    async getBrief(req) {
+    /** Real-time stock quotes. wire: quote_real_time */
+    async getRealTimeQuote(req) {
         return this.callInto('quote_real_time', req);
     }
-    async getKline(symbol, period) {
-        return this.callInto('kline', { symbols: [symbol], period });
+    /** @deprecated Use getRealTimeQuote instead. */
+    async getBrief(req) {
+        return this.getRealTimeQuote(req);
+    }
+    async getKline(req) {
+        return this.callInto('kline', req);
     }
     async getTimeline(symbols) {
         return this.callInto('timeline', { symbols });
@@ -86,30 +144,68 @@ class QuoteClient {
         return this.callInto('quote_depth', req);
     }
     // === Options ===
-    async getOptionExpiration(symbol) {
-        return this.callInto('option_expiration', { symbols: [symbol] });
-    }
-    /** Option chain; `expiry` is "YYYY-MM-DD". */
-    async getOptionChain(symbol, expiry) {
-        const d = new Date(expiry + 'T00:00:00Z');
-        const expiryMs = d.getTime();
-        if (Number.isNaN(expiryMs)) {
-            throw new Error(`invalid expiry date, expected YYYY-MM-DD: ${expiry}`);
-        }
-        return this.callInto('option_chain', { option_basic: [{ symbol, expiry: expiryMs }] }, '3.0');
+    async getOptionExpiration(symbols, market) {
+        const params = { symbols };
+        if (market)
+            params.market = market;
+        return this.callInto('option_expiration', params);
     }
-    async getOptionBrief(identifiers) {
+    /**
+     * Option chain; each item is [symbol, "YYYY-MM-DD"].
+     *
+     * @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 getOptionChain(items, timezone) {
+        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}`);
+            }
+            const tz = resolveOptionTimezone(timezone, symbol);
+            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);
+            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');
     }
-    async getOptionKline(identifier, period) {
-        const p = parseOptionIdentifier(identifier);
-        return this.callInto('option_kline', {
-            option_query: [{ symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike, period }],
-        }, '2.0');
+    /** @deprecated Use getOptionQuote instead. */
+    async getOptionBrief(identifiers) {
+        return this.getOptionQuote(identifiers);
+    }
+    /**
+     * 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.
+     */
+    async getOptionKline(identifiers, period, beginTime = -1, endTime = -1, timezone) {
+        const resolvedBegin = beginTime === 0 ? -1 : beginTime;
+        const resolvedEnd = endTime === 0 ? -1 : endTime;
+        const optionQuery = identifiers.map((id) => {
+            const p = parseOptionIdentifier(id, timezone);
+            return {
+                symbol: p.symbol,
+                expiry: p.expiryMs,
+                right: p.right,
+                strike: p.strike,
+                period,
+                begin_time: resolvedBegin,
+                end_time: resolvedEnd,
+            };
+        });
+        return this.callInto('option_kline', { option_query: optionQuery }, '2.0');
     }
     // === Futures ===
     async getFutureExchange() {
@@ -122,15 +218,6 @@ class QuoteClient {
     async getFutureRealTimeQuote(req) {
         return this.callInto('future_real_time_quote', req);
     }
-    /** Futures K-line; use -1 for unbounded beginTime / endTime. */
-    async getFutureKline(req) {
-        const body = {
-            ...req,
-            beginTime: req.beginTime ?? -1,
-            endTime: req.endTime ?? -1,
-        };
-        return this.callInto('future_kline', body);
-    }
     // === Fundamentals ===
     async getFinancialDaily(req) {
         return this.callInto('financial_daily', req);
@@ -180,20 +267,16 @@ class QuoteClient {
     async getStockDetails(req) {
         return this.callIntoItems('stock_detail', req);
     }
-    /** Delayed stock briefs. wire: quote_delay */
-    async getStockDelayBriefs(req) {
+    /** Delayed stock quotes. wire: quote_delay */
+    async getDelayedQuote(req) {
         return this.callInto('quote_delay', req);
     }
-    /** K-line bars (full request). wire: kline */
-    async getBars(req) {
-        return this.callInto('kline', req);
+    /** @deprecated Use getDelayedQuote instead. */
+    async getStockDelayBriefs(req) {
+        return this.getDelayedQuote(req);
     }
-    /**
-     * Client-side paginated K-line fetch — loops over getBars until TotalSize
-     * bars are collected. Items are returned oldest-first, matching
-     * Python/Go get_bars_by_page behaviour.
-     */
-    async getBarsByPage(req) {
+    /** Client-side paginated K-line fetch. Loops until totalSize bars are collected, oldest-first. */
+    async getKlineByPage(req) {
         const pageSize = req.pageSize && req.pageSize > 0 ? req.pageSize : 200;
         const totalSize = req.totalSize && req.totalSize > 0 ? req.totalSize : 1000;
         let beginTime = req.beginTime ?? -1;
@@ -222,7 +305,6 @@ class QuoteClient {
             acc.push(...items);
             if (items.length < pageSize)
                 break;
-            // next page endTime = oldest bar time - 1
             let oldest = items[0].time;
             for (const it of items) {
                 if (it.time < oldest)
@@ -268,10 +350,6 @@ class QuoteClient {
     // ==========================================================================
     // Batch 4: option / future extensions
     // ==========================================================================
-    /** Option K-line. wire: option_kline (v2.0) */
-    async getOptionBars(req) {
-        return this.callInto('option_kline', req, '2.0');
-    }
     /** Option tick trades. wire: option_trade_tick */
     async getOptionTradeTicks(req) {
         return this.callInto('option_trade_tick', req);
@@ -312,11 +390,9 @@ class QuoteClient {
     async getFutureHistoryMainContract(req) {
         return this.callInto('future_main_contract', req);
     }
-    /**
-     * Futures K-line (full request with index pagination). wire: future_kline
-     * begin_time / end_time default to -1 when unset (server requires them present).
-     */
-    async getFutureBars(req) {
+    /** Futures K-line. wire: future_kline
+     * beginTime / endTime default to -1 when unset (server requires them present). */
+    async getFutureKline(req) {
         const body = {
             ...req,
             beginTime: req.beginTime ?? -1,
@@ -325,7 +401,7 @@ class QuoteClient {
         return this.callInto('future_kline', body);
     }
     /** Client-side paginated futures K-line fetch. */
-    async getFutureBarsByPage(req) {
+    async getFutureKlineByPage(req) {
         const pageSize = req.pageSize && req.pageSize > 0 ? req.pageSize : 200;
         const totalSize = req.totalSize && req.totalSize > 0 ? req.totalSize : 1000;
         let beginTime = req.beginTime ?? -1;
@@ -404,10 +480,14 @@ class QuoteClient {
     async getFundHistoryQuote(req) {
         return this.callInto('fund_history_quote', req);
     }
-    /** Warrant briefs. wire: warrant_briefs */
-    async getWarrantBriefs(req) {
+    /** Real-time warrant quotes. wire: warrant_briefs */
+    async getWarrantQuote(req) {
         return this.callInto('warrant_briefs', req);
     }
+    /** @deprecated Use getWarrantQuote instead. */
+    async getWarrantBriefs(req) {
+        return this.getWarrantQuote(req);
+    }
     /** Warrant filter (paged). wire: warrant_filter */
     async getWarrantFilter(req) {
         return this.callInto('warrant_filter', req);

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

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TradeClient = void 0;
+/**
+ * TradeClient — trading client.
+ *
+ * All methods return strongly-typed responses; request parameters are
+ * written in camelCase in TypeScript and converted to snake_case on the wire.
+ *
+ * v0.4.0: 所有查询类方法改为 Request 对象签名(OrdersRequest 等),补齐 17
+ * 个新方法(账户管理 / 资产分析 / 资金调拨 / 持仓划转等)。
+ */
+const http_client_1 = require("../client/http-client");
 const api_request_1 = require("../client/api-request");
 const api_response_1 = require("../client/api-response");
 const order_status_1 = require("../model/order-status");
@@ -30,6 +40,10 @@ class TradeClient {
         this.account = account;
         this.secretKey = secretKey;
     }
+    /** Create a TradeClient directly from a ClientConfig — no need to construct HttpClient manually. */
+    static fromConfig(config, account, secretKey) {
+        return new TradeClient(new http_client_1.HttpClient(config), account, secretKey);
+    }
     async callInto(method, bizParams) {
         const request = (0, api_request_1.createApiRequest)(method, bizParams);
         const response = await this.httpClient.executeRequest(request);

package/dist/cjs/version.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_VERSION = void 0;
+exports.SDK_VERSION = '0.4.8';

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

@@ -4,8 +4,7 @@ import { signWithRSA, verifyWithRSA } from '../signer/signer.js';
 import { TigerError } from './errors.js';
 import { defaultRetryPolicy } from './retry.js';
 import { parseApiResponse, unmarshalData } from './api-response.js';
-/** SDK 版本号 */
-const SDK_VERSION = '0.4.0';
+import { SDK_VERSION } from '../version.js';
 /** User-Agent 字符串 */
 const USER_AGENT = `openapi-typescript-sdk-${SDK_VERSION}`;
 /** 默认字符集 */

package/dist/esm/index.js

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

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

@@ -28,8 +28,9 @@ const DEFAULT_RECONNECT_INTERVAL = 5000;
 const MAX_RECONNECT_INTERVAL = 60000;
 /** Default connect timeout (ms) */
 const DEFAULT_CONNECT_TIMEOUT = 30000;
+import { SDK_VERSION as _SDK_VERSION } from '../version.js';
 /** SDK version identifier */
-const SDK_VERSION = 'typescript/0.4.0';
+const SDK_VERSION = `typescript/${_SDK_VERSION}`;
 /** Protocol version */
 const ACCEPT_VERSION = '1.0';
 /** Default send heartbeat interval (ms) */

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

@@ -1,10 +1,56 @@
+/**
+ * QuoteClient — market-data client.
+ *
+ * All methods return strongly-typed responses from the `model` package.
+ * Request parameters are written in camelCase in TypeScript and are
+ * converted to snake_case on the wire automatically.
+ */
+import { HttpClient } from '../client/http-client.js';
 import { createApiRequest } from '../client/api-request.js';
 import { unmarshalData } from '../client/api-response.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).
+ */
+function resolveOptionTimezone(tz, symbol) {
+    if (tz)
+        return tz;
+    return symbol.toUpperCase().endsWith('.HK') ? 'Asia/Hong_Kong' : 'America/New_York';
+}
+/**
+ * Convert a "YYYY-MM-DD" date string to the Unix timestamp (ms) of local midnight
+ * in the given IANA timezone.
+ *
+ * Strategy: use Intl.DateTimeFormat to determine what UTC time corresponds to
+ * local midnight in the target timezone, correctly handling DST.
+ */
+function localMidnightMs(dateStr, timezone) {
+    const [year, month, day] = dateStr.split('-').map(Number);
+    // Use noon UTC as a safe anchor (avoids DST ambiguity right at midnight)
+    const noonUtc = new Date(Date.UTC(year, month - 1, day, 12, 0, 0));
+    // Determine what hour/minute/second UTC noon appears as in the target timezone
+    const timeParts = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    }).formatToParts(noonUtc);
+    const h = parseInt(timeParts.find(p => p.type === 'hour').value, 10);
+    const m = parseInt(timeParts.find(p => p.type === 'minute').value, 10);
+    const s = parseInt(timeParts.find(p => p.type === 'second').value, 10);
+    // UTC offset at noon = 12:00:00 UTC − local time shown for noon UTC
+    // Local midnight = noon UTC − 12h + offset = noon UTC − (h*3600+m*60+s)s
+    return noonUtc.getTime() - (h * 3600 + m * 60 + s) * 1000;
+}
 /**
  * Parse an OCC-style option identifier like "AAPL  260619C00150000"
  * into its component parts.
+ *
+ * @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.
  */
-export function parseOptionIdentifier(identifier) {
+export function parseOptionIdentifier(identifier, timezone) {
     const trimmed = identifier.trim();
     const spaceIdx = trimmed.indexOf(' ');
     if (spaceIdx === -1) {
@@ -21,7 +67,11 @@ export function parseOptionIdentifier(identifier) {
     const yy = parseInt(datePart.substring(0, 2), 10);
     const mm = parseInt(datePart.substring(2, 4), 10);
     const dd = parseInt(datePart.substring(4, 6), 10);
-    const expiryMs = Date.UTC(2000 + yy, mm - 1, dd);
+    const resolvedTz = resolveOptionTimezone(timezone, symbol);
+    const paddedYear = String(2000 + yy).padStart(4, '0');
+    const paddedMonth = String(mm).padStart(2, '0');
+    const paddedDay = String(dd).padStart(2, '0');
+    const expiryMs = localMidnightMs(`${paddedYear}-${paddedMonth}-${paddedDay}`, resolvedTz);
     const right = rightChar === 'C' ? 'CALL' : rightChar === 'P' ? 'PUT' : '';
     if (!right)
         throw new Error(`invalid right character: ${rightChar}`);
@@ -36,6 +86,10 @@ export class QuoteClient {
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
+    /** Create a QuoteClient directly from a ClientConfig — no need to construct HttpClient manually. */
+    static fromConfig(config) {
+        return new QuoteClient(new HttpClient(config, undefined, { useQuoteServerUrl: true }));
+    }
     async callInto(method, bizParams, version) {
         const request = createApiRequest(method, bizParams, version);
         const response = await this.httpClient.executeRequest(request);
@@ -63,12 +117,16 @@ export class QuoteClient {
     async getMarketState(market) {
         return this.callInto('market_state', { market });
     }
-    /** Real-time stock briefs. wire: quote_real_time */
-    async getBrief(req) {
+    /** Real-time stock quotes. wire: quote_real_time */
+    async getRealTimeQuote(req) {
         return this.callInto('quote_real_time', req);
     }
-    async getKline(symbol, period) {
-        return this.callInto('kline', { symbols: [symbol], period });
+    /** @deprecated Use getRealTimeQuote instead. */
+    async getBrief(req) {
+        return this.getRealTimeQuote(req);
+    }
+    async getKline(req) {
+        return this.callInto('kline', req);
     }
     async getTimeline(symbols) {
         return this.callInto('timeline', { symbols });
@@ -82,30 +140,68 @@ export class QuoteClient {
         return this.callInto('quote_depth', req);
     }
     // === Options ===
-    async getOptionExpiration(symbol) {
-        return this.callInto('option_expiration', { symbols: [symbol] });
-    }
-    /** Option chain; `expiry` is "YYYY-MM-DD". */
-    async getOptionChain(symbol, expiry) {
-        const d = new Date(expiry + 'T00:00:00Z');
-        const expiryMs = d.getTime();
-        if (Number.isNaN(expiryMs)) {
-            throw new Error(`invalid expiry date, expected YYYY-MM-DD: ${expiry}`);
-        }
-        return this.callInto('option_chain', { option_basic: [{ symbol, expiry: expiryMs }] }, '3.0');
+    async getOptionExpiration(symbols, market) {
+        const params = { symbols };
+        if (market)
+            params.market = market;
+        return this.callInto('option_expiration', params);
     }
-    async getOptionBrief(identifiers) {
+    /**
+     * Option chain; each item is [symbol, "YYYY-MM-DD"].
+     *
+     * @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 getOptionChain(items, timezone) {
+        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}`);
+            }
+            const tz = resolveOptionTimezone(timezone, symbol);
+            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);
+            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');
     }
-    async getOptionKline(identifier, period) {
-        const p = parseOptionIdentifier(identifier);
-        return this.callInto('option_kline', {
-            option_query: [{ symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike, period }],
-        }, '2.0');
+    /** @deprecated Use getOptionQuote instead. */
+    async getOptionBrief(identifiers) {
+        return this.getOptionQuote(identifiers);
+    }
+    /**
+     * 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.
+     */
+    async getOptionKline(identifiers, period, beginTime = -1, endTime = -1, timezone) {
+        const resolvedBegin = beginTime === 0 ? -1 : beginTime;
+        const resolvedEnd = endTime === 0 ? -1 : endTime;
+        const optionQuery = identifiers.map((id) => {
+            const p = parseOptionIdentifier(id, timezone);
+            return {
+                symbol: p.symbol,
+                expiry: p.expiryMs,
+                right: p.right,
+                strike: p.strike,
+                period,
+                begin_time: resolvedBegin,
+                end_time: resolvedEnd,
+            };
+        });
+        return this.callInto('option_kline', { option_query: optionQuery }, '2.0');
     }
     // === Futures ===
     async getFutureExchange() {
@@ -118,15 +214,6 @@ export class QuoteClient {
     async getFutureRealTimeQuote(req) {
         return this.callInto('future_real_time_quote', req);
     }
-    /** Futures K-line; use -1 for unbounded beginTime / endTime. */
-    async getFutureKline(req) {
-        const body = {
-            ...req,
-            beginTime: req.beginTime ?? -1,
-            endTime: req.endTime ?? -1,
-        };
-        return this.callInto('future_kline', body);
-    }
     // === Fundamentals ===
     async getFinancialDaily(req) {
         return this.callInto('financial_daily', req);
@@ -176,20 +263,16 @@ export class QuoteClient {
     async getStockDetails(req) {
         return this.callIntoItems('stock_detail', req);
     }
-    /** Delayed stock briefs. wire: quote_delay */
-    async getStockDelayBriefs(req) {
+    /** Delayed stock quotes. wire: quote_delay */
+    async getDelayedQuote(req) {
         return this.callInto('quote_delay', req);
     }
-    /** K-line bars (full request). wire: kline */
-    async getBars(req) {
-        return this.callInto('kline', req);
+    /** @deprecated Use getDelayedQuote instead. */
+    async getStockDelayBriefs(req) {
+        return this.getDelayedQuote(req);
     }
-    /**
-     * Client-side paginated K-line fetch — loops over getBars until TotalSize
-     * bars are collected. Items are returned oldest-first, matching
-     * Python/Go get_bars_by_page behaviour.
-     */
-    async getBarsByPage(req) {
+    /** Client-side paginated K-line fetch. Loops until totalSize bars are collected, oldest-first. */
+    async getKlineByPage(req) {
         const pageSize = req.pageSize && req.pageSize > 0 ? req.pageSize : 200;
         const totalSize = req.totalSize && req.totalSize > 0 ? req.totalSize : 1000;
         let beginTime = req.beginTime ?? -1;
@@ -218,7 +301,6 @@ export class QuoteClient {
             acc.push(...items);
             if (items.length < pageSize)
                 break;
-            // next page endTime = oldest bar time - 1
             let oldest = items[0].time;
             for (const it of items) {
                 if (it.time < oldest)
@@ -264,10 +346,6 @@ export class QuoteClient {
     // ==========================================================================
     // Batch 4: option / future extensions
     // ==========================================================================
-    /** Option K-line. wire: option_kline (v2.0) */
-    async getOptionBars(req) {
-        return this.callInto('option_kline', req, '2.0');
-    }
     /** Option tick trades. wire: option_trade_tick */
     async getOptionTradeTicks(req) {
         return this.callInto('option_trade_tick', req);
@@ -308,11 +386,9 @@ export class QuoteClient {
     async getFutureHistoryMainContract(req) {
         return this.callInto('future_main_contract', req);
     }
-    /**
-     * Futures K-line (full request with index pagination). wire: future_kline
-     * begin_time / end_time default to -1 when unset (server requires them present).
-     */
-    async getFutureBars(req) {
+    /** Futures K-line. wire: future_kline
+     * beginTime / endTime default to -1 when unset (server requires them present). */
+    async getFutureKline(req) {
         const body = {
             ...req,
             beginTime: req.beginTime ?? -1,
@@ -321,7 +397,7 @@ export class QuoteClient {
         return this.callInto('future_kline', body);
     }
     /** Client-side paginated futures K-line fetch. */
-    async getFutureBarsByPage(req) {
+    async getFutureKlineByPage(req) {
         const pageSize = req.pageSize && req.pageSize > 0 ? req.pageSize : 200;
         const totalSize = req.totalSize && req.totalSize > 0 ? req.totalSize : 1000;
         let beginTime = req.beginTime ?? -1;
@@ -400,10 +476,14 @@ export class QuoteClient {
     async getFundHistoryQuote(req) {
         return this.callInto('fund_history_quote', req);
     }
-    /** Warrant briefs. wire: warrant_briefs */
-    async getWarrantBriefs(req) {
+    /** Real-time warrant quotes. wire: warrant_briefs */
+    async getWarrantQuote(req) {
         return this.callInto('warrant_briefs', req);
     }
+    /** @deprecated Use getWarrantQuote instead. */
+    async getWarrantBriefs(req) {
+        return this.getWarrantQuote(req);
+    }
     /** Warrant filter (paged). wire: warrant_filter */
     async getWarrantFilter(req) {
         return this.callInto('warrant_filter', req);

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

@@ -1,3 +1,13 @@
+/**
+ * TradeClient — trading client.
+ *
+ * All methods return strongly-typed responses; request parameters are
+ * written in camelCase in TypeScript and converted to snake_case on the wire.
+ *
+ * v0.4.0: 所有查询类方法改为 Request 对象签名(OrdersRequest 等),补齐 17
+ * 个新方法(账户管理 / 资产分析 / 资金调拨 / 持仓划转等)。
+ */
+import { HttpClient } from '../client/http-client.js';
 import { createApiRequest } from '../client/api-request.js';
 import { unmarshalData } from '../client/api-response.js';
 import { normalizeOrderStatus } from '../model/order-status.js';
@@ -27,6 +37,10 @@ export class TradeClient {
         this.account = account;
         this.secretKey = secretKey;
     }
+    /** Create a TradeClient directly from a ClientConfig — no need to construct HttpClient manually. */
+    static fromConfig(config, account, secretKey) {
+        return new TradeClient(new HttpClient(config), account, secretKey);
+    }
     async callInto(method, bizParams) {
         const request = createApiRequest(method, bizParams);
         const response = await this.httpClient.executeRequest(request);

package/dist/esm/version.js

@@ -0,0 +1 @@
+export const SDK_VERSION = '0.4.8';

package/dist/types/index.d.ts

@@ -15,7 +15,7 @@
  * @packageDocumentation
  */
 /** SDK 版本号 */
-export declare const VERSION = "0.4.6";
+export { SDK_VERSION as VERSION } from './version';
 export { createClientConfig, loadPropertiesFile } from './config';
 export type { ClientConfig, ClientConfigOptions } from './config';
 export { TokenManager } from './config';
@@ -35,5 +35,5 @@ 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 { BriefRequest, DepthQuoteRequest, TradeTickRequest, BarsRequest, BarsByPageRequest, FutureBriefRequest, FutureBarsRequest, FutureBarsByPageRequest, FutureTradeTicksRequest, FutureDepthRequest, FutureContractSingleRequest, FutureContinuousContractsRequest, FutureHistoryMainContractRequest, FutureTradingTimesRequest, AllFutureContractsRequest, OptionBarsRequest, 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 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/quote-requests.d.ts

@@ -58,11 +58,10 @@ export interface StockDelayBriefsRequest {
     secType?: string;
     lang?: string;
 }
-/**
- * K-line bars (full options). wire: kline
+/** K-line request. wire: kline
  * BeginTime/EndTime (ms) and BeginIndex/EndIndex are mutually exclusive.
  */
-export interface BarsRequest {
+export interface KlineRequest {
     symbols?: string[];
     period?: string;
     right?: string;
@@ -79,7 +78,7 @@ export interface BarsRequest {
     lang?: string;
 }
 /** K-line client-side pagination wrapper. */
-export interface BarsByPageRequest {
+export interface KlineByPageRequest {
     symbol?: string;
     period?: string;
     beginTime?: number;
@@ -155,12 +154,6 @@ export interface OptionQueryItem {
     endIndex?: number;
     pageToken?: string;
 }
-/** Option K-line. wire: option_kline (v2.0) */
-export interface OptionBarsRequest {
-    optionQuery?: OptionQueryItem[];
-    market?: string;
-    lang?: string;
-}
 /** Option tick trades. wire: option_trade_tick */
 export interface OptionTradeTicksRequest {
     contracts?: OptionQueryItem[];
@@ -215,8 +208,8 @@ export interface FutureHistoryMainContractRequest {
     endTime?: number;
     lang?: string;
 }
-/** Futures K-line (index + pagination). wire: future_kline */
-export interface FutureBarsRequest {
+/** Futures K-line request. wire: future_kline */
+export interface FutureKlineRequest {
     contractCodes?: string[];
     contractCode?: string;
     period?: string;
@@ -229,7 +222,7 @@ export interface FutureBarsRequest {
     lang?: string;
 }
 /** Futures K-line client-side pagination wrapper. */
-export interface FutureBarsByPageRequest {
+export interface FutureKlineByPageRequest {
     contractCode?: string;
     period?: string;
     beginTime?: number;

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

@@ -5,14 +5,18 @@
  * Request parameters are written in camelCase in TypeScript and are
  * converted to snake_case on the wire automatically.
  */
-import type { HttpClient } from '../client/http-client';
-import type { MarketState, Brief, Kline, KlineItem, Timeline, TradeTick, Depth, OptionExpiration, OptionChain, FutureExchange, FutureContractInfo, FutureQuote, FutureKline, FutureKlineItem, FinancialDailyItem, FinancialReportItem, CorporateAction, CapitalFlow, CapitalDistribution, ScannerResult, QuotePermission, FinancialDailyRequest, FinancialReportRequest, CorporateActionRequest, FutureKlineRequest, MarketScannerRequest, SymbolName, TradeMeta, StockDetail, StockBroker, StockIndustry, TradeRankItem, ShortInterest, KlineQuota, OptionAnalysis, OptionSymbol, FutureMainContractHistory, FutureTradingTime, FutureTradeTickItem, FutureDepth, WarrantBrief, WarrantFilterResult, IndustryItem, IndustryStock, TradingCalendarItem, ExchangeRate, FinancialCurrency, QuoteOvernight, MarketScannerTags, FundContractInfo, FundQuote, FundHistoryQuote } from '../model/quote';
-import type { BriefRequest, DepthQuoteRequest, TradeTickRequest, FutureBriefRequest, SymbolsRequest, TradeMetasRequest, StockDetailsRequest, StockDelayBriefsRequest, BarsRequest, BarsByPageRequest, TimelineHistoryRequest, TradeRankRequest, ShortInterestRequest, StockBrokerRequest, StockFundamentalRequest, StockIndustryRequest, KlineQuotaRequest, QuotePermissionRequest, OptionBarsRequest, OptionTradeTicksRequest, OptionTimelineRequest, OptionDepthRequest, OptionSymbolsRequest, OptionAnalysisRequest, FutureContractSingleRequest, AllFutureContractsRequest, FutureContinuousContractsRequest, FutureHistoryMainContractRequest, FutureBarsRequest, FutureBarsByPageRequest, FutureTradeTicksRequest, FutureDepthRequest, FutureTradingTimesRequest, FundSymbolsRequest, FundContractsRequest, FundQuoteRequest, FundHistoryQuoteRequest, WarrantBriefsRequest, WarrantFilterRequest, IndustryListRequest, IndustryStocksRequest, TradingCalendarRequest, FinancialExchangeRateRequest, FinancialCurrencyRequest, MarketScannerTagsRequest, QuoteOvernightRequest } from '../model/quote-requests';
+import { HttpClient } from '../client/http-client';
+import type { ClientConfig } from '../config/client-config';
+import type { MarketState, Brief, Kline, KlineItem, Timeline, TradeTick, Depth, OptionExpiration, OptionChain, FutureExchange, FutureContractInfo, FutureQuote, FutureKline, FutureKlineItem, FinancialDailyItem, FinancialReportItem, CorporateAction, CapitalFlow, CapitalDistribution, ScannerResult, QuotePermission, MarketScannerRequest, SymbolName, TradeMeta, StockDetail, StockBroker, StockIndustry, TradeRankItem, ShortInterest, KlineQuota, OptionAnalysis, OptionSymbol, FutureMainContractHistory, FutureTradingTime, FutureTradeTickItem, FutureDepth, WarrantBrief, WarrantFilterResult, IndustryItem, IndustryStock, TradingCalendarItem, ExchangeRate, FinancialCurrency, QuoteOvernight, MarketScannerTags, FundContractInfo, FundQuote, FundHistoryQuote, FinancialDailyRequest, FinancialReportRequest, CorporateActionRequest } from '../model/quote';
+import type { BriefRequest, DepthQuoteRequest, TradeTickRequest, FutureBriefRequest, SymbolsRequest, TradeMetasRequest, StockDetailsRequest, StockDelayBriefsRequest, KlineRequest, KlineByPageRequest, TimelineHistoryRequest, TradeRankRequest, ShortInterestRequest, StockBrokerRequest, StockFundamentalRequest, StockIndustryRequest, KlineQuotaRequest, QuotePermissionRequest, OptionTradeTicksRequest, OptionTimelineRequest, OptionDepthRequest, OptionSymbolsRequest, OptionAnalysisRequest, FutureContractSingleRequest, AllFutureContractsRequest, FutureContinuousContractsRequest, FutureHistoryMainContractRequest, FutureKlineRequest, FutureKlineByPageRequest, FutureTradeTicksRequest, FutureDepthRequest, FutureTradingTimesRequest, FundSymbolsRequest, FundContractsRequest, FundQuoteRequest, FundHistoryQuoteRequest, WarrantBriefsRequest, WarrantFilterRequest, IndustryListRequest, IndustryStocksRequest, TradingCalendarRequest, FinancialExchangeRateRequest, FinancialCurrencyRequest, MarketScannerTagsRequest, QuoteOvernightRequest } from '../model/quote-requests';
 /**
  * Parse an OCC-style option identifier like "AAPL  260619C00150000"
  * into its component parts.
+ *
+ * @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.
  */
-export declare function parseOptionIdentifier(identifier: string): {
+export declare function parseOptionIdentifier(identifier: string, timezone?: string): {
     symbol: string;
     expiryMs: number;
     right: string;
@@ -22,6 +26,8 @@ export declare function parseOptionIdentifier(identifier: string): {
 export declare class QuoteClient {
     private httpClient;
     constructor(httpClient: HttpClient);
+    /** Create a QuoteClient directly from a ClientConfig — no need to construct HttpClient manually. */
+    static fromConfig(config: ClientConfig): QuoteClient;
     private callInto;
     /**
      * Some endpoints return either a list or a single object depending on the
@@ -32,25 +38,44 @@ export declare class QuoteClient {
     /** Unwrap server {"items":[...]} envelope. */
     private callIntoItems;
     getMarketState(market: string): Promise<MarketState[]>;
-    /** Real-time stock briefs. wire: quote_real_time */
+    /** Real-time stock quotes. wire: quote_real_time */
+    getRealTimeQuote(req: BriefRequest): Promise<Brief[]>;
+    /** @deprecated Use getRealTimeQuote instead. */
     getBrief(req: BriefRequest): Promise<Brief[]>;
-    getKline(symbol: string, period: string): Promise<Kline[]>;
+    getKline(req: KlineRequest): Promise<Kline[]>;
     getTimeline(symbols: string[]): Promise<Timeline[]>;
     /** Tick-by-tick trades. wire: trade_tick */
     getTradeTick(req: TradeTickRequest): Promise<TradeTick[]>;
     /** Depth snapshot. wire: quote_depth */
     getQuoteDepth(req: DepthQuoteRequest): Promise<Depth[]>;
-    getOptionExpiration(symbol: string): Promise<OptionExpiration[]>;
-    /** Option chain; `expiry` is "YYYY-MM-DD". */
-    getOptionChain(symbol: string, expiry: string): Promise<OptionChain[]>;
+    getOptionExpiration(symbols: string[], market?: string): Promise<OptionExpiration[]>;
+    /**
+     * Option chain; each item is [symbol, "YYYY-MM-DD"].
+     *
+     * @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.
+     */
+    getOptionChain(items: Array<[string, string]>, timezone?: string): Promise<OptionChain[]>;
+    /**
+     * 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.
+     */
+    getOptionQuote(identifiers: string[], timezone?: string): Promise<Brief[]>;
+    /** @deprecated Use getOptionQuote instead. */
     getOptionBrief(identifiers: string[]): Promise<Brief[]>;
-    getOptionKline(identifier: string, period: string): Promise<Kline[]>;
+    /**
+     * 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.
+     */
+    getOptionKline(identifiers: string[], period: string, beginTime?: number, endTime?: number, timezone?: string): Promise<Kline[]>;
     getFutureExchange(): Promise<FutureExchange[]>;
     getFutureContracts(exchange: string): Promise<FutureContractInfo[]>;
     /** Real-time futures quotes. wire: future_real_time_quote */
     getFutureRealTimeQuote(req: FutureBriefRequest): Promise<FutureQuote[]>;
-    /** Futures K-line; use -1 for unbounded beginTime / endTime. */
-    getFutureKline(req: FutureKlineRequest): Promise<FutureKline[]>;
     getFinancialDaily(req: FinancialDailyRequest): Promise<FinancialDailyItem[]>;
     getFinancialReport(req: FinancialReportRequest): Promise<FinancialReportItem[]>;
     /**
@@ -69,16 +94,12 @@ export declare class QuoteClient {
     getTradeMetas(req: TradeMetasRequest): Promise<TradeMeta[]>;
     /** Stock details. wire: stock_detail. Server returns {items:[...]}. */
     getStockDetails(req: StockDetailsRequest): Promise<StockDetail[]>;
-    /** Delayed stock briefs. wire: quote_delay */
+    /** Delayed stock quotes. wire: quote_delay */
+    getDelayedQuote(req: StockDelayBriefsRequest): Promise<Brief[]>;
+    /** @deprecated Use getDelayedQuote instead. */
     getStockDelayBriefs(req: StockDelayBriefsRequest): Promise<Brief[]>;
-    /** K-line bars (full request). wire: kline */
-    getBars(req: BarsRequest): Promise<Kline[]>;
-    /**
-     * Client-side paginated K-line fetch — loops over getBars until TotalSize
-     * bars are collected. Items are returned oldest-first, matching
-     * Python/Go get_bars_by_page behaviour.
-     */
-    getBarsByPage(req: BarsByPageRequest): Promise<KlineItem[]>;
+    /** Client-side paginated K-line fetch. Loops until totalSize bars are collected, oldest-first. */
+    getKlineByPage(req: KlineByPageRequest): Promise<KlineItem[]>;
     /** Historical intraday timeline. wire: history_timeline */
     getTimelineHistory(req: TimelineHistoryRequest): Promise<Timeline[]>;
     /** Trade rank (top movers / volume). wire: trade_rank */
@@ -95,8 +116,6 @@ export declare class QuoteClient {
     getQuotePermission(req: QuotePermissionRequest): Promise<QuotePermission[]>;
     /** K-line quota usage. wire: kline_quota */
     getKlineQuota(req: KlineQuotaRequest): Promise<KlineQuota[]>;
-    /** Option K-line. wire: option_kline (v2.0) */
-    getOptionBars(req: OptionBarsRequest): Promise<Kline[]>;
     /** Option tick trades. wire: option_trade_tick */
     getOptionTradeTicks(req: OptionTradeTicksRequest): Promise<TradeTick[]>;
     /** Option intraday timeline. wire: option_timeline */
@@ -117,13 +136,11 @@ export declare class QuoteClient {
     getFutureContinuousContracts(req: FutureContinuousContractsRequest): Promise<FutureContractInfo[]>;
     /** Historical main contracts. wire: future_main_contract */
     getFutureHistoryMainContract(req: FutureHistoryMainContractRequest): Promise<FutureMainContractHistory[]>;
-    /**
-     * Futures K-line (full request with index pagination). wire: future_kline
-     * begin_time / end_time default to -1 when unset (server requires them present).
-     */
-    getFutureBars(req: FutureBarsRequest): Promise<FutureKline[]>;
+    /** Futures K-line. wire: future_kline
+     * beginTime / endTime default to -1 when unset (server requires them present). */
+    getFutureKline(req: FutureKlineRequest): Promise<FutureKline[]>;
     /** Client-side paginated futures K-line fetch. */
-    getFutureBarsByPage(req: FutureBarsByPageRequest): Promise<FutureKlineItem[]>;
+    getFutureKlineByPage(req: FutureKlineByPageRequest): Promise<FutureKlineItem[]>;
     /** Futures tick trades. wire: future_tick (API v3.0)
      * Server returns {contractCode, items:[...]}; unwrap items and backfill contractCode.
      * endIndex defaults to 30 when not set (consistent with Python/Go SDK). */
@@ -140,7 +157,9 @@ export declare class QuoteClient {
     getFundQuote(req: FundQuoteRequest): Promise<FundQuote[]>;
     /** Fund historical NAV. wire: fund_history_quote */
     getFundHistoryQuote(req: FundHistoryQuoteRequest): Promise<FundHistoryQuote[]>;
-    /** Warrant briefs. wire: warrant_briefs */
+    /** Real-time warrant quotes. wire: warrant_briefs */
+    getWarrantQuote(req: WarrantBriefsRequest): Promise<WarrantBrief[]>;
+    /** @deprecated Use getWarrantQuote instead. */
     getWarrantBriefs(req: WarrantBriefsRequest): Promise<WarrantBrief[]>;
     /** Warrant filter (paged). wire: warrant_filter */
     getWarrantFilter(req: WarrantFilterRequest): Promise<WarrantFilterResult | undefined>;

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

@@ -7,7 +7,8 @@
  * v0.4.0: 所有查询类方法改为 Request 对象签名(OrdersRequest 等),补齐 17
  * 个新方法(账户管理 / 资产分析 / 资金调拨 / 持仓划转等)。
  */
-import type { HttpClient } from '../client/http-client';
+import { HttpClient } from '../client/http-client';
+import type { ClientConfig } from '../config/client-config';
 import type { OrderRequest, Order } from '../model/order';
 import type { Contract } from '../model/contract';
 import type { Position } from '../model/position';
@@ -19,6 +20,8 @@ export declare class TradeClient {
     private account;
     private secretKey?;
     constructor(httpClient: HttpClient, account: string, secretKey?: string);
+    /** Create a TradeClient directly from a ClientConfig — no need to construct HttpClient manually. */
+    static fromConfig(config: ClientConfig, account: string, secretKey?: string): TradeClient;
     private callInto;
     /** Strip `{items: [...]}` envelope used by most trade read endpoints. */
     private callIntoItems;

package/dist/types/version.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "0.4.8";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tigeropenapi/tigeropen",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Tiger Brokers OpenAPI TypeScript SDK for market data, trading, and real-time push",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",