@0xmonaco/types 1.0.29 → 1.0.32-develop.522174b

package/dist/market/index.d.ts

@@ -353,8 +353,24 @@ export interface FundingState {
 }
 export interface FundingRecord {
     tradingPairId: string;
+    /** Sequential settlement-window index (serialized as a JSON number). */
+    epoch: number;
+    /** Capped settled rate for the window, as a decimal-string fraction per funding interval (e.g. "0.0001" = 0.01%). */
     fundingRate: string;
+    /** Quote charged per unit of base position for this window (fundingRate × referencePrice; positive means longs paid shorts). */
+    fundingDeltaPerUnit: string;
+    /** Running sum of fundingDeltaPerUnit across settled windows; position payments settle against deltas of this value. */
     cumulativeFundingPerUnit?: string;
+    /** Mark price at the window boundary — the payment basis for every position settled in the window. */
+    referencePrice: string;
+    /** Number of premium samples that fed the window's settled rate. */
+    sampleCount: number;
+    /** Window open time (ISO 8601). */
+    windowStartedAt: string;
+    /** Window close time (ISO 8601). */
+    windowClosedAt: string;
+    /** Settlement time (ISO 8601); the sort key for `listAllFundingHistory`. */
+    settledAt: string;
     /** True when the window settled at the carried last rate (sparse-sample rule). */
     carried?: boolean;
 }

package/dist/positions/index.d.ts

@@ -1,7 +1,17 @@
 import type { BaseAPI } from "../api";
 import type { MarginMode } from "../margin-accounts";
 import type { OrderType, PositionSide, TimeInForce } from "../trading";
-export type PositionStatus = "OPEN" | "CLOSED" | "LIQUIDATING";
+/**
+ * Position lifecycle statuses the API returns. `CLOSED`, `LIQUIDATED`, and
+ * `EXPIRED` are terminal; `LIQUIDATING` is transient.
+ */
+export type PositionStatus = "OPEN" | "CLOSED" | "LIQUIDATING" | "LIQUIDATED" | "EXPIRED";
+/**
+ * Accepted `status` filter values for {@link ListPositionsParams}. Narrower than
+ * {@link PositionStatus}: the backend folds `EXPIRED` positions under a `CLOSED`
+ * filter, so `EXPIRED` is not an accepted filter value.
+ */
+export type PositionStatusFilter = "OPEN" | "CLOSED" | "LIQUIDATING" | "LIQUIDATED";
 export type ClosePositionType = "MARKET" | "LIMIT" | "IOC";
 export interface Position {
     positionId: string;
@@ -64,7 +74,7 @@ export interface Position {
 export interface ListPositionsParams {
     marginAccountId?: string;
     tradingPairId?: string;
-    status?: PositionStatus;
+    status?: PositionStatusFilter;
     page?: number;
     pageSize?: number;
 }

package/dist/profile/index.d.ts

@@ -231,16 +231,24 @@ export interface UserTrade {
  * Query parameters for getting user trades
  */
 export interface GetUserTradesParams {
-    /** Page number (starts from 1) */
+    /**
+     * Page number for legacy offset pagination (starts from 1).
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode, which only ever sees recent (hot)
+     * history; omitting both `page` and `pageToken` now drives cursor mode.
+     */
     page?: number;
-    /** Number of items per page (max 100) */
+    /** Number of items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     pageSize?: number;
     /** Filter by trading pair ID (UUID) */
     tradingPairId?: string;
     /**
      * Pagination cursor with three distinct states:
-     * - Omitted (`undefined`): legacy page-number pagination via `page`,
-     *   limited to recent history once the archive window is enabled.
+     * - Omitted (`undefined`): the SDK starts a cursor walk (it sends
+     *   `pageToken=""`) unless the deprecated `page` param was passed, in
+     *   which case the request uses legacy page-number pagination, limited to
+     *   recent history once the archive window is enabled.
      * - Empty string (`""`): start a cursor walk with no prior position, from
      *   the newest row (this endpoint always sorts newest-first).
      * - Non-empty: an opaque cursor from a previous response's
@@ -261,13 +269,28 @@ export interface GetUserTradesParams {
 export interface GetUserTradesResponse {
     /** List of user trades */
     trades: UserTrade[];
-    /** Current page number */
+    /**
+     * Current page number.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode. Use `pageToken`/`nextPageToken` pagination instead.
+     */
     page: number;
     /** Items per page */
     pageSize: number;
-    /** Total number of trades */
+    /**
+     * Total number of trades.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     total: number;
-    /** Total number of pages */
+    /**
+     * Total number of pages.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     totalPages: number;
     /**
      * Cursor for the next page. Empty on every page-number (legacy) response —
@@ -546,12 +569,20 @@ export interface ProfileAPI extends BaseAPI {
      *
      * @param params - Optional query parameters for pagination and filtering
      * @param params.page - Page number (starts from 1)
-     * @param params.limit - Number of items per page (max 100)
+     * @param params.limit - Number of items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present)
      * @param params.tradingPairId - Filter by trading pair ID (UUID)
      * @returns Promise resolving to paginated trades response
      * @throws ValidationError If pagination params (page/limit) are invalid or tradingPairId is not a valid UUID; this may occur before any network request.
      */
     getUserTrades(params?: GetUserTradesParams): Promise<GetUserTradesResponse>;
+    /**
+     * Walks the user's full trade history with cursor pagination, yielding one
+     * trade at a time. Follows each response's `nextPageToken` until the walk
+     * is exhausted; covers hot and archived history.
+     * @param params - Optional filters and page size; the cursor is managed internally
+     * @returns Async generator yielding trades
+     */
+    iterateUserTrades(params?: Omit<GetUserTradesParams, "page" | "pageToken">): AsyncGenerator<UserTrade, void, undefined>;
     /**
      * List the current user's funding payment history with pagination and filters.
      *

package/dist/trading/index.d.ts

@@ -5,7 +5,7 @@
  */
 import type { BaseAPI } from "../api/index";
 import type { MarginMode } from "../margin-accounts";
-import type { OrderSide, PositionSide, TimeInForce, TradingMode } from "./orders";
+import type { Order, OrderSide, PositionSide, TimeInForce, TradingMode } from "./orders";
 import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, ConditionalOrder, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ParentTpSlLegParams, ReplaceOrderResponse } from "./responses";
 /**
  * Trading API interface.
@@ -135,6 +135,14 @@ export interface TradingAPI extends BaseAPI {
      * @returns Promise resolving to the paginated orders result
      */
     getPaginatedOrders(params?: GetPaginatedOrdersParams): Promise<GetPaginatedOrdersResponse>;
+    /**
+     * Walks the user's full order history with cursor pagination, yielding one
+     * order at a time. Follows each response's `nextPageToken` until the walk
+     * is exhausted; covers hot and archived history.
+     * @param params - Optional filters and page size; the cursor is managed internally
+     * @returns Async generator yielding orders
+     */
+    iterateOrders(params?: Omit<GetPaginatedOrdersParams, "page" | "pageToken">): AsyncGenerator<Order, void, undefined>;
     /**
      * Gets a single order by its ID.
      * @param orderId - ID of the order to retrieve
@@ -142,6 +150,6 @@ export interface TradingAPI extends BaseAPI {
      */
     getOrder(orderId: string): Promise<GetOrderResponse>;
 }
-export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, PositionSide, TimeInForce, TradingMode, } from "./orders";
+export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderStatusFilter, OrderTerminalReason, OrderType, PositionSide, TimeInForce, TradingMode, } from "./orders";
 export { ORDER_STATUS_VALUES } from "./orders";
 export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, ConditionalOrder, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, MatchResult, ParentTpSlLegParams, ReplaceOrderResponse, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -115,6 +115,14 @@ export declare const ORDER_STATUS_VALUES: readonly ["SUBMITTED", "PARTIALLY_FILL
  * - EXPIRED: Order expired based on time constraints
  */
 export type OrderStatus = (typeof ORDER_STATUS_VALUES)[number];
+/**
+ * Order status filter accepted by the order listing endpoints.
+ *
+ * A single status matches only that status; an array matches any of the listed
+ * statuses (sent to the API as a comma-separated `status` query parameter), so
+ * several statuses can be fetched in one request instead of one per status.
+ */
+export type OrderStatusFilter = OrderStatus | readonly OrderStatus[];
 /**
  * Trading mode
  */

package/dist/trading/responses.d.ts

@@ -4,7 +4,7 @@
  * Response types for trading operations.
  */
 import type { MarginMode } from "../margin-accounts";
-import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderSide, OrderStatus, OrderType, PositionSide, TimeInForce, TradingMode } from "./orders";
+import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderSide, OrderStatus, OrderStatusFilter, OrderType, PositionSide, TimeInForce, TradingMode } from "./orders";
 /**
  * Match result information for order execution.
  * Contains detailed information about trades, fills, and execution quality.
@@ -125,22 +125,30 @@ export interface UpdatedFields {
  * Query parameters for getting paginated orders
  */
 export interface GetPaginatedOrdersParams {
-    /** Filter by order status */
-    status?: OrderStatus;
+    /** Filter by order status, or by any of several statuses when given an array */
+    status?: OrderStatusFilter;
     /** Filter by trading pair UUID */
     tradingPairId?: string;
     /** Filter by trading mode */
     tradingMode?: TradingMode;
     /** Filter by margin account UUID */
     marginAccountId?: string;
-    /** Page number for pagination (default: 1) */
+    /**
+     * Page number for legacy offset pagination.
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode, which only ever sees recent (hot)
+     * history; omitting both `page` and `pageToken` now drives cursor mode.
+     */
     page?: number;
-    /** Number of orders per page (default: 10, max: 100) */
+    /** Number of orders per page (default: 10; max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     pageSize?: number;
     /**
      * Pagination cursor with three distinct states:
-     * - Omitted (`undefined`): legacy page-number pagination via `page`,
-     *   limited to recent history once the archive window is enabled.
+     * - Omitted (`undefined`): the SDK starts a cursor walk (it sends
+     *   `pageToken=""`) unless the deprecated `page` param was passed, in
+     *   which case the request uses legacy page-number pagination, limited to
+     *   recent history once the archive window is enabled.
      * - Empty string (`""`): start a cursor walk with no prior position, from
      *   the newest row (or the oldest, when `orderBy` is `"ASC"`).
      * - Non-empty: an opaque cursor from a previous response's
@@ -166,13 +174,28 @@ export interface GetPaginatedOrdersResponse {
     latest_orders?: Order[];
     /** Array of historical orders from PostgreSQL (paginated) */
     orders: Order[];
-    /** Total number of orders matching the query */
+    /**
+     * Total number of orders matching the query.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     total: number;
-    /** Current page number */
+    /**
+     * Current page number.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode. Use `pageToken`/`nextPageToken` pagination instead.
+     */
     page: number;
     /** Number of orders per page */
     pageSize: number;
-    /** Total number of pages */
+    /**
+     * Total number of pages.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     totalPages: number;
     /**
      * Cursor for the next page. Empty on every page-number (legacy) response —

package/dist/validation/positions.d.ts

@@ -11,6 +11,7 @@ export declare const ListPositionsSchema: z.ZodObject<{
         OPEN: "OPEN";
         CLOSED: "CLOSED";
         LIQUIDATING: "LIQUIDATING";
+        LIQUIDATED: "LIQUIDATED";
     }>>;
 }, z.core.$strip>;
 export declare const GetPositionSchema: z.ZodObject<{

package/dist/validation/positions.js

@@ -7,8 +7,11 @@ const PaginationSchema = z.object({
     page: z.number().int().min(1, "Page must be at least 1").optional(),
     pageSize: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
 });
-const PositionStatusSchema = z.enum(["OPEN", "CLOSED", "LIQUIDATING"], {
-    message: 'Position status must be "OPEN", "CLOSED", or "LIQUIDATING"',
+// Filter values accepted by the list-positions endpoint. Narrower than the
+// returned PositionStatus: the backend folds EXPIRED positions under CLOSED, so
+// EXPIRED is not an accepted filter value.
+const PositionStatusSchema = z.enum(["OPEN", "CLOSED", "LIQUIDATING", "LIQUIDATED"], {
+    message: 'Position status must be "OPEN", "CLOSED", "LIQUIDATING", or "LIQUIDATED"',
 });
 const ClosePositionTypeSchema = z.enum(["MARKET", "LIMIT", "IOC"], {
     message: 'Close type must be "MARKET", "LIMIT", or "IOC"',

package/dist/validation/profile.js

@@ -37,11 +37,25 @@ export const GetUserMovementsSchema = z.object({
  * Validates parameters for fetching paginated user trades.
  * All fields are optional — an empty object or undefined is valid.
  */
-export const GetUserTradesSchema = z.object({
+export const GetUserTradesSchema = z
+    .object({
     page: z.number().int("Page must be an integer").min(1, "Page must be at least 1").optional(),
-    pageSize: z.number().int("Page size must be an integer").min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    pageSize: z.number().int("Page size must be an integer").min(1, "Page size must be at least 1").max(1000, "Page size cannot exceed 1000").optional(),
     tradingPairId: UUIDSchema.optional(),
     pageToken: z.string().optional(),
+})
+    .superRefine((params, ctx) => {
+    // The higher 1000 cap only applies to cursor (pageToken) requests; the
+    // server keeps the 100 cap for page-number requests (offset scans).
+    // Legacy page-number mode is selected only by passing `page` without
+    // `pageToken` — omitting both starts a cursor walk.
+    if (params.page !== undefined && params.pageToken === undefined && params.pageSize !== undefined && params.pageSize > 100) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Page size cannot exceed 100 in page-number mode (page without pageToken)",
+            path: ["pageSize"],
+        });
+    }
 });
 export const ListFundingPaymentsSchema = z.object({
     page: z.number().int("Page must be an integer").min(1, "Page must be at least 1").optional(),

package/dist/validation/trading.d.ts

@@ -237,13 +237,13 @@ export declare const ReplaceOrderSchema: z.ZodObject<{
  *
  * Validates parameters for fetching paginated orders.
  * Matches the getPaginatedOrders method signature which accepts:
- * - status: OrderStatus (optional filter)
+ * - status: OrderStatus, or a non-empty array of them (optional filter)
  * - tradingPairId: trading pair UUID (optional filter)
  * - page: number (default: 1)
- * - pageSize: number (default: 10, max: 100)
+ * - pageSize: number (default: 10, max: 100 in page-number mode, 1000 when pageToken is present)
  */
 export declare const GetPaginatedOrdersSchema: z.ZodObject<{
-    status: z.ZodOptional<z.ZodEnum<{
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
         SUBMITTED: "SUBMITTED";
         PARTIALLY_FILLED: "PARTIALLY_FILLED";
         FILLED: "FILLED";
@@ -252,7 +252,16 @@ export declare const GetPaginatedOrdersSchema: z.ZodObject<{
         CANCELLED: "CANCELLED";
         REJECTED: "REJECTED";
         EXPIRED: "EXPIRED";
-    }>>;
+    }>, z.ZodArray<z.ZodEnum<{
+        SUBMITTED: "SUBMITTED";
+        PARTIALLY_FILLED: "PARTIALLY_FILLED";
+        FILLED: "FILLED";
+        SETTLED_ON_CHAIN: "SETTLED_ON_CHAIN";
+        SETTLED: "SETTLED";
+        CANCELLED: "CANCELLED";
+        REJECTED: "REJECTED";
+        EXPIRED: "EXPIRED";
+    }>>]>>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
     tradingMode: z.ZodOptional<z.ZodEnum<{
         SPOT: "SPOT";

package/dist/validation/trading.js

@@ -281,19 +281,33 @@ export const ReplaceOrderSchema = z.object({
  *
  * Validates parameters for fetching paginated orders.
  * Matches the getPaginatedOrders method signature which accepts:
- * - status: OrderStatus (optional filter)
+ * - status: OrderStatus, or a non-empty array of them (optional filter)
  * - tradingPairId: trading pair UUID (optional filter)
  * - page: number (default: 1)
- * - pageSize: number (default: 10, max: 100)
+ * - pageSize: number (default: 10, max: 100 in page-number mode, 1000 when pageToken is present)
  */
-export const GetPaginatedOrdersSchema = z.object({
-    status: z.enum(ORDER_STATUS_VALUES).optional(),
+export const GetPaginatedOrdersSchema = z
+    .object({
+    status: z.union([z.enum(ORDER_STATUS_VALUES), z.array(z.enum(ORDER_STATUS_VALUES)).min(1, "Status filter must list at least one status")]).optional(),
     tradingPairId: UUIDSchema.optional(),
     tradingMode: TradingModeSchema.optional(),
     marginAccountId: UUIDSchema.optional(),
     page: z.number().int().min(1, "Page must be at least 1").optional(),
-    pageSize: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    pageSize: z.number().int().min(1, "Page size must be at least 1").max(1000, "Page size cannot exceed 1000").optional(),
     pageToken: z.string().optional(),
+})
+    .superRefine((params, ctx) => {
+    // The higher 1000 cap only applies to cursor (pageToken) requests; the
+    // server keeps the 100 cap for page-number requests (offset scans).
+    // Legacy page-number mode is selected only by passing `page` without
+    // `pageToken` — omitting both starts a cursor walk.
+    if (params.page !== undefined && params.pageToken === undefined && params.pageSize !== undefined && params.pageSize > 100) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Page size cannot exceed 100 in page-number mode (page without pageToken)",
+            path: ["pageSize"],
+        });
+    }
 });
 export const ConditionalOrderConditionTypeSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"], {
     message: 'conditionType must be "STOP_LOSS" or "TAKE_PROFIT"',

package/dist/websocket/events/balance-events.d.ts

@@ -2,7 +2,7 @@
  * User Balance WebSocket Event Types
  *
  * Types for real-time user balance update events.
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */
 import type { Address } from "viem";
 /**

package/dist/websocket/events/balance-events.js

@@ -2,5 +2,5 @@
  * User Balance WebSocket Event Types
  *
  * Types for real-time user balance update events.
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */

package/dist/websocket/events/movement-events.d.ts

@@ -2,7 +2,7 @@
  * User Movement WebSocket Event Types
  *
  * Types for real-time user ledger movement events (deposits, withdrawals, transfers).
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */
 import type { Address } from "viem";
 /**

package/dist/websocket/events/movement-events.js

@@ -2,5 +2,5 @@
  * User Movement WebSocket Event Types
  *
  * Types for real-time user ledger movement events (deposits, withdrawals, transfers).
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */

package/dist/wire/schema.d.ts

@@ -1496,8 +1496,17 @@ export interface paths {
          * Batch replace orders
          * @description Batch replace orders.
          *
-         *      Replace multiple orders in a single batch. Each order is processed
-         *      sequentially through the matching engine.
+         *      Replace multiple orders in one engine step with per-item results: every
+         *      original is cancelled first, then each replacement is placed in request
+         *      order. A
+         *      two-sided quote can therefore shift across its own resting prices in one
+         *      call, and a replacement may use funds freed by any original in the batch.
+         *
+         *      Failure semantics: an item that fails validation, or whose original
+         *      cannot be found, leaves the original resting. An item whose replacement
+         *      fails to PLACE (for example insufficient balance or self-trade
+         *      prevention) reports the error with its original already cancelled — the
+         *      original is never silently left resting after a failed replacement.
          */
         post: operations["batch_replace_orders"];
         delete?: never;
@@ -4507,7 +4516,8 @@ export interface components {
         GetUserTradesResponse: {
             trades?: components["schemas"]["UserTrade"][] | null;
             /**
-             * @description Current page number
+             * @deprecated
+             * @description Deprecated: current page number (legacy offset mode only; 0 in cursor mode)
              * @example 1
              */
             page?: string | null;
@@ -4517,12 +4527,14 @@ export interface components {
              */
             pageSize?: string | null;
             /**
-             * @description Total number of trades
+             * @deprecated
+             * @description Deprecated: total number of trades (legacy offset mode only; 0 in cursor mode)
              * @example 150
              */
             total?: string | null;
             /**
-             * @description Total number of pages
+             * @deprecated
+             * @description Deprecated: total number of pages (legacy offset mode only; 0 in cursor mode)
              * @example 8
              */
             totalPages?: string | null;
@@ -4887,13 +4899,15 @@ export interface components {
             orders?: components["schemas"]["GetOrderResponse"][] | null;
             /**
              * Format: uint32
-             * @description Total number of orders matching the filter
+             * @deprecated
+             * @description Deprecated: total number of orders matching the filter (legacy offset mode only; 0 in cursor mode)
              * @example 150
              */
             total?: number | null;
             /**
              * Format: uint32
-             * @description Current page number
+             * @deprecated
+             * @description Deprecated: current page number (legacy offset mode only; 0 in cursor mode)
              * @example 1
              */
             page?: number | null;
@@ -4905,7 +4919,8 @@ export interface components {
             pageSize?: number | null;
             /**
              * Format: uint32
-             * @description Total number of pages
+             * @deprecated
+             * @description Deprecated: total number of pages (legacy offset mode only; 0 in cursor mode)
              * @example 8
              */
             totalPages?: number | null;
@@ -7570,9 +7585,12 @@ export interface operations {
     get_user_trades: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
+                /**
+                 * @deprecated
+                 * @description Deprecated: page number for legacy offset pagination (1-indexed). Use pageToken cursor pagination instead.
+                 */
                 page?: number;
-                /** @description Items per page (max 100) */
+                /** @description Items per page (max: 100 in page-number mode; up to 1000 when pageToken is present) */
                 pageSize?: number;
                 /** @description Trading pair identifier (UUID) */
                 tradingPairId?: string;
@@ -9483,9 +9501,12 @@ export interface operations {
     get_orders: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
+                /**
+                 * @deprecated
+                 * @description Deprecated: page number for legacy offset pagination (1-indexed). Use pageToken cursor pagination instead.
+                 */
                 page?: number;
-                /** @description Items per page (max 100) */
+                /** @description Items per page (max 100 in page-number mode; up to 1000 when pageToken is present) */
                 pageSize?: number;
                 /** @description Order status (single value or comma-separated list) */
                 status?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.29",
+	"version": "1.0.32-develop.522174b",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.29",
+		"@0xmonaco/contracts": "1.0.32-develop.522174b",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {