@finatic/client 0.0.139 → 0.0.141

package/dist/index.d.ts

@@ -85,16 +85,6 @@ interface SessionInitResponse {
         expires_at: string;
     };
 }
-interface SessionResponseData {
-    session_id: string;
-    company_id: string;
-    status: 'pending';
-    expires_at: string;
-}
-interface SessionStartResponse {
-    data: SessionResponseData;
-    message: 'Session started successfully';
-}
 interface OtpRequestResponse {
     success: boolean;
     message: string;
@@ -113,17 +103,14 @@ interface OtpVerifyResponse {
     };
 }
 interface UserToken {
-    accessToken: string;
-    refreshToken: string;
-    expiresIn: number;
     user_id: string;
-    tokenType: string;
-    scope: string;
 }
 interface SessionValidationResponse {
     valid: boolean;
     company_id: string;
     status: string;
+    is_sandbox: boolean;
+    environment: string;
 }
 interface SessionAuthenticateResponse {
     success: boolean;
@@ -154,23 +141,18 @@ interface TokenInfo {
     expiresAt: string;
     userId?: string;
 }
+interface SessionResponseData {
+    session_id: string;
+    company_id: string;
+    status: string;
+    expires_at: string;
+    user_id?: string | null;
+    auto_login?: boolean;
+}
 interface SessionResponse {
-    data: {
-        session_id: string;
-        state: SessionState;
-        device_info?: Record<string, string>;
-        company_id?: string;
-        status?: string;
-        expires_at?: string;
-        user_id?: string | null;
-        auto_login?: boolean;
-        access_token?: string;
-        refresh_token?: string;
-        expires_in?: number;
-        token_type?: string;
-        scope?: string;
-    };
+    success: boolean;
     message: string;
+    data: SessionResponseData;
 }
 declare enum SessionState {
     PENDING = "PENDING",
@@ -297,7 +279,7 @@ interface BrokerOrderParams {
     broker: 'robinhood' | 'tasty_trade' | 'ninja_trader';
     order_id?: string;
     orderType: 'Market' | 'Limit' | 'Stop' | 'StopLimit';
-    assetType: 'Stock' | 'Option' | 'Crypto' | 'Future';
+    assetType: 'equity' | 'equity_option' | 'crypto' | 'forex' | 'future' | 'future_option';
     action: 'Buy' | 'Sell';
     timeInForce: 'day' | 'gtc' | 'gtd' | 'ioc' | 'fok';
     accountNumber: string | number;
@@ -306,7 +288,7 @@ interface BrokerOrderParams {
     price?: number;
     stopPrice?: number;
 }
-interface BrokerExtras {
+interface BrokerExtras$1 {
     robinhood?: {
         extendedHours?: boolean;
         marketHours?: 'regular_hours' | 'extended_hours';
@@ -491,6 +473,122 @@ interface DisconnectCompanyResponse {
     message: string;
     status_code: number;
 }
+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;
+}
+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;
+}
+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;
+}
+interface OrderGroupOrder extends BrokerDataOrder {
+    legs: OrderLeg[];
+}
+interface OrderGroup {
+    id: string;
+    user_broker_connection_id: string | null;
+    created_at: string;
+    updated_at: string;
+    orders: OrderGroupOrder[];
+}
+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[];
+}
+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;
+}
+interface OrderFillsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}
+interface OrderEventsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}
+interface OrderGroupsFilter {
+    broker_id?: string;
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+    created_after?: string;
+    created_before?: string;
+}
+interface PositionLotsFilter {
+    broker_id?: string;
+    connection_id?: string;
+    account_id?: string;
+    symbol?: string;
+    position_id?: string;
+    limit?: number;
+    offset?: number;
+}
+interface PositionLotFillsFilter {
+    connection_id?: string;
+    limit?: number;
+    offset?: number;
+}
 
 /**
  * Order-related types
@@ -1027,9 +1125,6 @@ declare class ApiClient {
     protected currentSessionState: SessionState | null;
     protected currentSessionId: string | null;
     private tradingContext;
-    private tokenInfo;
-    private refreshPromise;
-    private readonly REFRESH_BUFFER_MINUTES;
     private companyId;
     private csrfToken;
     constructor(baseUrl: string, deviceInfo?: DeviceInfo$1);
@@ -1050,33 +1145,24 @@ declare class ApiClient {
      */
     getCurrentCsrfToken(): string | null;
     /**
-     * Store tokens after successful authentication
-     */
-    setTokens(accessToken: string, refreshToken: string, expiresAt: string, userId?: string): void;
-    /**
-     * Get the current access token, refreshing if necessary
+     * Get a valid access token (session-based auth - no tokens needed)
      */
     getValidAccessToken(): Promise<string>;
     /**
-     * Check if the current token is expired or about to expire
+     * Perform the actual Supabase session refresh
      */
-    private isTokenExpired;
     /**
-     * Refresh the access token using the refresh token
-     */
-    private refreshTokens;
-    /**
-     * Perform the actual token refresh request
-     */
-    private performTokenRefresh;
-    /**
-     * Clear stored tokens (useful for logout)
+     * Clear session tokens (useful for logout)
      */
     clearTokens(): void;
     /**
-     * Get current token info (for debugging/testing)
+     * Get current session info (for debugging/testing) - session-based auth
      */
-    getTokenInfo(): TokenInfo | null;
+    getTokenInfo(): {
+        accessToken: string;
+        refreshToken: string;
+        expiresAt: number;
+    } | null;
     /**
      * Make a request to the API.
      */
@@ -1110,23 +1196,21 @@ declare class ApiClient {
         orderQty: number;
         action: 'Buy' | 'Sell';
         orderType: 'Market' | 'Limit' | 'Stop' | 'StopLimit';
-        assetType: 'Stock' | 'Option' | 'Crypto' | 'Future';
-    }, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
+        assetType: 'equity' | 'equity_option' | 'crypto' | 'forex' | 'future' | 'future_option';
+    }, extras?: BrokerExtras$1, connection_id?: string): Promise<OrderResponse>;
     cancelBrokerOrder(orderId: string, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', extras?: any, connection_id?: string): Promise<OrderResponse>;
     modifyBrokerOrder(orderId: string, params: Partial<BrokerOrderParams>, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', extras?: any, connection_id?: string): Promise<OrderResponse>;
     setBroker(broker: 'robinhood' | 'tasty_trade' | 'ninja_trader'): void;
     setAccount(accountNumber: string, accountId?: string): void;
-    getTradingContext(): TradingContext;
-    clearTradingContext(): void;
-    placeStockMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    placeStockLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    placeStockStopOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', stopPrice: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    placeCryptoMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeCryptoLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeOptionsMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options: OptionsOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeOptionsLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, options: OptionsOrderOptions, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeFuturesMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeFuturesLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
+    placeStockMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1, connection_id?: string): Promise<OrderResponse>;
+    placeStockLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1, connection_id?: string): Promise<OrderResponse>;
+    placeStockStopOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', stopPrice: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1, connection_id?: string): Promise<OrderResponse>;
+    placeCryptoMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1): Promise<OrderResponse>;
+    placeCryptoLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1): Promise<OrderResponse>;
+    placeOptionsMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options: OptionsOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1): Promise<OrderResponse>;
+    placeOptionsLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, options: OptionsOrderOptions, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1): Promise<OrderResponse>;
+    placeFuturesMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1): Promise<OrderResponse>;
+    placeFuturesLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras$1): Promise<OrderResponse>;
     private buildOrderRequestBody;
     private buildModifyRequestBody;
     private applyBrokerDefaults;
@@ -1137,6 +1221,7 @@ declare class ApiClient {
     getCurrentSessionState(): SessionState | null;
     /**
      * Refresh the current session to extend its lifetime
+     * Note: This now uses Supabase session refresh instead of custom endpoint
      */
     refreshSession(): Promise<{
         success: boolean;
@@ -1223,6 +1308,74 @@ 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;
+    }>;
 }
 
 type EventCallback = (...args: any[]) => void;
@@ -1262,47 +1415,41 @@ declare class FinaticConnect extends EventEmitter {
     private readonly SESSION_REFRESH_BUFFER_HOURS;
     private sessionStartTime;
     constructor(options: FinaticConnectOptions, deviceInfo?: DeviceInfo);
-    private handleTokens;
+    private linkUserToSession;
     /**
-     * Check if the user is fully authenticated (has userId, access token, and refresh token)
-     * @returns True if the user is fully authenticated and ready for API calls
+     * Store user ID for authentication state persistence
+     * @param userId - The user ID to store
      */
-    isAuthed(): boolean;
+    private storeUserId;
     /**
-     * Check if the client is authenticated (alias for isAuthed for consistency)
-     * @returns True if authenticated, false otherwise
+     * Check if the user is fully authenticated (has userId in session context)
+     * @returns True if the user is fully authenticated and ready for API calls
      */
-    is_authenticated(): boolean;
+    isAuthenticated(): Promise<boolean>;
     /**
      * Get user's orders with pagination and optional filtering
      * @param params - Query parameters including page, perPage, and filters
      * @returns Promise with paginated result that supports navigation
      */
-    getOrders(params?: {
-        page?: number;
-        perPage?: number;
-        filter?: OrdersFilter;
-    }): Promise<PaginatedResult<BrokerDataOrder[]>>;
+    getOrders(page?: number, perPage?: number, options?: BrokerDataOptions, filters?: OrdersFilter): Promise<PaginatedResult<BrokerDataOrder[]>>;
     /**
      * Get user's positions with pagination and optional filtering
      * @param params - Query parameters including page, perPage, and filters
      * @returns Promise with paginated result that supports navigation
      */
-    getPositions(params?: {
-        page?: number;
-        perPage?: number;
-        filter?: PositionsFilter;
-    }): Promise<PaginatedResult<BrokerDataPosition[]>>;
+    getPositions(page?: number, perPage?: number, options?: BrokerDataOptions, filters?: PositionsFilter): Promise<PaginatedResult<BrokerDataPosition[]>>;
     /**
      * Get user's accounts with pagination and optional filtering
      * @param params - Query parameters including page, perPage, and filters
      * @returns Promise with paginated result that supports navigation
      */
-    getAccounts(params?: {
-        page?: number;
-        perPage?: number;
-        filter?: AccountsFilter;
-    }): Promise<PaginatedResult<BrokerDataAccount[]>>;
+    getAccounts(page?: number, perPage?: number, options?: BrokerDataOptions, filters?: AccountsFilter): Promise<PaginatedResult<BrokerDataAccount[]>>;
+    /**
+     * Get user's balances with pagination and optional filtering
+     * @param params - Query parameters including page, perPage, and filters
+     * @returns Promise with paginated result that supports navigation
+     */
+    getBalances(page?: number, perPage?: number, options?: BrokerDataOptions, filters?: BalancesFilter): Promise<PaginatedResult<BrokerBalance[]>>;
     /**
      * Initialize the Finatic Connect SDK
      * @param token - The portal token from your backend
@@ -1322,7 +1469,6 @@ declare class FinaticConnect extends EventEmitter {
      * Get the user and tokens for a completed session
      * @returns Promise with user information and tokens
      */
-    getSessionUser(): Promise<Record<string, any>>;
     private initializeWithUser;
     /**
      * Handle company access error by opening the portal
@@ -1348,20 +1494,7 @@ declare class FinaticConnect extends EventEmitter {
      * Place a new order using the broker order API
      * @param order - Order details with broker context
      */
-    placeOrder(order: {
-        symbol: string;
-        quantity: number;
-        side: 'buy' | 'sell';
-        orderType: 'market' | 'limit' | 'stop' | 'stop_limit';
-        price?: number;
-        stopPrice?: number;
-        timeInForce: 'day' | 'gtc' | 'gtd' | 'ioc' | 'fok';
-        broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader';
-        accountNumber?: string;
-        assetType?: 'Stock' | 'Option' | 'Crypto' | 'Future';
-        order_id?: string;
-        connection_id?: string;
-    }): Promise<OrderResponse>;
+    placeOrder(order: BrokerOrderParams, extras?: BrokerExtras): Promise<OrderResponse>;
     /**
      * Cancel a broker order
      * @param orderId - The order ID to cancel
@@ -1386,25 +1519,6 @@ declare class FinaticConnect extends EventEmitter {
         side?: 'Buy' | 'Sell';
         order_id?: string;
     }>, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', connection_id?: string): Promise<OrderResponse>;
-    /**
-     * Set the broker context for trading
-     * @param broker - The broker to use for trading
-     */
-    setTradingContextBroker(broker: 'robinhood' | 'tasty_trade' | 'ninja_trader' | 'interactive_brokers' | 'tradestation'): void;
-    /**
-     * Set the account context for trading
-     * @param accountNumber - The account number to use for trading
-     * @param accountId - Optional account ID
-     */
-    setTradingContextAccount(accountNumber: string, accountId?: string): void;
-    /**
-     * Get the current trading context
-     */
-    getTradingContext(): TradingContext;
-    /**
-     * Clear the trading context
-     */
-    clearTradingContext(): void;
     /**
      * Place a stock market order (convenience method)
      */
@@ -1446,7 +1560,7 @@ declare class FinaticConnect extends EventEmitter {
      * @returns The current user ID or undefined if not authenticated
      * @throws AuthenticationError if user is not authenticated
      */
-    getUserId(): string | null;
+    getUserId(): Promise<string | null>;
     /**
      * Get list of supported brokers
      * @returns Promise with array of broker information
@@ -1502,50 +1616,6 @@ declare class FinaticConnect extends EventEmitter {
      * @returns Promise with array of positions for the broker
      */
     getPositionsByBroker(brokerId: string): Promise<BrokerDataPosition[]>;
-    /**
-     * Get a specific page of orders with pagination metadata
-     * @param page - Page number (default: 1)
-     * @param perPage - Items per page (default: 100)
-     * @param filter - Optional filter parameters
-     * @returns Promise with paginated orders result
-     */
-    getOrdersPage(page?: number, perPage?: number, filter?: OrdersFilter): Promise<PaginatedResult<BrokerDataOrder[]>>;
-    /**
-     * Get a specific page of positions with pagination metadata
-     * @param page - Page number (default: 1)
-     * @param perPage - Items per page (default: 100)
-     * @param filter - Optional filter parameters
-     * @returns Promise with paginated positions result
-     */
-    getPositionsPage(page?: number, perPage?: number, filter?: PositionsFilter): Promise<PaginatedResult<BrokerDataPosition[]>>;
-    /**
-     * Get a specific page of accounts with pagination metadata
-     * @param page - Page number (default: 1)
-     * @param perPage - Items per page (default: 100)
-     * @param filter - Optional filter parameters
-     * @returns Promise with paginated accounts result
-     */
-    getAccountsPage(page?: number, perPage?: number, filter?: AccountsFilter): Promise<PaginatedResult<BrokerDataAccount[]>>;
-    getBalancesPage(page?: number, perPage?: number, filter?: BalancesFilter): Promise<PaginatedResult<BrokerBalance[]>>;
-    /**
-     * Get the next page of orders
-     * @param previousResult - The previous paginated result
-     * @returns Promise with next page of orders or null if no more pages
-     */
-    getNextOrdersPage(previousResult: PaginatedResult<BrokerDataOrder[]>): Promise<PaginatedResult<BrokerDataOrder[]> | null>;
-    /**
-     * Get the next page of positions
-     * @param previousResult - The previous paginated result
-     * @returns Promise with next page of positions or null if no more pages
-     */
-    getNextPositionsPage(previousResult: PaginatedResult<BrokerDataPosition[]>): Promise<PaginatedResult<BrokerDataPosition[]> | null>;
-    /**
-     * Get the next page of accounts
-     * @param previousResult - The previous paginated result
-     * @returns Promise with next page of accounts or null if no more pages
-     */
-    getNextAccountsPage(previousResult: PaginatedResult<BrokerDataAccount[]>): Promise<PaginatedResult<BrokerDataAccount[]> | null>;
-    getNextBalancesPage(previousResult: PaginatedResult<BrokerBalance[]>): Promise<PaginatedResult<BrokerBalance[]> | null>;
     /**
      * Get all orders across all pages (convenience method)
      * @param filter - Optional filter parameters
@@ -1610,6 +1680,39 @@ 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?: OrderFillsFilter): Promise<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?: OrderEventsFilter): Promise<OrderEvent[]>;
+    /**
+     * Get order groups
+     * @param filter - Optional filter parameters
+     * @returns Promise with order groups response
+     */
+    getOrderGroups(filter?: OrderGroupsFilter): Promise<OrderGroup[]>;
+    /**
+     * Get position lots (tax lots for positions)
+     * @param filter - Optional filter parameters
+     * @returns Promise with position lots response
+     */
+    getPositionLots(filter?: PositionLotsFilter): Promise<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?: PositionLotFillsFilter): Promise<PositionLotFill[]>;
 }
 
 /**
@@ -1648,351 +1751,5 @@ declare function createCustomThemeFromPreset(preset: string, modifications: Part
 
 declare const portalThemePresets: Record<string, PortalThemeConfig>;
 
-/**
- * Configuration for mock behavior
- */
-interface MockConfig {
-    delay?: number;
-    scenario?: MockScenario;
-    customData?: Record<string, any>;
-    mockApiOnly?: boolean;
-}
-/**
- * Different mock scenarios for testing
- */
-type MockScenario = 'success' | 'error' | 'network_error' | 'rate_limit' | 'auth_failure';
-/**
- * Mock data provider for Finatic API endpoints
- */
-declare class MockDataProvider {
-    private config;
-    private sessionData;
-    private userTokens;
-    constructor(config?: MockConfig);
-    /**
-     * Get a random delay between min and max milliseconds
-     */
-    private getRandomDelay;
-    /**
-     * Simulate network delay
-     */
-    simulateDelay(): Promise<void>;
-    /**
-     * Generate a realistic session ID
-     */
-    private generateSessionId;
-    /**
-     * Generate a realistic user ID
-     */
-    private generateUserId;
-    /**
-     * Generate a realistic company ID
-     */
-    private generateCompanyId;
-    /**
-     * Generate mock tokens
-     */
-    private generateTokens;
-    mockStartSession(token: string, userId?: string): Promise<SessionResponse>;
-    mockRequestOtp(sessionId: string, email: string): Promise<OtpRequestResponse>;
-    mockVerifyOtp(sessionId: string, otp: string): Promise<OtpVerifyResponse>;
-    mockAuthenticateDirectly(sessionId: string, userId: string): Promise<SessionAuthenticateResponse>;
-    mockGetPortalUrl(sessionId: string): Promise<PortalUrlResponse>;
-    mockValidatePortalSession(sessionId: string, signature: string): Promise<SessionValidationResponse>;
-    mockCompletePortalSession(sessionId: string): Promise<PortalUrlResponse>;
-    mockRefreshToken(refreshToken: string): Promise<RefreshTokenResponse>;
-    mockGetBrokerList(): Promise<{
-        _id: string;
-        response_data: BrokerInfo[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    mockGetBrokerAccounts(): Promise<{
-        _id: string;
-        response_data: BrokerAccount[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    mockGetBrokerConnections(): Promise<{
-        _id: string;
-        response_data: BrokerConnection[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    mockGetOrders(filter?: OrdersFilter): Promise<{
-        data: Order[];
-    }>;
-    mockGetBrokerOrders(filter?: OrdersFilter): Promise<{
-        data: BrokerDataOrder[];
-    }>;
-    mockGetBrokerPositions(filter?: PositionsFilter): Promise<{
-        data: BrokerDataPosition[];
-    }>;
-    mockGetBrokerBalances(filter?: BalancesFilter): Promise<{
-        data: BrokerBalance[];
-    }>;
-    mockGetBrokerDataAccounts(filter?: AccountsFilter): Promise<{
-        data: BrokerAccount[];
-    }>;
-    mockPlaceOrder(order: BrokerOrderParams): Promise<OrderResponse>;
-    /**
-     * Get stored session data
-     */
-    getSessionData(sessionId: string): any;
-    /**
-     * Get stored user token
-     */
-    getUserToken(sessionId: string): UserToken | undefined;
-    /**
-     * Clear all stored data
-     */
-    clearData(): void;
-    /**
-     * Update configuration
-     */
-    updateConfig(config: Partial<MockConfig>): void;
-    setScenario(scenario: MockScenario): void;
-    getScenario(): MockScenario;
-    private applyOrderFilters;
-    private applyBrokerOrderFilters;
-    private applyBrokerPositionFilters;
-    private applyBrokerAccountFilters;
-    private applyBrokerBalanceFilters;
-    /**
-     * Generate mock orders with diverse data
-     */
-    private generateMockOrders;
-    /**
-     * Generate mock positions with diverse data
-     */
-    private generateMockPositions;
-    /**
-     * Generate mock accounts with diverse data
-     */
-    private generateMockAccounts;
-    /**
-     * Mock disconnect company method
-     * @param connectionId - The connection ID to disconnect
-     * @returns Promise with mock disconnect response
-     */
-    mockDisconnectCompany(connectionId: string): Promise<DisconnectCompanyResponse>;
-}
-
-/**
- * Mock API Client that implements the same interface as the real ApiClient
- * but returns mock data instead of making HTTP requests
- */
-declare class MockApiClient {
-    private readonly baseUrl;
-    protected readonly deviceInfo?: DeviceInfo$1;
-    protected currentSessionState: SessionState | null;
-    protected currentSessionId: string | null;
-    private tradingContext;
-    private tokenInfo;
-    private refreshPromise;
-    private readonly REFRESH_BUFFER_MINUTES;
-    private companyId;
-    private csrfToken;
-    private mockDataProvider;
-    private readonly mockApiOnly;
-    constructor(baseUrl: string, deviceInfo?: DeviceInfo$1, mockConfig?: MockConfig);
-    /**
-     * Store tokens after successful authentication
-     */
-    setTokens(accessToken: string, refreshToken: string, expiresAt: string, userId?: string): void;
-    /**
-     * Get the current access token, refreshing if necessary
-     */
-    getValidAccessToken(): Promise<string>;
-    /**
-     * Check if the current token is expired or about to expire
-     */
-    private isTokenExpired;
-    /**
-     * Refresh the access token using the refresh token
-     */
-    private refreshTokens;
-    /**
-     * Perform the actual token refresh request
-     */
-    private performTokenRefresh;
-    /**
-     * Clear stored tokens (useful for logout)
-     */
-    clearTokens(): void;
-    /**
-     * Get current token info (for debugging/testing)
-     */
-    getTokenInfo(): TokenInfo | null;
-    /**
-     * Set session context (session ID, company ID, CSRF token)
-     */
-    setSessionContext(sessionId: string, companyId: string, csrfToken?: string): void;
-    /**
-     * Get the current session ID
-     */
-    getCurrentSessionId(): string | null;
-    /**
-     * Get the current company ID
-     */
-    getCurrentCompanyId(): string | null;
-    /**
-     * Get the current CSRF token
-     */
-    getCurrentCsrfToken(): string | null;
-    startSession(token: string, userId?: string): Promise<SessionResponse>;
-    requestOtp(sessionId: string, email: string): Promise<OtpRequestResponse>;
-    verifyOtp(sessionId: string, otp: string): Promise<OtpVerifyResponse>;
-    authenticateDirectly(sessionId: string, userId: string): Promise<SessionAuthenticateResponse>;
-    getPortalUrl(sessionId: string): Promise<PortalUrlResponse>;
-    validatePortalSession(sessionId: string, signature: string): Promise<SessionValidationResponse>;
-    completePortalSession(sessionId: string): Promise<PortalUrlResponse>;
-    getOrders(filter?: OrdersFilter): Promise<{
-        data: Order[];
-    }>;
-    placeOrder(order: BrokerOrderParams): Promise<void>;
-    placeBrokerOrder(params: Partial<BrokerOrderParams> & {
-        symbol: string;
-        orderQty: number;
-        action: 'Buy' | 'Sell';
-        orderType: 'Market' | 'Limit' | 'Stop' | 'StopLimit';
-        assetType: 'Stock' | 'Option' | 'Crypto' | 'Future';
-    }, extras?: BrokerExtras, connection_id?: string): Promise<OrderResponse>;
-    cancelBrokerOrder(orderId: string, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', extras?: any, connection_id?: string): Promise<OrderResponse>;
-    modifyBrokerOrder(orderId: string, params: Partial<BrokerOrderParams>, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', extras?: any, connection_id?: string): Promise<OrderResponse>;
-    setBroker(broker: 'robinhood' | 'tasty_trade' | 'ninja_trader'): void;
-    setAccount(accountNumber: string, accountId?: string): void;
-    getTradingContext(): TradingContext;
-    clearTradingContext(): void;
-    placeStockMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeStockLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeStockStopOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', stopPrice: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeCryptoMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeCryptoLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', options?: CryptoOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeOptionsMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', options: OptionsOrderOptions, broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeOptionsLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, options: OptionsOrderOptions, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeFuturesMarketOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    placeFuturesLimitOrder(symbol: string, orderQty: number, action: 'Buy' | 'Sell', price: number, timeInForce?: 'day' | 'gtc', broker?: 'robinhood' | 'tasty_trade' | 'ninja_trader', accountNumber?: string, extras?: BrokerExtras): Promise<OrderResponse>;
-    getUserToken(sessionId: string): Promise<UserToken>;
-    getCurrentSessionState(): SessionState | null;
-    getBrokerList(): Promise<{
-        _id: string;
-        response_data: BrokerInfo[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    getBrokerAccounts(options?: BrokerDataOptions): Promise<{
-        _id: string;
-        response_data: BrokerAccount[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    getBrokerOrders(options?: BrokerDataOptions): Promise<{
-        _id: string;
-        response_data: BrokerOrder[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    getBrokerPositions(options?: BrokerDataOptions): Promise<{
-        _id: string;
-        response_data: BrokerPosition[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    getBrokerOrdersWithFilter(filter?: OrdersFilter): Promise<{
-        data: BrokerDataOrder[];
-    }>;
-    getBrokerPositionsWithFilter(filter?: PositionsFilter): Promise<{
-        data: BrokerDataPosition[];
-    }>;
-    getBrokerBalancesWithFilter(filter?: BalancesFilter): Promise<{
-        data: BrokerBalance[];
-    }>;
-    getBrokerDataAccountsWithFilter(filter?: AccountsFilter): Promise<{
-        data: BrokerAccount[];
-    }>;
-    getBrokerOrdersPage(page?: number, perPage?: number, filters?: OrdersFilter): Promise<PaginatedResult<BrokerDataOrder[]>>;
-    getBrokerAccountsPage(page?: number, perPage?: number, filters?: AccountsFilter): Promise<PaginatedResult<BrokerAccount[]>>;
-    getBrokerPositionsPage(page?: number, perPage?: number, filters?: PositionsFilter): Promise<PaginatedResult<BrokerDataPosition[]>>;
-    getBrokerBalancesPage(page?: number, perPage?: number, filters?: BalancesFilter): Promise<PaginatedResult<BrokerBalance[]>>;
-    getBrokerConnections(): Promise<{
-        _id: string;
-        response_data: BrokerConnection[];
-        message: string;
-        status_code: number;
-        warnings: null;
-        errors: null;
-    }>;
-    /**
-     * Mock disconnect company method
-     * @param connectionId - The connection ID to disconnect
-     * @returns Promise with mock disconnect response
-     */
-    disconnectCompany(connectionId: string): Promise<DisconnectCompanyResponse>;
-    getMockDataProvider(): MockDataProvider;
-    clearMockData(): void;
-    /**
-     * Check if this is a mock client
-     * @returns true if this is a mock client
-     */
-    isMockClient(): boolean;
-}
-
-/**
- * Factory class for creating API clients (real or mock)
- */
-declare class MockFactory {
-    /**
-     * Create an API client based on environment configuration
-     * @param baseUrl - The base URL for the API
-     * @param deviceInfo - Optional device information
-     * @param mockConfig - Optional mock configuration (only used if mocks are enabled)
-     * @returns ApiClient or MockApiClient instance
-     */
-    static createApiClient(baseUrl: string, deviceInfo?: DeviceInfo$1, mockConfig?: MockConfig): ApiClient | MockApiClient;
-    /**
-     * Force create a mock API client regardless of environment settings
-     * @param baseUrl - The base URL for the API
-     * @param deviceInfo - Optional device information
-     * @param mockConfig - Optional mock configuration
-     * @returns MockApiClient instance
-     */
-    static createMockApiClient(baseUrl: string, deviceInfo?: DeviceInfo$1, mockConfig?: MockConfig): MockApiClient;
-    /**
-     * Force create a real API client regardless of environment settings
-     * @param baseUrl - The base URL for the API
-     * @param deviceInfo - Optional device information
-     * @returns ApiClient instance
-     */
-    static createRealApiClient(baseUrl: string, deviceInfo?: DeviceInfo$1): ApiClient;
-    /**
-     * Check if mocks are currently enabled
-     * @returns boolean indicating if mocks are enabled
-     */
-    static isMockMode(): boolean;
-    /**
-     * Get current mock configuration
-     * @returns Mock configuration object
-     */
-    static getMockConfig(): {
-        enabled: boolean;
-        delay?: number;
-    };
-}
-
-export { ApiClient, ApiError, AuthenticationError, AuthorizationError, BaseError, CompanyAccessError, EventEmitter, FinaticConnect, MockFactory, NetworkError, OrderError, OrderValidationError, PaginatedResult, RateLimitError, SecurityError, SessionError, TokenError, TradingNotEnabledError, appendThemeToURL, createCustomThemeFromPreset, generatePortalThemeURL, getThemePreset, portalThemePresets, validateCustomTheme };
-export type { AccountsFilter, ApiConfig, ApiResponse, BalancesFilter, BrokerAccount, BrokerBalance, BrokerConnection, BrokerDataAccount, BrokerDataOptions, BrokerDataOrder, BrokerDataPosition, BrokerExtras, BrokerInfo, BrokerOrder, BrokerOrderParams, BrokerPosition, CryptoOrderOptions, DeviceInfo$1 as DeviceInfo, FilteredAccountsResponse, FilteredBalancesResponse, FilteredOrdersResponse, FilteredPositionsResponse, FinaticConnectOptions, FinaticUserToken, Holding, OptionsOrder, OptionsOrderOptions, Order, OrderNotFoundError, OrderResponse, OrdersFilter, OtpRequestResponse, OtpVerifyResponse, PerformanceMetrics, PortalMessage, PortalProps, PortalResponse, PortalTheme, PortalThemeConfig, PortalThemePreset, PortalUrlResponse, Portfolio, PortfolioSnapshot, PositionsFilter, RefreshTokenRequest, RefreshTokenResponse, RequestHeaders, SessionAuthenticateResponse, SessionInitResponse, SessionResponse, SessionStartResponse, SessionStatus, SessionValidationResponse, TokenInfo, TradeAccessDeniedError, TradingContext, UserToken, ValidationError };
+export { ApiClient, ApiError, AuthenticationError, AuthorizationError, BaseError, CompanyAccessError, EventEmitter, FinaticConnect, NetworkError, OrderError, OrderValidationError, PaginatedResult, RateLimitError, SecurityError, SessionError, TokenError, TradingNotEnabledError, appendThemeToURL, createCustomThemeFromPreset, generatePortalThemeURL, getThemePreset, portalThemePresets, validateCustomTheme };
+export type { AccountsFilter, ApiConfig, ApiResponse, BalancesFilter, BrokerAccount, BrokerBalance, BrokerConnection, BrokerDataAccount, BrokerDataOptions, BrokerDataOrder, BrokerDataPosition, BrokerExtras$1 as BrokerExtras, BrokerInfo, BrokerOrder, BrokerOrderParams, BrokerPosition, CryptoOrderOptions, DeviceInfo$1 as DeviceInfo, FilteredAccountsResponse, FilteredBalancesResponse, FilteredOrdersResponse, FilteredPositionsResponse, FinaticConnectOptions, FinaticUserToken, Holding, OptionsOrder, OptionsOrderOptions, Order, OrderEvent, OrderEventsFilter, OrderFill, OrderFillsFilter, OrderGroup, OrderGroupOrder, OrderGroupsFilter, OrderLeg, OrderNotFoundError, OrderResponse, OrdersFilter, OtpRequestResponse, OtpVerifyResponse, PerformanceMetrics, PortalMessage, PortalProps, PortalResponse, PortalTheme, PortalThemeConfig, PortalThemePreset, PortalUrlResponse, Portfolio, PortfolioSnapshot, PositionLot, PositionLotFill, PositionLotFillsFilter, PositionLotsFilter, PositionsFilter, RefreshTokenRequest, RefreshTokenResponse, RequestHeaders, SessionAuthenticateResponse, SessionInitResponse, SessionResponse, SessionStatus, SessionValidationResponse, TokenInfo, TradeAccessDeniedError, TradingContext, UserToken, ValidationError };