@tigeropenapi/tigeropen 0.4.8 → 0.5.0

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

@@ -12,11 +12,49 @@ exports.parseOptionIdentifier = parseOptionIdentifier;
 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) {
@@ -33,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}`);
@@ -79,10 +121,14 @@ 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);
     }
+    /** @deprecated Use getRealTimeQuote instead. */
+    async getBrief(req) {
+        return this.getRealTimeQuote(req);
+    }
     async getKline(req) {
         return this.callInto('kline', req);
     }
@@ -98,32 +144,66 @@ class QuoteClient {
         return this.callInto('quote_depth', req);
     }
     // === Options ===
-    async getOptionExpiration(symbols) {
-        return this.callInto('option_expiration', { symbols });
+    async getOptionExpiration(symbols, market) {
+        const params = { symbols };
+        if (market)
+            params.market = market;
+        return this.callInto('option_expiration', params);
     }
-    /** Option chain; each item is [symbol, "YYYY-MM-DD"]. */
-    async getOptionChain(items) {
+    /**
+     * 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]) => {
-            const d = new Date(expiry + 'T00:00:00Z');
-            const expiryMs = d.getTime();
-            if (Number.isNaN(expiryMs)) {
+            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');
     }
-    async getOptionBrief(identifiers) {
+    /**
+     * 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(identifiers, period) {
+    /** @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);
-            return { symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike, period };
+            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');
     }
@@ -187,10 +267,14 @@ 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);
     }
+    /** @deprecated Use getDelayedQuote instead. */
+    async getStockDelayBriefs(req) {
+        return this.getDelayedQuote(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;
@@ -396,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/esm/quote/quote-client.js

@@ -8,11 +8,49 @@
 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) {
@@ -29,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}`);
@@ -75,10 +117,14 @@ 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);
     }
+    /** @deprecated Use getRealTimeQuote instead. */
+    async getBrief(req) {
+        return this.getRealTimeQuote(req);
+    }
     async getKline(req) {
         return this.callInto('kline', req);
     }
@@ -94,32 +140,66 @@ export class QuoteClient {
         return this.callInto('quote_depth', req);
     }
     // === Options ===
-    async getOptionExpiration(symbols) {
-        return this.callInto('option_expiration', { symbols });
+    async getOptionExpiration(symbols, market) {
+        const params = { symbols };
+        if (market)
+            params.market = market;
+        return this.callInto('option_expiration', params);
     }
-    /** Option chain; each item is [symbol, "YYYY-MM-DD"]. */
-    async getOptionChain(items) {
+    /**
+     * 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]) => {
-            const d = new Date(expiry + 'T00:00:00Z');
-            const expiryMs = d.getTime();
-            if (Number.isNaN(expiryMs)) {
+            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');
     }
-    async getOptionBrief(identifiers) {
+    /**
+     * 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(identifiers, period) {
+    /** @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);
-            return { symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike, period };
+            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');
     }
@@ -183,10 +263,14 @@ 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);
     }
+    /** @deprecated Use getDelayedQuote instead. */
+    async getStockDelayBriefs(req) {
+        return this.getDelayedQuote(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;
@@ -392,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/types/model/quote.d.ts

@@ -407,16 +407,26 @@ export interface KlineQuota {
 }
 /** Option historical-volatility time series point. */
 export interface OptionVolatilityPoint {
-    date?: string;
-    volatility?: number;
+    impliedVol?: number;
+    percentile?: number;
+    rank?: number;
+    hisVolatility?: number;
+    timestamp?: number;
+}
+/** Implied-volatility metric for a specific period. */
+export interface ImpliedVolMetric {
+    period?: string;
+    percentile?: number;
+    rank?: number;
 }
 /** Option analysis (option_analysis). */
 export interface OptionAnalysis {
     symbol?: string;
-    historicalVolatility30Day?: number;
-    historicalVolatility60Day?: number;
-    historicalVolatility90Day?: number;
-    impliedVolatility?: number;
+    impliedVol30Days?: number;
+    hisVolatility?: number;
+    ivHisVRatio?: number;
+    callPutRatio?: number;
+    impliedVolMetric?: ImpliedVolMetric;
     volatilityList?: OptionVolatilityPoint[];
 }
 /** Option symbol listing (option_symbol). */
@@ -541,11 +551,14 @@ export interface MarketScannerTag {
     name?: string;
     values?: string[];
 }
-/** Market scanner tag set (market_scanner_tags). */
-export interface MarketScannerTags {
-    tagFields?: string[];
-    tags?: MarketScannerTag[];
+/** Market-scanner tag group (one entry per market). wire: market_scanner_tags returns array of these. */
+export interface MarketScannerTagGroup {
+    market?: string;
+    multiTagField?: string;
+    tagList?: MarketScannerTag[];
 }
+/** @deprecated Use MarketScannerTagGroup[] instead. Kept for backwards compatibility. */
+export type MarketScannerTags = MarketScannerTagGroup;
 /** Fund contract info (fund_contracts). */
 export interface FundContractInfo {
     symbol?: string;

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

@@ -203,7 +203,8 @@ export interface SegmentFundHistoryItem {
     updatedAt?: number;
 }
 export interface FundDetails {
-    id?: number;
+    /** int64 fund-detail ID — server may return as string (e.g. "4733519770"). */
+    id?: string | number;
     account?: string;
     segType?: string;
     fundType?: string;

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

@@ -7,13 +7,16 @@
  */
 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 { 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, MarketScannerTagGroup, 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;
@@ -35,7 +38,9 @@ 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(req: KlineRequest): Promise<Kline[]>;
     getTimeline(symbols: string[]): Promise<Timeline[]>;
@@ -43,11 +48,30 @@ export declare class QuoteClient {
     getTradeTick(req: TradeTickRequest): Promise<TradeTick[]>;
     /** Depth snapshot. wire: quote_depth */
     getQuoteDepth(req: DepthQuoteRequest): Promise<Depth[]>;
-    getOptionExpiration(symbols: string[]): Promise<OptionExpiration[]>;
-    /** Option chain; each item is [symbol, "YYYY-MM-DD"]. */
-    getOptionChain(items: Array<[string, 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(identifiers: 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 */
@@ -70,7 +94,9 @@ 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[]>;
     /** Client-side paginated K-line fetch. Loops until totalSize bars are collected, oldest-first. */
     getKlineByPage(req: KlineByPageRequest): Promise<KlineItem[]>;
@@ -131,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>;
@@ -152,7 +180,7 @@ export declare class QuoteClient {
     /** Trading calendar. wire: trading_calendar */
     getTradingCalendar(req: TradingCalendarRequest): Promise<TradingCalendarItem[]>;
     /** Available market-scanner tags. wire: market_scanner_tags */
-    getMarketScannerTags(req: MarketScannerTagsRequest): Promise<MarketScannerTags | undefined>;
+    getMarketScannerTags(req: MarketScannerTagsRequest): Promise<MarketScannerTagGroup[]>;
     /** Overnight quote. wire: quote_overnight */
     getQuoteOvernight(req: QuoteOvernightRequest): Promise<QuoteOvernight[]>;
 }

package/package.json

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