@tigeropenapi/tigeropen 0.4.7 → 0.4.8

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,6 +2,14 @@
 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");
 /**
@@ -40,6 +48,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);
@@ -71,8 +83,8 @@ class QuoteClient {
     async getBrief(req) {
         return this.callInto('quote_real_time', req);
     }
-    async getKline(symbol, period) {
-        return this.callInto('kline', { symbols: [symbol], period });
+    async getKline(req) {
+        return this.callInto('kline', req);
     }
     async getTimeline(symbols) {
         return this.callInto('timeline', { symbols });
@@ -86,17 +98,20 @@ 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) {
+        return this.callInto('option_expiration', { symbols });
+    }
+    /** Option chain; each item is [symbol, "YYYY-MM-DD"]. */
+    async getOptionChain(items) {
+        const optionBasic = items.map(([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 { symbol, expiry: expiryMs };
+        });
+        return this.callInto('option_chain', { option_basic: optionBasic }, '3.0');
     }
     async getOptionBrief(identifiers) {
         const optionBasic = identifiers.map((id) => {
@@ -105,11 +120,12 @@ class QuoteClient {
         });
         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');
+    async getOptionKline(identifiers, period) {
+        const optionQuery = identifiers.map((id) => {
+            const p = parseOptionIdentifier(id);
+            return { symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike, period };
+        });
+        return this.callInto('option_kline', { option_query: optionQuery }, '2.0');
     }
     // === Futures ===
     async getFutureExchange() {
@@ -122,15 +138,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);
@@ -184,16 +191,8 @@ class QuoteClient {
     async getStockDelayBriefs(req) {
         return this.callInto('quote_delay', req);
     }
-    /** K-line bars (full request). wire: kline */
-    async getBars(req) {
-        return this.callInto('kline', 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 +221,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 +266,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 +306,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 +317,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;

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,3 +1,11 @@
+/**
+ * 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';
 /**
@@ -36,6 +44,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);
@@ -67,8 +79,8 @@ export class QuoteClient {
     async getBrief(req) {
         return this.callInto('quote_real_time', req);
     }
-    async getKline(symbol, period) {
-        return this.callInto('kline', { symbols: [symbol], period });
+    async getKline(req) {
+        return this.callInto('kline', req);
     }
     async getTimeline(symbols) {
         return this.callInto('timeline', { symbols });
@@ -82,17 +94,20 @@ 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) {
+        return this.callInto('option_expiration', { symbols });
+    }
+    /** Option chain; each item is [symbol, "YYYY-MM-DD"]. */
+    async getOptionChain(items) {
+        const optionBasic = items.map(([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 { symbol, expiry: expiryMs };
+        });
+        return this.callInto('option_chain', { option_basic: optionBasic }, '3.0');
     }
     async getOptionBrief(identifiers) {
         const optionBasic = identifiers.map((id) => {
@@ -101,11 +116,12 @@ export class QuoteClient {
         });
         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');
+    async getOptionKline(identifiers, period) {
+        const optionQuery = identifiers.map((id) => {
+            const p = parseOptionIdentifier(id);
+            return { symbol: p.symbol, expiry: p.expiryMs, right: p.right, strike: p.strike, period };
+        });
+        return this.callInto('option_kline', { option_query: optionQuery }, '2.0');
     }
     // === Futures ===
     async getFutureExchange() {
@@ -118,15 +134,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);
@@ -180,16 +187,8 @@ export class QuoteClient {
     async getStockDelayBriefs(req) {
         return this.callInto('quote_delay', req);
     }
-    /** K-line bars (full request). wire: kline */
-    async getBars(req) {
-        return this.callInto('kline', 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 +217,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 +262,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 +302,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 +313,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;

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,9 +5,10 @@
  * 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.
@@ -22,6 +23,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
@@ -34,23 +37,21 @@ export declare class QuoteClient {
     getMarketState(market: string): Promise<MarketState[]>;
     /** Real-time stock briefs. wire: quote_real_time */
     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[]): Promise<OptionExpiration[]>;
+    /** Option chain; each item is [symbol, "YYYY-MM-DD"]. */
+    getOptionChain(items: Array<[string, string]>): Promise<OptionChain[]>;
     getOptionBrief(identifiers: string[]): Promise<Brief[]>;
-    getOptionKline(identifier: string, period: string): Promise<Kline[]>;
+    getOptionKline(identifiers: string[], period: 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[]>;
     /**
@@ -71,14 +72,8 @@ export declare class QuoteClient {
     getStockDetails(req: StockDetailsRequest): Promise<StockDetail[]>;
     /** Delayed stock briefs. wire: quote_delay */
     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 +90,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 +110,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). */

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.8",
   "description": "Tiger Brokers OpenAPI TypeScript SDK for market data, trading, and real-time push",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",