@limitless-exchange/sdk 0.0.3 → 1.0.1

package/dist/index.d.ts

@@ -1,34 +1,11 @@
+import { AxiosRequestConfig } from 'axios';
 import { ethers } from 'ethers';
-import { AxiosRequestConfig, AxiosResponse } from 'axios';
 
-/**
- * Client type for authentication.
- * @public
- */
-type ClientType = 'eoa' | 'base' | 'etherspot';
 /**
  * Trading mode for user interface.
  * @public
  */
 type TradingMode = 'SIMPLE' | 'ADVANCED';
-/**
- * Authentication headers required for login.
- * @public
- */
-interface SignatureHeaders {
-    /**
-     * The Ethereum address of the user
-     */
-    'x-account': string;
-    /**
-     * The signing message in hex format
-     */
-    'x-signing-message': string;
-    /**
-     * The signature generated by signing the message with the user's wallet
-     */
-    'x-signature': string;
-}
 /**
  * User rank information.
  * @public
@@ -74,7 +51,7 @@ interface ReferralData {
     displayName: string;
 }
 /**
- * User profile information returned after authentication (1:1 with API response).
+ * User profile information (1:1 with API response).
  * @public
  */
 interface UserProfile {
@@ -83,13 +60,9 @@ interface UserProfile {
      */
     id: number;
     /**
-     * User's Ethereum address (EOA)
+     * User's Ethereum address
      */
     account: string;
-    /**
-     * Client type used for authentication
-     */
-    client: ClientType;
     /**
      * User rank information containing feeRateBps
      */
@@ -118,10 +91,6 @@ interface UserProfile {
      * Social media URL
      */
     socialUrl?: string;
-    /**
-     * Smart wallet address (optional, required for ETHERSPOT client)
-     */
-    smartWallet?: string;
     /**
      * Trade wallet option
      */
@@ -182,7 +151,6 @@ interface ModeInfo {
  *
  * @remarks
  * Contains user-specific information needed for creating orders.
- * Typically extracted from authentication result.
  *
  * @public
  */
@@ -197,35 +165,6 @@ interface UserData {
      */
     feeRateBps: number;
 }
-/**
- * Complete authentication result including session and profile.
- * @public
- */
-interface AuthResult {
-    /**
-     * Session cookie value (JWT token)
-     */
-    sessionCookie: string;
-    /**
-     * User profile information
-     */
-    profile: UserProfile;
-}
-/**
- * Options for login authentication.
- * @public
- */
-interface LoginOptions {
-    /**
-     * Client type to use for authentication
-     * @defaultValue 'eoa'
-     */
-    client?: ClientType;
-    /**
-     * Smart wallet address (required when client is 'etherspot')
-     */
-    smartWallet?: string;
-}
 
 /**
  * Logger interface for SDK integration.
@@ -677,875 +616,909 @@ interface OrderSigningConfig {
 }
 
 /**
- * Market-related types for Limitless Exchange.
- * @module types/markets
+ * Portfolio and position types for Limitless Exchange.
+ * @module types/portfolio
  */
 /**
- * Collateral token information.
+ * Market information for a position.
+ *
  * @public
  */
-interface CollateralToken {
-    /**
-     * Token contract address
-     */
-    address: string;
-    /**
-     * Token decimals
-     */
-    decimals: number;
+interface PositionMarket {
     /**
-     * Token symbol (e.g., "USDC")
+     * Market ID
      */
-    symbol: string;
-}
-/**
- * Market creator information.
- * @public
- */
-interface MarketCreator {
+    id: number | string;
     /**
-     * Creator name
+     * Market slug
      */
-    name: string;
+    slug: string;
     /**
-     * Creator image URL
+     * Market title
      */
-    imageURI?: string;
+    title: string;
     /**
-     * Creator link URL
+     * Market status
      */
-    link?: string;
-}
-/**
- * Market metadata.
- * @public
- */
-interface MarketMetadata {
+    status?: string;
     /**
-     * Fee enabled flag
+     * Whether market is closed
      */
-    fee: boolean;
+    closed: boolean;
     /**
-     * Banner flag
+     * Market deadline
      */
-    isBannered?: boolean;
+    deadline: string;
     /**
-     * Polymarket arbitrage flag
+     * Condition ID
      */
-    isPolyArbitrage?: boolean;
+    conditionId?: string;
     /**
-     * Market making flag
+     * Winning outcome index (null if unresolved)
      */
-    shouldMarketMake?: boolean;
+    winningOutcomeIndex?: number | null;
     /**
-     * Opening price for oracle markets
+     * Market group information
      */
-    openPrice?: string;
+    group?: {
+        slug?: string;
+        title?: string;
+    };
 }
 /**
- * Market settings for CLOB markets.
+ * Position details for YES or NO side.
+ *
  * @public
  */
-interface MarketSettings {
+interface PositionSide {
     /**
-     * Minimum order size
+     * Cost basis (6 decimals)
      */
-    minSize: string;
+    cost: string;
     /**
-     * Maximum spread allowed
+     * Fill price (6 decimals for CLOB, decimal string for AMM)
      */
-    maxSpread: number;
+    fillPrice: string;
     /**
-     * Daily reward amount
+     * Current market value (6 decimals)
      */
-    dailyReward: string;
+    marketValue: string;
     /**
-     * Rewards epoch duration
+     * Realized P&L (6 decimals)
      */
-    rewardsEpoch: string;
+    realisedPnl: string;
     /**
-     * Constant parameter
+     * Unrealized P&L (6 decimals)
      */
-    c: string;
+    unrealizedPnl: string;
 }
 /**
- * Trade prices for different order types.
+ * Token balance for YES or NO side.
+ *
  * @public
  */
-interface TradePrices {
+interface TokenBalance {
     /**
-     * Buy prices (market and limit) for yes/no tokens
+     * YES token balance (6 decimals)
      */
-    buy: {
-        market: [number, number];
-        limit: [number, number];
-    };
+    yes: string;
     /**
-     * Sell prices (market and limit) for yes/no tokens
+     * NO token balance (6 decimals)
      */
-    sell: {
-        market: [number, number];
-        limit: [number, number];
-    };
+    no: string;
 }
 /**
- * Price oracle metadata for oracle-based markets.
+ * Latest trade information.
+ *
  * @public
  */
-interface PriceOracleMetadata {
+interface LatestTrade {
     /**
-     * Asset ticker symbol
+     * Latest YES price (0.0 to 1.0)
      */
-    ticker: string;
+    latestYesPrice: number;
     /**
-     * Asset type (e.g., "CRYPTO")
+     * Latest NO price (0.0 to 1.0)
      */
-    assetType: string;
+    latestNoPrice: number;
     /**
-     * Pyth Network price feed address
+     * Outcome token price (0.0 to 1.0)
      */
-    pythAddress: string;
+    outcomeTokenPrice: number;
+}
+/**
+ * CLOB (Central Limit Order Book) position.
+ *
+ * @public
+ */
+interface CLOBPosition {
     /**
-     * Price feed symbol
+     * Market information
      */
-    symbol: string;
+    market: PositionMarket;
     /**
-     * Asset name
+     * User's wallet address
      */
-    name: string;
+    makerAddress: string;
     /**
-     * Logo URL
+     * Position details for YES and NO sides
      */
-    logo: string;
-}
-/**
- * Orderbook entry (bid or ask).
- * Matches API response format exactly (1:1 parity).
- *
- * @public
- */
-interface OrderbookEntry {
+    positions: {
+        yes: PositionSide;
+        no: PositionSide;
+    };
     /**
-     * Price per share (0-1 range)
+     * Token balances
      */
-    price: number;
+    tokensBalance: TokenBalance;
     /**
-     * Size in shares
+     * Latest trade information
      */
-    size: number;
+    latestTrade: LatestTrade;
     /**
-     * Order side ("BUY" or "SELL")
+     * Active orders information
      */
-    side: string;
+    orders?: {
+        liveOrders: any[];
+        totalCollateralLocked: string;
+    };
+    /**
+     * Rewards information
+     */
+    rewards?: {
+        epochs: any[];
+        isEarning: boolean;
+    };
 }
 /**
- * Complete orderbook for a market.
- * Matches API response format exactly (1:1 parity).
+ * AMM (Automated Market Maker) position.
  *
  * @public
  */
-interface OrderBook {
+interface AMMPosition {
     /**
-     * Bid orders (buy orders) sorted by price descending
+     * Market information
      */
-    bids: OrderbookEntry[];
+    market: PositionMarket;
     /**
-     * Ask orders (sell orders) sorted by price ascending
+     * User's wallet address
      */
-    asks: OrderbookEntry[];
+    account: string;
     /**
-     * Token ID for the orderbook (YES token)
+     * Outcome index (0 for YES, 1 for NO)
      */
-    tokenId: string;
+    outcomeIndex: number;
     /**
-     * Adjusted midpoint price between best bid and ask
+     * Collateral amount (decimal string)
      */
-    adjustedMidpoint: number;
+    collateralAmount: string;
     /**
-     * Maximum allowed spread for the market
+     * Outcome token amount (decimal string)
      */
-    maxSpread: string;
+    outcomeTokenAmount: string;
     /**
-     * Minimum order size allowed
+     * Average fill price (decimal string)
      */
-    minSize: string;
+    averageFillPrice: string;
     /**
-     * Last trade price for the market
+     * Total buys cost (decimal string)
      */
-    lastTradePrice: number;
-}
-/**
- * Market price information.
- * @public
- */
-interface MarketPrice {
+    totalBuysCost: string;
     /**
-     * Token ID
+     * Total sells cost (decimal string)
      */
-    tokenId: string;
+    totalSellsCost: string;
     /**
-     * Current price
+     * Realized P&L (decimal string)
      */
-    price: number;
+    realizedPnl: string;
     /**
-     * Last update timestamp
+     * Unrealized P&L (decimal string)
+     */
+    unrealizedPnl: string;
+    /**
+     * Latest trade information
      */
-    updatedAt?: string;
+    latestTrade?: {
+        outcomeTokenPrice: string;
+    };
 }
 /**
- * Market outcome information.
+ * API response for /portfolio/positions endpoint.
+ *
  * @public
  */
-interface MarketOutcome {
+interface PortfolioPositionsResponse {
     /**
-     * Outcome ID
+     * AMM positions
      */
-    id: number;
+    amm: AMMPosition[];
     /**
-     * Outcome title
+     * CLOB positions
      */
-    title: string;
+    clob: CLOBPosition[];
     /**
-     * Token ID for this outcome
+     * Group positions
      */
-    tokenId: string;
+    group: any[];
     /**
-     * Current price
+     * User points
      */
-    price?: number;
-}
-/**
- * Venue information for CLOB markets.
- *
- * @remarks
- * Contains contract addresses required for trading:
- * - exchange: Used as verifyingContract for EIP-712 order signing
- * - adapter: Required for NegRisk/Grouped market SELL approvals
- *
- * @public
- */
-interface Venue {
+    points?: string;
     /**
-     * Exchange contract address.
-     *
-     * @remarks
-     * This address is used as the verifyingContract in EIP-712 order signing.
-     * All BUY orders require USDC approval to this address.
-     * Simple CLOB SELL orders require CT approval to this address.
+     * Accumulative points
      */
-    exchange: string;
+    accumulativePoints?: string;
     /**
-     * Adapter contract address.
-     *
-     * @remarks
-     * Required for NegRisk/Grouped markets only.
-     * SELL orders on NegRisk markets require CT approval to both exchange AND adapter.
+     * Rewards information
      */
-    adapter: string;
-}
-/**
- * Market token IDs for CLOB markets.
- * @public
- */
-interface MarketTokens {
-    yes: string;
-    no: string;
+    rewards?: {
+        todaysRewards: string;
+        rewardsByEpoch: any[];
+        rewardsChartData: any[];
+        totalUnpaidRewards: string;
+        totalUserRewardsLastEpoch: string;
+    };
 }
 /**
- * Complete market information (1:1 with API response).
- * Handles both CLOB single markets and NegRisk group markets.
+ * Simplified position for unified view.
  *
  * @public
  */
-interface Market {
+interface Position {
     /**
-     * Market database ID
+     * Position type
      */
-    id: number;
+    type: 'CLOB' | 'AMM';
     /**
-     * Market slug identifier
+     * Market information
      */
-    slug: string;
+    market: PositionMarket;
     /**
-     * Market title
+     * Position side (YES or NO)
      */
-    title: string;
+    side: 'YES' | 'NO';
     /**
-     * Market proxy title
+     * Cost basis in USDC (6 decimals)
      */
-    proxyTitle: string | null;
+    costBasis: number;
     /**
-     * Market description
+     * Current market value in USDC (6 decimals)
      */
-    description?: string;
+    marketValue: number;
     /**
-     * Collateral token information
+     * Unrealized P&L in USDC (6 decimals)
      */
-    collateralToken: CollateralToken;
+    unrealizedPnl: number;
     /**
-     * Human-readable expiration date
+     * Realized P&L in USDC (6 decimals)
      */
-    expirationDate: string;
+    realizedPnl: number;
     /**
-     * Expiration timestamp in milliseconds
+     * Current price (0.0 to 1.0)
      */
-    expirationTimestamp: number;
+    currentPrice: number;
     /**
-     * Whether market is expired
+     * Average entry price (0.0 to 1.0)
      */
-    expired?: boolean;
+    avgPrice: number;
     /**
-     * Creation timestamp
+     * Token balance (6 decimals)
      */
-    createdAt: string;
+    tokenBalance: number;
+}
+/**
+ * Portfolio summary statistics.
+ *
+ * @public
+ */
+interface PortfolioSummary {
     /**
-     * Last update timestamp
+     * Total portfolio value in USDC (6 decimals)
      */
-    updatedAt: string;
+    totalValue: number;
     /**
-     * Market categories
+     * Total cost basis in USDC (6 decimals)
      */
-    categories: string[];
+    totalCostBasis: number;
     /**
-     * Market status
+     * Total unrealized P&L in USDC (6 decimals)
      */
-    status: string;
+    totalUnrealizedPnl: number;
     /**
-     * Creator information
+     * Total realized P&L in USDC (6 decimals)
      */
-    creator: MarketCreator;
+    totalRealizedPnl: number;
     /**
-     * Market tags
+     * Total unrealized P&L percentage
      */
-    tags: string[];
+    totalUnrealizedPnlPercent: number;
     /**
-     * Trade type (clob or amm)
+     * Number of open positions
      */
-    tradeType: string;
+    positionCount: number;
     /**
-     * Market type (single or group)
+     * Number of markets with positions
      */
-    marketType: string;
+    marketCount: number;
     /**
-     * Priority index for sorting
+     * Breakdown by position type
      */
-    priorityIndex: number;
+    breakdown: {
+        clob: {
+            positions: number;
+            value: number;
+            pnl: number;
+        };
+        amm: {
+            positions: number;
+            value: number;
+            pnl: number;
+        };
+    };
+}
+/**
+ * User history entry.
+ *
+ * Represents various types of user actions:
+ * - AMM trades
+ * - CLOB trades
+ * - Token splits/merges
+ * - NegRisk conversions
+ *
+ * @public
+ */
+interface HistoryEntry {
     /**
-     * Market metadata
+     * Entry ID
      */
-    metadata: MarketMetadata;
+    id: string;
     /**
-     * Trading volume
+     * Entry type (trade, split, merge, conversion, etc.)
      */
-    volume?: string;
+    type: string;
     /**
-     * Formatted trading volume
+     * Entry creation timestamp
      */
-    volumeFormatted?: string;
+    createdAt: string;
     /**
-     * Condition ID (CLOB only)
+     * Associated market slug
      */
-    conditionId?: string;
+    marketSlug?: string;
     /**
-     * NegRisk request ID (CLOB only)
+     * Transaction amount
      */
-    negRiskRequestId?: string | null;
+    amount?: string;
     /**
-     * Token IDs for yes/no outcomes (CLOB only)
-     * @example
-     * {
-     *   yes: "27687694610130623013351012526567944730242898906227824547270172934678693687246",
-     *   no: "9288900480010863316984252765488448624297561656655547117581633191173128271467"
-     * }
+     * Additional entry details
      */
-    tokens?: MarketTokens;
+    details?: Record<string, any>;
+}
+/**
+ * Paginated user history response from /portfolio/history endpoint.
+ *
+ * @public
+ */
+interface HistoryResponse {
     /**
-     * Current prices [yes, no] (CLOB only)
+     * List of history entries
      */
-    prices?: number[];
+    data: HistoryEntry[];
     /**
-     * Trade prices for buy/sell market/limit orders (CLOB only)
+     * Total number of entries
      */
-    tradePrices?: TradePrices;
+    totalCount: number;
+}
+
+/**
+ * Market-related types for Limitless Exchange.
+ * @module types/markets
+ */
+/**
+ * Collateral token information.
+ * @public
+ */
+interface CollateralToken {
     /**
-     * Whether market is rewardable (CLOB only)
+     * Token contract address
      */
-    isRewardable?: boolean;
+    address: string;
     /**
-     * Market settings (CLOB only)
+     * Token decimals
      */
-    settings?: MarketSettings;
+    decimals: number;
     /**
-     * Venue information for CLOB markets.
-     *
-     * @remarks
-     * Contains exchange and adapter contract addresses for order signing and approvals.
-     * The exchange address is used as verifyingContract in EIP-712 signatures.
-     *
-     * Performance tip: Call getMarket() before createOrder() to cache venue data
-     * and avoid additional API requests during order creation.
+     * Token symbol (e.g., "USDC")
      */
-    venue?: Venue;
+    symbol: string;
+}
+/**
+ * Market creator information.
+ * @public
+ */
+interface MarketCreator {
     /**
-     * Market logo URL
+     * Creator name
      */
-    logo?: string | null;
+    name: string;
     /**
-     * Price oracle metadata (oracle markets only)
+     * Creator image URL
      */
-    priceOracleMetadata?: PriceOracleMetadata;
+    imageURI?: string;
     /**
-     * Order within group (group markets only)
+     * Creator link URL
      */
-    orderInGroup?: number;
+    link?: string;
+}
+/**
+ * Market metadata.
+ * @public
+ */
+interface MarketMetadata {
     /**
-     * Winning outcome index
+     * Fee enabled flag
      */
-    winningOutcomeIndex?: number | null;
+    fee: boolean;
     /**
-     * Outcome token names (group only)
+     * Banner flag
      */
-    outcomeTokens?: string[];
+    isBannered?: boolean;
     /**
-     * OG image URI (group only)
+     * Polymarket arbitrage flag
      */
-    ogImageURI?: string;
+    isPolyArbitrage?: boolean;
     /**
-     * NegRisk market ID (group only)
+     * Market making flag
      */
-    negRiskMarketId?: string;
+    shouldMarketMake?: boolean;
     /**
-     * Child markets in group (group only)
+     * Opening price for oracle markets
      */
-    markets?: Market[];
+    openPrice?: string;
+}
+/**
+ * Market settings for CLOB markets.
+ * @public
+ */
+interface MarketSettings {
     /**
-     * Daily reward for group (group only)
+     * Minimum order size
      */
-    dailyReward?: string;
+    minSize: string;
     /**
-     * Market contract address
-     * @deprecated Use conditionId instead
+     * Maximum spread allowed
      */
-    address?: string | null;
+    maxSpread: number;
     /**
-     * Market type (CLOB or AMM)
-     * @deprecated Use tradeType instead
+     * Daily reward amount
      */
-    type?: string;
+    dailyReward: string;
     /**
-     * Market outcomes
-     * @deprecated Use tokens for CLOB markets
+     * Rewards epoch duration
      */
-    outcomes?: MarketOutcome[];
+    rewardsEpoch: string;
     /**
-     * Resolution timestamp
-     * @deprecated Use expirationTimestamp instead
+     * Constant parameter
      */
-    resolutionDate?: string;
+    c: string;
 }
 /**
- * Markets list response.
+ * Trade prices for different order types.
  * @public
  */
-interface MarketsResponse {
-    /**
-     * Array of markets
-     */
-    markets: Market[];
-    /**
-     * Total count
-     */
-    total?: number;
+interface TradePrices {
     /**
-     * Pagination offset
+     * Buy prices (market and limit) for yes/no tokens
      */
-    offset?: number;
+    buy: {
+        market: [number, number];
+        limit: [number, number];
+    };
     /**
-     * Pagination limit
+     * Sell prices (market and limit) for yes/no tokens
      */
-    limit?: number;
+    sell: {
+        market: [number, number];
+        limit: [number, number];
+    };
 }
 /**
- * Sort options for active markets.
- * @public
- */
-type ActiveMarketsSortBy = 'lp_rewards' | 'ending_soon' | 'newest' | 'high_value' | 'liquidity';
-/**
- * Query parameters for active markets endpoint.
+ * Price oracle metadata for oracle-based markets.
  * @public
  */
-interface ActiveMarketsParams {
+interface PriceOracleMetadata {
     /**
-     * Maximum number of markets to return (max 25)
-     * @defaultValue 25
+     * Asset ticker symbol
      */
-    limit?: number;
+    ticker: string;
     /**
-     * Page number for pagination (starts at 1)
-     * @defaultValue 1
+     * Asset type (e.g., "CRYPTO")
      */
-    page?: number;
+    assetType: string;
     /**
-     * Sort order for markets
+     * Pyth Network price feed address
      */
-    sortBy?: ActiveMarketsSortBy;
-}
-/**
- * Active markets response from API.
- * @public
- */
-interface ActiveMarketsResponse {
+    pythAddress: string;
     /**
-     * Array of active markets
+     * Price feed symbol
      */
-    data: Market[];
+    symbol: string;
     /**
-     * Total count of active markets
+     * Asset name
      */
-    totalMarketsCount: number;
+    name: string;
+    /**
+     * Logo URL
+     */
+    logo: string;
 }
-
 /**
- * Portfolio and position types for Limitless Exchange.
- * @module types/portfolio
- */
-/**
- * Market information for a position.
+ * Orderbook entry (bid or ask).
+ * Matches API response format exactly (1:1 parity).
  *
  * @public
  */
-interface PositionMarket {
+interface OrderbookEntry {
     /**
-     * Market ID
+     * Price per share (0-1 range)
      */
-    id: number | string;
+    price: number;
     /**
-     * Market slug
+     * Size in shares
      */
-    slug: string;
+    size: number;
     /**
-     * Market title
+     * Order side ("BUY" or "SELL")
      */
-    title: string;
+    side: string;
+}
+/**
+ * Complete orderbook for a market.
+ * Matches API response format exactly (1:1 parity).
+ *
+ * @public
+ */
+interface OrderBook {
     /**
-     * Market status
+     * Bid orders (buy orders) sorted by price descending
      */
-    status?: string;
+    bids: OrderbookEntry[];
     /**
-     * Whether market is closed
+     * Ask orders (sell orders) sorted by price ascending
      */
-    closed: boolean;
+    asks: OrderbookEntry[];
     /**
-     * Market deadline
+     * Token ID for the orderbook (YES token)
      */
-    deadline: string;
+    tokenId: string;
     /**
-     * Condition ID
+     * Adjusted midpoint price between best bid and ask
      */
-    conditionId?: string;
+    adjustedMidpoint: number;
     /**
-     * Winning outcome index (null if unresolved)
+     * Maximum allowed spread for the market
      */
-    winningOutcomeIndex?: number | null;
+    maxSpread: string;
     /**
-     * Market group information
+     * Minimum order size allowed
      */
-    group?: {
-        slug?: string;
-        title?: string;
-    };
+    minSize: string;
+    /**
+     * Last trade price for the market
+     */
+    lastTradePrice: number;
 }
 /**
- * Position details for YES or NO side.
- *
+ * Market outcome information.
  * @public
  */
-interface PositionSide {
-    /**
-     * Cost basis (6 decimals)
-     */
-    cost: string;
+interface MarketOutcome {
     /**
-     * Fill price (6 decimals for CLOB, decimal string for AMM)
+     * Outcome ID
      */
-    fillPrice: string;
+    id: number;
     /**
-     * Current market value (6 decimals)
+     * Outcome title
      */
-    marketValue: string;
+    title: string;
     /**
-     * Realized P&L (6 decimals)
+     * Token ID for this outcome
      */
-    realisedPnl: string;
+    tokenId: string;
     /**
-     * Unrealized P&L (6 decimals)
+     * Current price
      */
-    unrealizedPnl: string;
+    price?: number;
 }
 /**
- * Token balance for YES or NO side.
+ * Venue information for CLOB markets.
+ *
+ * @remarks
+ * Contains contract addresses required for trading:
+ * - exchange: Used as verifyingContract for EIP-712 order signing
+ * - adapter: Required for NegRisk/Grouped market SELL approvals
  *
  * @public
  */
-interface TokenBalance {
+interface Venue {
     /**
-     * YES token balance (6 decimals)
+     * Exchange contract address.
+     *
+     * @remarks
+     * This address is used as the verifyingContract in EIP-712 order signing.
+     * All BUY orders require USDC approval to this address.
+     * Simple CLOB SELL orders require CT approval to this address.
      */
-    yes: string;
+    exchange: string;
     /**
-     * NO token balance (6 decimals)
+     * Adapter contract address.
+     *
+     * @remarks
+     * Required for NegRisk/Grouped markets only.
+     * SELL orders on NegRisk markets require CT approval to both exchange AND adapter.
      */
+    adapter: string;
+}
+/**
+ * Market token IDs for CLOB markets.
+ * @public
+ */
+interface MarketTokens {
+    yes: string;
     no: string;
 }
 /**
- * Latest trade information.
+ * Complete market information (1:1 with API response).
+ * Handles both CLOB single markets and NegRisk group markets.
  *
  * @public
  */
-interface LatestTrade {
+interface Market$1 {
     /**
-     * Latest YES price (0.0 to 1.0)
+     * Market database ID
      */
-    latestYesPrice: number;
+    id: number;
     /**
-     * Latest NO price (0.0 to 1.0)
+     * Market slug identifier
      */
-    latestNoPrice: number;
+    slug: string;
     /**
-     * Outcome token price (0.0 to 1.0)
+     * Market title
      */
-    outcomeTokenPrice: number;
-}
-/**
- * CLOB (Central Limit Order Book) position.
- *
- * @public
- */
-interface CLOBPosition {
+    title: string;
     /**
-     * Market information
+     * Market proxy title
      */
-    market: PositionMarket;
+    proxyTitle: string | null;
     /**
-     * User's wallet address
+     * Market description
      */
-    makerAddress: string;
+    description?: string;
     /**
-     * Position details for YES and NO sides
+     * Collateral token information
      */
-    positions: {
-        yes: PositionSide;
-        no: PositionSide;
-    };
+    collateralToken: CollateralToken;
     /**
-     * Token balances
+     * Human-readable expiration date
      */
-    tokensBalance: TokenBalance;
+    expirationDate: string;
     /**
-     * Latest trade information
+     * Expiration timestamp in milliseconds
      */
-    latestTrade: LatestTrade;
+    expirationTimestamp: number;
     /**
-     * Active orders information
+     * Whether market is expired
      */
-    orders?: {
-        liveOrders: any[];
-        totalCollateralLocked: string;
-    };
+    expired?: boolean;
     /**
-     * Rewards information
+     * Creation timestamp
      */
-    rewards?: {
-        epochs: any[];
-        isEarning: boolean;
-    };
-}
-/**
- * AMM (Automated Market Maker) position.
- *
- * @public
- */
-interface AMMPosition {
+    createdAt: string;
     /**
-     * Market information
+     * Last update timestamp
      */
-    market: PositionMarket;
+    updatedAt: string;
     /**
-     * User's wallet address
+     * Market categories
      */
-    account: string;
+    categories: string[];
     /**
-     * Outcome index (0 for YES, 1 for NO)
+     * Market status
      */
-    outcomeIndex: number;
+    status: string;
     /**
-     * Collateral amount (decimal string)
+     * Creator information
      */
-    collateralAmount: string;
+    creator: MarketCreator;
     /**
-     * Outcome token amount (decimal string)
+     * Market tags
      */
-    outcomeTokenAmount: string;
+    tags: string[];
     /**
-     * Average fill price (decimal string)
+     * Trade type (clob or amm)
      */
-    averageFillPrice: string;
+    tradeType: string;
     /**
-     * Total buys cost (decimal string)
+     * Market type (single or group)
      */
-    totalBuysCost: string;
+    marketType: string;
     /**
-     * Total sells cost (decimal string)
+     * Priority index for sorting
      */
-    totalSellsCost: string;
+    priorityIndex: number;
     /**
-     * Realized P&L (decimal string)
+     * Market metadata
      */
-    realizedPnl: string;
+    metadata: MarketMetadata;
     /**
-     * Unrealized P&L (decimal string)
+     * Trading volume
      */
-    unrealizedPnl: string;
+    volume?: string;
     /**
-     * Latest trade information
+     * Formatted trading volume
      */
-    latestTrade?: {
-        outcomeTokenPrice: string;
-    };
-}
-/**
- * API response for /portfolio/positions endpoint.
- *
- * @public
- */
-interface PortfolioPositionsResponse {
+    volumeFormatted?: string;
     /**
-     * AMM positions
+     * Condition ID (CLOB only)
      */
-    amm: AMMPosition[];
+    conditionId?: string;
     /**
-     * CLOB positions
+     * NegRisk request ID (CLOB only)
      */
-    clob: CLOBPosition[];
+    negRiskRequestId?: string | null;
     /**
-     * Group positions
+     * Token IDs for yes/no outcomes (CLOB only)
+     * @example
+     * {
+     *   yes: "27687694610130623013351012526567944730242898906227824547270172934678693687246",
+     *   no: "9288900480010863316984252765488448624297561656655547117581633191173128271467"
+     * }
      */
-    group: any[];
+    tokens?: MarketTokens;
     /**
-     * User points
+     * Current prices [yes, no] (CLOB only)
      */
-    points?: string;
+    prices?: number[];
     /**
-     * Accumulative points
+     * Trade prices for buy/sell market/limit orders (CLOB only)
      */
-    accumulativePoints?: string;
+    tradePrices?: TradePrices;
     /**
-     * Rewards information
+     * Whether market is rewardable (CLOB only)
      */
-    rewards?: {
-        todaysRewards: string;
-        rewardsByEpoch: any[];
-        rewardsChartData: any[];
-        totalUnpaidRewards: string;
-        totalUserRewardsLastEpoch: string;
-    };
-}
-/**
- * Simplified position for unified view.
- *
- * @public
- */
-interface Position {
+    isRewardable?: boolean;
     /**
-     * Position type
+     * Market settings (CLOB only)
      */
-    type: 'CLOB' | 'AMM';
+    settings?: MarketSettings;
     /**
-     * Market information
+     * Venue information for CLOB markets.
+     *
+     * @remarks
+     * Contains exchange and adapter contract addresses for order signing and approvals.
+     * The exchange address is used as verifyingContract in EIP-712 signatures.
+     *
+     * Performance tip: Call getMarket() before createOrder() to cache venue data
+     * and avoid additional API requests during order creation.
      */
-    market: PositionMarket;
+    venue?: Venue;
     /**
-     * Position side (YES or NO)
+     * Market logo URL
      */
-    side: 'YES' | 'NO';
+    logo?: string | null;
     /**
-     * Cost basis in USDC (6 decimals)
+     * Price oracle metadata (oracle markets only)
      */
-    costBasis: number;
+    priceOracleMetadata?: PriceOracleMetadata;
     /**
-     * Current market value in USDC (6 decimals)
+     * Order within group (group markets only)
      */
-    marketValue: number;
+    orderInGroup?: number;
+    /**
+     * Winning outcome index
+     */
+    winningOutcomeIndex?: number | null;
+    /**
+     * Outcome token names (group only)
+     */
+    outcomeTokens?: string[];
+    /**
+     * OG image URI (group only)
+     */
+    ogImageURI?: string;
+    /**
+     * NegRisk market ID (group only)
+     */
+    negRiskMarketId?: string;
+    /**
+     * Child markets in group (group only)
+     */
+    markets?: Market$1[];
     /**
-     * Unrealized P&L in USDC (6 decimals)
+     * Daily reward for group (group only)
      */
-    unrealizedPnl: number;
+    dailyReward?: string;
     /**
-     * Realized P&L in USDC (6 decimals)
+     * Market contract address
+     * @deprecated Use conditionId instead
      */
-    realizedPnl: number;
+    address?: string | null;
     /**
-     * Current price (0.0 to 1.0)
+     * Market type (CLOB or AMM)
+     * @deprecated Use tradeType instead
      */
-    currentPrice: number;
+    type?: string;
     /**
-     * Average entry price (0.0 to 1.0)
+     * Market outcomes
+     * @deprecated Use tokens for CLOB markets
      */
-    avgPrice: number;
+    outcomes?: MarketOutcome[];
     /**
-     * Token balance (6 decimals)
+     * Resolution timestamp
+     * @deprecated Use expirationTimestamp instead
      */
-    tokenBalance: number;
+    resolutionDate?: string;
 }
 /**
- * Portfolio summary statistics.
- *
+ * Markets list response.
  * @public
  */
-interface PortfolioSummary {
+interface MarketsResponse {
     /**
-     * Total portfolio value in USDC (6 decimals)
+     * Array of markets
      */
-    totalValue: number;
+    markets: Market$1[];
     /**
-     * Total cost basis in USDC (6 decimals)
+     * Total count
      */
-    totalCostBasis: number;
+    total?: number;
     /**
-     * Total unrealized P&L in USDC (6 decimals)
+     * Pagination offset
      */
-    totalUnrealizedPnl: number;
+    offset?: number;
     /**
-     * Total realized P&L in USDC (6 decimals)
+     * Pagination limit
      */
-    totalRealizedPnl: number;
+    limit?: number;
+}
+/**
+ * Sort options for active markets.
+ * @public
+ */
+type ActiveMarketsSortBy = 'lp_rewards' | 'ending_soon' | 'newest' | 'high_value' | 'liquidity';
+/**
+ * Query parameters for active markets endpoint.
+ * @public
+ */
+interface ActiveMarketsParams {
     /**
-     * Total unrealized P&L percentage
+     * Maximum number of markets to return (max 25)
+     * @defaultValue 25
      */
-    totalUnrealizedPnlPercent: number;
+    limit?: number;
     /**
-     * Number of open positions
+     * Page number for pagination (starts at 1)
+     * @defaultValue 1
      */
-    positionCount: number;
+    page?: number;
     /**
-     * Number of markets with positions
+     * Sort order for markets
      */
-    marketCount: number;
+    sortBy?: ActiveMarketsSortBy;
+}
+/**
+ * Active markets response from API.
+ * @public
+ */
+interface ActiveMarketsResponse {
     /**
-     * Breakdown by position type
+     * Array of active markets
      */
-    breakdown: {
-        clob: {
-            positions: number;
-            value: number;
-            pnl: number;
-        };
-        amm: {
-            positions: number;
-            value: number;
-            pnl: number;
-        };
-    };
+    data: Market$1[];
+    /**
+     * Total count of active markets
+     */
+    totalMarketsCount: number;
 }
 
 /**
@@ -1563,9 +1536,16 @@ interface WebSocketConfig {
      */
     url?: string;
     /**
-     * Session cookie for authentication
+     * API key for authentication
+     *
+     * @remarks
+     * **Required** for authenticated subscriptions (positions, transactions).
+     * Not required for public subscriptions (market prices, orderbook).
+     *
+     * You can generate an API key at https://limitless.exchange
+     * and the LIMITLESS_API_KEY environment variable.
      */
-    sessionCookie?: string;
+    apiKey?: string;
     /**
      * Auto-reconnect on connection loss (default: true)
      */
@@ -1819,76 +1799,26 @@ interface WebSocketEvents {
 interface SubscriptionOptions {
     /**
      * Market slug to subscribe to (required for market-specific channels)
+     * @deprecated Use marketSlugs (array) instead - server expects array format
      */
     marketSlug?: string;
     /**
-     * Market address to subscribe to (for AMM markets)
-     */
-    marketAddress?: string;
-    /**
-     * Additional filters
-     */
-    filters?: Record<string, any>;
-}
-
-/**
- * Message signer for authentication.
- *
- * @remarks
- * This class handles signing messages with an Ethereum wallet and
- * creating authentication headers required by the Limitless Exchange API.
- *
- * @public
- */
-declare class MessageSigner {
-    private wallet;
-    /**
-     * Creates a new message signer instance.
-     *
-     * @param wallet - Ethers wallet instance for signing
-     */
-    constructor(wallet: ethers.Wallet);
-    /**
-     * Creates authentication headers for API requests.
-     *
-     * @param signingMessage - Message to sign from the API
-     * @returns Promise resolving to signature headers
-     *
-     * @example
-     * ```typescript
-     * const signer = new MessageSigner(wallet);
-     * const headers = await signer.createAuthHeaders(message);
-     * ```
+     * Market slugs to subscribe to (array format - required by server)
      */
-    createAuthHeaders(signingMessage: string): Promise<SignatureHeaders>;
+    marketSlugs?: string[];
     /**
-     * Signs EIP-712 typed data.
-     *
-     * @param domain - EIP-712 domain
-     * @param types - EIP-712 types
-     * @param value - Value to sign
-     * @returns Promise resolving to signature string
-     *
-     * @example
-     * ```typescript
-     * const signature = await signer.signTypedData(domain, types, order);
-     * ```
+     * Market address to subscribe to (for AMM markets)
+     * @deprecated Use marketAddresses (array) instead - server expects array format
      */
-    signTypedData(domain: ethers.TypedDataDomain, types: Record<string, ethers.TypedDataField[]>, value: Record<string, any>): Promise<string>;
+    marketAddress?: string;
     /**
-     * Gets the wallet address.
-     *
-     * @returns Ethereum address
+     * Market addresses to subscribe to (array format - required by server)
      */
-    getAddress(): string;
+    marketAddresses?: string[];
     /**
-     * Converts a string to hex format.
-     *
-     * @param text - String to convert
-     * @returns Hex string with 0x prefix
-     * @internal
+     * Additional filters
      */
-    private stringToHex;
+    filters?: Record<string, any>;
 }
 
 /**
@@ -1907,9 +1837,12 @@ interface HttpClientConfig {
      */
     timeout?: number;
     /**
-     * Session cookie for authenticated requests
+     * API key for authenticated requests
+     * @remarks
+     * If not provided, will attempt to load from LIMITLESS_API_KEY environment variable.
+     * Required for authenticated endpoints (portfolio, orders, etc.)
      */
-    sessionCookie?: string;
+    apiKey?: string;
     /**
      * Optional logger for debugging
      * @defaultValue NoOpLogger (no logging)
@@ -1966,285 +1899,153 @@ interface HttpClientConfig {
 }
 /**
  * HTTP client wrapper for Limitless Exchange API.
- *
- * @remarks
- * This class provides a centralized HTTP client with cookie management,
- * error handling, and request/response interceptors.
- *
- * @public
- */
-declare class HttpClient {
-    private client;
-    private sessionCookie?;
-    private logger;
-    /**
-     * Creates a new HTTP client instance.
-     *
-     * @param config - Configuration options for the HTTP client
-     */
-    constructor(config?: HttpClientConfig);
-    /**
-     * Sets up request and response interceptors.
-     * @internal
-     */
-    private setupInterceptors;
-    /**
-     * Sets the session cookie for authenticated requests.
-     *
-     * @param cookie - Session cookie value
-     */
-    setSessionCookie(cookie: string): void;
-    /**
-     * Clears the session cookie.
-     */
-    clearSessionCookie(): void;
-    /**
-     * Performs a GET request.
-     *
-     * @param url - Request URL
-     * @param config - Additional request configuration
-     * @returns Promise resolving to the response data
-     */
-    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
-    /**
-     * Performs a POST request.
-     *
-     * @param url - Request URL
-     * @param data - Request body data
-     * @param config - Additional request configuration
-     * @returns Promise resolving to the response data
-     */
-    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
-    /**
-     * Performs a POST request and returns the full response object.
-     * Useful when you need access to response headers (e.g., for cookie extraction).
-     *
-     * @param url - Request URL
-     * @param data - Request body data
-     * @param config - Additional request configuration
-     * @returns Promise resolving to the full AxiosResponse object
-     * @internal
-     */
-    postWithResponse<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
-    /**
-     * Performs a DELETE request.
-     *
-     * @remarks
-     * DELETE requests typically don't have a body, so we remove the Content-Type header
-     * to avoid "Body cannot be empty" errors from the API.
-     *
-     * @param url - Request URL
-     * @param config - Additional request configuration
-     * @returns Promise resolving to the response data
-     */
-    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
-    /**
-     * Extracts cookies from response headers.
-     *
-     * @param response - Axios response object
-     * @returns Object containing parsed cookies
-     * @internal
-     */
-    extractCookies(response: AxiosResponse): Record<string, string>;
-}
-
-/**
- * Authenticator for Limitless Exchange API.
- *
- * @remarks
- * This class handles the complete authentication flow:
- * 1. Get signing message from API
- * 2. Sign message with wallet
- * 3. Login and obtain session cookie
- * 4. Verify authentication status
- *
- * @public
- */
-declare class Authenticator {
-    private httpClient;
-    private signer;
-    private logger;
-    /**
-     * Creates a new authenticator instance.
-     *
-     * @param httpClient - HTTP client for API requests
-     * @param signer - Message signer for wallet operations
-     * @param logger - Optional logger for debugging and monitoring (default: no logging)
-     *
-     * @example
-     * ```typescript
-     * // Without logging (default)
-     * const authenticator = new Authenticator(httpClient, signer);
-     *
-     * // With logging
-     * import { ConsoleLogger } from '@limitless-exchange/sdk';
-     * const logger = new ConsoleLogger('debug');
-     * const authenticator = new Authenticator(httpClient, signer, logger);
-     * ```
-     */
-    constructor(httpClient: HttpClient, signer: MessageSigner, logger?: ILogger);
-    /**
-     * Gets a signing message from the API.
-     *
-     * @returns Promise resolving to signing message string
-     * @throws Error if API request fails
-     *
-     * @example
-     * ```typescript
-     * const message = await authenticator.getSigningMessage();
-     * console.log(message);
-     * ```
-     */
-    getSigningMessage(): Promise<string>;
-    /**
-     * Authenticates with the API and obtains session cookie.
-     *
-     * @param options - Login options including client type and smart wallet
-     * @returns Promise resolving to authentication result
-     * @throws Error if authentication fails or smart wallet is required but not provided
-     *
-     * @example
-     * ```typescript
-     * // EOA authentication
-     * const result = await authenticator.authenticate({ client: 'eoa' });
-     *
-     * // ETHERSPOT with smart wallet
-     * const result = await authenticator.authenticate({
-     *   client: 'etherspot',
-     *   smartWallet: '0x...'
-     * });
-     * ```
-     */
-    authenticate(options?: LoginOptions): Promise<AuthResult>;
-    /**
-     * Verifies the current authentication status.
-     *
-     * @param sessionCookie - Session cookie to verify
-     * @returns Promise resolving to user's Ethereum address
-     * @throws Error if session is invalid
-     *
-     * @example
-     * ```typescript
-     * const address = await authenticator.verifyAuth(sessionCookie);
-     * console.log(`Authenticated as: ${address}`);
-     * ```
-     */
-    verifyAuth(sessionCookie: string): Promise<string>;
-    /**
-     * Logs out and clears the session.
-     *
-     * @param sessionCookie - Session cookie to invalidate
-     * @throws Error if logout request fails
-     *
-     * @example
-     * ```typescript
-     * await authenticator.logout(sessionCookie);
-     * console.log('Logged out successfully');
-     * ```
-     */
-    logout(sessionCookie: string): Promise<void>;
-}
-
-/**
- * Optional helper for automatic authentication retry on token expiration.
- * @module auth/authenticated-client
- */
-
-/**
- * Configuration for authenticated client with auto-retry.
+ *
+ * @remarks
+ * This class provides a centralized HTTP client with API key authentication,
+ * error handling, and request/response interceptors.
+ *
  * @public
  */
-interface AuthenticatedClientConfig {
+declare class HttpClient {
+    private client;
+    private apiKey?;
+    private logger;
     /**
-     * HTTP client instance
+     * Creates a new HTTP client instance.
+     *
+     * @param config - Configuration options for the HTTP client
      */
-    httpClient: HttpClient;
+    constructor(config?: HttpClientConfig);
     /**
-     * Authenticator instance
+     * Sets up request and response interceptors.
+     * @internal
      */
-    authenticator: Authenticator;
+    private setupInterceptors;
     /**
-     * Authentication client type ('eoa' or 'etherspot')
+     * Sets the API key for authenticated requests.
+     *
+     * @param apiKey - API key value
      */
-    client: 'eoa' | 'etherspot';
+    setApiKey(apiKey: string): void;
     /**
-     * Optional smart wallet address (required for 'etherspot')
+     * Clears the API key.
      */
-    smartWallet?: string;
+    clearApiKey(): void;
     /**
-     * Optional logger for debugging
+     * Performs a GET request.
+     *
+     * @param url - Request URL
+     * @param config - Additional request configuration
+     * @returns Promise resolving to the response data
      */
-    logger?: ILogger;
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
     /**
-     * Maximum retry attempts for auth errors (default: 1)
+     * Performs a POST request.
+     *
+     * @param url - Request URL
+     * @param data - Request body data
+     * @param config - Additional request configuration
+     * @returns Promise resolving to the response data
      */
-    maxRetries?: number;
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Performs a DELETE request.
+     *
+     * @remarks
+     * DELETE requests typically don't have a body, so we remove the Content-Type header
+     * to avoid "Body cannot be empty" errors from the API.
+     *
+     * @param url - Request URL
+     * @param config - Additional request configuration
+     * @returns Promise resolving to the response data
+     */
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
 }
+
+/**
+ * Market class with fluent API methods.
+ * @module types/market-class
+ */
+
 /**
- * Optional helper class that automatically re-authenticates on token expiration.
+ * Market class with fluent API support.
  *
  * @remarks
- * This is an optional convenience wrapper. Users can choose to handle
- * authentication retry manually or use this helper for automatic retry logic.
- *
- * @example
- * ```typescript
- * // Create authenticated client with auto-retry
- * const authClient = new AuthenticatedClient({
- *   httpClient,
- *   authenticator,
- *   client: 'eoa'
- * });
- *
- * // Use withRetry for automatic re-authentication
- * const portfolioFetcher = new PortfolioFetcher(httpClient);
- * const positions = await authClient.withRetry(() =>
- *   portfolioFetcher.getPositions()
- * );
- * ```
+ * This class represents a market with methods for fetching related data.
+ * Instances are created by MarketFetcher and have http_client attached.
  *
  * @public
  */
-declare class AuthenticatedClient {
-    private httpClient;
-    private authenticator;
-    private client;
-    private smartWallet?;
-    private logger;
-    private maxRetries;
+declare class Market {
+    id: number;
+    slug: string;
+    title: string;
+    proxyTitle: string | null;
+    description?: string;
+    collateralToken: CollateralToken;
+    expirationDate: string;
+    expirationTimestamp: number;
+    expired?: boolean;
+    createdAt: string;
+    updatedAt: string;
+    categories: string[];
+    status: string;
+    creator: MarketCreator;
+    tags: string[];
+    tradeType: string;
+    marketType: string;
+    priorityIndex: number;
+    metadata: MarketMetadata;
+    volume?: string;
+    volumeFormatted?: string;
+    conditionId?: string;
+    negRiskRequestId?: string | null;
+    tokens?: MarketTokens;
+    prices?: number[];
+    tradePrices?: TradePrices;
+    isRewardable?: boolean;
+    settings?: MarketSettings;
+    venue?: Venue;
+    logo?: string | null;
+    priceOracleMetadata?: PriceOracleMetadata;
+    orderInGroup?: number;
+    winningOutcomeIndex?: number | null;
+    outcomeTokens?: string[];
+    ogImageURI?: string;
+    negRiskMarketId?: string;
+    markets?: Market[];
+    dailyReward?: string;
+    address?: string | null;
+    type?: string;
+    outcomes?: MarketOutcome[];
+    resolutionDate?: string;
+    private httpClient?;
     /**
-     * Creates a new authenticated client with auto-retry capability.
+     * Creates a Market instance.
      *
-     * @param config - Configuration for authenticated client
+     * @param data - Market data from API
+     * @param httpClient - HTTP client for making requests
      */
-    constructor(config: AuthenticatedClientConfig);
+    constructor(data: any, httpClient?: HttpClient);
     /**
-     * Executes a function with automatic retry on authentication errors.
+     * Get user's orders for this market.
      *
-     * @param fn - Function to execute with auth retry
-     * @returns Promise resolving to the function result
-     * @throws Error if max retries exceeded or non-auth error occurs
+     * @remarks
+     * Fetches all orders placed by the authenticated user for this specific market.
+     * Uses the http_client from the MarketFetcher that created this Market instance.
+     *
+     * @returns Promise resolving to array of user orders
+     * @throws Error if market wasn't fetched via MarketFetcher
      *
      * @example
      * ```typescript
-     * // Automatic retry on 401/403
-     * const positions = await authClient.withRetry(() =>
-     *   portfolioFetcher.getPositions()
-     * );
-     *
-     * // Works with any async operation
-     * const order = await authClient.withRetry(() =>
-     *   orderClient.createOrder({ ... })
-     * );
+     * // Clean fluent API
+     * const market = await marketFetcher.getMarket("bitcoin-2024");
+     * const orders = await market.getUserOrders();
+     * console.log(`You have ${orders.length} orders in ${market.title}`);
      * ```
      */
-    withRetry<T>(fn: () => Promise<T>): Promise<T>;
-    /**
-     * Re-authenticates with the API.
-     *
-     * @internal
-     */
-    private reauthenticate;
+    getUserOrders(): Promise<any[]>;
 }
 
 /**
@@ -2319,6 +2120,72 @@ declare class APIError extends Error {
      */
     isAuthError(): boolean;
 }
+/**
+ * Rate limit error (HTTP 429).
+ *
+ * @remarks
+ * Thrown when API rate limits are exceeded. The request should be retried after a delay.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await marketFetcher.getActiveMarkets();
+ * } catch (error) {
+ *   if (error instanceof RateLimitError) {
+ *     console.log('Rate limit exceeded, retry after delay');
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+declare class RateLimitError extends APIError {
+    constructor(message?: string, status?: number, data?: any, url?: string, method?: string);
+}
+/**
+ * Authentication error (HTTP 401, 403).
+ *
+ * @remarks
+ * Thrown when authentication fails or API key is invalid/missing.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await portfolioFetcher.getPositions();
+ * } catch (error) {
+ *   if (error instanceof AuthenticationError) {
+ *     console.log('Authentication failed - check API key');
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+declare class AuthenticationError extends APIError {
+    constructor(message?: string, status?: number, data?: any, url?: string, method?: string);
+}
+/**
+ * Validation error (HTTP 400).
+ *
+ * @remarks
+ * Thrown when request validation fails (invalid parameters, missing required fields, etc.).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await orderClient.createOrder({ ... });
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.log('Validation failed:', error.message);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+declare class ValidationError extends APIError {
+    constructor(message: string, status?: number, data?: any, url?: string, method?: string);
+}
 
 /**
  * Retry mechanism for handling transient API failures.
@@ -2870,17 +2737,17 @@ declare class OrderSigner {
  */
 
 /**
- * Validation error class.
+ * Order validation error class for client-side validation.
  * @public
  */
-declare class ValidationError extends Error {
+declare class OrderValidationError extends Error {
     constructor(message: string);
 }
 /**
  * Validates order arguments before building.
  *
  * @param args - Order arguments to validate (FOK or GTC)
- * @throws ValidationError if validation fails
+ * @throws OrderValidationError if validation fails
  *
  * @public
  *
@@ -2898,7 +2765,7 @@ declare function validateOrderArgs(args: OrderArgs): void;
  * Validates an unsigned order.
  *
  * @param order - Unsigned order to validate
- * @throws ValidationError if validation fails
+ * @throws OrderValidationError if validation fails
  *
  * @public
  *
@@ -2912,7 +2779,7 @@ declare function validateUnsignedOrder(order: UnsignedOrder): void;
  * Validates a signed order.
  *
  * @param order - Signed order to validate
- * @throws ValidationError if validation fails
+ * @throws OrderValidationError if validation fails
  *
  * @public
  *
@@ -2996,9 +2863,14 @@ declare class MarketFetcher {
      *
      * @example
      * ```typescript
+     * // Get market
      * const market = await fetcher.getMarket('bitcoin-price-2024');
      * console.log(`Market: ${market.title}`);
      *
+     * // Fluent API - get user orders for this market (clean!)
+     * const orders = await market.getUserOrders();
+     * console.log(`You have ${orders.length} orders`);
+     *
      * // Venue is now cached for order signing
      * await orderClient.createOrder({
      *   marketSlug: 'bitcoin-price-2024',
@@ -3040,20 +2912,6 @@ declare class MarketFetcher {
      * ```
      */
     getOrderBook(slug: string): Promise<OrderBook>;
-    /**
-     * Gets the current price for a token.
-     *
-     * @param tokenId - Token ID
-     * @returns Promise resolving to price information
-     * @throws Error if API request fails
-     *
-     * @example
-     * ```typescript
-     * const price = await fetcher.getPrice('123456');
-     * console.log(`Current price: ${price.price}`);
-     * ```
-     */
-    getPrice(tokenId: string): Promise<MarketPrice>;
 }
 
 /**
@@ -3066,7 +2924,8 @@ declare class MarketFetcher {
  *
  * @remarks
  * The order client auto-configures signing based on venue data from the API.
- * Custom signingConfig is optional for advanced use cases.
+ * User data (userId, feeRateBps) is automatically fetched from the profile API
+ * on first order creation and cached for subsequent orders.
  *
  * Performance tip: Provide a shared marketFetcher instance to enable venue caching
  * across market fetches and order creation, avoiding redundant API calls.
@@ -3075,25 +2934,13 @@ declare class MarketFetcher {
  */
 interface OrderClientConfig {
     /**
-     * HTTP client for API requests
+     * HTTP client for API requests (must have API key configured)
      */
     httpClient: HttpClient;
     /**
-     * Wallet for signing orders
+     * Wallet for signing orders with EIP-712
      */
     wallet: ethers.Wallet;
-    /**
-     * User data containing userId and feeRateBps
-     *
-     * @example
-     * ```typescript
-     * {
-     *   userId: 123,      // From auth result
-     *   feeRateBps: 300   // User's fee rate (3%)
-     * }
-     * ```
-     */
-    userData: UserData;
     /**
      * Custom signing configuration (optional)
      *
@@ -3118,7 +2965,6 @@ interface OrderClientConfig {
      * const orderClient = new OrderClient({
      *   httpClient,
      *   wallet,
-     *   userData,
      *   marketFetcher  // Shared instance
      * });
      *
@@ -3142,24 +2988,23 @@ interface OrderClientConfig {
  * This class provides high-level methods for order operations,
  * abstracting away HTTP details and order signing complexity.
  *
+ * User data (userId, feeRateBps) is automatically fetched from profile API
+ * on first order creation and cached for subsequent orders.
+ *
  * Uses dynamic venue addressing for EIP-712 order signing. For best performance,
  * always call marketFetcher.getMarket() before creating orders to cache venue data.
  *
  * @example
  * ```typescript
+ * import { ethers } from 'ethers';
+ *
+ * const wallet = new ethers.Wallet(process.env.PRIVATE_KEY!);
  * const orderClient = new OrderClient({
- *   httpClient,
- *   wallet,
- *   userData: {
- *     userId: 123,
- *     feeRateBps: 100
- *   },
- *   signingConfig: {
- *     chainId: 8453,
- *     contractAddress: '0x...'
- *   }
+ *   httpClient,  // Must have API key configured
+ *   wallet,      // For EIP-712 signing
  * });
  *
+ * // User data automatically fetched on first order
  * const order = await orderClient.createOrder({
  *   tokenId: '123...',
  *   price: 0.65,
@@ -3174,10 +3019,11 @@ interface OrderClientConfig {
  */
 declare class OrderClient {
     private httpClient;
-    private orderBuilder;
+    private wallet;
+    private orderBuilder?;
     private orderSigner;
     private marketFetcher;
-    private ownerId;
+    private cachedUserData?;
     private signingConfig;
     private logger;
     /**
@@ -3186,6 +3032,14 @@ declare class OrderClient {
      * @param config - Order client configuration
      */
     constructor(config: OrderClientConfig);
+    /**
+     * Ensures user data is loaded and cached.
+     * Fetches from profile API on first call, then caches for subsequent calls.
+     *
+     * @returns Promise resolving to cached user data
+     * @internal
+     */
+    private ensureUserData;
     /**
      * Creates and submits a new order.
      *
@@ -3268,25 +3122,6 @@ declare class OrderClient {
     cancelAll(marketSlug: string): Promise<{
         message: string;
     }>;
-    /**
-     * @deprecated Use `cancel()` instead
-     */
-    cancelOrder(orderId: string): Promise<void>;
-    /**
-     * Gets an order by ID.
-     *
-     * @param orderId - Order ID to fetch
-     * @returns Promise resolving to order details
-     *
-     * @throws Error if order not found
-     *
-     * @example
-     * ```typescript
-     * const order = await orderClient.getOrder('order-id-123');
-     * console.log(order.order.side);
-     * ```
-     */
-    getOrder(orderId: string): Promise<OrderResponse>;
     /**
      * Builds an unsigned order without submitting.
      *
@@ -3295,11 +3130,11 @@ declare class OrderClient {
      * before signing and submission.
      *
      * @param params - Order parameters
-     * @returns Unsigned order
+     * @returns Promise resolving to unsigned order
      *
      * @example
      * ```typescript
-     * const unsignedOrder = orderClient.buildUnsignedOrder({
+     * const unsignedOrder = await orderClient.buildUnsignedOrder({
      *   tokenId: '123456',
      *   price: 0.65,
      *   size: 100,
@@ -3307,7 +3142,7 @@ declare class OrderClient {
      * });
      * ```
      */
-    buildUnsignedOrder(params: OrderArgs): UnsignedOrder;
+    buildUnsignedOrder(params: OrderArgs): Promise<UnsignedOrder>;
     /**
      * Signs an unsigned order without submitting.
      *
@@ -3324,6 +3159,32 @@ declare class OrderClient {
      * ```
      */
     signOrder(order: UnsignedOrder): Promise<string>;
+    /**
+     * Gets the wallet address.
+     *
+     * @returns Ethereum address of the wallet
+     *
+     * @example
+     * ```typescript
+     * const address = orderClient.walletAddress;
+     * console.log(`Wallet: ${address}`);
+     * ```
+     */
+    get walletAddress(): string;
+    /**
+     * Gets the owner ID (user ID from profile).
+     *
+     * @returns Owner ID from user profile, or undefined if not yet loaded
+     *
+     * @example
+     * ```typescript
+     * const ownerId = orderClient.ownerId;
+     * if (ownerId) {
+     *   console.log(`Owner ID: ${ownerId}`);
+     * }
+     * ```
+     */
+    get ownerId(): number | undefined;
 }
 
 /**
@@ -3360,6 +3221,26 @@ declare class PortfolioFetcher {
      * ```
      */
     constructor(httpClient: HttpClient, logger?: ILogger);
+    /**
+     * Gets user profile for a specific wallet address.
+     *
+     * @remarks
+     * Returns user profile data including user ID and fee rate.
+     * Used internally by OrderClient to fetch user data.
+     *
+     * @param address - Wallet address to fetch profile for
+     * @returns Promise resolving to user profile data
+     * @throws Error if API request fails or user is not authenticated
+     *
+     * @example
+     * ```typescript
+     * const profile = await portfolioFetcher.getProfile('0x1234...');
+     * console.log(`User ID: ${profile.id}`);
+     * console.log(`Account: ${profile.account}`);
+     * console.log(`Fee Rate: ${profile.rank?.feeRateBps}`);
+     * ```
+     */
+    getProfile(address: string): Promise<any>;
     /**
      * Gets raw portfolio positions response from API.
      *
@@ -3406,65 +3287,32 @@ declare class PortfolioFetcher {
      */
     getAMMPositions(): Promise<AMMPosition[]>;
     /**
-     * Flattens positions into a unified format for easier consumption.
-     *
-     * @remarks
-     * Converts CLOB positions (which have YES/NO sides) and AMM positions
-     * into a unified Position array. Only includes positions with non-zero values.
-     *
-     * @returns Promise resolving to array of flattened positions
-     * @throws Error if API request fails
-     *
-     * @example
-     * ```typescript
-     * const positions = await portfolioFetcher.getFlattenedPositions();
-     * positions.forEach(pos => {
-     *   const pnlPercent = (pos.unrealizedPnl / pos.costBasis) * 100;
-     *   console.log(`${pos.market.title} (${pos.side}): ${pnlPercent.toFixed(2)}% P&L`);
-     * });
-     * ```
-     */
-    getFlattenedPositions(): Promise<Position[]>;
-    /**
-     * Calculates portfolio summary statistics from raw API response.
-     *
-     * @param response - Portfolio positions response from API
-     * @returns Portfolio summary with totals and statistics
-     *
-     * @example
-     * ```typescript
-     * const response = await portfolioFetcher.getPositions();
-     * const summary = portfolioFetcher.calculateSummary(response);
+     * Gets paginated history of user actions.
      *
-     * console.log(`Total Portfolio Value: $${(summary.totalValue / 1e6).toFixed(2)}`);
-     * console.log(`Total P&L: ${summary.totalUnrealizedPnlPercent.toFixed(2)}%`);
-     * console.log(`CLOB Positions: ${summary.breakdown.clob.positions}`);
-     * console.log(`AMM Positions: ${summary.breakdown.amm.positions}`);
-     * ```
-     */
-    calculateSummary(response: PortfolioPositionsResponse): PortfolioSummary;
-    /**
-     * Gets positions and calculates summary in a single call.
+     *  Includes AMM trades, CLOB trades, Negrisk trades & conversions.
      *
-     * @returns Promise resolving to response and summary
+     * @param page - Page number (starts at 1)
+     * @param limit - Number of items per page
+     * @returns Promise resolving to paginated history response
      * @throws Error if API request fails or user is not authenticated
      *
      * @example
      * ```typescript
-     * const { response, summary } = await portfolioFetcher.getPortfolio();
-     *
-     * console.log('Portfolio Summary:');
-     * console.log(`  Total Value: $${(summary.totalValue / 1e6).toFixed(2)}`);
-     * console.log(`  Total P&L: $${(summary.totalUnrealizedPnl / 1e6).toFixed(2)}`);
-     * console.log(`  P&L %: ${summary.totalUnrealizedPnlPercent.toFixed(2)}%`);
-     * console.log(`\nCLOB Positions: ${response.clob.length}`);
-     * console.log(`AMM Positions: ${response.amm.length}`);
+     * // Get first page
+     * const response = await portfolioFetcher.getUserHistory(1, 20);
+     * console.log(`Found ${response.data.length} of ${response.totalCount} entries`);
+     *
+     * // Process history entries
+     * for (const entry of response.data) {
+     *   console.log(`Type: ${entry.type}`);
+     *   console.log(`Market: ${entry.marketSlug}`);
+     * }
+     *
+     * // Get next page
+     * const page2 = await portfolioFetcher.getUserHistory(2, 20);
      * ```
      */
-    getPortfolio(): Promise<{
-        response: PortfolioPositionsResponse;
-        summary: PortfolioSummary;
-    }>;
+    getUserHistory(page?: number, limit?: number): Promise<HistoryResponse>;
 }
 
 /**
@@ -3479,22 +3327,36 @@ declare class PortfolioFetcher {
  * This client uses Socket.IO to connect to the WebSocket server and provides
  * typed event subscriptions for orderbook, trades, orders, and market data.
  *
+ * **Public Subscriptions** (no authentication required):
+ * - Market prices (AMM)
+ * - Orderbook updates (CLOB)
+ *
+ * **Authenticated Subscriptions** (require API key):
+ * - User positions
+ * - User transactions
+ *
  * @example
  * ```typescript
- * // Create client
+ * // Public subscription (no API key needed)
  * const wsClient = new WebSocketClient({
- *   sessionCookie: 'your-session-cookie',
  *   autoReconnect: true,
  * });
  *
- * // Subscribe to orderbook updates
- * wsClient.on('orderbook', (data) => {
- *   console.log('Orderbook update:', data);
+ * await wsClient.connect();
+ * await wsClient.subscribe('subscribe_market_prices', {
+ *   marketSlugs: ['market-123']
+ * });
+ *
+ * // Authenticated subscription (API key required)
+ * const wsClientAuth = new WebSocketClient({
+ *   apiKey: process.env.LIMITLESS_API_KEY,
+ *   autoReconnect: true,
  * });
  *
- * // Connect and subscribe
- * await wsClient.connect();
- * await wsClient.subscribe('orderbook', { marketSlug: 'market-123' });
+ * await wsClientAuth.connect();
+ * await wsClientAuth.subscribe('subscribe_positions', {
+ *   marketSlugs: ['market-123']
+ * });
  * ```
  *
  * @public
@@ -3527,11 +3389,20 @@ declare class WebSocketClient {
      */
     isConnected(): boolean;
     /**
-     * Sets the session cookie for authentication.
+     * Sets the API key for authentication.
+     *
+     * @param apiKey - API key value
      *
-     * @param sessionCookie - Session cookie value
+     * @remarks
+     * API key is required for authenticated subscriptions (positions, transactions).
+     * If already connected, this will trigger a reconnection with the new API key.
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Reconnects with new authentication credentials.
+     * @internal
      */
-    setSessionCookie(sessionCookie: string): void;
+    private reconnectWithNewAuth;
     /**
      * Connects to the WebSocket server.
      *
@@ -3548,24 +3419,26 @@ declare class WebSocketClient {
     /**
      * Disconnects from the WebSocket server.
      *
+     * @returns Promise that resolves when disconnected
+     *
      * @example
      * ```typescript
-     * wsClient.disconnect();
+     * await wsClient.disconnect();
      * ```
      */
-    disconnect(): void;
+    disconnect(): Promise<void>;
     /**
      * Subscribes to a channel.
      *
      * @param channel - Channel to subscribe to
      * @param options - Subscription options
-     * @returns Promise that resolves when subscribed
+     * @returns Promise that resolves immediately (kept async for API compatibility)
      * @throws Error if not connected
      *
      * @example
      * ```typescript
      * // Subscribe to orderbook for a specific market
-     * await wsClient.subscribe('orderbook', { marketSlug: 'market-123' });
+     * await wsClient.subscribe('orderbook', { marketSlugs: ['market-123'] });
      *
      * // Subscribe to all trades
      * await wsClient.subscribe('trades');
@@ -3581,10 +3454,11 @@ declare class WebSocketClient {
      * @param channel - Channel to unsubscribe from
      * @param options - Subscription options (must match subscribe call)
      * @returns Promise that resolves when unsubscribed
+     * @throws Error if not connected or unsubscribe fails
      *
      * @example
      * ```typescript
-     * await wsClient.unsubscribe('orderbook', { marketSlug: 'market-123' });
+     * await wsClient.unsubscribe('orderbook', { marketSlugs: ['market-123'] });
      * ```
      */
     unsubscribe(channel: SubscriptionChannel, options?: SubscriptionOptions): Promise<void>;
@@ -3616,10 +3490,19 @@ declare class WebSocketClient {
      * Removes an event listener.
      *
      * @param event - Event name
-     * @param handler - Event handler to remove
+     * @param handler - Event handler to remove (if undefined, removes all handlers for event)
      * @returns This client for chaining
+     *
+     * @example
+     * ```typescript
+     * // Remove specific handler
+     * wsClient.off('orderbookUpdate', myHandler);
+     *
+     * // Remove all handlers for event
+     * wsClient.off('orderbookUpdate');
+     * ```
      */
-    off<K extends keyof WebSocketEvents>(event: K, handler: WebSocketEvents[K]): this;
+    off<K extends keyof WebSocketEvents>(event: K, handler?: WebSocketEvents[K]): this;
     /**
      * Attach any pending event listeners that were added before connect().
      * @internal
@@ -3647,4 +3530,4 @@ declare class WebSocketClient {
     private getChannelFromKey;
 }
 
-export { type AMMPosition, APIError, type ActiveMarketsParams, type ActiveMarketsResponse, type ActiveMarketsSortBy, type AmmPriceEntry, type AuthResult, AuthenticatedClient, type AuthenticatedClientConfig, Authenticator, BASE_SEPOLIA_CHAIN_ID, type BaseOrderArgs, type CLOBPosition, CONTRACT_ADDRESSES, type ClientType, type CollateralToken, ConsoleLogger, type CreatedOrder, DEFAULT_API_URL, DEFAULT_CHAIN_ID, DEFAULT_WS_URL, type FOKOrderArgs, type FillEvent, type GTCOrderArgs, HttpClient, type HttpClientConfig, type ILogger, type LatestTrade, type LoginOptions, type Market, type MarketCreator, MarketFetcher, type MarketMetadata, type MarketOutcome, type MarketPrice, type MarketSettings, type MarketTokens, type MarketUpdate, type MarketsResponse, MessageSigner, type ModeInfo, type NewOrderPayload, type NewPriceData, NoOpLogger, type OrderArgs, type OrderBook, OrderBuilder, OrderClient, type OrderClientConfig, type OrderMatch, type OrderResponse, OrderSigner, type OrderSigningConfig, OrderType, type OrderUpdate, type OrderbookData, type OrderbookEntry, type OrderbookUpdate, PortfolioFetcher, type PortfolioPositionsResponse, type PortfolioSummary, type Position, type PositionMarket, type PositionSide, type PriceOracleMetadata, type PriceUpdate, type ReferralData, RetryConfig, type RetryConfigOptions, RetryableClient, SIGNING_MESSAGE_TEMPLATE, Side, type SignatureHeaders, SignatureType, type SignedOrder, type SubscriptionChannel, type SubscriptionOptions, type TokenBalance, type TradeEvent, type TradePrices, type TradingMode, type TransactionEvent, type UnsignedOrder, type UserData, type UserProfile, type UserRank, ValidationError, type Venue, WebSocketClient, type WebSocketConfig, type WebSocketEvents, WebSocketState, ZERO_ADDRESS, getContractAddress, retryOnErrors, validateOrderArgs, validateSignedOrder, validateUnsignedOrder, withRetry };
+export { type AMMPosition, APIError, type ActiveMarketsParams, type ActiveMarketsResponse, type ActiveMarketsSortBy, type AmmPriceEntry, AuthenticationError, BASE_SEPOLIA_CHAIN_ID, type BaseOrderArgs, type CLOBPosition, CONTRACT_ADDRESSES, type CollateralToken, ConsoleLogger, type CreatedOrder, DEFAULT_API_URL, DEFAULT_CHAIN_ID, DEFAULT_WS_URL, type FOKOrderArgs, type FillEvent, type GTCOrderArgs, type HistoryEntry, type HistoryResponse, HttpClient, type HttpClientConfig, type ILogger, type LatestTrade, Market, type MarketCreator, MarketFetcher, type Market$1 as MarketInterface, type MarketMetadata, type MarketOutcome, type MarketSettings, type MarketTokens, type MarketUpdate, type MarketsResponse, type ModeInfo, type NewOrderPayload, type NewPriceData, NoOpLogger, type OrderArgs, type OrderBook, OrderBuilder, OrderClient, type OrderClientConfig, type OrderMatch, type OrderResponse, OrderSigner, type OrderSigningConfig, OrderType, type OrderUpdate, OrderValidationError, type OrderbookData, type OrderbookEntry, type OrderbookUpdate, PortfolioFetcher, type PortfolioPositionsResponse, type PortfolioSummary, type Position, type PositionMarket, type PositionSide, type PriceOracleMetadata, type PriceUpdate, RateLimitError, type ReferralData, RetryConfig, type RetryConfigOptions, RetryableClient, SIGNING_MESSAGE_TEMPLATE, Side, SignatureType, type SignedOrder, type SubscriptionChannel, type SubscriptionOptions, type TokenBalance, type TradeEvent, type TradePrices, type TradingMode, type TransactionEvent, type UnsignedOrder, type UserData, type UserProfile, type UserRank, ValidationError, type Venue, WebSocketClient, type WebSocketConfig, type WebSocketEvents, WebSocketState, ZERO_ADDRESS, getContractAddress, retryOnErrors, validateOrderArgs, validateSignedOrder, validateUnsignedOrder, withRetry };