@tigeropenapi/tigeropen 0.1.0 → 0.4.0

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

@@ -1,106 +1,451 @@
 import { createApiRequest } from '../client/api-request';
+import { unmarshalData } from '../client/api-response';
 /**
- * 行情查询客户端，封装所有行情相关 API。
+ * Parse an OCC-style option identifier like "AAPL  260619C00150000"
+ * into its component parts.
  */
+export function parseOptionIdentifier(identifier) {
+    const trimmed = identifier.trim();
+    const spaceIdx = trimmed.indexOf(' ');
+    if (spaceIdx === -1) {
+        throw new Error(`invalid option identifier: ${identifier}`);
+    }
+    const symbol = trimmed.substring(0, spaceIdx);
+    const rest = trimmed.substring(spaceIdx + 1).trim();
+    if (rest.length < 15) {
+        throw new Error(`option code too short: ${rest}`);
+    }
+    const datePart = rest.substring(0, 6);
+    const rightChar = rest.substring(6, 7);
+    const strikePart = rest.substring(7);
+    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 right = rightChar === 'C' ? 'CALL' : rightChar === 'P' ? 'PUT' : '';
+    if (!right)
+        throw new Error(`invalid right character: ${rightChar}`);
+    const strikeInt = parseInt(strikePart, 10);
+    if (Number.isNaN(strikeInt))
+        throw new Error(`invalid strike digits: ${strikePart}`);
+    const strike = strikeInt / 1000;
+    return { symbol, expiryMs, right, strike };
+}
+/** Market data client wrapping all quote-related APIs. */
 export class QuoteClient {
     constructor(httpClient) {
         this.httpClient = httpClient;
     }
+    async callInto(method, bizParams, version) {
+        const request = createApiRequest(method, bizParams, version);
+        const response = await this.httpClient.executeRequest(request);
+        return unmarshalData(response.data);
+    }
     /**
-     * 内部通用方法：构造请求、发送、返回 data 字段
+     * Some endpoints return either a list or a single object depending on the
+     * server response shape (future_contract_by_contract_code /
+     * future_continuous_contracts). Unify into an array.
      */
-    async execute(method, bizParams) {
-        const request = createApiRequest(method, bizParams);
-        const response = await this.httpClient.executeRequest(request);
-        return response.data;
-    }
-    // === 基础行情方法 ===
-    /** 获取市场状态 */
-    async marketState(market) {
-        return this.execute('market_state', { market });
-    }
-    /** 获取实时报价 */
-    async quoteRealTime(symbols) {
-        return this.execute('quote_real_time', { symbols });
-    }
-    /** 获取 K 线数据 */
-    async kline(symbol, period) {
-        return this.execute('kline', { symbols: [symbol], period });
-    }
-    /** 获取分时数据 */
-    async timeline(symbols) {
-        return this.execute('timeline', { symbols });
-    }
-    /** 获取逐笔成交数据 */
-    async tradeTick(symbols) {
-        return this.execute('trade_tick', { symbols });
-    }
-    /** 获取深度行情 */
-    async quoteDepth(symbol) {
-        return this.execute('quote_depth', { symbol });
-    }
-    // === 期权行情方法 ===
-    /** 获取期权到期日 */
-    async optionExpiration(symbol) {
-        return this.execute('option_expiration', { symbols: [symbol] });
-    }
-    /** 获取期权链 */
-    async optionChain(symbol, expiry) {
-        return this.execute('option_chain', { symbol, expiry });
-    }
-    /** 获取期权报价 */
-    async optionBrief(identifiers) {
-        return this.execute('option_brief', { identifiers });
-    }
-    /** 获取期权 K 线 */
-    async optionKline(identifier, period) {
-        return this.execute('option_kline', { identifier, period });
-    }
-    // === 期货行情方法 ===
-    /** 获取期货交易所列表 */
-    async futureExchange() {
-        return this.execute('future_exchange', { sec_type: 'FUT' });
-    }
-    /** 获取期货合约列表 */
-    async futureContracts(exchange) {
-        return this.execute('future_contracts', { exchange });
-    }
-    /** 获取期货实时报价 */
-    async futureRealTimeQuote(symbols) {
-        return this.execute('future_real_time_quote', { symbols });
-    }
-    /** 获取期货 K 线 */
-    async futureKline(symbol, period) {
-        return this.execute('future_kline', { symbol, period });
-    }
-    // === 基本面和资金流向方法 ===
-    /** 获取财务日报 */
-    async financialDaily(symbol) {
-        return this.execute('financial_daily', { symbol });
-    }
-    /** 获取财务报告 */
-    async financialReport(symbol) {
-        return this.execute('financial_report', { symbol });
-    }
-    /** 获取公司行动 */
-    async corporateAction(symbol) {
-        return this.execute('corporate_action', { symbol });
-    }
-    /** 获取资金流向 */
-    async capitalFlow(symbol) {
-        return this.execute('capital_flow', { symbol });
-    }
-    /** 获取资金分布 */
-    async capitalDistribution(symbol) {
-        return this.execute('capital_distribution', { symbol });
-    }
-    // === 选股器和行情权限方法 ===
-    /** 选股器 */
-    async marketScanner(params) {
-        return this.execute('market_scanner', params);
-    }
-    /** 获取行情权限 */
+    async callIntoListOrObject(method, bizParams, version) {
+        const raw = await this.callInto(method, bizParams, version);
+        if (raw == null)
+            return [];
+        if (Array.isArray(raw))
+            return raw;
+        return [raw];
+    }
+    /** Unwrap server {"items":[...]} envelope. */
+    async callIntoItems(method, bizParams, version) {
+        const wrap = await this.callInto(method, bizParams, version);
+        return wrap?.items ?? [];
+    }
+    // === Basic market data ===
+    async getMarketState(market) {
+        return this.callInto('market_state', { market });
+    }
+    /** Real-time stock briefs. wire: quote_real_time */
+    async getBrief(req) {
+        return this.callInto('quote_real_time', req);
+    }
+    async getKline(symbol, period) {
+        return this.callInto('kline', { symbols: [symbol], period });
+    }
+    async getTimeline(symbols) {
+        return this.callInto('timeline', { symbols });
+    }
+    /** Tick-by-tick trades. wire: trade_tick */
+    async getTradeTick(req) {
+        return this.callInto('trade_tick', req);
+    }
+    /** Depth snapshot. wire: quote_depth */
+    async getQuoteDepth(req) {
+        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 getOptionBrief(identifiers) {
+        const optionBasic = identifiers.map((id) => {
+            const p = parseOptionIdentifier(id);
+            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');
+    }
+    // === Futures ===
+    async getFutureExchange() {
+        return this.callInto('future_exchange', { secType: 'FUT' });
+    }
+    async getFutureContracts(exchange) {
+        return this.callInto('future_contract_by_exchange_code', { exchangeCode: exchange });
+    }
+    /** Real-time futures quotes. wire: future_real_time_quote */
+    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);
+    }
+    async getFinancialReport(req) {
+        return this.callInto('financial_report', req);
+    }
+    /**
+     * Corporate actions. Server returns {symbol: [...]}, this method flattens into a single list.
+     */
+    async getCorporateAction(req) {
+        const grouped = await this.callInto('corporate_action', req);
+        if (!grouped || typeof grouped !== 'object')
+            return [];
+        return Object.values(grouped).flat();
+    }
+    // === Capital flow ===
+    async getCapitalFlow(symbol, market, period) {
+        return this.callInto('capital_flow', { symbol, market, period });
+    }
+    async getCapitalDistribution(symbol, market) {
+        return this.callInto('capital_distribution', { symbol, market });
+    }
+    // === Scanner & permission ===
+    async marketScanner(req) {
+        return this.callInto('market_scanner', req);
+    }
     async grabQuotePermission() {
-        return this.execute('grab_quote_permission');
+        return this.callInto('grab_quote_permission');
+    }
+    // ==========================================================================
+    // Batch 3: stock basics + time series
+    // ==========================================================================
+    /** All symbol codes (string list). wire: all_symbols */
+    async getSymbols(req) {
+        return this.callInto('all_symbols', req);
+    }
+    /** All symbols with names. wire: all_symbol_names */
+    async getSymbolNames(req) {
+        return this.callInto('all_symbol_names', req);
+    }
+    /** Trade meta (lot size / tick size). wire: quote_stock_trade */
+    async getTradeMetas(req) {
+        return this.callInto('quote_stock_trade', req);
+    }
+    /** Stock details. wire: stock_detail. Server returns {items:[...]}. */
+    async getStockDetails(req) {
+        return this.callIntoItems('stock_detail', req);
+    }
+    /** Delayed stock briefs. wire: quote_delay */
+    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) {
+        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;
+        let endTime = req.endTime ?? -1;
+        if (beginTime === 0)
+            beginTime = -1;
+        if (endTime === 0)
+            endTime = -1;
+        const acc = [];
+        while (acc.length < totalSize) {
+            const sub = {
+                symbols: req.symbol ? [req.symbol] : undefined,
+                period: req.period,
+                right: req.right,
+                beginTime,
+                endTime,
+                limit: pageSize,
+                tradeSession: req.tradeSession,
+                lang: req.lang,
+            };
+            const pageOut = await this.callInto('kline', sub);
+            if (!pageOut || pageOut.length === 0 || !pageOut[0].items || pageOut[0].items.length === 0) {
+                break;
+            }
+            const items = pageOut[0].items;
+            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)
+                    oldest = it.time;
+            }
+            endTime = oldest - 1;
+        }
+        return acc;
+    }
+    /** Historical intraday timeline. wire: history_timeline */
+    async getTimelineHistory(req) {
+        return this.callInto('history_timeline', req);
+    }
+    /** Trade rank (top movers / volume). wire: trade_rank */
+    async getTradeRank(req) {
+        return this.callInto('trade_rank', req);
+    }
+    /** Short interest / shortable. wire: quote_shortable_stocks */
+    async getShortInterest(req) {
+        return this.callInto('quote_shortable_stocks', req);
+    }
+    /** Broker queue. wire: stock_broker */
+    async getStockBroker(req) {
+        return this.callInto('stock_broker', req);
+    }
+    /** Stock fundamentals (server returns grouped map). wire: stock_fundamental */
+    async getStockFundamental(req) {
+        const out = await this.callInto('stock_fundamental', req);
+        return out ?? {};
+    }
+    /** Stock industry classification (array). wire: stock_industry */
+    async getStockIndustry(req) {
+        return this.callInto('stock_industry', req);
+    }
+    /** Quote permission detail. wire: get_quote_permission */
+    async getQuotePermission(req) {
+        return this.callInto('get_quote_permission', req);
+    }
+    /** K-line quota usage. wire: kline_quota */
+    async getKlineQuota(req) {
+        return this.callInto('kline_quota', req);
+    }
+    // ==========================================================================
+    // 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);
+    }
+    /** Option intraday timeline. wire: option_timeline */
+    async getOptionTimeline(req) {
+        return this.callInto('option_timeline', req);
+    }
+    /** Option depth. wire: option_depth */
+    async getOptionDepth(req) {
+        return this.callInto('option_depth', req);
+    }
+    /** Available option symbols. wire: option_symbol */
+    async getOptionSymbols(req) {
+        return this.callInto('option_symbol', req);
+    }
+    /** Option analysis (volatility). wire: option_analysis */
+    async getOptionAnalysis(req) {
+        return this.callInto('option_analysis', req);
+    }
+    /** Single futures contract by code. wire: future_contract_by_contract_code */
+    async getFutureContract(req) {
+        return this.callIntoListOrObject('future_contract_by_contract_code', req);
+    }
+    /** All futures contracts. wire: future_contracts */
+    async getAllFutureContracts(req) {
+        return this.callInto('future_contracts', req);
+    }
+    /** Current main contract. wire: future_current_contract */
+    async getCurrentFutureContract(req) {
+        return this.callInto('future_current_contract', req);
+    }
+    /** Continuous main contracts. wire: future_continuous_contracts */
+    async getFutureContinuousContracts(req) {
+        return this.callIntoListOrObject('future_continuous_contracts', req);
+    }
+    /** Historical main contracts. wire: future_main_contract */
+    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) {
+        const body = {
+            ...req,
+            beginTime: req.beginTime ?? -1,
+            endTime: req.endTime ?? -1,
+        };
+        return this.callInto('future_kline', body);
+    }
+    /** Client-side paginated futures K-line fetch. */
+    async getFutureBarsByPage(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;
+        let endTime = req.endTime ?? -1;
+        if (beginTime === 0)
+            beginTime = -1;
+        if (endTime === 0)
+            endTime = -1;
+        const acc = [];
+        while (acc.length < totalSize) {
+            const sub = {
+                contractCode: req.contractCode,
+                period: req.period,
+                beginTime,
+                endTime,
+                limit: pageSize,
+                lang: req.lang,
+            };
+            const pageOut = await this.callInto('future_kline', sub);
+            if (!pageOut || pageOut.length === 0 || !pageOut[0].items || pageOut[0].items.length === 0) {
+                break;
+            }
+            const items = pageOut[0].items;
+            acc.push(...items);
+            if (items.length < pageSize)
+                break;
+            let oldest = items[0].time;
+            for (const it of items) {
+                if (it.time < oldest)
+                    oldest = it.time;
+            }
+            endTime = oldest - 1;
+        }
+        return acc;
+    }
+    /** Futures tick trades. wire: future_tick (API v3.0) */
+    async getFutureTradeTicks(req) {
+        return this.callInto('future_tick', req, '3.0');
+    }
+    /** Futures depth. wire: future_depth */
+    async getFutureDepth(req) {
+        return this.callInto('future_depth', req);
+    }
+    /** Futures trading times (single-object response). wire: future_trading_date */
+    async getFutureTradingTimes(req) {
+        return this.callInto('future_trading_date', req);
+    }
+    // ==========================================================================
+    // Batch 5: fund / warrant / industry / corporate / financial / calendar
+    // ==========================================================================
+    /** Fund symbols. wire: fund_all_symbols */
+    async getFundSymbols(req) {
+        return this.callInto('fund_all_symbols', req);
+    }
+    /** Fund contracts. wire: fund_contracts */
+    async getFundContracts(req) {
+        return this.callInto('fund_contracts', req);
+    }
+    /** Fund real-time NAV. wire: fund_quote */
+    async getFundQuote(req) {
+        return this.callInto('fund_quote', req);
+    }
+    /** Fund historical NAV. wire: fund_history_quote */
+    async getFundHistoryQuote(req) {
+        return this.callInto('fund_history_quote', req);
+    }
+    /** Warrant briefs. wire: warrant_briefs */
+    async getWarrantBriefs(req) {
+        return this.callInto('warrant_briefs', req);
+    }
+    /** Warrant filter (paged). wire: warrant_filter */
+    async getWarrantFilter(req) {
+        return this.callInto('warrant_filter', req);
+    }
+    /** Industry list. wire: industry_list */
+    async getIndustryList(req) {
+        return this.callInto('industry_list', req);
+    }
+    /** Stocks inside an industry. wire: industry_stock_list */
+    async getIndustryStocks(req) {
+        return this.callInto('industry_stock_list', req);
+    }
+    /** Corporate split (flattened). wire: corporate_action (action_type=split) */
+    async getCorporateSplit(req) {
+        const body = { ...req, actionType: 'split' };
+        const grouped = await this.callInto('corporate_action', body);
+        if (!grouped || typeof grouped !== 'object')
+            return [];
+        return Object.values(grouped).flat();
+    }
+    /** Corporate dividend (flattened). wire: corporate_action (action_type=dividend) */
+    async getCorporateDividend(req) {
+        const body = { ...req, actionType: 'dividend' };
+        const grouped = await this.callInto('corporate_action', body);
+        if (!grouped || typeof grouped !== 'object')
+            return [];
+        return Object.values(grouped).flat();
+    }
+    /** Corporate earnings calendar (flattened). wire: corporate_action (action_type=earning) */
+    async getCorporateEarningsCalendar(req) {
+        const body = { ...req, actionType: 'earning' };
+        const grouped = await this.callInto('corporate_action', body);
+        if (!grouped || typeof grouped !== 'object')
+            return [];
+        return Object.values(grouped).flat();
+    }
+    /** Financial currency per symbol. wire: financial_currency */
+    async getFinancialCurrency(req) {
+        return this.callInto('financial_currency', req);
+    }
+    /** FX rates. wire: financial_exchange_rate */
+    async getFinancialExchangeRate(req) {
+        return this.callInto('financial_exchange_rate', req);
+    }
+    /** Trading calendar. wire: trading_calendar */
+    async getTradingCalendar(req) {
+        return this.callInto('trading_calendar', req);
+    }
+    /** Available market-scanner tags. wire: market_scanner_tags */
+    async getMarketScannerTags(req) {
+        return this.callInto('market_scanner_tags', req);
+    }
+    /** Overnight quote. wire: quote_overnight */
+    async getQuoteOvernight(req) {
+        return this.callInto('quote_overnight', req);
     }
 }

package/dist/esm/signer/signer.js

@@ -73,16 +73,16 @@ export function signWithRSA(privateKeyStr, content) {
     return sign.sign(key, 'base64');
 }
 /**
- * 使用 RSA 公钥验证 SHA1WithRSA 签名。
+ * Verify a SHA1WithRSA signature using an RSA public key.
  *
- * @param publicKey - 公钥对象
- * @param content - 原始内容
- * @param signature - Base64 编码的签名字符串
- * @returns 验签是否成功
+ * @param publicKeyBase64 - Base64-encoded public key (DER / PKCS#1 or SPKI)
+ * @param content - Original content that was signed
+ * @param signatureBase64 - Base64-encoded signature
+ * @returns Whether the signature is valid
  */
-export function verifyWithRSA(publicKey, content, signature) {
-    const verify = createVerify('SHA1');
-    verify.update(content);
-    verify.end();
-    return verify.verify(publicKey, signature, 'base64');
+export function verifyWithRSA(publicKeyBase64, content, signatureBase64) {
+    const pem = `-----BEGIN PUBLIC KEY-----\n${publicKeyBase64}\n-----END PUBLIC KEY-----`;
+    const verifier = createVerify('SHA1');
+    verifier.update(content);
+    return verifier.verify(pem, signatureBase64, 'base64');
 }