@0xmonaco/types 1.0.26 → 1.0.28

package/dist/profile/index.d.ts

@@ -237,6 +237,23 @@ export interface GetUserTradesParams {
     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.
+     * - 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
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * In either cursor-walk state (empty or non-empty), `page` is ignored, the
+     * response omits exact totals (`total`/`totalPages`/`page` are 0), and
+     * results cover full trade history — hot and archived rows merged —
+     * unlike page-number mode, which only ever sees recent history. Clients
+     * that need complete trade history must use the cursor form (pass `""` to
+     * start, then follow `nextPageToken`) rather than `page`.
+     */
+    pageToken?: string;
 }
 /**
  * Response from getting user trades
@@ -252,6 +269,21 @@ export interface GetUserTradesResponse {
     total: number;
     /** Total number of pages */
     totalPages: number;
+    /**
+     * Cursor for the next page. Empty on every page-number (legacy) response —
+     * page-number mode never mints a token, full page or not, since resuming
+     * from a legacy-minted position could silently strand archived history
+     * newer than wherever that page happened to end.
+     *
+     * To walk full history, start a cursor-mode request with `pageToken`
+     * present but empty (`""`); from then on the token is present whenever
+     * that page returned any rows (AIP-158 "maybe more" semantics), not only
+     * when the page is exactly full. Empty only when a cursor-mode page
+     * returned zero rows, which is the sole proof the walk is exhausted. The
+     * two modes never bridge — page-number pagination is deprecated for deep
+     * history.
+     */
+    nextPageToken: string;
 }
 /**
  * Direction of a funding payment from the user's perspective.

package/dist/trading/responses.d.ts

@@ -139,6 +139,23 @@ export interface GetPaginatedOrdersParams {
     page?: number;
     /** Number of orders per page (default: 10, max: 100) */
     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.
+     * - 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, the
+     * response omits exact totals (`total`/`totalPages`/`page` are 0), and
+     * 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`.
+     */
+    pageToken?: string;
 }
 /**
  * Response from getting paginated orders
@@ -159,6 +176,21 @@ export interface GetPaginatedOrdersResponse {
     pageSize: number;
     /** Total number of pages */
     totalPages: number;
+    /**
+     * Cursor for the next page. Empty on every page-number (legacy) response —
+     * page-number mode never mints a token, full page or not, since resuming
+     * from a legacy-minted position could silently strand archived history
+     * newer than wherever that page happened to end.
+     *
+     * To walk full history, start a cursor-mode request with `pageToken`
+     * present but empty (`""`); from then on the token is present whenever
+     * that page returned any rows (AIP-158 "maybe more" semantics), not only
+     * when the page is exactly full. Empty only when a cursor-mode page
+     * returned zero rows, which is the sole proof the walk is exhausted. The
+     * two modes never bridge — page-number pagination is deprecated for deep
+     * history.
+     */
+    nextPageToken: string;
 }
 /**
  * Response from getting a single order by ID

package/dist/validation/profile.d.ts

@@ -66,6 +66,7 @@ export declare const GetUserTradesSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ListFundingPaymentsSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;

package/dist/validation/profile.js

@@ -41,6 +41,7 @@ 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(),
     tradingPairId: UUIDSchema.optional(),
+    pageToken: z.string().optional(),
 });
 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

@@ -261,6 +261,7 @@ export declare const GetPaginatedOrdersSchema: z.ZodObject<{
     marginAccountId: z.ZodOptional<z.ZodUUID>;
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ConditionalOrderConditionTypeSchema: z.ZodEnum<{
     STOP_LOSS: "STOP_LOSS";

package/dist/validation/trading.js

@@ -285,6 +285,7 @@ export const GetPaginatedOrdersSchema = z.object({
     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(),
+    pageToken: z.string().optional(),
 });
 export const ConditionalOrderConditionTypeSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"], {
     message: 'conditionType must be "STOP_LOSS" or "TAKE_PROFIT"',
@@ -343,6 +344,10 @@ export const BatchCreateOrderItemSchema = z
     .refine((data) => data.orderType !== "MARKET" || data.price === undefined, {
     message: "Price must not be provided for MARKET orders",
     path: ["price"],
+})
+    .refine((data) => data.orderType !== "MARKET" || data.timeInForce === undefined, {
+    message: "timeInForce must not be provided for MARKET orders",
+    path: ["timeInForce"],
 })
     .refine((data) => data.riskBucketCollateral === undefined || data.tradingMode === "MARGIN", {
     message: "riskBucketCollateral is only supported for MARGIN orders",

package/dist/wire/schema.d.ts

@@ -2508,7 +2508,7 @@ export interface components {
              */
             expirationDate?: string | null;
             /**
-             * @description Time in force: GTC, IOC, or FOK
+             * @description Time in force: GTC, IOC, or FOK. LIMIT orders only; rejected on MARKET orders.
              * @example GTC
              */
             timeInForce?: string | null;
@@ -2957,7 +2957,7 @@ export interface components {
              */
             expirationDate?: string | null;
             /**
-             * @description Time in force: GTC, IOC, or FOK
+             * @description Time in force: GTC, IOC, or FOK. LIMIT orders only; rejected on MARKET orders.
              * @example GTC
              */
             timeInForce?: string | null;
@@ -4385,6 +4385,22 @@ export interface components {
              * @example 8
              */
             totalPages?: string | null;
+            /**
+             * @description Cursor for the next page. Empty on every page-number (legacy) response —
+             *      page-number mode never mints a token, full page or not, since resuming
+             *      a client from a legacy-minted position could silently strand archived
+             *      history newer than wherever that page happened to end. To walk full
+             *      history, start a cursor-mode request with `page_token` present but
+             *      empty (`""`); from then on the token is present whenever that page
+             *      returned any rows (AIP-158 "maybe more" semantics), not only when the
+             *      page is exactly full. Empty only when a cursor-mode page returned zero
+             *      rows, which is the sole proof the walk is exhausted; a non-empty token
+             *      does not guarantee further results, so keep following it until a
+             *      response returns zero rows and an empty token. The two modes never
+             *      bridge: a page-number response's empty token is not "done," it simply
+             *      means page-number mode does not participate in cursor continuation.
+             */
+            nextPageToken?: string | null;
         };
         IndexComponent: {
             provider?: string | null;
@@ -4743,6 +4759,22 @@ export interface components {
              * @example 8
              */
             totalPages?: number | null;
+            /**
+             * @description Cursor for the next page. Empty on every page-number (legacy) response —
+             *      page-number mode never mints a token, full page or not, since resuming
+             *      a client from a legacy-minted position could silently strand archived
+             *      history newer than wherever that page happened to end. To walk full
+             *      history, start a cursor-mode request with `page_token` present but
+             *      empty (`""`); from then on the token is present whenever that page
+             *      returned any rows (AIP-158 "maybe more" semantics), not only when the
+             *      page is exactly full. Empty only when a cursor-mode page returned zero
+             *      rows, which is the sole proof the walk is exhausted; a non-empty token
+             *      does not guarantee further results, so keep following it until a
+             *      response returns zero rows and an empty token. The two modes never
+             *      bridge: a page-number response's empty token is not "done," it simply
+             *      means page-number mode does not participate in cursor continuation.
+             */
+            nextPageToken?: string | null;
         };
         ListPendingWithdrawalsResponse: {
             withdrawals?: components["schemas"]["PendingWithdrawal"][] | null;
@@ -7296,6 +7328,24 @@ export interface operations {
                 pageSize?: number;
                 /** @description Trading pair identifier (UUID) */
                 tradingPairId?: string;
+                /**
+                 * @description Pagination cursor with three distinct states:
+                 *       - Omitted: legacy page-number pagination via `page`, 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
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      In either cursor-walk state (empty or non-empty), `page` is ignored, the
+                 *      response omits exact totals (total/total_pages/page are 0), and results
+                 *      cover full trade history — hot and archived rows merged — unlike
+                 *      page-number mode, which only ever sees recent history. Clients that need
+                 *      complete trade history must use the cursor form (start with an empty
+                 *      string, then follow next_page_token) rather than `page`. Filters must
+                 *      match the request that produced the token.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;
@@ -9165,6 +9215,24 @@ export interface operations {
                 marginAccountId?: string;
                 /** @description Sort direction for createdAt */
                 orderBy?: "ASC" | "DESC";
+                /**
+                 * @description Pagination cursor with three distinct states:
+                 *       - Omitted: legacy page-number pagination via `page`, 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
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      In either cursor-walk state (empty or non-empty), `page` is ignored, the
+                 *      response omits exact totals (total/total_pages/page are 0), and 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 (start with an empty
+                 *      string, then follow next_page_token) rather than `page`. Filters and
+                 *      orderBy must match the request that produced the token.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;

package/package.json

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