fix: typed FetchOrderBookParams for OpenAPI docs generation

Replace Record<string, any> with FetchOrderBookParams interface
so the OpenAPI generator can enumerate side, since, until params
in the auto-generated docs.

Author: realfishsam

changelog.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.43.2] - 2026-05-22
+
+### Fixed
+
+- **Docs**: `fetchOrderBook` params (`side`, `since`, `until`) now appear in auto-generated API docs. Replaced `Record<string, any>` with typed `FetchOrderBookParams` interface so the OpenAPI generator can enumerate the properties.
+
 ## [2.43.1] - 2026-05-22
 
 ### Fixed

core/src/BaseExchange.ts

@@ -166,6 +166,19 @@ export interface MyTradesParams {
     cursor?: string;     // for Kalshi cursor pagination
 }
 
+export interface FetchOrderBookParams {
+    /** Outcome side: 'yes' or 'no'. Required for exchanges like Limitless
+     *  where the API returns a single orderbook per market. */
+    side?: 'yes' | 'no';
+    /** Unix timestamp (ms) — fetch a historical snapshot at or before this
+     *  time, or the start of a range when combined with `until` (hosted API only). */
+    since?: number;
+    /** Unix timestamp (ms) — end of a historical range. When combined with
+     *  `since`, returns an array of reconstructed L2 OrderBook snapshots
+     *  between `since` and `until` (hosted API only). */
+    until?: number;
+}
+
 export interface OrderHistoryParams {
     marketId?: string;   // required for Limitless (slug)
     /** Only return records after this date */
@@ -856,7 +869,7 @@ export abstract class PredictionMarketExchange {
      * @returns Order book with bids and asks. Returns OrderBook[] when
      *   both `since` and `until` are provided.
      */
-    async fetchOrderBook(outcomeId: string, limit?: number, params?: Record<string, any>): Promise<OrderBook> {
+    async fetchOrderBook(outcomeId: string, limit?: number, params?: FetchOrderBookParams): Promise<OrderBook> {
         throw new Error("Method fetchOrderBook not implemented.");
     }
 

sdks/typescript/pmxt/client.ts

@@ -22,6 +22,7 @@ import {
     EventFilterCriteria,
     EventFilterFunction,
     ExecutionPriceResult,
+    FetchOrderBookParams,
     MarketFetchParams,
     MarketFilterCriteria,
     MarketFilterFunction,
@@ -766,7 +767,7 @@ export abstract class Exchange {
         }
     }
 
-    async fetchOrderBook(outcomeId: string | MarketOutcome, limit?: number, params?: Record<string, any>): Promise<OrderBook | OrderBook[]> {
+    async fetchOrderBook(outcomeId: string | MarketOutcome, limit?: number, params?: FetchOrderBookParams): Promise<OrderBook | OrderBook[]> {
         await this.initPromise;
         try {
             const args: any[] = [];

sdks/typescript/pmxt/models.ts

@@ -522,6 +522,18 @@ export interface TradesParams {
     limit?: number;
 }
 
+/**
+ * Parameters for fetchOrderBook historical queries.
+ */
+export interface FetchOrderBookParams {
+    /** Outcome side: 'yes' or 'no' (for exchanges like Limitless) */
+    side?: 'yes' | 'no';
+    /** Unix timestamp (ms) — historical snapshot at or before this time */
+    since?: number;
+    /** Unix timestamp (ms) — end of range. With `since`, returns OrderBook[] */
+    until?: number;
+}
+
 /**
  * Parameters for fetching the authenticated user's trade history.
  */