@limitless-exchange/sdk 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -30,26 +30,138 @@ interface SignatureHeaders {
     'x-signature': string;
 }
 /**
- * User profile information returned after authentication.
+ * User rank information.
+ * @public
+ */
+interface UserRank {
+    /**
+     * Rank ID
+     */
+    id: number;
+    /**
+     * Rank name
+     */
+    name: string;
+    /**
+     * Fee rate in basis points
+     */
+    feeRateBps: number;
+}
+/**
+ * Referral data for a user.
+ * @public
+ */
+interface ReferralData {
+    /**
+     * Referral creation timestamp
+     */
+    createdAt: string;
+    /**
+     * Referral ID
+     */
+    id: number;
+    /**
+     * Referred user's profile ID
+     */
+    referredProfileId: number;
+    /**
+     * Profile picture URL
+     */
+    pfpUrl: string | null;
+    /**
+     * Display name
+     */
+    displayName: string;
+}
+/**
+ * User profile information returned after authentication (1:1 with API response).
  * @public
  */
 interface UserProfile {
+    /**
+     * User ID (used as ownerId for orders)
+     */
+    id: number;
     /**
      * User's Ethereum address (EOA)
      */
     account: string;
+    /**
+     * Client type used for authentication
+     */
+    client: ClientType;
+    /**
+     * User rank information containing feeRateBps
+     */
+    rank?: UserRank;
+    /**
+     * Account creation timestamp
+     */
+    createdAt?: string;
+    /**
+     * Username
+     */
+    username?: string;
     /**
      * Display name for the user
      */
-    displayName: string;
+    displayName?: string;
+    /**
+     * Profile picture URL
+     */
+    pfpUrl?: string;
+    /**
+     * User bio
+     */
+    bio?: string;
+    /**
+     * Social media URL
+     */
+    socialUrl?: string;
     /**
      * Smart wallet address (optional, required for ETHERSPOT client)
      */
     smartWallet?: string;
     /**
-     * Client type used for authentication
+     * Trade wallet option
      */
-    client: ClientType;
+    tradeWalletOption?: string;
+    /**
+     * Embedded account address
+     */
+    embeddedAccount?: string;
+    /**
+     * Total points
+     */
+    points?: number;
+    /**
+     * Accumulative points
+     */
+    accumulativePoints?: number;
+    /**
+     * Whether enrolled in points program
+     */
+    enrolledInPointsProgram?: boolean;
+    /**
+     * Position on leaderboard
+     */
+    leaderboardPosition?: number;
+    /**
+     * Whether user is in top 100
+     */
+    isTop100?: boolean;
+    /**
+     * Whether user is a captain
+     */
+    isCaptain?: boolean;
+    /**
+     * List of referral information
+     */
+    referralData?: ReferralData[];
+    /**
+     * Count of referred users
+     */
+    referredUsersCount?: number;
 }
 /**
  * Mode information from authentication response.
@@ -197,14 +309,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
@@ -230,11 +334,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'
@@ -572,48 +671,186 @@ 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
  */
+/**
+ * Collateral token information.
+ * @public
+ */
+interface CollateralToken {
+    /**
+     * Token contract address
+     */
+    address: string;
+    /**
+     * Token decimals
+     */
+    decimals: number;
+    /**
+     * Token symbol (e.g., "USDC")
+     */
+    symbol: string;
+}
+/**
+ * Market creator information.
+ * @public
+ */
+interface MarketCreator {
+    /**
+     * Creator name
+     */
+    name: string;
+    /**
+     * Creator image URL
+     */
+    imageURI?: string;
+    /**
+     * Creator link URL
+     */
+    link?: string;
+}
+/**
+ * Market metadata.
+ * @public
+ */
+interface MarketMetadata {
+    /**
+     * Fee enabled flag
+     */
+    fee: boolean;
+    /**
+     * Banner flag
+     */
+    isBannered?: boolean;
+    /**
+     * Polymarket arbitrage flag
+     */
+    isPolyArbitrage?: boolean;
+    /**
+     * Market making flag
+     */
+    shouldMarketMake?: boolean;
+    /**
+     * Opening price for oracle markets
+     */
+    openPrice?: string;
+}
+/**
+ * Market settings for CLOB markets.
+ * @public
+ */
+interface MarketSettings {
+    /**
+     * Minimum order size
+     */
+    minSize: string;
+    /**
+     * Maximum spread allowed
+     */
+    maxSpread: number;
+    /**
+     * Daily reward amount
+     */
+    dailyReward: string;
+    /**
+     * Rewards epoch duration
+     */
+    rewardsEpoch: string;
+    /**
+     * Constant parameter
+     */
+    c: string;
+}
+/**
+ * Trade prices for different order types.
+ * @public
+ */
+interface TradePrices {
+    /**
+     * Buy prices (market and limit) for yes/no tokens
+     */
+    buy: {
+        market: [number, number];
+        limit: [number, number];
+    };
+    /**
+     * Sell prices (market and limit) for yes/no tokens
+     */
+    sell: {
+        market: [number, number];
+        limit: [number, number];
+    };
+}
+/**
+ * Price oracle metadata for oracle-based markets.
+ * @public
+ */
+interface PriceOracleMetadata {
+    /**
+     * Asset ticker symbol
+     */
+    ticker: string;
+    /**
+     * Asset type (e.g., "CRYPTO")
+     */
+    assetType: string;
+    /**
+     * Pyth Network price feed address
+     */
+    pythAddress: string;
+    /**
+     * Price feed symbol
+     */
+    symbol: string;
+    /**
+     * Asset name
+     */
+    name: string;
+    /**
+     * Logo URL
+     */
+    logo: string;
+}
 /**
  * Orderbook entry (bid or ask).
+ * Matches API response format exactly (1:1 parity).
+ *
  * @public
  */
 interface OrderbookEntry {
     /**
-     * Price per share
+     * Price per share (0-1 range)
      */
     price: number;
     /**
-     * Size in shares (scaled by 1e6)
+     * Size in shares
      */
     size: number;
     /**
-     * Order side (BUY or SELL)
+     * Order side ("BUY" or "SELL")
      */
     side: string;
 }
 /**
  * Complete orderbook for a market.
+ * Matches API response format exactly (1:1 parity).
+ *
  * @public
  */
 interface OrderBook {
     /**
-     * Bid orders (buy orders)
+     * Bid orders (buy orders) sorted by price descending
      */
     bids: OrderbookEntry[];
     /**
-     * Ask orders (sell orders)
+     * Ask orders (sell orders) sorted by price ascending
      */
     asks: OrderbookEntry[];
     /**
@@ -621,13 +858,21 @@ interface OrderBook {
      */
     tokenId: string;
     /**
-     * Minimum order size
+     * Adjusted midpoint price between best bid and ask
+     */
+    adjustedMidpoint: number;
+    /**
+     * Maximum allowed spread for the market
+     */
+    maxSpread: string;
+    /**
+     * Minimum order size allowed
      */
     minSize: string;
     /**
-     * Last trade price
+     * Last trade price for the market
      */
-    lastTradePrice?: number;
+    lastTradePrice: number;
 }
 /**
  * Market price information.
@@ -670,7 +915,46 @@ interface MarketOutcome {
     price?: number;
 }
 /**
- * Complete market information.
+ * 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 {
+    /**
+     * 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.
+     */
+    exchange: string;
+    /**
+     * 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;
+}
+/**
+ * Complete market information (1:1 with API response).
+ * Handles both CLOB single markets and NegRisk group markets.
+ *
  * @public
  */
 interface Market {
@@ -679,9 +963,9 @@ interface Market {
      */
     id: number;
     /**
-     * Market contract address
+     * Market slug identifier
      */
-    address: string | null;
+    slug: string;
     /**
      * Market title
      */
@@ -693,19 +977,23 @@ interface Market {
     /**
      * Market description
      */
-    description: string;
+    description?: string;
     /**
-     * Market slug identifier
+     * Collateral token information
      */
-    slug: string;
+    collateralToken: CollateralToken;
     /**
-     * Market type (CLOB or AMM)
+     * Human-readable expiration date
      */
-    type?: string;
+    expirationDate: string;
     /**
-     * Market outcomes
+     * Expiration timestamp in milliseconds
      */
-    outcomes?: MarketOutcome[];
+    expirationTimestamp: number;
+    /**
+     * Whether market is expired
+     */
+    expired?: boolean;
     /**
      * Creation timestamp
      */
@@ -714,12 +1002,144 @@ interface Market {
      * Last update timestamp
      */
     updatedAt: string;
+    /**
+     * Market categories
+     */
+    categories: string[];
     /**
      * Market status
      */
-    status?: string;
+    status: string;
+    /**
+     * Creator information
+     */
+    creator: MarketCreator;
+    /**
+     * Market tags
+     */
+    tags: string[];
+    /**
+     * Trade type (clob or amm)
+     */
+    tradeType: string;
+    /**
+     * Market type (single or group)
+     */
+    marketType: string;
+    /**
+     * Priority index for sorting
+     */
+    priorityIndex: number;
+    /**
+     * Market metadata
+     */
+    metadata: MarketMetadata;
+    /**
+     * Trading volume
+     */
+    volume?: string;
+    /**
+     * Formatted trading volume
+     */
+    volumeFormatted?: string;
+    /**
+     * Condition ID (CLOB only)
+     */
+    conditionId?: string;
+    /**
+     * NegRisk request ID (CLOB only)
+     */
+    negRiskRequestId?: string | null;
+    /**
+     * Token IDs for yes/no outcomes (CLOB only)
+     * @example
+     * {
+     *   yes: "27687694610130623013351012526567944730242898906227824547270172934678693687246",
+     *   no: "9288900480010863316984252765488448624297561656655547117581633191173128271467"
+     * }
+     */
+    tokens?: MarketTokens;
+    /**
+     * Current prices [yes, no] (CLOB only)
+     */
+    prices?: number[];
+    /**
+     * 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)
+     */
+    priceOracleMetadata?: PriceOracleMetadata;
+    /**
+     * Order within group (group markets only)
+     */
+    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[];
+    /**
+     * Daily reward for group (group only)
+     */
+    dailyReward?: string;
+    /**
+     * Market contract address
+     * @deprecated Use conditionId instead
+     */
+    address?: string | null;
+    /**
+     * Market type (CLOB or AMM)
+     * @deprecated Use tradeType instead
+     */
+    type?: string;
+    /**
+     * Market outcomes
+     * @deprecated Use tokens for CLOB markets
+     */
+    outcomes?: MarketOutcome[];
     /**
      * Resolution timestamp
+     * @deprecated Use expirationTimestamp instead
      */
     resolutionDate?: string;
 }
@@ -749,7 +1169,7 @@ interface MarketsResponse {
  * Sort options for active markets.
  * @public
  */
-type ActiveMarketsSortBy = 'lp_rewards' | 'ending_soon' | 'newest' | 'high_value';
+type ActiveMarketsSortBy = 'lp_rewards' | 'ending_soon' | 'newest' | 'high_value' | 'liquidity';
 /**
  * Query parameters for active markets endpoint.
  * @public
@@ -1132,6 +1552,7 @@ interface PortfolioSummary {
  * WebSocket types for real-time data streaming.
  * @module types/websocket
  */
+
 /**
  * WebSocket connection configuration.
  * @public
@@ -1177,22 +1598,36 @@ declare enum WebSocketState {
  * Subscription channels for WebSocket events.
  * @public
  */
-type SubscriptionChannel = 'orderbook' | 'trades' | 'orders' | 'fills' | 'markets' | 'prices';
+type SubscriptionChannel = 'orderbook' | 'trades' | 'orders' | 'fills' | 'markets' | 'prices' | 'subscribe_market_prices' | 'subscribe_positions' | 'subscribe_transactions';
+/**
+ * Orderbook data structure (nested object in OrderbookUpdate).
+ * @public
+ */
+interface OrderbookData {
+    /** List of bid orders sorted by price descending */
+    bids: OrderbookEntry[];
+    /** List of ask orders sorted by price ascending */
+    asks: OrderbookEntry[];
+    /** Token ID for the orderbook */
+    tokenId: string;
+    /** Adjusted midpoint price */
+    adjustedMidpoint: number;
+    /** Maximum spread allowed */
+    maxSpread: number;
+    /** Minimum order size */
+    minSize: number;
+}
 /**
- * Orderbook update event.
+ * Orderbook update event - matches API format exactly.
  * @public
  */
 interface OrderbookUpdate {
+    /** Market slug identifier (camelCase to match API) */
     marketSlug: string;
-    bids: Array<{
-        price: number;
-        size: number;
-    }>;
-    asks: Array<{
-        price: number;
-        size: number;
-    }>;
-    timestamp: number;
+    /** Nested orderbook data object */
+    orderbook: OrderbookData;
+    /** Timestamp as Date or number after serialization */
+    timestamp: Date | number | string;
 }
 /**
  * Trade event.
@@ -1245,14 +1680,79 @@ interface MarketUpdate {
     timestamp: number;
 }
 /**
- * Price update event.
+ * Price update event (deprecated - use NewPriceData for AMM prices).
+ *
+ * Note: This type does not match the actual API response.
+ * Use NewPriceData for the correct AMM price update format.
+ *
  * @public
+ * @deprecated
  */
 interface PriceUpdate {
     marketSlug: string;
     price: number;
     timestamp: number;
 }
+/**
+ * Single AMM price entry in updatedPrices array.
+ * @public
+ */
+interface AmmPriceEntry {
+    /** Market ID */
+    marketId: number;
+    /** Market contract address */
+    marketAddress: string;
+    /** YES token price (0-1 range) */
+    yesPrice: number;
+    /** NO token price (0-1 range) */
+    noPrice: number;
+}
+/**
+ * AMM price update event (newPriceData) - matches API format exactly.
+ * @public
+ */
+interface NewPriceData {
+    /** Market contract address (camelCase to match API) */
+    marketAddress: string;
+    /** Array of price updates for this market */
+    updatedPrices: AmmPriceEntry[];
+    /** Blockchain block number */
+    blockNumber: number;
+    /** Timestamp as Date or number after serialization */
+    timestamp: Date | number | string;
+}
+/**
+ * Transaction event (blockchain transaction status).
+ * @public
+ */
+interface TransactionEvent {
+    /** User ID (optional) */
+    userId?: number;
+    /** Transaction hash (optional) */
+    txHash?: string;
+    /** Transaction status */
+    status: 'CONFIRMED' | 'FAILED';
+    /** Transaction source */
+    source: string;
+    /** Transaction timestamp */
+    timestamp: Date | string;
+    /** Market address (optional) */
+    marketAddress?: string;
+    /** Market slug identifier (optional) */
+    marketSlug?: string;
+    /** Token ID (optional) */
+    tokenId?: string;
+    /** Condition ID (optional) */
+    conditionId?: string;
+    /** Amount of contracts (optional, in string format) */
+    amountContracts?: string;
+    /** Amount of collateral (optional, in string format) */
+    amountCollateral?: string;
+    /** Price (optional, in string format) */
+    price?: string;
+    /** Trade side (optional) */
+    side?: 'BUY' | 'SELL';
+}
 /**
  * WebSocket event types.
  * @public
@@ -1275,9 +1775,13 @@ interface WebSocketEvents {
      */
     reconnecting: (attempt: number) => void;
     /**
-     * Orderbook updates
+     * Orderbook updates (CLOB markets) - API event name: orderbookUpdate
+     */
+    orderbookUpdate: (data: OrderbookUpdate) => void;
+    /**
+     * AMM price updates - API event name: newPriceData
      */
-    orderbook: (data: OrderbookUpdate) => void;
+    newPriceData: (data: NewPriceData) => void;
     /**
      * Trade events
      */
@@ -1295,7 +1799,16 @@ interface WebSocketEvents {
      */
     market: (data: MarketUpdate) => void;
     /**
-     * Price updates
+     * Position updates
+     */
+    positions: (data: any) => void;
+    /**
+     * Transaction events (blockchain confirmations)
+     */
+    tx: (data: TransactionEvent) => void;
+    /**
+     * Price updates (deprecated - use newPriceData)
+     * @deprecated
      */
     price: (data: PriceUpdate) => void;
 }
@@ -1392,16 +1905,64 @@ interface HttpClientConfig {
      * Request timeout in milliseconds
      * @defaultValue 30000
      */
-    timeout?: number;
+    timeout?: number;
+    /**
+     * Session cookie for authenticated requests
+     */
+    sessionCookie?: string;
+    /**
+     * Optional logger for debugging
+     * @defaultValue NoOpLogger (no logging)
+     */
+    logger?: ILogger;
+    /**
+     * Enable HTTP connection pooling with keepAlive
+     * @defaultValue true
+     * @remarks
+     * When enabled, HTTP connections are reused across requests, reducing latency by 30-50%.
+     * Recommended for production environments with high request volume.
+     */
+    keepAlive?: boolean;
+    /**
+     * Maximum number of sockets to allow per host
+     * @defaultValue 50
+     * @remarks
+     * Controls the connection pool size. Higher values allow more concurrent requests
+     * but consume more system resources.
+     */
+    maxSockets?: number;
+    /**
+     * Maximum number of free sockets to keep open per host
+     * @defaultValue 10
+     * @remarks
+     * Determines how many idle connections to maintain in the pool.
+     * Keeping connections open reduces latency for subsequent requests.
+     */
+    maxFreeSockets?: number;
     /**
-     * Session cookie for authenticated requests
+     * Socket timeout in milliseconds
+     * @defaultValue 60000
+     * @remarks
+     * Time to wait before closing an idle socket connection.
      */
-    sessionCookie?: string;
+    socketTimeout?: number;
     /**
-     * Optional logger for debugging
-     * @defaultValue NoOpLogger (no logging)
+     * Additional headers to include in all requests
+     * @remarks
+     * These headers will be merged with default headers and sent with every request.
+     * Can be overridden by per-request headers.
+     *
+     * @example
+     * ```typescript
+     * const client = new HttpClient({
+     *   additionalHeaders: {
+     *     'X-Custom-Header': 'value',
+     *     'X-API-Version': 'v1'
+     *   }
+     * });
+     * ```
      */
-    logger?: ILogger;
+    additionalHeaders?: Record<string, string>;
 }
 /**
  * HTTP client wrapper for Limitless Exchange API.
@@ -2014,22 +2575,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
  *
@@ -2037,7 +2610,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.
@@ -2101,8 +2674,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)
@@ -2110,8 +2682,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
      * });
      * ```
      */
@@ -2265,8 +2836,7 @@ declare class OrderSigner {
      * ```typescript
      * const signature = await signer.signOrder(unsignedOrder, {
      *   chainId: 8453,
-     *   contractAddress: '0x...',
-     *   marketType: MarketType.CLOB
+     *   contractAddress: '0x...'
      * });
      * ```
      */
@@ -2353,6 +2923,139 @@ declare function validateUnsignedOrder(order: UnsignedOrder): void;
  */
 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
+     * const market = await fetcher.getMarket('bitcoin-price-2024');
+     * console.log(`Market: ${market.title}`);
+     *
+     * // 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
+     * Returns venue data previously cached by getMarket() call.
+     * Used internally by OrderClient for efficient order signing.
+     *
+     * @param slug - Market slug identifier
+     * @returns Cached venue information, or undefined if not in cache
+     *
+     * @example
+     * ```typescript
+     * const venue = fetcher.getVenue('bitcoin-price-2024');
+     * if (venue) {
+     *   console.log(`Exchange: ${venue.exchange}`);
+     * }
+     * ```
+     */
+    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>;
+    /**
+     * 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>;
+}
+
 /**
  * Order client for managing orders on Limitless Exchange.
  * @module orders/client
@@ -2362,9 +3065,11 @@ 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.
+ * Custom signingConfig is optional for advanced use cases.
+ *
+ * Performance tip: Provide a shared marketFetcher instance to enable venue caching
+ * across market fetches and order creation, avoiding redundant API calls.
  *
  * @public
  */
@@ -2390,23 +3095,41 @@ interface OrderClientConfig {
      */
     userData: UserData;
     /**
-     * Market type for auto-configuration (optional if signingConfig provided)
+     * Custom signing configuration (optional)
      *
      * @remarks
-     * When provided without signingConfig, automatically loads contract address
-     * from environment variables or SDK defaults.
-     *
-     * @defaultValue MarketType.CLOB
+     * If not provided, SDK will auto-configure from venue data.
+     * Useful for custom deployments or testing.
      */
-    marketType?: MarketType;
+    signingConfig?: OrderSigningConfig;
     /**
-     * Custom signing configuration (optional)
+     * Shared MarketFetcher instance for venue caching (optional)
      *
      * @remarks
-     * If not provided, SDK will auto-configure based on marketType.
-     * Useful for custom deployments or testing.
+     * When provided, enables efficient venue caching across market fetches and order creation.
+     * If not provided, OrderClient creates its own internal MarketFetcher instance.
+     *
+     * Best practice: Share the same MarketFetcher instance between market operations
+     * and order creation for optimal performance.
+     *
+     * @example
+     * ```typescript
+     * const marketFetcher = new MarketFetcher(httpClient);
+     * const orderClient = new OrderClient({
+     *   httpClient,
+     *   wallet,
+     *   userData,
+     *   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
      */
@@ -2419,17 +3142,21 @@ interface OrderClientConfig {
  * This class provides high-level methods for order operations,
  * abstracting away HTTP details and order signing complexity.
  *
+ * 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
  * const orderClient = new OrderClient({
  *   httpClient,
  *   wallet,
- *   ownerId: 123,
- *   feeRateBps: 100,
+ *   userData: {
+ *     userId: 123,
+ *     feeRateBps: 100
+ *   },
  *   signingConfig: {
  *     chainId: 8453,
- *     contractAddress: '0x...',
- *     marketType: MarketType.CLOB
+ *     contractAddress: '0x...'
  *   }
  * });
  *
@@ -2449,6 +3176,7 @@ declare class OrderClient {
     private httpClient;
     private orderBuilder;
     private orderSigner;
+    private marketFetcher;
     private ownerId;
     private signingConfig;
     private logger;
@@ -2456,8 +3184,6 @@ declare class OrderClient {
      * Creates a new order client instance.
      *
      * @param config - Order client configuration
-     *
-     * @throws Error if neither marketType nor signingConfig is provided
      */
     constructor(config: OrderClientConfig);
     /**
@@ -2465,24 +3191,31 @@ declare class OrderClient {
      *
      * @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}`);
@@ -2593,104 +3326,6 @@ 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.
-     *
-     * @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>;
-    /**
-     * 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>;
-}
-
 /**
  * Portfolio data fetcher for Limitless Exchange.
  * @module portfolio/fetcher
@@ -3012,4 +3647,4 @@ declare class WebSocketClient {
     private getChannelFromKey;
 }
 
-export { type AMMPosition, APIError, type ActiveMarketsParams, type ActiveMarketsResponse, type ActiveMarketsSortBy, type AuthResult, AuthenticatedClient, type AuthenticatedClientConfig, Authenticator, BASE_SEPOLIA_CHAIN_ID, type BaseOrderArgs, type CLOBPosition, CONTRACT_ADDRESSES, type ClientType, 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, MarketFetcher, type MarketOutcome, type MarketPrice, MarketType, type MarketUpdate, type MarketsResponse, MessageSigner, type ModeInfo, type NewOrderPayload, NoOpLogger, type OrderArgs, type OrderBook, OrderBuilder, OrderClient, type OrderClientConfig, type OrderMatch, type OrderResponse, OrderSigner, type OrderSigningConfig, OrderType, type OrderUpdate, type OrderbookEntry, type OrderbookUpdate, PortfolioFetcher, type PortfolioPositionsResponse, type PortfolioSummary, type Position, type PositionMarket, type PositionSide, type PriceUpdate, RetryConfig, type RetryConfigOptions, RetryableClient, SIGNING_MESSAGE_TEMPLATE, Side, type SignatureHeaders, SignatureType, type SignedOrder, type SubscriptionChannel, type SubscriptionOptions, type TokenBalance, type TradeEvent, type TradingMode, type UnsignedOrder, type UserData, type UserProfile, 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, 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 };