@finatic/client 0.0.140 → 0.0.141

package/dist/types/core/client/ApiClient.d.ts

@@ -3,7 +3,7 @@ import { BrokerInfo, BrokerAccount, BrokerOrder, BrokerPosition, BrokerBalance,
 import { BrokerOrderParams, BrokerExtras } from '../../types/api/broker';
 import { CryptoOrderOptions, OptionsOrderOptions, OrderResponse } from '../../types/api/orders';
 import { BrokerConnection } from '../../types/api/broker';
-import { OrdersFilter, PositionsFilter, AccountsFilter, BalancesFilter } from '../../types/api/broker';
+import { OrdersFilter, PositionsFilter, AccountsFilter, BalancesFilter, OrderFill, OrderEvent, OrderGroup, PositionLot, PositionLotFill, OrderFillsFilter, OrderEventsFilter, OrderGroupsFilter, PositionLotsFilter, PositionLotFillsFilter } from '../../types/api/broker';
 import { PaginatedResult } from '../../types/common/pagination';
 import { PortalUrlResponse } from '../../types/api/core';
 import { DeviceInfo, SessionState, SessionResponse, OtpRequestResponse, OtpVerifyResponse, SessionAuthenticateResponse, UserToken } from '../../types/api/auth';
@@ -197,4 +197,72 @@ export declare class ApiClient {
      * @returns Promise with disconnect response
      */
     disconnectCompany(connectionId: string): Promise<DisconnectCompanyResponse>;
+    /**
+     * Get order fills for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order fills response
+     */
+    getOrderFills(orderId: string, filter?: OrderFillsFilter): Promise<{
+        _id: string;
+        response_data: OrderFill[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get order events for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order events response
+     */
+    getOrderEvents(orderId: string, filter?: OrderEventsFilter): Promise<{
+        _id: string;
+        response_data: OrderEvent[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get order groups
+     * @param filter - Optional filter parameters
+     * @returns Promise with order groups response
+     */
+    getOrderGroups(filter?: OrderGroupsFilter): Promise<{
+        _id: string;
+        response_data: OrderGroup[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get position lots (tax lots for positions)
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lots response
+     */
+    getPositionLots(filter?: PositionLotsFilter): Promise<{
+        _id: string;
+        response_data: PositionLot[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
+    /**
+     * Get position lot fills for a specific lot
+     * @param lotId - The position lot ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lot fills response
+     */
+    getPositionLotFills(lotId: string, filter?: PositionLotFillsFilter): Promise<{
+        _id: string;
+        response_data: PositionLotFill[];
+        message: string;
+        status_code: number;
+        warnings: null;
+        errors: null;
+    }>;
 }

package/dist/types/core/client/FinaticConnect.d.ts

@@ -293,5 +293,38 @@ export declare class FinaticConnect extends EventEmitter {
      * @throws AuthenticationError if user is not authenticated
      */
     disconnectCompany(connectionId: string): Promise<DisconnectCompanyResponse>;
+    /**
+     * Get order fills for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order fills response
+     */
+    getOrderFills(orderId: string, filter?: import('../../types/api/broker').OrderFillsFilter): Promise<import('../../types/api/broker').OrderFill[]>;
+    /**
+     * Get order events for a specific order
+     * @param orderId - The order ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with order events response
+     */
+    getOrderEvents(orderId: string, filter?: import('../../types/api/broker').OrderEventsFilter): Promise<import('../../types/api/broker').OrderEvent[]>;
+    /**
+     * Get order groups
+     * @param filter - Optional filter parameters
+     * @returns Promise with order groups response
+     */
+    getOrderGroups(filter?: import('../../types/api/broker').OrderGroupsFilter): Promise<import('../../types/api/broker').OrderGroup[]>;
+    /**
+     * Get position lots (tax lots for positions)
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lots response
+     */
+    getPositionLots(filter?: import('../../types/api/broker').PositionLotsFilter): Promise<import('../../types/api/broker').PositionLot[]>;
+    /**
+     * Get position lot fills for a specific lot
+     * @param lotId - The position lot ID
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lot fills response
+     */
+    getPositionLotFills(lotId: string, filter?: import('../../types/api/broker').PositionLotFillsFilter): Promise<import('../../types/api/broker').PositionLotFill[]>;
 }
 export {};

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export type { ApiConfig, ApiResponse, Order, OptionsOrder, BrokerAccount, PortfolioSnapshot, PerformanceMetrics, UserToken, Holding, Portfolio, PortalResponse, SessionInitResponse, SessionResponse, OtpRequestResponse, OtpVerifyResponse, PortalUrlResponse, SessionValidationResponse, SessionAuthenticateResponse, RequestHeaders, SessionStatus, BrokerOrderParams, BrokerExtras, CryptoOrderOptions, OptionsOrderOptions, OrderResponse, TradingContext, DeviceInfo, BrokerOrder, BrokerPosition, BrokerBalance, BrokerDataOptions, BrokerInfo, TokenInfo, RefreshTokenRequest, RefreshTokenResponse, AccountsFilter, OrdersFilter, PositionsFilter, BalancesFilter, BrokerDataOrder, BrokerDataPosition, BrokerDataAccount, FilteredOrdersResponse, FilteredPositionsResponse, FilteredAccountsResponse, FilteredBalancesResponse, BrokerConnection, } from './types';
+export type { ApiConfig, ApiResponse, Order, OptionsOrder, BrokerAccount, PortfolioSnapshot, PerformanceMetrics, UserToken, Holding, Portfolio, PortalResponse, SessionInitResponse, SessionResponse, OtpRequestResponse, OtpVerifyResponse, PortalUrlResponse, SessionValidationResponse, SessionAuthenticateResponse, RequestHeaders, SessionStatus, BrokerOrderParams, BrokerExtras, CryptoOrderOptions, OptionsOrderOptions, OrderResponse, TradingContext, DeviceInfo, BrokerOrder, BrokerPosition, BrokerBalance, BrokerDataOptions, BrokerInfo, TokenInfo, RefreshTokenRequest, RefreshTokenResponse, AccountsFilter, OrdersFilter, PositionsFilter, BalancesFilter, BrokerDataOrder, BrokerDataPosition, BrokerDataAccount, FilteredOrdersResponse, FilteredPositionsResponse, FilteredAccountsResponse, FilteredBalancesResponse, BrokerConnection, OrderFill, OrderEvent, OrderLeg, OrderGroup, OrderGroupOrder, PositionLot, PositionLotFill, OrderFillsFilter, OrderEventsFilter, OrderGroupsFilter, PositionLotsFilter, PositionLotFillsFilter, } from './types';
 export type { FinaticConnectOptions, FinaticUserToken, PortalMessage } from './types/connect';
 export type { PortalProps, PortalTheme, PortalThemeConfig, PortalThemePreset, } from './types/portal';
 export type { TradeAccessDeniedError, OrderNotFoundError, ValidationError, } from './types/api/errors';

package/dist/types/types/api/broker.d.ts

@@ -303,3 +303,119 @@ export interface DisconnectCompanyResponse {
     message: string;
     status_code: number;
 }
+export interface OrderFill {
+    id: string;
+    order_id: string;
+    leg_id: string | null;
+    price: number;
+    quantity: number;
+    executed_at: string;
+    execution_id: string | null;
+    trade_id: string | null;
+    venue: string | null;
+    commission_fee: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface OrderEvent {
+    id: string;
+    order_id: string;
+    order_group_id: string | null;
+    event_type: string | null;
+    event_time: string;
+    event_id: string | null;
+    order_status: string | null;
+    inferred: boolean;
+    confidence: number | null;
+    reason_code: string | null;
+    recorded_at: string | null;
+}
+export interface OrderLeg {
+    id: string;
+    order_id: string;
+    leg_index: number;
+    asset_type: string;
+    broker_provided_symbol: string | null;
+    quantity: number;
+    filled_quantity: number | null;
+    avg_fill_price: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+export interface OrderGroupOrder extends BrokerDataOrder {
+    legs: OrderLeg[];
+}
+export interface OrderGroup {
+    id: string;
+    user_broker_connection_id: string | null;
+    created_at: string;
+    updated_at: string;
+    orders: OrderGroupOrder[];
+}
+export interface PositionLot {
+    id: string;
+    position_id: string | null;
+    user_broker_connection_id: string;
+    broker_provided_account_id: string;
+    instrument_key: string;
+    asset_type: string | null;
+    side: 'long' | 'short' | null;
+    open_quantity: number;
+    closed_quantity: number;
+    remaining_quantity: number;
+    open_price: number;
+    close_price_avg: number | null;
+    cost_basis: number;
+    cost_basis_w_commission: number;
+    realized_pl: number;
+    realized_pl_w_commission: number;
+    lot_opened_at: string;
+    lot_closed_at: string | null;
+    position_group_id: string | null;
+    created_at: string;
+    updated_at: string;
+    position_lot_fills?: PositionLotFill[];
+}
+export interface PositionLotFill {
+    id: string;
+    lot_id: string;
+    order_fill_id: string;
+    fill_price: number;
+    fill_quantity: number;
+    executed_at: string;
+    commission_share: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface OrderFillsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface OrderEventsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface OrderGroupsFilter {
+    broker_id?: string;
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+    created_after?: string;
+    created_before?: string;
+}
+export interface PositionLotsFilter {
+    broker_id?: string;
+    connection_id?: string;
+    account_id?: string;
+    symbol?: string;
+    position_id?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface PositionLotFillsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finatic/client",
-  "version": "0.0.140",
+  "version": "0.0.141",
   "description": "Finatic Client SDK for browser integration",
   "type": "module",
   "publishConfig": {

package/src/core/client/ApiClient.ts

@@ -16,6 +16,16 @@ import {
   PositionsFilter,
   AccountsFilter,
   BalancesFilter,
+  OrderFill,
+  OrderEvent,
+  OrderGroup,
+  PositionLot,
+  PositionLotFill,
+  OrderFillsFilter,
+  OrderEventsFilter,
+  OrderGroupsFilter,
+  PositionLotsFilter,
+  PositionLotFillsFilter,
 } from '../../types/api/broker';
 import { TradingContext } from '../../types/api/orders';
 import { ApiPaginationInfo, PaginatedResult } from '../../types/common/pagination';
@@ -1718,4 +1728,251 @@ export class ApiClient {
       },
     });
   }
+
+  /**
+   * Get order fills for a specific order
+   * @param orderId - The order ID
+   * @param filter - Optional filter parameters
+   * @returns Promise with order fills response
+   */
+  async getOrderFills(
+    orderId: string,
+    filter?: OrderFillsFilter
+  ): Promise<{
+    _id: string;
+    response_data: OrderFill[];
+    message: string;
+    status_code: number;
+    warnings: null;
+    errors: null;
+  }> {
+    const accessToken = await this.getValidAccessToken();
+    const params: Record<string, string> = {};
+
+    if (filter?.connection_id) {
+      params.connection_id = filter.connection_id;
+    }
+    if (filter?.limit) {
+      params.limit = filter.limit.toString();
+    }
+    if (filter?.offset) {
+      params.offset = filter.offset.toString();
+    }
+
+    return this.request<{
+      _id: string;
+      response_data: OrderFill[];
+      message: string;
+      status_code: number;
+      warnings: null;
+      errors: null;
+    }>(`/brokers/data/orders/${orderId}/fills`, {
+      method: 'GET',
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+      params,
+    });
+  }
+
+  /**
+   * Get order events for a specific order
+   * @param orderId - The order ID
+   * @param filter - Optional filter parameters
+   * @returns Promise with order events response
+   */
+  async getOrderEvents(
+    orderId: string,
+    filter?: OrderEventsFilter
+  ): Promise<{
+    _id: string;
+    response_data: OrderEvent[];
+    message: string;
+    status_code: number;
+    warnings: null;
+    errors: null;
+  }> {
+    const accessToken = await this.getValidAccessToken();
+    const params: Record<string, string> = {};
+
+    if (filter?.connection_id) {
+      params.connection_id = filter.connection_id;
+    }
+    if (filter?.limit) {
+      params.limit = filter.limit.toString();
+    }
+    if (filter?.offset) {
+      params.offset = filter.offset.toString();
+    }
+
+    return this.request<{
+      _id: string;
+      response_data: OrderEvent[];
+      message: string;
+      status_code: number;
+      warnings: null;
+      errors: null;
+    }>(`/brokers/data/orders/${orderId}/events`, {
+      method: 'GET',
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+      params,
+    });
+  }
+
+  /**
+   * Get order groups
+   * @param filter - Optional filter parameters
+   * @returns Promise with order groups response
+   */
+  async getOrderGroups(
+    filter?: OrderGroupsFilter
+  ): Promise<{
+    _id: string;
+    response_data: OrderGroup[];
+    message: string;
+    status_code: number;
+    warnings: null;
+    errors: null;
+  }> {
+    const accessToken = await this.getValidAccessToken();
+    const params: Record<string, string> = {};
+
+    if (filter?.broker_id) {
+      params.broker_id = filter.broker_id;
+    }
+    if (filter?.connection_id) {
+      params.connection_id = filter.connection_id;
+    }
+    if (filter?.limit) {
+      params.limit = filter.limit.toString();
+    }
+    if (filter?.offset) {
+      params.offset = filter.offset.toString();
+    }
+    if (filter?.created_after) {
+      params.created_after = filter.created_after;
+    }
+    if (filter?.created_before) {
+      params.created_before = filter.created_before;
+    }
+
+    return this.request<{
+      _id: string;
+      response_data: OrderGroup[];
+      message: string;
+      status_code: number;
+      warnings: null;
+      errors: null;
+    }>('/brokers/data/orders/groups', {
+      method: 'GET',
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+      params,
+    });
+  }
+
+  /**
+   * Get position lots (tax lots for positions)
+   * @param filter - Optional filter parameters
+   * @returns Promise with position lots response
+   */
+  async getPositionLots(
+    filter?: PositionLotsFilter
+  ): Promise<{
+    _id: string;
+    response_data: PositionLot[];
+    message: string;
+    status_code: number;
+    warnings: null;
+    errors: null;
+  }> {
+    const accessToken = await this.getValidAccessToken();
+    const params: Record<string, string> = {};
+
+    if (filter?.broker_id) {
+      params.broker_id = filter.broker_id;
+    }
+    if (filter?.connection_id) {
+      params.connection_id = filter.connection_id;
+    }
+    if (filter?.account_id) {
+      params.account_id = filter.account_id;
+    }
+    if (filter?.symbol) {
+      params.symbol = filter.symbol;
+    }
+    if (filter?.position_id) {
+      params.position_id = filter.position_id;
+    }
+    if (filter?.limit) {
+      params.limit = filter.limit.toString();
+    }
+    if (filter?.offset) {
+      params.offset = filter.offset.toString();
+    }
+
+    return this.request<{
+      _id: string;
+      response_data: PositionLot[];
+      message: string;
+      status_code: number;
+      warnings: null;
+      errors: null;
+    }>('/brokers/data/positions/lots', {
+      method: 'GET',
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+      params,
+    });
+  }
+
+  /**
+   * Get position lot fills for a specific lot
+   * @param lotId - The position lot ID
+   * @param filter - Optional filter parameters
+   * @returns Promise with position lot fills response
+   */
+  async getPositionLotFills(
+    lotId: string,
+    filter?: PositionLotFillsFilter
+  ): Promise<{
+    _id: string;
+    response_data: PositionLotFill[];
+    message: string;
+    status_code: number;
+    warnings: null;
+    errors: null;
+  }> {
+    const accessToken = await this.getValidAccessToken();
+    const params: Record<string, string> = {};
+
+    if (filter?.connection_id) {
+      params.connection_id = filter.connection_id;
+    }
+    if (filter?.limit) {
+      params.limit = filter.limit.toString();
+    }
+    if (filter?.offset) {
+      params.offset = filter.offset.toString();
+    }
+
+    return this.request<{
+      _id: string;
+      response_data: PositionLotFill[];
+      message: string;
+      status_code: number;
+      warnings: null;
+      errors: null;
+    }>(`/brokers/data/positions/lots/${lotId}/fills`, {
+      method: 'GET',
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+      },
+      params,
+    });
+  }
 }

package/src/core/client/FinaticConnect.ts

@@ -1471,6 +1471,87 @@ export class FinaticConnect extends EventEmitter {
     return this.apiClient.disconnectCompany(connectionId);
   }
 
+  /**
+   * Get order fills for a specific order
+   * @param orderId - The order ID
+   * @param filter - Optional filter parameters
+   * @returns Promise with order fills response
+   */
+  public async getOrderFills(
+    orderId: string,
+    filter?: import('../../types/api/broker').OrderFillsFilter
+  ): Promise<import('../../types/api/broker').OrderFill[]> {
+    if (!(await this.isAuthenticated())) {
+      throw new AuthenticationError('User is not authenticated');
+    }
+    const response = await this.apiClient.getOrderFills(orderId, filter);
+    return response.response_data;
+  }
+
+  /**
+   * Get order events for a specific order
+   * @param orderId - The order ID
+   * @param filter - Optional filter parameters
+   * @returns Promise with order events response
+   */
+  public async getOrderEvents(
+    orderId: string,
+    filter?: import('../../types/api/broker').OrderEventsFilter
+  ): Promise<import('../../types/api/broker').OrderEvent[]> {
+    if (!(await this.isAuthenticated())) {
+      throw new AuthenticationError('User is not authenticated');
+    }
+    const response = await this.apiClient.getOrderEvents(orderId, filter);
+    return response.response_data;
+  }
+
+  /**
+   * Get order groups
+   * @param filter - Optional filter parameters
+   * @returns Promise with order groups response
+   */
+  public async getOrderGroups(
+    filter?: import('../../types/api/broker').OrderGroupsFilter
+  ): Promise<import('../../types/api/broker').OrderGroup[]> {
+    if (!(await this.isAuthenticated())) {
+      throw new AuthenticationError('User is not authenticated');
+    }
+    const response = await this.apiClient.getOrderGroups(filter);
+    return response.response_data;
+  }
+
+  /**
+   * Get position lots (tax lots for positions)
+   * @param filter - Optional filter parameters
+   * @returns Promise with position lots response
+   */
+  public async getPositionLots(
+    filter?: import('../../types/api/broker').PositionLotsFilter
+  ): Promise<import('../../types/api/broker').PositionLot[]> {
+    if (!(await this.isAuthenticated())) {
+      throw new AuthenticationError('User is not authenticated');
+    }
+    const response = await this.apiClient.getPositionLots(filter);
+    return response.response_data;
+  }
+
+  /**
+   * Get position lot fills for a specific lot
+   * @param lotId - The position lot ID
+   * @param filter - Optional filter parameters
+   * @returns Promise with position lot fills response
+   */
+  public async getPositionLotFills(
+    lotId: string,
+    filter?: import('../../types/api/broker').PositionLotFillsFilter
+  ): Promise<import('../../types/api/broker').PositionLotFill[]> {
+    if (!(await this.isAuthenticated())) {
+      throw new AuthenticationError('User is not authenticated');
+    }
+    const response = await this.apiClient.getPositionLotFills(lotId, filter);
+    return response.response_data;
+  }
+
   // Duplicate getBalances method removed - using the paginated version above
 
 }

package/src/index.ts

@@ -48,6 +48,18 @@ export type {
   FilteredAccountsResponse,
   FilteredBalancesResponse,
   BrokerConnection,
+  OrderFill,
+  OrderEvent,
+  OrderLeg,
+  OrderGroup,
+  OrderGroupOrder,
+  PositionLot,
+  PositionLotFill,
+  OrderFillsFilter,
+  OrderEventsFilter,
+  OrderGroupsFilter,
+  PositionLotsFilter,
+  PositionLotFillsFilter,
 } from './types';
 
 export type { FinaticConnectOptions, FinaticUserToken, PortalMessage } from './types/connect';