@limitless-exchange/sdk 0.0.2 → 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.
@@ -309,14 +248,6 @@ declare enum OrderType {
     /** Good-Til-Cancelled: Remain on orderbook until filled or cancelled */
     GTC = "GTC"
 }
-/**
- * Market type enum.
- * @public
- */
-declare enum MarketType {
-    CLOB = "CLOB",
-    NEGRISK = "NEGRISK"
-}
 /**
  * Signature type enum.
  * @public
@@ -342,11 +273,6 @@ interface BaseOrderArgs {
      * Order side (BUY or SELL)
      */
     side: Side;
-    /**
-     * Market type (CLOB or NEGRISK)
-     * @defaultValue 'CLOB'
-     */
-    marketType?: MarketType;
     /**
      * Expiration timestamp (0 for no expiration)
      * @defaultValue '0'
@@ -684,845 +610,915 @@ interface OrderSigningConfig {
      */
     chainId: number;
     /**
-     * Contract address for verification
+     * Contract address for verification (from venue.exchange)
      */
     contractAddress: string;
-    /**
-     * Market type (CLOB or NEGRISK)
-     */
-    marketType: MarketType;
 }
 
 /**
- * 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)
      */
-    updatedAt?: string;
+    unrealizedPnl: string;
+    /**
+     * Latest trade information
+     */
+    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;
-}
-/**
- * Market token IDs for CLOB markets.
- * @public
- */
-interface MarketTokens {
-    yes: string;
-    no: string;
+    points?: string;
+    /**
+     * Accumulative points
+     */
+    accumulativePoints?: string;
+    /**
+     * Rewards information
+     */
+    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;
     /**
-     * Market logo URL
+     * Token symbol (e.g., "USDC")
      */
-    logo?: string | null;
+    symbol: string;
+}
+/**
+ * Market creator information.
+ * @public
+ */
+interface MarketCreator {
     /**
-     * Price oracle metadata (oracle markets only)
+     * Creator name
      */
-    priceOracleMetadata?: PriceOracleMetadata;
+    name: string;
     /**
-     * Order within group (group markets only)
+     * Creator image URL
      */
-    orderInGroup?: number;
+    imageURI?: string;
     /**
-     * Winning outcome index
+     * Creator link URL
      */
-    winningOutcomeIndex?: number | null;
+    link?: string;
+}
+/**
+ * Market metadata.
+ * @public
+ */
+interface MarketMetadata {
     /**
-     * Outcome token names (group only)
+     * Fee enabled flag
      */
-    outcomeTokens?: string[];
+    fee: boolean;
     /**
-     * OG image URI (group only)
+     * Banner flag
      */
-    ogImageURI?: string;
+    isBannered?: boolean;
     /**
-     * NegRisk market ID (group only)
+     * Polymarket arbitrage flag
      */
-    negRiskMarketId?: string;
+    isPolyArbitrage?: boolean;
     /**
-     * Child markets in group (group only)
+     * Market making flag
      */
-    markets?: Market[];
+    shouldMarketMake?: boolean;
     /**
-     * Daily reward for group (group only)
+     * Opening price for oracle markets
      */
-    dailyReward?: string;
+    openPrice?: string;
+}
+/**
+ * Market settings for CLOB markets.
+ * @public
+ */
+interface MarketSettings {
     /**
-     * Market contract address
-     * @deprecated Use conditionId instead
+     * Minimum order size
      */
-    address?: string | null;
+    minSize: string;
     /**
-     * Market type (CLOB or AMM)
-     * @deprecated Use tradeType instead
+     * Maximum spread allowed
      */
-    type?: string;
+    maxSpread: number;
     /**
-     * Market outcomes
-     * @deprecated Use tokens for CLOB markets
+     * Daily reward amount
      */
-    outcomes?: MarketOutcome[];
+    dailyReward: string;
     /**
-     * Resolution timestamp
-     * @deprecated Use expirationTimestamp instead
+     * Rewards epoch duration
      */
-    resolutionDate?: string;
+    rewardsEpoch: string;
+    /**
+     * Constant parameter
+     */
+    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;
+    pythAddress: string;
+    /**
+     * Price feed symbol
+     */
+    symbol: string;
+    /**
+     * Asset name
+     */
+    name: string;
+    /**
+     * Logo URL
+     */
+    logo: string;
 }
 /**
- * Active markets response from API.
+ * Orderbook entry (bid or ask).
+ * Matches API response format exactly (1:1 parity).
+ *
  * @public
  */
-interface ActiveMarketsResponse {
+interface OrderbookEntry {
     /**
-     * Array of active markets
+     * Price per share (0-1 range)
      */
-    data: Market[];
+    price: number;
     /**
-     * Total count of active markets
+     * Size in shares
      */
-    totalMarketsCount: number;
+    size: number;
+    /**
+     * Order side ("BUY" or "SELL")
+     */
+    side: string;
 }
-
-/**
- * Portfolio and position types for Limitless Exchange.
- * @module types/portfolio
- */
 /**
- * Market information for a position.
+ * Complete orderbook for a market.
+ * Matches API response format exactly (1:1 parity).
  *
  * @public
  */
-interface PositionMarket {
-    /**
-     * Market ID
-     */
-    id: number | string;
-    /**
-     * Market slug
-     */
-    slug: string;
+interface OrderBook {
     /**
-     * Market title
+     * Bid orders (buy orders) sorted by price descending
      */
-    title: string;
+    bids: OrderbookEntry[];
     /**
-     * Market status
+     * Ask orders (sell orders) sorted by price ascending
      */
-    status?: string;
+    asks: OrderbookEntry[];
     /**
-     * Whether market is closed
+     * Token ID for the orderbook (YES token)
      */
-    closed: boolean;
+    tokenId: string;
     /**
-     * Market deadline
+     * Adjusted midpoint price between best bid and ask
      */
-    deadline: string;
+    adjustedMidpoint: number;
     /**
-     * Condition ID
+     * Maximum allowed spread for the market
      */
-    conditionId?: string;
+    maxSpread: string;
     /**
-     * Winning outcome index (null if unresolved)
+     * Minimum order size allowed
      */
-    winningOutcomeIndex?: number | null;
+    minSize: string;
     /**
-     * Market group information
+     * Last trade price for the market
      */
-    group?: {
-        slug?: string;
-        title?: string;
-    };
+    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)
+     */
+    tradePrices?: TradePrices;
+    /**
+     * Whether market is rewardable (CLOB only)
+     */
+    isRewardable?: boolean;
+    /**
+     * Market settings (CLOB only)
+     */
+    settings?: MarketSettings;
+    /**
+     * 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.
+     */
+    venue?: Venue;
+    /**
+     * Market logo URL
+     */
+    logo?: string | null;
+    /**
+     * Price oracle metadata (oracle markets only)
      */
-    accumulativePoints?: string;
+    priceOracleMetadata?: PriceOracleMetadata;
     /**
-     * Rewards information
+     * Order within group (group markets only)
      */
-    rewards?: {
-        todaysRewards: string;
-        rewardsByEpoch: any[];
-        rewardsChartData: any[];
-        totalUnpaidRewards: string;
-        totalUserRewardsLastEpoch: string;
-    };
-}
-/**
- * Simplified position for unified view.
- *
- * @public
- */
-interface Position {
+    orderInGroup?: number;
     /**
-     * Position type
+     * Winning outcome index
      */
-    type: 'CLOB' | 'AMM';
+    winningOutcomeIndex?: number | null;
     /**
-     * Market information
+     * Outcome token names (group only)
      */
-    market: PositionMarket;
+    outcomeTokens?: string[];
     /**
-     * Position side (YES or NO)
+     * OG image URI (group only)
      */
-    side: 'YES' | 'NO';
+    ogImageURI?: string;
     /**
-     * Cost basis in USDC (6 decimals)
+     * NegRisk market ID (group only)
      */
-    costBasis: number;
+    negRiskMarketId?: string;
     /**
-     * Current market value in USDC (6 decimals)
+     * Child markets in group (group only)
      */
-    marketValue: number;
+    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;
 }
 
 /**
@@ -1540,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)
      */
@@ -1796,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>;
 }
 
 /**
@@ -1884,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)
@@ -1945,14 +1901,14 @@ interface HttpClientConfig {
  * HTTP client wrapper for Limitless Exchange API.
  *
  * @remarks
- * This class provides a centralized HTTP client with cookie management,
+ * This class provides a centralized HTTP client with API key authentication,
  * error handling, and request/response interceptors.
  *
  * @public
  */
 declare class HttpClient {
     private client;
-    private sessionCookie?;
+    private apiKey?;
     private logger;
     /**
      * Creates a new HTTP client instance.
@@ -1966,15 +1922,15 @@ declare class HttpClient {
      */
     private setupInterceptors;
     /**
-     * Sets the session cookie for authenticated requests.
+     * Sets the API key for authenticated requests.
      *
-     * @param cookie - Session cookie value
+     * @param apiKey - API key value
      */
-    setSessionCookie(cookie: string): void;
+    setApiKey(apiKey: string): void;
     /**
-     * Clears the session cookie.
+     * Clears the API key.
      */
-    clearSessionCookie(): void;
+    clearApiKey(): void;
     /**
      * Performs a GET request.
      *
@@ -1992,17 +1948,6 @@ declare class HttpClient {
      * @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.
      *
@@ -2015,213 +1960,92 @@ declare class HttpClient {
      * @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.
- * @public
+ * Market class with fluent API methods.
+ * @module types/market-class
  */
-interface AuthenticatedClientConfig {
-    /**
-     * HTTP client instance
-     */
-    httpClient: HttpClient;
-    /**
-     * Authenticator instance
-     */
-    authenticator: Authenticator;
-    /**
-     * Authentication client type ('eoa' or 'etherspot')
-     */
-    client: 'eoa' | 'etherspot';
-    /**
-     * Optional smart wallet address (required for 'etherspot')
-     */
-    smartWallet?: string;
-    /**
-     * Optional logger for debugging
-     */
-    logger?: ILogger;
-    /**
-     * Maximum retry attempts for auth errors (default: 1)
-     */
-    maxRetries?: number;
-}
+
 /**
- * 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[]>;
 }
 
 /**
@@ -2296,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.
@@ -2552,22 +2442,34 @@ declare const SIGNING_MESSAGE_TEMPLATE = "Welcome to Limitless.exchange! Please
 declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 /**
  * Contract addresses by network
+ *
+ * @remarks
+ * Note: CLOB and NegRisk exchange addresses are provided dynamically via the venue system
+ * (market.venue.exchange and market.venue.adapter). These addresses vary per market and
+ * should be fetched from the API rather than hardcoded.
+ *
  * @public
  */
 declare const CONTRACT_ADDRESSES: {
     readonly 8453: {
-        readonly CLOB: "0xa4409D988CA2218d956BeEFD3874100F444f0DC3";
-        readonly NEGRISK: "0x5a38afc17F7E97ad8d6C547ddb837E40B4aEDfC6";
+        readonly USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        readonly CTF: "0xC9c98965297Bc527861c898329Ee280632B76e18";
     };
     readonly 84532: {
-        readonly CLOB: "0x...";
-        readonly NEGRISK: "0x...";
+        readonly USDC: "0x...";
+        readonly CTF: "0x...";
     };
 };
 /**
- * Get contract address for a specific market type and chain
+ * Get contract address for tokens (USDC or CTF)
+ *
+ * @remarks
+ * For CLOB and NegRisk exchange addresses, use the venue system instead:
+ * - Fetch market via `marketFetcher.getMarket(slug)`
+ * - Use `market.venue.exchange` for signing and approvals
+ * - Use `market.venue.adapter` for NegRisk adapter approvals
  *
- * @param marketType - Market type (CLOB or NEGRISK)
+ * @param contractType - Contract type (USDC or CTF)
  * @param chainId - Chain ID (default: 8453 for Base mainnet)
  * @returns Contract address
  *
@@ -2575,7 +2477,7 @@ declare const CONTRACT_ADDRESSES: {
  *
  * @public
  */
-declare function getContractAddress(marketType: 'CLOB' | 'NEGRISK', chainId?: number): string;
+declare function getContractAddress(contractType: 'USDC' | 'CTF', chainId?: number): string;
 
 /**
  * Order builder for constructing unsigned order payloads.
@@ -2639,8 +2541,7 @@ declare class OrderBuilder {
      * const fokOrder = builder.buildOrder({
      *   tokenId: '123456',
      *   makerAmount: 50,  // 50 USDC to spend
-     *   side: Side.BUY,
-     *   marketType: MarketType.CLOB
+     *   side: Side.BUY
      * });
      *
      * // GTC order (price + size)
@@ -2648,8 +2549,7 @@ declare class OrderBuilder {
      *   tokenId: '123456',
      *   price: 0.38,
      *   size: 22.123,  // Will be rounded to tick-aligned: 22.123 shares
-     *   side: Side.BUY,
-     *   marketType: MarketType.CLOB
+     *   side: Side.BUY
      * });
      * ```
      */
@@ -2803,8 +2703,7 @@ declare class OrderSigner {
      * ```typescript
      * const signature = await signer.signOrder(unsignedOrder, {
      *   chainId: 8453,
-     *   contractAddress: '0x...',
-     *   marketType: MarketType.CLOB
+     *   contractAddress: '0x...'
      * });
      * ```
      */
@@ -2819,77 +2718,201 @@ declare class OrderSigner {
      */
     private getDomain;
     /**
-     * Gets the EIP-712 type definitions.
+     * Gets the EIP-712 type definitions.
+     *
+     * @remarks
+     * This matches the order structure expected by the Limitless Exchange
+     * smart contracts.
+     *
+     * @returns EIP-712 types definition
+     *
+     * @internal
+     */
+    private getTypes;
+}
+
+/**
+ * Order validation utilities.
+ * @module orders/validator
+ */
+
+/**
+ * Order validation error class for client-side validation.
+ * @public
+ */
+declare class OrderValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates order arguments before building.
+ *
+ * @param args - Order arguments to validate (FOK or GTC)
+ * @throws OrderValidationError if validation fails
+ *
+ * @public
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateOrderArgs(orderArgs);
+ * } catch (error) {
+ *   console.error('Validation failed:', error.message);
+ * }
+ * ```
+ */
+declare function validateOrderArgs(args: OrderArgs): void;
+/**
+ * Validates an unsigned order.
+ *
+ * @param order - Unsigned order to validate
+ * @throws OrderValidationError if validation fails
+ *
+ * @public
+ *
+ * @example
+ * ```typescript
+ * validateUnsignedOrder(unsignedOrder);
+ * ```
+ */
+declare function validateUnsignedOrder(order: UnsignedOrder): void;
+/**
+ * Validates a signed order.
+ *
+ * @param order - Signed order to validate
+ * @throws OrderValidationError if validation fails
+ *
+ * @public
+ *
+ * @example
+ * ```typescript
+ * validateSignedOrder(signedOrder);
+ * ```
+ */
+declare function validateSignedOrder(order: SignedOrder): void;
+
+/**
+ * Market data fetcher for Limitless Exchange.
+ * @module markets/fetcher
+ */
+
+/**
+ * Market data fetcher for retrieving market information and orderbooks.
+ *
+ * @remarks
+ * This class provides methods to fetch market data, orderbooks, and prices
+ * from the Limitless Exchange API.
+ *
+ * Venue caching: When fetching market data, venue information is automatically
+ * cached for efficient order signing. This eliminates redundant API calls when
+ * creating orders for the same market.
+ *
+ * @public
+ */
+declare class MarketFetcher {
+    private httpClient;
+    private logger;
+    private venueCache;
+    /**
+     * Creates a new market fetcher instance.
+     *
+     * @param httpClient - HTTP client for API requests
+     * @param logger - Optional logger for debugging (default: no logging)
+     *
+     * @example
+     * ```typescript
+     * const fetcher = new MarketFetcher(httpClient);
+     * ```
+     */
+    constructor(httpClient: HttpClient, logger?: ILogger);
+    /**
+     * Gets active markets with query parameters and pagination support.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @returns Promise resolving to active markets response
+     * @throws Error if API request fails
+     *
+     * @example
+     * ```typescript
+     * // Get 8 markets sorted by LP rewards
+     * const response = await fetcher.getActiveMarkets({
+     *   limit: 8,
+     *   sortBy: 'lp_rewards'
+     * });
+     * console.log(`Found ${response.data.length} of ${response.totalMarketsCount} markets`);
+     *
+     * // Get page 2
+     * const page2 = await fetcher.getActiveMarkets({
+     *   limit: 8,
+     *   page: 2,
+     *   sortBy: 'ending_soon'
+     * });
+     * ```
+     */
+    getActiveMarkets(params?: ActiveMarketsParams): Promise<ActiveMarketsResponse>;
+    /**
+     * Gets a single market by slug.
+     *
+     * @remarks
+     * Automatically caches venue information for efficient order signing.
+     * Always call this method before creating orders to ensure venue data
+     * is available and avoid additional API requests.
+     *
+     * @param slug - Market slug identifier
+     * @returns Promise resolving to market details
+     * @throws Error if API request fails or market not found
+     *
+     * @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',
+     *   ...
+     * });
+     * ```
+     */
+    getMarket(slug: string): Promise<Market>;
+    /**
+     * Gets cached venue information for a market.
      *
      * @remarks
-     * This matches the order structure expected by the Limitless Exchange
-     * smart contracts.
+     * Returns venue data previously cached by getMarket() call.
+     * Used internally by OrderClient for efficient order signing.
      *
-     * @returns EIP-712 types definition
+     * @param slug - Market slug identifier
+     * @returns Cached venue information, or undefined if not in cache
      *
-     * @internal
+     * @example
+     * ```typescript
+     * const venue = fetcher.getVenue('bitcoin-price-2024');
+     * if (venue) {
+     *   console.log(`Exchange: ${venue.exchange}`);
+     * }
+     * ```
      */
-    private getTypes;
-}
-
-/**
- * Order validation utilities.
- * @module orders/validator
- */
-
-/**
- * Validation error class.
- * @public
- */
-declare class ValidationError extends Error {
-    constructor(message: string);
+    getVenue(slug: string): Venue | undefined;
+    /**
+     * Gets the orderbook for a CLOB market.
+     *
+     * @param slug - Market slug identifier
+     * @returns Promise resolving to orderbook data
+     * @throws Error if API request fails
+     *
+     * @example
+     * ```typescript
+     * const orderbook = await fetcher.getOrderBook('bitcoin-price-2024');
+     * console.log(`Bids: ${orderbook.bids.length}, Asks: ${orderbook.asks.length}`);
+     * ```
+     */
+    getOrderBook(slug: string): Promise<OrderBook>;
 }
-/**
- * Validates order arguments before building.
- *
- * @param args - Order arguments to validate (FOK or GTC)
- * @throws ValidationError if validation fails
- *
- * @public
- *
- * @example
- * ```typescript
- * try {
- *   validateOrderArgs(orderArgs);
- * } catch (error) {
- *   console.error('Validation failed:', error.message);
- * }
- * ```
- */
-declare function validateOrderArgs(args: OrderArgs): void;
-/**
- * Validates an unsigned order.
- *
- * @param order - Unsigned order to validate
- * @throws ValidationError if validation fails
- *
- * @public
- *
- * @example
- * ```typescript
- * validateUnsignedOrder(unsignedOrder);
- * ```
- */
-declare function validateUnsignedOrder(order: UnsignedOrder): void;
-/**
- * Validates a signed order.
- *
- * @param order - Signed order to validate
- * @throws ValidationError if validation fails
- *
- * @public
- *
- * @example
- * ```typescript
- * validateSignedOrder(signedOrder);
- * ```
- */
-declare function validateSignedOrder(order: SignedOrder): void;
 
 /**
  * Order client for managing orders on Limitless Exchange.
@@ -2900,51 +2923,59 @@ declare function validateSignedOrder(order: SignedOrder): void;
  * Configuration for the order client.
  *
  * @remarks
- * The order client supports two configuration modes:
- * 1. Simple mode: Provide userData and marketType (auto-configures signing)
- * 2. Advanced mode: Provide userData and custom signingConfig
+ * The order client auto-configures signing based on venue data from the API.
+ * 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.
  *
  * @public
  */
 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
+     * Custom signing configuration (optional)
      *
-     * @example
-     * ```typescript
-     * {
-     *   userId: 123,      // From auth result
-     *   feeRateBps: 300   // User's fee rate (3%)
-     * }
-     * ```
+     * @remarks
+     * If not provided, SDK will auto-configure from venue data.
+     * Useful for custom deployments or testing.
      */
-    userData: UserData;
+    signingConfig?: OrderSigningConfig;
     /**
-     * Market type for auto-configuration (optional if signingConfig provided)
+     * Shared MarketFetcher instance for venue caching (optional)
      *
      * @remarks
-     * When provided without signingConfig, automatically loads contract address
-     * from environment variables or SDK defaults.
+     * When provided, enables efficient venue caching across market fetches and order creation.
+     * If not provided, OrderClient creates its own internal MarketFetcher instance.
      *
-     * @defaultValue MarketType.CLOB
-     */
-    marketType?: MarketType;
-    /**
-     * Custom signing configuration (optional)
+     * Best practice: Share the same MarketFetcher instance between market operations
+     * and order creation for optimal performance.
      *
-     * @remarks
-     * If not provided, SDK will auto-configure based on marketType.
-     * Useful for custom deployments or testing.
+     * @example
+     * ```typescript
+     * const marketFetcher = new MarketFetcher(httpClient);
+     * const orderClient = new OrderClient({
+     *   httpClient,
+     *   wallet,
+     *   marketFetcher  // Shared instance
+     * });
+     *
+     * // Venue is cached
+     * await marketFetcher.getMarket('bitcoin-2024');
+     *
+     * // Uses cached venue, no extra API call
+     * await orderClient.createOrder({ marketSlug: 'bitcoin-2024', ... });
+     * ```
      */
-    signingConfig?: OrderSigningConfig;
+    marketFetcher?: MarketFetcher;
     /**
      * Optional logger
      */
@@ -2957,20 +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,
- *   ownerId: 123,
- *   feeRateBps: 100,
- *   signingConfig: {
- *     chainId: 8453,
- *     contractAddress: '0x...',
- *     marketType: MarketType.CLOB
- *   }
+ *   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,
@@ -2985,42 +3019,57 @@ interface OrderClientConfig {
  */
 declare class OrderClient {
     private httpClient;
-    private orderBuilder;
+    private wallet;
+    private orderBuilder?;
     private orderSigner;
-    private ownerId;
+    private marketFetcher;
+    private cachedUserData?;
     private signingConfig;
     private logger;
     /**
      * Creates a new order client instance.
      *
      * @param config - Order client configuration
-     *
-     * @throws Error if neither marketType nor signingConfig is provided
      */
     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.
      *
      * @remarks
      * This method handles the complete order creation flow:
-     * 1. Build unsigned order
-     * 2. Sign with EIP-712
-     * 3. Submit to API
+     * 1. Resolve venue address (from cache or API)
+     * 2. Build unsigned order
+     * 3. Sign with EIP-712 using venue.exchange as verifyingContract
+     * 4. Submit to API
+     *
+     * Performance best practice: Always call marketFetcher.getMarket(marketSlug)
+     * before createOrder() to cache venue data and avoid additional API requests.
      *
      * @param params - Order parameters
      * @returns Promise resolving to order response
      *
-     * @throws Error if order creation fails
+     * @throws Error if order creation fails or venue not found
      *
      * @example
      * ```typescript
+     * // Best practice: fetch market first to cache venue
+     * const market = await marketFetcher.getMarket('bitcoin-2024');
+     *
      * const order = await orderClient.createOrder({
-     *   tokenId: '123456',
+     *   tokenId: market.tokens.yes,
      *   price: 0.65,
      *   size: 100,
      *   side: Side.BUY,
      *   orderType: OrderType.GTC,
-     *   marketSlug: 'market-slug'
+     *   marketSlug: 'bitcoin-2024'
      * });
      *
      * console.log(`Order created: ${order.order.id}`);
@@ -3073,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.
      *
@@ -3100,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,
@@ -3112,7 +3142,7 @@ declare class OrderClient {
      * });
      * ```
      */
-    buildUnsignedOrder(params: OrderArgs): UnsignedOrder;
+    buildUnsignedOrder(params: OrderArgs): Promise<UnsignedOrder>;
     /**
      * Signs an unsigned order without submitting.
      *
@@ -3129,104 +3159,32 @@ declare class OrderClient {
      * ```
      */
     signOrder(order: UnsignedOrder): Promise<string>;
-}
-
-/**
- * Market data fetcher for Limitless Exchange.
- * @module markets/fetcher
- */
-
-/**
- * Market data fetcher for retrieving market information and orderbooks.
- *
- * @remarks
- * This class provides methods to fetch market data, orderbooks, and prices
- * from the Limitless Exchange API.
- *
- * @public
- */
-declare class MarketFetcher {
-    private httpClient;
-    private logger;
-    /**
-     * Creates a new market fetcher instance.
-     *
-     * @param httpClient - HTTP client for API requests
-     * @param logger - Optional logger for debugging (default: no logging)
-     *
-     * @example
-     * ```typescript
-     * const fetcher = new MarketFetcher(httpClient);
-     * ```
-     */
-    constructor(httpClient: HttpClient, logger?: ILogger);
-    /**
-     * Gets active markets with query parameters and pagination support.
-     *
-     * @param params - Query parameters for filtering and pagination
-     * @returns Promise resolving to active markets response
-     * @throws Error if API request fails
-     *
-     * @example
-     * ```typescript
-     * // Get 8 markets sorted by LP rewards
-     * const response = await fetcher.getActiveMarkets({
-     *   limit: 8,
-     *   sortBy: 'lp_rewards'
-     * });
-     * console.log(`Found ${response.data.length} of ${response.totalMarketsCount} markets`);
-     *
-     * // Get page 2
-     * const page2 = await fetcher.getActiveMarkets({
-     *   limit: 8,
-     *   page: 2,
-     *   sortBy: 'ending_soon'
-     * });
-     * ```
-     */
-    getActiveMarkets(params?: ActiveMarketsParams): Promise<ActiveMarketsResponse>;
-    /**
-     * Gets a single market by slug.
-     *
-     * @param slug - Market slug identifier
-     * @returns Promise resolving to market details
-     * @throws Error if API request fails or market not found
-     *
-     * @example
-     * ```typescript
-     * const market = await fetcher.getMarket('bitcoin-price-2024');
-     * console.log(`Market: ${market.title}`);
-     * ```
-     */
-    getMarket(slug: string): Promise<Market>;
     /**
-     * Gets the orderbook for a CLOB market.
+     * Gets the wallet address.
      *
-     * @param slug - Market slug identifier
-     * @returns Promise resolving to orderbook data
-     * @throws Error if API request fails
+     * @returns Ethereum address of the wallet
      *
      * @example
      * ```typescript
-     * const orderbook = await fetcher.getOrderBook('bitcoin-price-2024');
-     * console.log(`Bids: ${orderbook.bids.length}, Asks: ${orderbook.asks.length}`);
+     * const address = orderClient.walletAddress;
+     * console.log(`Wallet: ${address}`);
      * ```
      */
-    getOrderBook(slug: string): Promise<OrderBook>;
+    get walletAddress(): string;
     /**
-     * Gets the current price for a token.
+     * Gets the owner ID (user ID from profile).
      *
-     * @param tokenId - Token ID
-     * @returns Promise resolving to price information
-     * @throws Error if API request fails
+     * @returns Owner ID from user profile, or undefined if not yet loaded
      *
      * @example
      * ```typescript
-     * const price = await fetcher.getPrice('123456');
-     * console.log(`Current price: ${price.price}`);
+     * const ownerId = orderClient.ownerId;
+     * if (ownerId) {
+     *   console.log(`Owner ID: ${ownerId}`);
+     * }
      * ```
      */
-    getPrice(tokenId: string): Promise<MarketPrice>;
+    get ownerId(): number | undefined;
 }
 
 /**
@@ -3263,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.
      *
@@ -3309,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>;
 }
 
 /**
@@ -3382,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
@@ -3430,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.
      *
@@ -3451,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');
@@ -3484,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>;
@@ -3519,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
@@ -3550,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, MarketType, 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, 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 };