@0xmonaco/types 1.0.73-develop.af0f5d0 → 1.0.74-develop.367860f

package/dist/profile/index.d.ts

@@ -98,13 +98,24 @@ export type TransactionType = "DEPOSIT" | "WITHDRAWAL" | "TRADE" | "FEE" | "FUND
  * Query parameters for getting user movements
  */
 export interface GetUserMovementsParams {
+    /** Number of items per page, 1 to 1000 (default 20) */
+    pageSize?: number;
     /**
-     * Page number (starts from 1, at most 10,000 — the last page this listing
-     * counts towards; a larger page is rejected).
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or 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
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a `400`. Every walk covers the ledger and funding arms
+     * merged. Filters and `orderBy` must match the request that minted the
+     * token.
      */
-    page?: number;
-    /** Number of items per page (max 100) */
-    pageSize?: number;
+    pageToken?: string;
+    /** Sort direction for `createdAt`: `"ASC"` or `"DESC"` (default `"DESC"`) */
+    orderBy?: "ASC" | "DESC";
     /** Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE) */
     entryType?: LedgerEntryType;
     /** Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, FEE, FUNDING, LIQUIDATION, INTEREST, REWARD) */
@@ -116,10 +127,22 @@ export interface GetUserMovementsParams {
  * Query parameters for getting user balances
  */
 export interface GetUserBalancesParams {
-    /** Page number (starts from 1) */
-    page?: number;
-    /** Number of items per page (max 100) */
+    /** Number of items per page, 1 to 1000 (default 20) */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position, from the lowest token address.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a `400`. The walk seeks on `(token, assetId)` over the
+     * balance set the server builds after overlaying the matching engine's
+     * authoritative amounts, so a balance that appears or is zeroed mid-walk no
+     * longer shifts the rows behind it across the resume point.
+     */
+    pageToken?: string;
 }
 /**
  * Response from getting user movements
@@ -127,22 +150,30 @@ export interface GetUserBalancesParams {
 export interface GetPaginatedUserMovementsResponse {
     /** All movements from PostgreSQL (historical, paginated) */
     movements: LedgerMovement[];
-    /** Current page number */
-    page: number;
     /** Items per page */
     pageSize: number;
     /**
-     * Matching movements. Exact up to 10,000 pages of the requested `pageSize`
-     * (`pageSize` x 10,000 rows) and saturates there, so a user with more
-     * matching movements than the listing can page through reads the cap, not
-     * their lifetime total.
+     * Movements matching the filter, bounded by the server count ceiling — see
+     * `totalCapped`. A lower bound when `totalCapped` is `true`.
      */
     total: number;
+    /** Pages at this `pageSize`, bounded by the same ceiling as `total`. */
+    totalPages: number;
     /**
-     * Number of pages at the requested `pageSize`. Exact up to 10,000 and
-     * saturates there, the last page this listing can reach.
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page. Each arm of the ledger+funding union is cut at the same
+     * over-fetched depth inside one statement, so a page shorter than
+     * `pageSize` means both arms are exhausted and this is `""`. A non-empty
+     * token always has at least one further row behind it.
      */
-    totalPages: number;
+    nextPageToken: string;
+    /**
+     * `true` when MORE than the server ceiling of movements matched, so the
+     * count stopped at the ceiling and `total` / `totalPages` are a lower
+     * bound. `false` when `total` is the exact count — including exactly the
+     * ceiling, which is still reported exactly.
+     */
+    totalCapped: boolean;
 }
 /**
  * Response from getting user balances
@@ -150,14 +181,21 @@ export interface GetPaginatedUserMovementsResponse {
 export interface GetUserBalancesResponse {
     /** List of token balances for the user */
     balances: AccountBalance[];
-    /** Total number of balances */
+    /**
+     * Total number of balances. Exact — the set is bounded by the asset universe
+     * and counted in memory after the live overlay, so no ceiling applies.
+     */
     total: number;
     /** Items per page */
     pageSize: number;
-    /** Current page number */
-    page: number;
     /** Total number of pages */
     totalPages: number;
+    /**
+     * Cursor for the next page, `""` once the walk is exhausted. The whole set
+     * is already in memory, so each page over-fetches one row and an empty token
+     * is definitive — follow a non-empty token, stop on an empty one.
+     */
+    nextPageToken: string;
 }
 /**
  * Order information for recent orders.
@@ -351,13 +389,21 @@ export interface FundingPayment {
  * Query parameters for listing funding payments.
  */
 export interface ListFundingPaymentsParams {
+    /** Number of items per page, 1 to 1000 (default 20) */
+    pageSize?: number;
     /**
-     * Page number (starts from 1, at most 10,000 — the last page this listing
-     * counts towards; a larger page is rejected).
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position, from the newest payment.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a `400`. The walk seeks on `(createdAt, id)` descending —
+     * not `periodEnd`, which the removed mode led its sort with and which is
+     * nullable. Filters must match the request that minted the token.
      */
-    page?: number;
-    /** Number of items per page (max 100) */
-    pageSize?: number;
+    pageToken?: string;
     /** Filter by trading pair ID (UUID) */
     tradingPairId?: string;
     /** Filter by margin position ID (UUID) */
@@ -371,22 +417,29 @@ export interface ListFundingPaymentsParams {
 export interface ListFundingPaymentsResponse {
     /** List of funding payment records */
     records: FundingPayment[];
-    /** Current page number */
-    page: number;
     /** Items per page */
     pageSize: number;
     /**
-     * Matching funding payment records. Exact up to 10,000 pages of the
-     * requested `pageSize` (`pageSize` x 10,000 rows) and saturates there, so a
-     * user with more matching payments than the listing can page through reads
-     * the cap, not their lifetime total.
+     * Payments matching the filter, bounded by the server count ceiling — see
+     * `totalCapped`. A lower bound when `totalCapped` is `true`.
      */
     total: number;
+    /** Pages at this `pageSize`, bounded by the same ceiling as `total`. */
+    totalPages: number;
     /**
-     * Number of pages at the requested `pageSize`. Exact up to 10,000 and
-     * saturates there, the last page this listing can reach.
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page. This listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`. A non-empty token always
+     * has at least one further row behind it.
      */
-    totalPages: number;
+    nextPageToken: string;
+    /**
+     * `true` when MORE than the server ceiling of payments matched, so the count
+     * stopped at the ceiling and `total` / `totalPages` are a lower bound.
+     * `false` when `total` is the exact count — including exactly the ceiling,
+     * which is still reported exactly.
+     */
+    totalCapped: boolean;
 }
 /**
  * Time period for portfolio stats and chart queries.
@@ -539,9 +592,14 @@ export interface ProfileAPI extends BaseAPI {
      * Fetches the user's transaction history from the /api/v1/accounts/movements endpoint.
      * Requires a valid access token to be set.
      *
+     * Cursor paged (0XM-2788/0XM-2820): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` until it comes back empty. There is no `page`
+     * — sending one is a `400`.
+     *
      * @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.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
+     * @param params.orderBy - Sort direction for `createdAt` (default `"DESC"`)
      * @param params.entryType - Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE)
      * @param params.transactionType - Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, FEE, FUNDING, LIQUIDATION, INTEREST, REWARD)
      * @param params.assetId - Filter by asset ID (UUID)
@@ -554,10 +612,15 @@ export interface ProfileAPI extends BaseAPI {
      * Fetches the user's token balances from the /api/v1/accounts/balances endpoint.
      * Requires a valid access token to be set.
      *
+     * Cursor paged (0XM-2788/0XM-2821): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` until it comes back empty. There is no `page`
+     * — sending one is a `400`.
+     *
      * @param params - Optional query parameters for pagination
-     * @param params.limit - Number of items to return
-     * @param params.offset - Number of items to skip
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
      * @returns Promise resolving to paginated balances response
+     * @throws ValidationError If the page size is invalid or `page` is sent; this may occur before any network request.
      */
     getUserBalances(params?: GetUserBalancesParams): Promise<GetUserBalancesResponse>;
     /**
@@ -597,12 +660,15 @@ export interface ProfileAPI extends BaseAPI {
      * Fetches the user's executed trades from the /api/v1/accounts/trades endpoint.
      * Requires a valid access token to be set.
      *
+     * Cursor paged (0XM-2963): omit `pageToken` or pass `""` to start, then
+     * follow `nextPageToken` until it comes back empty. There is no `page`.
+     *
      * @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 1000)
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (max 1000)
      * @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.
+     * @throws ValidationError If the page size is invalid, `page` is sent, or tradingPairId is not a valid UUID; this may occur before any network request.
      */
     getUserTrades(params?: GetUserTradesParams): Promise<GetUserTradesResponse>;
     /**
@@ -619,14 +685,18 @@ export interface ProfileAPI extends BaseAPI {
      * Fetches funding payments from the /api/v1/accounts/funding-payments endpoint.
      * Requires a valid access token to be set.
      *
+     * Cursor paged (0XM-2788/0XM-2818): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` until it comes back empty. There is no `page`
+     * — sending one is a `400`.
+     *
      * @param params - Optional query parameters for pagination and filtering
-     * @param params.page - Page number (starts from 1)
-     * @param params.pageSize - Number of items per page (max 100)
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
      * @param params.tradingPairId - Filter by trading pair ID (UUID)
      * @param params.positionId - Filter by margin position ID (UUID)
      * @param params.marginAccountId - Filter by margin account ID (UUID)
      * @returns Promise resolving to paginated funding payments response
-     * @throws ValidationError If pagination params or a UUID filter are invalid; this may occur before any network request.
+     * @throws ValidationError If the page size is invalid, `page` is sent, or a UUID filter is invalid; this may occur before any network request.
      */
     listFundingPayments(params?: ListFundingPaymentsParams): Promise<ListFundingPaymentsResponse>;
     /**

package/dist/sdk/index.d.ts

@@ -144,12 +144,20 @@ export interface MonacoSDK {
     };
     /** Trades REST API for fetching historical trades */
     trades: {
+        /**
+         * One page of a pair's trade feed, newest first. Cursor paged (0XM-2821):
+         * omit `pageToken` to start, then follow `nextPageToken` until it is empty.
+         */
         getTrades: (tradingPairId: string, options?: {
-            /** Page number (starts from 1, default: 1) */
-            page?: number;
-            /** Maximum number of records to return (default: 25, max: 100) */
+            /** Maximum number of records to return (default: 25, max: 1000) */
             pageSize?: number;
-        }) => Promise<TradeEvent[]>;
+            /** Cursor from a previous response's `nextPageToken`; omit to start */
+            pageToken?: string;
+        }) => Promise<{
+            trades: TradeEvent[];
+            /** Empty exactly when the walk is finished. */
+            nextPageToken: string;
+        }>;
     };
     /** WebSocket client for real-time data — the full typed channel surface of {@link MonacoWebSocket} */
     ws: MonacoWebSocket;

package/dist/trading/index.d.ts

@@ -267,6 +267,6 @@ export interface TradingAPI extends BaseAPI {
      */
     listTwapOrders(params?: ListTwapOrdersParams): Promise<ListTwapOrdersResponse>;
 }
-export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, ListedOrderType, Order, OrderRole, OrderSide, OrderStatus, OrderStatusFilter, OrderTerminalReason, OrderType, PositionSide, SelfTradePreventionMode, TimeInForce, TradingMode, TwapExecutionStyle, TwapOrderState, } from "./orders";
+export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderStatusFilter, OrderTerminalReason, OrderType, PositionSide, SelfTradePreventionMode, TimeInForce, TradingMode, TwapExecutionStyle, TwapOrderState, } from "./orders";
 export { ORDER_STATUS_VALUES } from "./orders";
 export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrdersParams, ListTwapOrdersResponse, MatchResult, ParentTpSlLegParams, ParentTrailingStopLegParams, ReplaceOrderResponse, TriggeredOrderSummary, TwapOrder, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -3,7 +3,6 @@
  *
  * Types for trading operations and order management.
  */
-import type { ConditionalOrder, TwapOrder } from "./responses";
 /**
  * Standard order structure used across all order-related responses.
  * This represents the complete order information as returned by the API.
@@ -14,12 +13,9 @@ import type { ConditionalOrder, TwapOrder } from "./responses";
  * Orders can transition to `CANCELLED`, `REJECTED`, or `EXPIRED` at various stages.
  * Fee fields are only populated after order fills occur.
  *
- * The order listing returns every kind of order in one stream, so a row here
- * may be a book order, a TWAP parent (`orderType: "TWAP"`) or a conditional
- * order (`orderType: "CONDITIONAL"`). Switch on `orderType`: the kind-specific
- * detail hangs off `twap` / `conditional`, and the fields above are populated
- * for every kind — a parent's `quantity` is its total, `filledQuantity` what
- * it has executed so far, and `status` its state expressed as an order status.
+ * Every row is a book order: the order listing carries `LIMIT` and `MARKET`
+ * orders only. TWAP parents and conditional (TP/SL) orders are listed by
+ * `listTwapOrders` and `listConditionalOrders`, never here.
  *
  * @example
  * To calculate remaining quantity:
@@ -34,8 +30,8 @@ export interface Order {
     tradingPairId: string;
     /** Order side (BUY or SELL) */
     side: OrderSide;
-    /** What kind of order this row is - see ListedOrderType */
-    orderType: ListedOrderType;
+    /** Order type (LIMIT or MARKET) */
+    orderType: OrderType;
     /** Order status - see OrderStatus for lifecycle details */
     status: OrderStatus;
     /** Order price - null for market orders, required for limit orders */
@@ -98,18 +94,6 @@ export interface Order {
     clientOrderId?: string;
     /** Position ID linked to the order, when available */
     positionId?: string;
-    /**
-     * The TWAP parent behind this row - its schedule, slice counters and
-     * progress - present only when `orderType` is `"TWAP"`. Identical to what
-     * `getTwapOrder` returns for the same id.
-     */
-    twap?: TwapOrder;
-    /**
-     * The conditional order behind this row - its trigger and the order it fires
-     * - present only when `orderType` is `"CONDITIONAL"`. Identical to what the
-     * conditional-order endpoints return for the same id.
-     */
-    conditional?: ConditionalOrder;
     /** Stable cause when status is CANCELLED */
     terminalReason?: OrderTerminalReason;
     /**
@@ -178,7 +162,7 @@ export interface Order {
     version?: number;
 }
 /** Stable terminal causes for accepted orders that end as CANCELLED. */
-export type OrderTerminalReason = "USER_REQUESTED" | "REPLACED" | "LIQUIDATION" | "INSUFFICIENT_MARGIN" | "REDUCE_ONLY_EXHAUSTED" | "POSITION_CLOSED" | "OCO_SIBLING_TRIGGERED" | "SELF_TRADE_PREVENTION" | "AUTO_DELEVERAGING" | "SYSTEM";
+export type OrderTerminalReason = "USER_REQUESTED" | "REPLACED" | "LIQUIDATION" | "INSUFFICIENT_MARGIN" | "REDUCE_ONLY_EXHAUSTED" | "POSITION_CLOSED" | "OCO_SIBLING_TRIGGERED" | "SELF_TRADE_PREVENTION" | "AUTO_DELEVERAGING" | "PRICE_BAND" | "SLIPPAGE_TOLERANCE" | "SYSTEM";
 /**
  * Role of the creator or order
  */
@@ -201,16 +185,6 @@ export type PositionSide = "LONG" | "SHORT" | "NONE";
  * - TRAILING_STOP: Stop order that trails the market price
  */
 export type OrderType = "LIMIT" | "MARKET";
-/**
- * What kind of order a listed row is.
- *
- * Wider than {@link OrderType}, which is what you can place: the order listing
- * serves book orders, TWAP parents and conditional orders as one stream, and
- * `"TWAP"` / `"CONDITIONAL"` name the two kinds that are created through their
- * own endpoints rather than `createOrder`. A row of either kind carries its
- * detail on {@link Order.twap} or {@link Order.conditional}.
- */
-export type ListedOrderType = OrderType | "TWAP" | "CONDITIONAL";
 /**
  * Source-of-truth order status values used by runtime validation schemas.
  */

package/dist/trading/responses.d.ts

@@ -197,23 +197,18 @@ export interface GetPaginatedOrdersParams {
     /** Number of orders per page (default: 10; max 1000) */
     pageSize?: number;
     /**
-     * Pagination cursor with three distinct states:
-     * - 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"`).
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or 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
      *   `nextPageToken`; results resume immediately after that position.
      *
-     * In either cursor-walk state (empty or non-empty), `page` is ignored (it
-     * comes back as 0), but `total` and `totalPages` ARE populated — bounded by
-     * the server count ceiling, see `totalCapped`. Results cover full order
-     * history — hot and archived rows merged — unlike page-number mode, which
-     * only ever sees recent history. Clients that need complete order history
-     * must use the cursor form (pass `""` to start, then follow `nextPageToken`)
-     * rather than `page`.
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a `400`. `total` and `totalPages` are still populated,
+     * bounded by the server count ceiling — see `totalCapped`. Every walk
+     * covers full order history, hot and archived rows merged. Filters and
+     * `orderBy` must match the request that minted the token.
      */
     pageToken?: string;
 }

package/dist/validation/applications.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Public application listing validation schemas
+ *
+ * The four reporting listings are cursor paged (0XM-2822). Each schema
+ * REJECTS `page` rather than omitting it: forwarding the params field by
+ * field drops a stray `page` before it reaches the wire, which means a
+ * JavaScript or `any` caller looping on `{ page: n }` would be handed the
+ * FIRST cursor page on every call and would export the same rows forever —
+ * the exact failure the REST 400 exists to surface. Validating here turns
+ * that into an immediate `ValidationError`, which is what the 400 would have
+ * done before the field-by-field forwarding hid it.
+ */
+import { z } from "zod";
+export declare const ListAppOrdersSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    page: z.ZodOptional<z.ZodNever>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodUUID>;
+    tradingPairId: z.ZodOptional<z.ZodUUID>;
+    side: z.ZodOptional<z.ZodString>;
+    orderType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ListAppUsersSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    page: z.ZodOptional<z.ZodNever>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    accountType: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ListAppMovementsSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    page: z.ZodOptional<z.ZodNever>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodUUID>;
+    transactionType: z.ZodOptional<z.ZodString>;
+    entryType: z.ZodOptional<z.ZodString>;
+    assetId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export declare const ListAppBalancesSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    page: z.ZodOptional<z.ZodNever>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodUUID>;
+    assetId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;

package/dist/validation/applications.js

@@ -0,0 +1,45 @@
+/**
+ * Public application listing validation schemas
+ *
+ * The four reporting listings are cursor paged (0XM-2822). Each schema
+ * REJECTS `page` rather than omitting it: forwarding the params field by
+ * field drops a stray `page` before it reaches the wire, which means a
+ * JavaScript or `any` caller looping on `{ page: n }` would be handed the
+ * FIRST cursor page on every call and would export the same rows forever —
+ * the exact failure the REST 400 exists to surface. Validating here turns
+ * that into an immediate `ValidationError`, which is what the 400 would have
+ * done before the field-by-field forwarding hid it.
+ */
+import { z } from "zod";
+import { UUIDSchema } from "./trading";
+/** A client ID is required; `page` is gone; a page size is bounded; a cursor may be `""` to start. */
+const AppCursorPaginationSchema = z.object({
+    /** The application's public client ID; the listings are selected by it. */
+    clientId: z.string().trim().min(1, "Client ID is required"),
+    page: z.never().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(),
+    pageToken: z.string().optional(),
+});
+export const ListAppOrdersSchema = AppCursorPaginationSchema.extend({
+    status: z.string().trim().min(1, "Status cannot be empty").optional(),
+    userId: UUIDSchema.optional(),
+    tradingPairId: UUIDSchema.optional(),
+    side: z.string().trim().min(1, "Side cannot be empty").optional(),
+    orderType: z.string().trim().min(1, "Order type cannot be empty").optional(),
+});
+export const ListAppUsersSchema = AppCursorPaginationSchema.extend({
+    isActive: z.boolean().optional(),
+    accountType: z.string().trim().min(1, "Account type cannot be empty").optional(),
+    // A partial, case-insensitive match, so not a full address.
+    address: z.string().trim().min(1, "Address filter cannot be empty").optional(),
+});
+export const ListAppMovementsSchema = AppCursorPaginationSchema.extend({
+    userId: UUIDSchema.optional(),
+    transactionType: z.string().trim().min(1, "Transaction type cannot be empty").optional(),
+    entryType: z.string().trim().min(1, "Entry type cannot be empty").optional(),
+    assetId: UUIDSchema.optional(),
+});
+export const ListAppBalancesSchema = AppCursorPaginationSchema.extend({
+    userId: UUIDSchema.optional(),
+    assetId: UUIDSchema.optional(),
+});

package/dist/validation/index.d.ts

@@ -13,8 +13,10 @@
  * - Vault schemas (deposits, withdrawals)
  * - Market schemas (trading pairs, candlesticks)
  */
+export * from "./applications.js";
 export * from "./common.js";
 export * from "./copy-trading.js";
+export * from "./managed-markets.js";
 export * from "./margin-accounts.js";
 export * from "./market.js";
 export * from "./positions.js";

package/dist/validation/index.js

@@ -14,8 +14,10 @@
  * - Market schemas (trading pairs, candlesticks)
  */
 // Export validation utilities
+export * from "./applications.js";
 export * from "./common.js";
 export * from "./copy-trading.js";
+export * from "./managed-markets.js";
 export * from "./margin-accounts.js";
 export * from "./market.js";
 export * from "./positions.js";

package/dist/validation/managed-markets.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Managed Markets API Validation Schemas
+ */
+import { z } from "zod";
+/**
+ * Managed market assignments listing validation schema.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted: the client
+ * builds the query string field by field, so a stray `page` never reaches the
+ * REST guard, and a caller looping `{ page: 1 }`, `{ page: 2 }` would send
+ * identical cursorless requests and reread the first page forever.
+ */
+export declare const ListManagedMarketAssignmentsSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNever>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/validation/managed-markets.js

@@ -0,0 +1,17 @@
+/**
+ * Managed Markets API Validation Schemas
+ */
+import { z } from "zod";
+/**
+ * Managed market assignments listing validation schema.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted: the client
+ * builds the query string field by field, so a stray `page` never reaches the
+ * REST guard, and a caller looping `{ page: 1 }`, `{ page: 2 }` would send
+ * identical cursorless requests and reread the first page forever.
+ */
+export const ListManagedMarketAssignmentsSchema = z.object({
+    page: z.never().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(),
+    pageToken: z.string().optional(),
+});

package/dist/validation/margin-accounts.d.ts

@@ -3,8 +3,9 @@
  */
 import { z } from "zod";
 export declare const ListMarginAccountsSchema: z.ZodObject<{
-    page: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNever>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
     state: z.ZodOptional<z.ZodString>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strip>;
@@ -70,14 +71,16 @@ export declare const TransferCollateralFromParentMarginAccountSchema: z.ZodObjec
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const GetMarginAccountMovementsSchema: z.ZodObject<{
-    page: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNever>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
     marginAccountId: z.ZodUUID;
     movementType: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const GetParentMarginAccountMovementsSchema: z.ZodOptional<z.ZodObject<{
-    page: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNever>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
     movementType: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
 export declare const SimulateOrderRiskSchema: z.ZodObject<{
@@ -194,6 +197,10 @@ export declare const CreateMarginSubAccountSchema: z.ZodObject<{
 export declare const CloseMarginSubAccountSchema: z.ZodObject<{
     marginAccountId: z.ZodUUID;
 }, z.core.$strip>;
+export declare const SubAccountCollateralTransferSchema: z.ZodObject<{
+    marginAccountId: z.ZodUUID;
+    amount: z.ZodString;
+}, z.core.$strip>;
 export declare const GetMarginAccountPnlSchema: z.ZodObject<{
     marginAccountId: z.ZodUUID;
 }, z.core.$strip>;