@tigeropenapi/tigeropen 0.1.0 → 0.4.0

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

@@ -0,0 +1,195 @@
+/**
+ * Trade request interfaces (v0.4.0).
+ *
+ * 所有字段可选(用户调用时传一个空对象即可);字段名用 camelCase,
+ * client 层通过 keysToSnakeCase 转成服务端 wire 真名的 snake_case。
+ * **字段名设计规则:camelCase → snake_case 后必须等于服务端 wire 真名。**
+ * 比如 Trade 用 `startDate`/`endDate`(wire `start_date`/`end_date`),
+ * 不用 `startTime`/`endTime`(会被转成 `start_time`/`end_time`,与 wire 不符)。
+ *
+ * 参考 Go SDK model/trade_requests.go。
+ */
+export interface OrdersRequest {
+    account?: string;
+    secType?: string;
+    market?: string;
+    symbol?: string;
+    /** 毫秒时间戳 (wire: start_date) */
+    startDate?: number;
+    /** 毫秒时间戳 (wire: end_date) */
+    endDate?: number;
+    limit?: number;
+    isBrief?: boolean;
+    /** 订单状态过滤: Invalid / Initial / PendingCancel / Cancelled / Submitted / Filled / Inactive / PendingSubmit */
+    states?: string[];
+    /** LATEST_CREATED / LATEST_STATUS_UPDATED */
+    sortBy?: string;
+    segType?: string;
+    lang?: string;
+    pageToken?: string;
+    /** 仅 ActiveOrders 使用,按父订单 ID 过滤附加订单 */
+    parentId?: number;
+}
+export interface GetOrderRequest {
+    account?: string;
+    id?: number;
+    orderId?: number;
+    isBrief?: boolean;
+    showCharges?: boolean;
+    lang?: string;
+}
+export interface OrderTransactionsRequest {
+    account?: string;
+    orderId?: number;
+    symbol?: string;
+    secType?: string;
+    /** 毫秒时间戳 */
+    startDate?: number;
+    /** 毫秒时间戳 */
+    endDate?: number;
+    limit?: number;
+    expiry?: string;
+    strike?: number;
+    putCall?: string;
+    lang?: string;
+    pageToken?: string;
+}
+export interface PositionsRequest {
+    account?: string;
+    secType?: string;
+    currency?: string;
+    market?: string;
+    symbol?: string;
+    subAccounts?: string[];
+    expiry?: string;
+    strike?: string;
+    right?: string;
+    assetQuoteType?: string;
+    lang?: string;
+}
+export interface AssetsRequest {
+    account?: string;
+    subAccounts?: string[];
+    segment?: boolean;
+    marketValue?: boolean;
+    lang?: string;
+}
+export interface ManagedAccountsRequest {
+    account?: string;
+    lang?: string;
+}
+export interface DerivativeContractsRequest {
+    account?: string;
+    symbols: string[];
+    secType: string;
+    expiry?: string;
+    lang?: string;
+}
+export interface AnalyticsAssetRequest {
+    account?: string;
+    segType?: string;
+    /** 格式 "YYYY-MM-DD" */
+    startDate?: string;
+    endDate?: string;
+    lang?: string;
+}
+export interface AggregateAssetsRequest {
+    account?: string;
+    baseCurrency?: string;
+    segType?: string;
+    lang?: string;
+}
+export interface EstimateTradableQuantityRequest {
+    account?: string;
+    symbol: string;
+    secType: string;
+    action: string;
+    orderType?: string;
+    limitPrice?: number;
+    market?: string;
+    currency?: string;
+    expiry?: string;
+    strike?: string;
+    right?: string;
+    lang?: string;
+}
+export interface ForexOrderRequest {
+    account?: string;
+    segType?: string;
+    sourceCurrency: string;
+    targetCurrency: string;
+    sourceAmount?: number;
+    targetAmount?: number;
+    orderType?: string;
+    lang?: string;
+}
+export interface SegmentFundRequest {
+    account?: string;
+    id?: string;
+    fromSegment?: string;
+    toSegment?: string;
+    currency?: string;
+    amount?: number;
+    limit?: number;
+    lang?: string;
+}
+export interface FundDetailsRequest {
+    account?: string;
+    segTypes?: string[];
+    fundType?: string;
+    currency?: string;
+    /** 毫秒时间戳 */
+    startDate?: number;
+    /** 毫秒时间戳 */
+    endDate?: number;
+    limit?: number;
+    pageToken?: string;
+    lang?: string;
+}
+export interface FundingHistoryRequest {
+    account?: string;
+    segType?: string;
+    currency?: string;
+    /** 毫秒时间戳 */
+    startDate?: number;
+    /** 毫秒时间戳 */
+    endDate?: number;
+    limit?: number;
+    lang?: string;
+}
+export interface PositionTransferRequest {
+    fromAccount?: string;
+    toAccount: string;
+    market?: string;
+    transfers: Array<{
+        symbol?: string;
+        quantity?: number;
+        expiry?: string;
+        strike?: string;
+        right?: string;
+        secType?: string;
+    }>;
+    lang?: string;
+}
+export interface PositionTransferRecordsRequest {
+    /** wire: account_id */
+    accountId?: string;
+    sinceDate?: string;
+    toDate?: string;
+    market?: string;
+    limit?: number;
+    lang?: string;
+}
+export interface PositionTransferDetailRequest {
+    accountId?: string;
+    id: string;
+    lang?: string;
+}
+export interface PositionTransferExternalRecordsRequest {
+    accountId?: string;
+    sinceDate?: string;
+    toDate?: string;
+    market?: string;
+    limit?: number;
+    lang?: string;
+}

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

@@ -0,0 +1,235 @@
+/**
+ * Trade response models (Asset / PrimeAsset / order result / transaction).
+ */
+import type { Order } from './order';
+export interface AssetSegment {
+    account?: string;
+    category?: string;
+    title?: string;
+    netLiquidation?: number;
+    cashValue?: number;
+    availableFunds?: number;
+    equityWithLoan?: number;
+    excessLiquidity?: number;
+    accruedCash?: number;
+    accruedDividend?: number;
+    initMarginReq?: number;
+    maintMarginReq?: number;
+    grossPositionValue?: number;
+    leverage?: number;
+}
+export interface Asset {
+    account?: string;
+    capability?: string;
+    currency?: string;
+    buyingPower?: number;
+    cashValue?: number;
+    netLiquidation?: number;
+    realizedPnL?: number;
+    unrealizedPnL?: number;
+    segments?: AssetSegment[];
+}
+export interface CurrencyAsset {
+    currency?: string;
+    cashBalance?: number;
+    cashAvailableForTrade?: number;
+    forexRate?: number;
+}
+export interface PrimeAssetSegment {
+    capability?: string;
+    category?: string;
+    currency?: string;
+    cashBalance?: number;
+    cashAvailableForTrade?: number;
+    grossPositionValue?: number;
+    equityWithLoan?: number;
+    netLiquidation?: number;
+    initMargin?: number;
+    maintainMargin?: number;
+    overnightMargin?: number;
+    unrealizedPL?: number;
+    unrealizedPLByCostOfCarry?: number;
+    realizedPL?: number;
+    totalTodayPL?: number;
+    excessLiquidation?: number;
+    overnightLiquidation?: number;
+    buyingPower?: number;
+    lockedFunds?: number;
+    leverage?: number;
+    uncollected?: number;
+    currencyAssets?: CurrencyAsset[];
+    consolidatedSegTypes?: string[];
+}
+export interface PrimeAsset {
+    accountId: string;
+    updateTimestamp?: number;
+    segments: PrimeAssetSegment[];
+}
+export interface PreviewResult {
+    account?: string;
+    isPass: boolean;
+    commission?: number;
+    commissionCurrency?: string;
+    marginCurrency?: string;
+    initMargin?: number;
+    initMarginBefore?: number;
+    maintMargin?: number;
+    maintMarginBefore?: number;
+    equityWithLoan?: number;
+    equityWithLoanBefore?: number;
+    availableEE?: number;
+    excessLiquidity?: number;
+    overnightLiquidation?: number;
+    gst?: number;
+    message?: string;
+}
+export interface PlaceOrderResult {
+    id: number;
+    /** Account-level order ID; the server returns snake_case `order_id` */
+    order_id?: number;
+    subIds?: number[];
+    orders?: Order[];
+}
+export interface OrderIdResult {
+    id: number;
+}
+export interface Transaction {
+    id?: number;
+    orderId?: number;
+    account?: string;
+    symbol?: string;
+    secType?: string;
+    market?: string;
+    currency?: string;
+    identifier?: string;
+    action?: string;
+    price?: number;
+    quantity?: number;
+    filledQuantity?: number;
+    amount?: number;
+    commission?: number;
+    transactedAt?: number;
+    time?: number;
+}
+export interface ManagedAccount {
+    account?: string;
+    accountType?: string;
+    capability?: string;
+    status?: string;
+}
+export interface AnalyticsAsset {
+    date?: string;
+    holdingValue?: number;
+    cashBalance?: number;
+    pnl?: number;
+    pnlRate?: number;
+    netValueIndex?: number;
+    currency?: string;
+    segType?: string;
+}
+export interface AggregateAssets {
+    accountId?: string;
+    netLiquidation?: number;
+    grossPositionValue?: number;
+    cashBalance?: number;
+    baseCurrency?: string;
+    currencyAssets?: CurrencyAsset[];
+}
+export interface EstimateTradableQuantity {
+    tradableQuantity?: number;
+    maxCashBuyQuantity?: number;
+    maxMarginBuyQuantity?: number;
+    maxShortSellQuantity?: number;
+    maxPositionSellQuantity?: number;
+    cashBuyingPower?: number;
+    currency?: string;
+}
+export interface ForexOrderResult {
+    id?: string;
+    status?: string;
+    sourceCurrency?: string;
+    targetCurrency?: string;
+    sourceAmount?: number;
+    targetAmount?: number;
+    rate?: number;
+    submitTime?: number;
+}
+export interface SegmentFund {
+    id?: string;
+    status?: string;
+    fromSegment?: string;
+    toSegment?: string;
+    currency?: string;
+    amount?: number;
+    availableAmount?: number;
+    submitTime?: number;
+}
+export interface SegmentFundHistoryItem {
+    id?: number;
+    fromSegment?: string;
+    toSegment?: string;
+    currency?: string;
+    amount?: number;
+    status?: string;
+    submitTime?: number;
+    updateTime?: number;
+}
+export interface FundDetails {
+    id?: number;
+    account?: string;
+    segType?: string;
+    fundType?: string;
+    currency?: string;
+    amount?: number;
+    balance?: number;
+    occurTime?: number;
+    remark?: string;
+    externalId?: string;
+}
+export interface FundingHistoryItem {
+    id?: string;
+    segType?: string;
+    currency?: string;
+    amount?: number;
+    status?: string;
+    submitTime?: number;
+    updateTime?: number;
+}
+export interface TransferItem {
+    symbol?: string;
+    quantity?: number;
+    expiry?: string;
+    strike?: string;
+    right?: string;
+    secType?: string;
+}
+export interface PositionTransferRecord {
+    id?: string;
+    fromAccount?: string;
+    toAccount?: string;
+    market?: string;
+    status?: string;
+    submitTime?: number;
+    transfers?: TransferItem[];
+}
+export interface PositionTransferDetail {
+    id?: string;
+    fromAccount?: string;
+    toAccount?: string;
+    market?: string;
+    status?: string;
+    submitTime?: number;
+    updateTime?: number;
+    transfers?: TransferItem[];
+    remark?: string;
+}
+export interface PositionTransferExternalRecord {
+    id?: string;
+    market?: string;
+    symbol?: string;
+    quantity?: number;
+    direction?: string;
+    status?: string;
+    submitTime?: number;
+    updateTime?: number;
+}

package/dist/types/push/callbacks.d.ts

@@ -1,57 +1,38 @@
 /**
- * 推送回调函数类型定义
+ * 推送回调函数类型定义（Protobuf 协议）
  *
- * 每种推送类型独立回调，连接状态回调独立管理。
+ * 每种推送类型独立回调，参数类型为 Protobuf 生成的类型。
+ * 连接状态回调独立管理。
  */
-import type { QuoteData, TickData, DepthData, KlineData, AssetData, PositionData, OrderData, TransactionData, SubjectType } from './push-message';
-/** 行情推送回调 */
-export type QuoteCallback = (data: QuoteData) => void;
-/** 逐笔成交推送回调 */
-export type TickCallback = (data: TickData) => void;
-/** 深度行情推送回调 */
-export type DepthCallback = (data: DepthData) => void;
-/** K 线推送回调 */
-export type KlineCallback = (data: KlineData) => void;
-/** 资产变动推送回调 */
-export type AssetCallback = (data: AssetData) => void;
-/** 持仓变动推送回调 */
-export type PositionCallback = (data: PositionData) => void;
-/** 订单状态推送回调 */
-export type OrderCallback = (data: OrderData) => void;
-/** 成交明细推送回调 */
-export type TransactionCallback = (data: TransactionData) => void;
-/** 连接成功回调 */
-export type ConnectCallback = () => void;
-/** 断开连接回调 */
-export type DisconnectCallback = () => void;
-/** 错误回调 */
-export type ErrorCallback = (err: Error) => void;
-/** 被踢出回调 */
-export type KickoutCallback = (message: string) => void;
-/** 订阅成功回调 */
-export type SubscribeCallback = (subject: SubjectType, symbols: string[]) => void;
-/** 退订成功回调 */
-export type UnsubscribeCallback = (subject: SubjectType, symbols: string[]) => void;
+import type { QuoteData } from './pb/QuoteData';
+import type { QuoteDepthData } from './pb/QuoteDepthData';
+import type { TradeTickData } from './pb/TradeTickData';
+import type { TickData } from './pb/TickData';
+import type { AssetData } from './pb/AssetData';
+import type { PositionData } from './pb/PositionData';
+import type { OrderStatusData } from './pb/OrderStatusData';
+import type { OrderTransactionData } from './pb/OrderTransactionData';
+import type { StockTopData } from './pb/StockTopData';
+import type { OptionTopData } from './pb/OptionTopData';
+import type { KlineData } from './pb/KlineData';
 /** 所有回调函数的集合 */
 export interface Callbacks {
-    onQuote?: QuoteCallback;
-    onTick?: TickCallback;
-    onDepth?: DepthCallback;
-    onOption?: QuoteCallback;
-    onFuture?: QuoteCallback;
-    onKline?: KlineCallback;
-    onStockTop?: QuoteCallback;
-    onOptionTop?: QuoteCallback;
-    onFullTick?: TickCallback;
-    onQuoteBBO?: QuoteCallback;
-    onAsset?: AssetCallback;
-    onPosition?: PositionCallback;
-    onOrder?: OrderCallback;
-    onTransaction?: TransactionCallback;
-    onConnect?: ConnectCallback;
-    onDisconnect?: DisconnectCallback;
-    onError?: ErrorCallback;
-    onKickout?: KickoutCallback;
-    onSubscribe?: SubscribeCallback;
-    onUnsubscribe?: UnsubscribeCallback;
+    onQuote?: (data: QuoteData) => void;
+    onTick?: (data: TradeTickData) => void;
+    onDepth?: (data: QuoteDepthData) => void;
+    onOption?: (data: QuoteData) => void;
+    onFuture?: (data: QuoteData) => void;
+    onKline?: (data: KlineData) => void;
+    onStockTop?: (data: StockTopData) => void;
+    onOptionTop?: (data: OptionTopData) => void;
+    onFullTick?: (data: TickData) => void;
+    onQuoteBBO?: (data: QuoteData) => void;
+    onAsset?: (data: AssetData) => void;
+    onPosition?: (data: PositionData) => void;
+    onOrder?: (data: OrderStatusData) => void;
+    onTransaction?: (data: OrderTransactionData) => void;
+    onConnect?: () => void;
+    onDisconnect?: () => void;
+    onError?: (err: Error) => void;
+    onKickout?: (message: string) => void;
 }

package/dist/types/push/index.d.ts

@@ -1,7 +1,9 @@
 /**
- * 推送模块导出
+ * Push module exports
  */
-export * from './push-message';
+export { SubjectType } from './push-message';
 export * from './callbacks';
+export * from './varint';
+export * from './proto-message';
 export { PushClient, ConnectionState } from './push-client';
-export type { PushClientOptions, WebSocketLike, WebSocketFactory } from './push-client';
+export type { PushClientOptions, TLSSocketLike, TLSSocketFactory } from './push-client';

package/dist/types/push/pb/AssetData.d.ts

@@ -0,0 +1,47 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "com.tigerbrokers.stock.openapi.client.socket.data.pb";
+export interface AssetData {
+    /** user account */
+    account: string;
+    /** currency. USD, HKD, etc. */
+    currency: string;
+    /** Securities Category C: (Commodities Futures), S: (Securities Stocks) */
+    segType: string;
+    /** available funds, overnight liquidity */
+    availableFunds: number;
+    /** excess liquidity, used to represent intraday risk value. */
+    excessLiquidity: number;
+    /** Total Assets (Net Liquidation Value) */
+    netLiquidation: number;
+    /** Equity with loan value (asset with loan value) - Securities Segment: Cash Value + Stock Value - Futures Segment: Cash Value - Maintenance Margin */
+    equityWithLoan: number;
+    /** buying power. An estimation of how many more dollars you can buy in stock assets. Only apply to stock segment */
+    buyingPower: number;
+    /** Cash amount. Sum of current cash balances in all currencies */
+    cashBalance: number;
+    /** total value of securities */
+    grossPositionValue: number;
+    /** initial margin requirement */
+    initMarginReq: number;
+    /** maintenance margin requirement */
+    maintMarginReq: number;
+    timestamp: number;
+}
+export declare const AssetData: MessageFns<AssetData>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/types/push/pb/KlineData.d.ts

@@ -0,0 +1,43 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "com.tigerbrokers.stock.openapi.client.socket.data.pb";
+export interface KlineData {
+    /** bar timestamp. */
+    time: number;
+    /** The first transaction price of current minute. */
+    open: number;
+    /** The highest price of current minute. */
+    high: number;
+    /** The lowest price of current minute. */
+    low: number;
+    /** The last transaction price in the current minute */
+    close: number;
+    /** The average price of current minute. */
+    avg: number;
+    /** Cumulative trading volume in current minute. */
+    volume: number;
+    /** The number of transaction in current minute. */
+    count: number;
+    /** symbol */
+    symbol: string;
+    /** Cumulative turnover in current minute. */
+    amount: number;
+    serverTimestamp?: number | undefined;
+}
+export declare const KlineData: MessageFns<KlineData>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/types/push/pb/OptionTopData.d.ts

@@ -0,0 +1,76 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "com.tigerbrokers.stock.openapi.client.socket.data.pb";
+export interface OptionTopData {
+    market: string;
+    timestamp: number;
+    topData: OptionTopData_TopData[];
+}
+export interface OptionTopData_TopData {
+    /** bigOrder, volume, amount, openInt */
+    targetName: string;
+    /** large order(bigOrder) */
+    bigOrder: OptionTopData_BigOrder[];
+    /** target value top list(volume, amount, openInt) */
+    item: OptionTopData_OptionItem[];
+}
+export interface OptionTopData_BigOrder {
+    symbol: string;
+    /** formate:yyyyMMdd */
+    expiry: string;
+    /** strike price */
+    strike: string;
+    /** CALL/PUT */
+    right: string;
+    /** BUY/SELL */
+    dir: string;
+    /** target value: volume > 1000 */
+    volume: number;
+    /** trade price */
+    price: number;
+    /** trade amount */
+    amount: number;
+    /** trade timestamp */
+    tradeTime: number;
+}
+export interface OptionTopData_OptionItem {
+    symbol: string;
+    /** formate:yyyyMMdd */
+    expiry: string;
+    /** strike price */
+    strike: string;
+    /** CALL/PUT */
+    right: string;
+    /** total trade amount */
+    totalAmount: number;
+    /** total trade volume */
+    totalVolume: number;
+    /** open interest */
+    totalOpenInt: number;
+    /** Volume to Open Interest */
+    volumeToOpenInt: number;
+    /** option latest price */
+    latestPrice: number;
+    /** uptate timestamp */
+    updateTime: number;
+}
+export declare const OptionTopData: MessageFns<OptionTopData>;
+export declare const OptionTopData_TopData: MessageFns<OptionTopData_TopData>;
+export declare const OptionTopData_BigOrder: MessageFns<OptionTopData_BigOrder>;
+export declare const OptionTopData_OptionItem: MessageFns<OptionTopData_OptionItem>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};