@tigeropenapi/tigeropen 0.4.0 → 0.4.6

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

@@ -84,18 +84,22 @@ export interface PreviewResult {
     message?: string;
 }
 export interface PlaceOrderResult {
-    id: number;
+    /** int64 order ID — may be a string when it exceeds Number.MAX_SAFE_INTEGER */
+    id: number | string;
     /** Account-level order ID; the server returns snake_case `order_id` */
-    order_id?: number;
-    subIds?: number[];
+    order_id?: number | string;
+    subIds?: (number | string)[];
     orders?: Order[];
 }
 export interface OrderIdResult {
-    id: number;
+    /** int64 order ID — may be a string when it exceeds Number.MAX_SAFE_INTEGER */
+    id: number | string;
 }
 export interface Transaction {
     id?: number;
     orderId?: number;
+    /** Numeric account ID (wire: accountId). */
+    accountId?: number;
     account?: string;
     symbol?: string;
     secType?: string;
@@ -103,12 +107,24 @@ export interface Transaction {
     currency?: string;
     identifier?: string;
     action?: string;
+    /** Order/commission price. */
     price?: number;
+    /** Fill price (wire: filledPrice). */
+    filledPrice?: number;
     quantity?: number;
     filledQuantity?: number;
+    /** Scale for filledQuantity (wire: filledQuantityScale). */
+    filledQuantityScale?: number;
+    /** Order amount. */
     amount?: number;
+    /** Fill amount (wire: filledAmount). */
+    filledAmount?: number;
     commission?: number;
-    transactedAt?: number;
+    /** Fill timestamp string, format "YYYY-MM-DD HH:MM:SS" (server returns string, not number). */
+    transactedAt?: string;
+    /** Fill time as Unix millisecond timestamp (wire: transactionTime). */
+    transactionTime?: number;
+    /** Legacy time field. */
     time?: number;
 }
 export interface ManagedAccount {
@@ -154,15 +170,25 @@ export interface ForexOrderResult {
     rate?: number;
     submitTime?: number;
 }
+/** Segment fund available item (segment_fund_available response). */
+export interface SegmentFundAvailableItem {
+    fromSegment?: string;
+    currency?: string;
+    amount?: number;
+}
+/** Segment fund transfer/cancel response. */
 export interface SegmentFund {
-    id?: string;
-    status?: string;
+    id?: string | number;
     fromSegment?: string;
     toSegment?: string;
     currency?: string;
     amount?: number;
-    availableAmount?: number;
-    submitTime?: number;
+    status?: string;
+    statusDesc?: string;
+    message?: string;
+    settledAt?: number;
+    createdAt?: number;
+    updatedAt?: number;
 }
 export interface SegmentFundHistoryItem {
     id?: number;
@@ -171,8 +197,10 @@ export interface SegmentFundHistoryItem {
     currency?: string;
     amount?: number;
     status?: string;
-    submitTime?: number;
-    updateTime?: number;
+    statusDesc?: string;
+    settledAt?: number;
+    createdAt?: number;
+    updatedAt?: number;
 }
 export interface FundDetails {
     id?: number;
@@ -187,13 +215,18 @@ export interface FundDetails {
     externalId?: string;
 }
 export interface FundingHistoryItem {
-    id?: string;
-    segType?: string;
+    id?: number;
+    refId?: string;
+    type?: number;
+    typeDesc?: string;
     currency?: string;
     amount?: number;
+    businessDate?: string;
     status?: string;
-    submitTime?: number;
-    updateTime?: number;
+    statusDesc?: string;
+    completedStatus?: boolean;
+    createdAt?: number;
+    updatedAt?: number;
 }
 export interface TransferItem {
     symbol?: string;
@@ -233,3 +266,63 @@ export interface PositionTransferExternalRecord {
     submitTime?: number;
     updateTime?: number;
 }
+/** 行权检验结果 */
+export interface OptionExerciseCheckResult {
+    availableQuantity: number;
+    position: number;
+    stkPosition: number;
+    stkPositionChange: number;
+    stkPositionBefore: number;
+    stkPositionAfter: number;
+    symbol?: string;
+}
+/** 可行权期权持仓条目 */
+export interface OptionExercisePosition {
+    contractId?: number;
+    symbol?: string;
+    stkSymbol?: string;
+    expireDate?: string;
+    strike?: string;
+    callPut?: string;
+    market?: string;
+    accountId?: number;
+    position: number;
+    availableQuantity: number;
+}
+/** 可行权持仓分页结果 */
+export interface OptionExercisePositionPageResult {
+    pageNum: number;
+    pageSize: number;
+    itemCount: number;
+    pageCount: number;
+    items?: OptionExercisePosition[];
+}
+/** 行权申请记录条目 */
+export interface OptionExerciseRecord {
+    id?: number;
+    contractId?: number;
+    symbol?: string;
+    stkSymbol?: string;
+    expireDate?: string;
+    strike?: string;
+    callPut?: string;
+    /** Exercise | Expire */
+    type?: string;
+    requestQuantity: number;
+    quantity: number;
+    /** New | Cancel | Success | Fail */
+    status?: string;
+    executingDate?: string;
+    itmRate: number;
+    isForce: boolean;
+    reason?: string;
+    accountId?: number;
+}
+/** 行权记录分页结果 */
+export interface OptionExerciseRecordPageResult {
+    pageNum: number;
+    pageSize: number;
+    itemCount: number;
+    pageCount: number;
+    items?: OptionExerciseRecord[];
+}

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

@@ -44,10 +44,12 @@ export declare class PushClient {
     private useFullTick;
     private socket;
     private _state;
+    /** Whether this connect attempt already fell back to unverified TLS */
+    private tlsFallback;
     private callbacks;
     /** Subscription state: subject -> Set<symbol> */
     private subscriptions;
-    /** Account-level subscriptions */
+    /** Account-level subscriptions: subject -> account string used at subscribe time */
     private accountSubs;
     private heartbeatTimer;
     private reconnectTimer;
@@ -166,6 +168,6 @@ export declare class PushClient {
     unsubscribeTransaction(): void;
     /** Get current market data subscriptions */
     getSubscriptions(): Map<SubjectType, string[]>;
-    /** Get account-level subscriptions */
-    getAccountSubscriptions(): SubjectType[];
+    /** Get account-level subscriptions: subject -> account */
+    getAccountSubscriptions(): Map<SubjectType, string>;
 }

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

@@ -124,7 +124,9 @@ export declare class QuoteClient {
     getFutureBars(req: FutureBarsRequest): Promise<FutureKline[]>;
     /** Client-side paginated futures K-line fetch. */
     getFutureBarsByPage(req: FutureBarsByPageRequest): Promise<FutureKlineItem[]>;
-    /** Futures tick trades. wire: future_tick (API v3.0) */
+    /** 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). */
     getFutureTradeTicks(req: FutureTradeTicksRequest): Promise<FutureTradeTickItem[]>;
     /** Futures depth. wire: future_depth */
     getFutureDepth(req: FutureDepthRequest): Promise<FutureDepth[]>;

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

@@ -11,13 +11,14 @@ import type { HttpClient } from '../client/http-client';
 import type { OrderRequest, Order } from '../model/order';
 import type { Contract } from '../model/contract';
 import type { Position } from '../model/position';
-import type { Asset, PrimeAsset, PreviewResult, PlaceOrderResult, OrderIdResult, Transaction, ManagedAccount, AnalyticsAsset, AggregateAssets, EstimateTradableQuantity, ForexOrderResult, SegmentFund, SegmentFundHistoryItem, FundDetails, FundingHistoryItem, PositionTransferRecord, PositionTransferDetail, PositionTransferExternalRecord } from '../model/trade';
-import type { OrdersRequest, GetOrderRequest, OrderTransactionsRequest, PositionsRequest, AssetsRequest, ManagedAccountsRequest, DerivativeContractsRequest, AnalyticsAssetRequest, AggregateAssetsRequest, EstimateTradableQuantityRequest, ForexOrderRequest, SegmentFundRequest, FundDetailsRequest, FundingHistoryRequest, PositionTransferRequest, PositionTransferRecordsRequest, PositionTransferDetailRequest, PositionTransferExternalRecordsRequest } from '../model/trade-requests';
+import type { Asset, PrimeAsset, PreviewResult, PlaceOrderResult, OrderIdResult, Transaction, ManagedAccount, AnalyticsAsset, AggregateAssets, EstimateTradableQuantity, ForexOrderResult, SegmentFund, SegmentFundAvailableItem, SegmentFundHistoryItem, FundDetails, FundingHistoryItem, PositionTransferRecord, PositionTransferDetail, PositionTransferExternalRecord, OptionExerciseCheckResult, OptionExercisePositionPageResult, OptionExerciseRecordPageResult } from '../model/trade';
+import 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';
 /** Trading client wrapping all trade-related APIs. */
 export declare class TradeClient {
     private httpClient;
     private account;
-    constructor(httpClient: HttpClient, account: string);
+    private secretKey?;
+    constructor(httpClient: HttpClient, account: string, secretKey?: string);
     private callInto;
     /** Strip `{items: [...]}` envelope used by most trade read endpoints. */
     private callIntoItems;
@@ -30,8 +31,8 @@ export declare class TradeClient {
     getQuoteContract(symbol: string, secType: string, expiry: string): Promise<Contract[]>;
     placeOrder(order: OrderRequest): Promise<PlaceOrderResult | undefined>;
     previewOrder(order: OrderRequest): Promise<PreviewResult | undefined>;
-    modifyOrder(id: number, order: OrderRequest): Promise<OrderIdResult | undefined>;
-    cancelOrder(id: number): Promise<OrderIdResult | undefined>;
+    modifyOrder(id: number | string, order: OrderRequest): Promise<OrderIdResult | undefined>;
+    cancelOrder(id: number | string, secretKey?: string): Promise<OrderIdResult | undefined>;
     /**
      * Query all historical orders. v0.4.0: optional OrdersRequest for filtering.
      *
@@ -91,7 +92,7 @@ export declare class TradeClient {
     /** Place forex order (sub-account base-currency swap). */
     placeForexOrder(req: ForexOrderRequest): Promise<ForexOrderResult | undefined>;
     /** Query amount available for inter-segment transfer. Returns array. */
-    getSegmentFundAvailable(req: SegmentFundRequest): Promise<SegmentFund[]>;
+    getSegmentFundAvailable(req: SegmentFundRequest): Promise<SegmentFundAvailableItem[]>;
     /** Query segment fund transfer history. Server returns plain array (no items wrapper). */
     getSegmentFundHistory(req: SegmentFundRequest): Promise<SegmentFundHistoryItem[]>;
     /** Execute an inter-segment fund transfer. */
@@ -100,7 +101,8 @@ export declare class TradeClient {
     cancelSegmentFund(req: SegmentFundRequest): Promise<SegmentFund | undefined>;
     /** Fund-movement details (by segment / currency / fund-type). */
     getFundDetails(req: FundDetailsRequest): Promise<FundDetails[]>;
-    /** Funding history (wire method: `transfer_fund`). */
+    /** Funding history (wire method: `transfer_fund`).
+     * Server returns bare list (no items wrapper). */
     getFundingHistory(req: FundingHistoryRequest): Promise<FundingHistoryItem[]>;
     /**
      * Internal position transfer (cross sub-account).
@@ -113,4 +115,14 @@ export declare class TradeClient {
     getPositionTransferDetail(req: PositionTransferDetailRequest): Promise<PositionTransferDetail | undefined>;
     /** Query external position transfer records (DWAC / FOP / etc.). */
     getPositionTransferExternalRecords(req: PositionTransferExternalRecordsRequest): Promise<PositionTransferExternalRecord[]>;
+    /** 行权检验：预估行权/作废后正股持仓变化 (wire: option_exercise_check) */
+    checkOptionExercise(req: OptionExerciseCheckRequest): Promise<OptionExerciseCheckResult | undefined>;
+    /** 查询可行权持仓列表 (wire: option_exercise_position) */
+    getOptionExercisePositions(req: OptionExercisePositionRequest): Promise<OptionExercisePositionPageResult | undefined>;
+    /** 提交行权/作废申请 (wire: option_exercise_submit) */
+    submitOptionExercise(req: OptionExerciseSubmitRequest): Promise<boolean>;
+    /** 分页查询行权记录 (wire: option_exercise_record) */
+    getOptionExerciseRecords(req: OptionExerciseRecordsRequest): Promise<OptionExerciseRecordPageResult | undefined>;
+    /** 撤销行权申请 (wire: option_exercise_cancel) */
+    cancelOptionExercise(req: OptionExerciseCancelRequest): Promise<boolean>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tigeropenapi/tigeropen",
-  "version": "0.4.0",
+  "version": "0.4.6",
   "description": "Tiger Brokers OpenAPI TypeScript SDK for market data, trading, and real-time push",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -24,7 +24,7 @@
     "url": "https://github.com/tigerfintech/openapi-typescript-sdk/issues"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/fix-esm-imports.mjs",
     "build:esm": "tsc -p tsconfig.json",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "prepublishOnly": "npm run build",
@@ -50,6 +50,7 @@
     "@types/node": "^25.6.0",
     "fast-check": "^3.15.0",
     "ts-proto": "^2.11.6",
+    "tsx": "^4.22.4",
     "typescript": "^5.3.0",
     "vitest": "^1.2.0"
   },