@0xmonaco/types 1.0.66 → 1.0.67

package/dist/market/index.d.ts

@@ -191,6 +191,8 @@ export interface ScreenerSnapshotPoint {
     quoteVolume: string;
     /** Percent price change (close - open) / open * 100 for the day */
     priceChangePercent: string;
+    /** Daily average of the valued completed-UTC-minute open interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
+    openInterestNotionalAvg: string | null;
 }
 /**
  * Per-pair screener row. Window fields are null when there is insufficient history.
@@ -251,6 +253,12 @@ export interface ScreenerItem {
      * getOpenInterest
      */
     openInterestNotional: string | null;
+    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
+    openInterestNotionalAvg1h: string | null;
+    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
+    openInterestNotionalAvg24h: string | null;
+    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
+    openInterestNotionalAvg7d: string | null;
 }
 /**
  * Paginated screener response, sorted by quoteVolume24h desc (nulls last)

package/dist/positions/index.d.ts

@@ -32,16 +32,13 @@ export interface Position {
     unrealizedPnl: string;
     realizedPnl: string;
     /**
-     * Open ISOLATED rows: the position's current backing — its risk bucket's
-     * allocated collateral adjusted by settled realized PnL and funding paid,
-     * net of collateral reserved for the bucket's open orders, clamped at zero
-     * (0XM-2558). Partial closes shrink the posted margin pro-rata while the
-     * realized loss stays in the bucket, so this is the unrealized-return
-     * denominator. Not a hard -100% bound: liquidation measures the bucket's
-     * whole equity, order reserves included, and a mark can gap past the
-     * backing. Open CROSS rows: the position's posted margin. Terminal rows:
-     * total initial margin allocated across the position's reducing executions
-     * when available — the margin basis for lifetime realized return.
+     * Open ISOLATED rows: principal committed to the filled position, adjusted
+     * by settled realized PnL, fees and funding, clamped at zero. Unfilled-order
+     * collateral is excluded. This is the unrealized-return denominator and
+     * the same backing used by isolated liquidation, on live and persisted reads.
+     * A price gap can pass the backing before asynchronous liquidation occurs.
+     * Open CROSS rows: posted margin. Terminal rows: total initial margin
+     * allocated across reducing executions, the lifetime-return denominator.
      */
     isolatedMargin: string;
     leverage?: string;

package/dist/trading/index.d.ts

@@ -32,6 +32,7 @@ export interface TradingAPI extends BaseAPI {
         marginAccountId?: string;
         marginMode?: MarginMode;
         riskBucketId?: string;
+        /** Initial order budget; unfilled funds do not back the isolated position. */
         riskBucketCollateral?: string;
         strategyKey?: string;
         /** @deprecated Order side is authoritative. */
@@ -85,6 +86,7 @@ export interface TradingAPI extends BaseAPI {
         marginAccountId?: string;
         marginMode?: MarginMode;
         riskBucketId?: string;
+        /** Initial order budget; unfilled funds do not back the isolated position. */
         riskBucketCollateral?: string;
         strategyKey?: string;
         /** @deprecated Order side is authoritative. */

package/dist/trading/responses.d.ts

@@ -487,8 +487,31 @@ export interface ListConditionalOrdersParams {
     marginAccountId?: string;
     tradingPairId?: string;
     state?: ConditionalOrderState;
+    /**
+     * Page number for legacy offset pagination.
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode; omitting both `page` and `pageToken`
+     * drives cursor mode.
+     */
     page?: number;
+    /** Items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     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.
+     * - Empty string (`""`): start a cursor walk with no prior position, from
+     *   the newest conditional order.
+     * - Non-empty: an opaque cursor from a previous response's `nextPageToken`;
+     *   results resume immediately after that position.
+     *
+     * In either cursor-walk state, `page` and `total` come back as 0 — cursor
+     * mode runs no COUNT (AIP-158). Follow `nextPageToken` until it comes back
+     * empty. Filters must match the request that produced the token.
+     */
+    pageToken?: string;
 }
 /**
  * What the order a conditional fired into has done so far — a projection of
@@ -618,14 +641,28 @@ export interface ConditionalOrder {
 export interface ListConditionalOrdersResponse {
     orders: ConditionalOrder[];
     /**
-     * Matching conditional orders. Exact up to 10,000 pages of the requested
-     * page size (`pageSize` x 10,000 rows) and saturates there, so a caller with
-     * more matching conditional orders than the listing can page through reads
-     * the cap, not its lifetime total. `page` is capped at 10,000.
+     * Matching conditional orders in page-number (offset) mode: exact up to
+     * 10,000 pages of the requested page size (`pageSize` x 10,000 rows) and
+     * saturates there, so a caller with more matching conditional orders than the
+     * listing can page through reads the cap, not its lifetime total. `0` in
+     * cursor (`pageToken`) mode, which runs no COUNT (AIP-158).
      */
     total: number;
+    /**
+     * Current page number in legacy offset mode; `0` in cursor mode.
+     *
+     * @deprecated Use cursor pagination (`pageToken`/`nextPageToken`) instead.
+     */
     page: number;
     pageSize: number;
+    /**
+     * Cursor for the next page, minted only while a further page exists (the read
+     * over-fetches one row to decide). Empty on every page-number response and on
+     * the final cursor page — an empty token is the definitive end of the walk,
+     * so no extra request is needed. Do not feed the empty token back as
+     * `pageToken`; an empty input restarts the walk from the newest row.
+     */
+    nextPageToken: string;
 }
 /**
  * Options for creating a server-side TWAP parent order.
@@ -881,10 +918,31 @@ export interface ListTwapOrdersParams {
     state?: TwapOrderState;
     /** Filter by trading pair UUID */
     tradingPairId?: string;
-    /** Page number (1-indexed) */
+    /**
+     * Page number for legacy offset pagination.
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode; omitting both `page` and `pageToken`
+     * drives cursor mode.
+     */
     page?: number;
-    /** Items per page (max 100) */
+    /** Items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     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.
+     * - Empty string (`""`): start a cursor walk with no prior position, from
+     *   the newest TWAP parent.
+     * - Non-empty: an opaque cursor from a previous response's `nextPageToken`;
+     *   results resume immediately after that position.
+     *
+     * In either cursor-walk state, `page` and `total` come back as 0 — cursor
+     * mode runs no COUNT (AIP-158). Follow `nextPageToken` until it comes back
+     * empty. Filters must match the request that produced the token.
+     */
+    pageToken?: string;
 }
 /**
  * Response from listing TWAP parent orders.
@@ -892,14 +950,27 @@ export interface ListTwapOrdersParams {
 export interface ListTwapOrdersResponse {
     orders: TwapOrder[];
     /**
-     * Matching TWAP orders. Exact up to 10,000 pages of the requested page size
-     * (`pageSize` x 10,000 rows) and saturates there, so a caller with more
-     * matching TWAP orders than the listing can page through reads the cap, not
-     * its lifetime total. `page` is capped at 10,000.
+     * Matching TWAP orders in page-number (offset) mode: exact up to 10,000 pages
+     * of the requested page size (`pageSize` x 10,000 rows) and saturates there,
+     * so a caller with more matching TWAP orders than the listing can page through
+     * reads the cap, not its lifetime total. `0` in cursor (`pageToken`) mode,
+     * which runs no COUNT (AIP-158).
      */
     total: number;
-    /** Current page number */
+    /**
+     * Current page number in legacy offset mode; `0` in cursor mode.
+     *
+     * @deprecated Use cursor pagination (`pageToken`/`nextPageToken`) instead.
+     */
     page: number;
     /** Items per page */
     pageSize: number;
+    /**
+     * Cursor for the next page, minted only while a further page exists (the read
+     * over-fetches one row to decide). Empty on every page-number response and on
+     * the final cursor page — an empty token is the definitive end of the walk,
+     * so no extra request is needed. Do not feed the empty token back as
+     * `pageToken`; an empty input restarts the walk from the newest row.
+     */
+    nextPageToken: string;
 }

package/dist/validation/trading.d.ts

@@ -403,6 +403,7 @@ export declare const ListConditionalOrdersSchema: z.ZodObject<{
     }>>;
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const TwapOrderStateSchema: z.ZodEnum<{
     CANCELLED: "CANCELLED";
@@ -464,6 +465,7 @@ export declare const ListTwapOrdersSchema: z.ZodObject<{
     tradingPairId: z.ZodOptional<z.ZodUUID>;
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Single batch create order item validation schema

package/dist/validation/trading.js

@@ -420,12 +420,27 @@ export const ClosePositionSideSchema = z.enum(["LONG", "SHORT"], {
 export const CancelConditionalOrderSchema = z.object({
     conditionalOrderId: UUIDSchema,
 });
-export const ListConditionalOrdersSchema = z.object({
+export const ListConditionalOrdersSchema = z
+    .object({
     marginAccountId: UUIDSchema.optional(),
     tradingPairId: UUIDSchema.optional(),
     state: ConditionalOrderStateSchema.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 TwapOrderStateSchema = z.enum(["PENDING", "ACTIVE", "COMPLETED", "CANCELLED"], {
     message: "Invalid TWAP order state",
@@ -549,11 +564,26 @@ export const CreateTwapOrderSchema = z
 export const CancelTwapOrderSchema = z.object({
     twapOrderId: UUIDSchema,
 });
-export const ListTwapOrdersSchema = z.object({
+export const ListTwapOrdersSchema = z
+    .object({
     state: TwapOrderStateSchema.optional(),
     tradingPairId: 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"],
+        });
+    }
 });
 /**
  * Single batch create order item validation schema

package/dist/websocket/base.d.ts

@@ -64,9 +64,11 @@ export type WebSocketErrorCode =
  */
  | "SNAPSHOT_UNAVAILABLE"
 /**
- * The per-connection inbound message-rate cap was exceeded; the connection
- * is closed (1008) after this frame. Batch subscriptions and back off
- * before reconnecting — a hot re-subscribe loop trips the cap again.
+ * A per-connection inbound cap was exceeded: the message rate, or the byte
+ * budget that refuses a burst of very large frames. The connection is
+ * closed (1008) after this frame. Batch subscriptions, keep frames small,
+ * and back off before reconnecting — a hot re-subscribe loop trips the cap
+ * again.
  */
  | "MESSAGE_RATE_LIMIT";
 /**

package/dist/websocket/events/conditional-order-events.d.ts

@@ -117,6 +117,13 @@ export interface ConditionalOrderEventData {
      * snapshot builds the same shape with `"snapshot"` instead.
      */
     reason: string;
+    /**
+     * When the conditional order was created (ISO 8601): the same string REST
+     * returns as `createdAt` for this id, on live updates and snapshot rows
+     * alike. Always present from current servers; optional so a frame from an
+     * older deployment during a rolling release still parses. Wire: `created_at`.
+     */
+    createdAt?: string;
     updatedAt: string;
     /**
      * Opaque, compare-only revision counter for this conditional order's state —

package/dist/wire/schema.d.ts

@@ -3197,7 +3197,7 @@ export interface components {
              */
             riskBucketId?: string | null;
             /**
-             * @description Decimal collateral to allocate into a new isolated risk bucket. When provided, the API creates the bucket ID and matching-engine persists the bucket through the durable log.
+             * @description Decimal collateral allocated as an order budget in a new isolated risk bucket. Fills commit their required margin and paid-fee funding to position backing; unfilled or unused order funds do not protect the position from liquidation. Use position margin adjustment to add liquidation protection. The API creates the bucket ID and the matching engine persists it through the durable log.
              * @example 1000
              */
             riskBucketCollateral?: string | null;
@@ -3831,7 +3831,7 @@ export interface components {
              */
             riskBucketId?: string | null;
             /**
-             * @description Decimal collateral to allocate into a new isolated risk bucket. When provided, the API creates the bucket ID and matching-engine persists the bucket through the durable log.
+             * @description Decimal collateral allocated as an order budget in a new isolated risk bucket. Fills commit their required margin and paid-fee funding to position backing; unfilled or unused order funds do not protect the position from liquidation. Use position margin adjustment to add liquidation protection. The API creates the bucket ID and the matching engine persists it through the durable log.
              * @example 1000
              */
             riskBucketCollateral?: string | null;
@@ -5477,22 +5477,16 @@ export interface components {
             unrealizedPnl?: string | null;
             realizedPnl?: string | null;
             /**
-             * @description Open ISOLATED rows: the position's current backing — its risk bucket's
-             *      allocated collateral adjusted by settled realized PnL and funding paid,
-             *      net of collateral reserved for the bucket's open orders, clamped at zero
-             *      (0XM-2558). Partial closes and partial liquidations shrink the posted
-             *      margin pro-rata while the realized loss stays in the bucket, so this,
-             *      not the posted margin, is the unrealized-return denominator. Not a hard
-             *      -100% bound: the liquidation trigger and liquidation_price measure the
-             *      bucket's whole equity, order reserves included, so with a resting order
-             *      the return can pass -100% by that order's earmark before liquidation
-             *      lands; a mark can gap past the backing before the asynchronous
-             *      liquidation; a fully drained bucket serves "0". Served from the live risk
-             *      engine; when only persisted state is reachable the value is gross of
-             *      order reserves. Open CROSS rows fall back to the position's posted
-             *      margin. Terminal rows: total initial margin allocated across the
-             *      position's reducing executions when available — the margin basis for
-             *      lifetime realized return.
+             * @description Open ISOLATED rows: principal committed to the filled position, adjusted
+             *      by settled realized PnL, fees and funding, clamped at zero. Collateral
+             *      allocated to unfilled orders is excluded. This is the unrealized-return
+             *      denominator and the same backing used by isolated liquidation. Placing,
+             *      cancelling or resizing an unfilled order does not add position backing.
+             *      A price gap can pass the backing before asynchronous liquidation occurs.
+             *      Live and persisted reads use the same position-principal basis.
+             *      Open CROSS rows: the position's posted margin. Terminal rows: total
+             *      initial margin allocated across the position's reducing executions when
+             *      available, used as the basis for lifetime realized return.
              */
             isolatedMargin?: string | null;
             leverage?: string | null;
@@ -6243,14 +6237,29 @@ export interface components {
             orders?: components["schemas"]["ConditionalOrder"][] | null;
             /**
              * Format: uint32
-             * @description Matching conditional orders. Exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more matching conditional orders than the listing can page through reads the cap, not its lifetime total.
+             * @description Matching conditional orders in page-number (offset) mode: exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more matching conditional orders than the listing can page through reads the cap, not its lifetime total. 0 in cursor (pageToken) mode, which runs no COUNT (AIP-158).
              * @example 3
              */
             total?: number | null;
-            /** Format: uint32 */
+            /**
+             * Format: uint32
+             * @deprecated
+             * @description Deprecated: current page number (legacy offset mode only; 0 in cursor mode)
+             */
             page?: number | null;
             /** Format: uint32 */
             pageSize?: number | null;
+            /**
+             * @description Cursor for the next page, minted only when a further page exists — the
+             *      read over-fetches one row to decide, so there is no "maybe more" state.
+             *      Empty on every page-number (legacy) response, and empty on the final
+             *      cursor page (including a full final page, since nothing follows it).
+             *      Follow it until it comes back empty; that empty token is the definitive
+             *      end of the walk, so no extra zero-row request is needed. Do not feed the
+             *      empty token back as `page_token` — an empty input `page_token` restarts
+             *      the walk from the newest row.
+             */
+            nextPageToken?: string | null;
         };
         ListDelegatedAgentOwnersResponse: {
             /** @description Owners that have an active delegation to the calling agent */
@@ -6459,13 +6468,14 @@ export interface components {
             orders?: components["schemas"]["TwapOrder"][] | null;
             /**
              * Format: uint32
-             * @description Matching TWAP orders. Exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more matching TWAP orders than the listing can page through reads the cap, not its lifetime total.
+             * @description Matching TWAP orders in page-number (offset) mode: exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more matching TWAP orders than the listing can page through reads the cap, not its lifetime total. 0 in cursor (pageToken) mode, which runs no COUNT (AIP-158).
              * @example 3
              */
             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;
@@ -6475,6 +6485,17 @@ export interface components {
              * @example 20
              */
             pageSize?: number | null;
+            /**
+             * @description Cursor for the next page, minted only when a further page exists — the
+             *      read over-fetches one row to decide, so there is no "maybe more" state.
+             *      Empty on every page-number (legacy) response, and empty on the final
+             *      cursor page (including a full final page, since nothing follows it).
+             *      Follow it until it comes back empty; that empty token is the definitive
+             *      end of the walk, so no extra zero-row request is needed. Do not feed the
+             *      empty token back as `page_token` — an empty input `page_token` restarts
+             *      the walk from the newest row.
+             */
+            nextPageToken?: string | null;
         };
         ManagedMarketAssignment: {
             launchId?: string | null;
@@ -7134,22 +7155,16 @@ export interface components {
             unrealizedPnl?: string | null;
             realizedPnl?: string | null;
             /**
-             * @description Open ISOLATED rows: the position's current backing — its risk bucket's
-             *      allocated collateral adjusted by settled realized PnL and funding paid,
-             *      net of collateral reserved for the bucket's open orders, clamped at zero
-             *      (0XM-2558). Partial closes and partial liquidations shrink the posted
-             *      margin pro-rata while the realized loss stays in the bucket, so this,
-             *      not the posted margin, is the unrealized-return denominator. Not a hard
-             *      -100% bound: the liquidation trigger and liquidation_price measure the
-             *      bucket's whole equity, order reserves included, so with a resting order
-             *      the return can pass -100% by that order's earmark before liquidation
-             *      lands; a mark can gap past the backing before the asynchronous
-             *      liquidation; a fully drained bucket serves "0". Served from the live risk
-             *      engine; when only persisted state is reachable the value is gross of
-             *      order reserves. Open CROSS rows fall back to the position's posted
-             *      margin. Terminal rows: total initial margin allocated across the
-             *      position's reducing executions when available — the margin basis for
-             *      lifetime realized return.
+             * @description Open ISOLATED rows: principal committed to the filled position, adjusted
+             *      by settled realized PnL, fees and funding, clamped at zero. Collateral
+             *      allocated to unfilled orders is excluded. This is the unrealized-return
+             *      denominator and the same backing used by isolated liquidation. Placing,
+             *      cancelling or resizing an unfilled order does not add position backing.
+             *      A price gap can pass the backing before asynchronous liquidation occurs.
+             *      Live and persisted reads use the same position-principal basis.
+             *      Open CROSS rows: the position's posted margin. Terminal rows: total
+             *      initial margin allocated across the position's reducing executions when
+             *      available, used as the basis for lifetime realized return.
              */
             isolatedMargin?: string | null;
             leverage?: string | null;
@@ -7869,6 +7884,21 @@ export interface components {
              * @example 1172836500.00
              */
             openInterestNotional?: string | null;
+            /**
+             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 60 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (57) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @example 1172836500.00
+             */
+            openInterestNotionalAvg1h?: string | null;
+            /**
+             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 1440 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (1368) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @example 1172836500.00
+             */
+            openInterestNotionalAvg24h?: string | null;
+            /**
+             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 10080 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (9576) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @example 1172836500.00
+             */
+            openInterestNotionalAvg7d?: string | null;
         };
         /** @description One UTC-day bucket in a pair's 7-day snapshot. */
         ScreenerSnapshotPoint: {
@@ -7887,6 +7917,11 @@ export interface components {
              * @example 0.85
              */
             priceChangePercent?: string | null;
+            /**
+             * @description Arithmetic mean of the valued open-interest notional observations (one per completed UTC minute) in this completed UTC day; published once at least 95% of its 1440 minutes (1368) carry a valued sample, null for spot pairs or below that coverage. Samples use gross open position size x latest trade price in quote units; a minute without a trade price is unvalued, never zero; known zero remains "0". No historical backfill.
+             * @example 1172836500.00
+             */
+            openInterestNotionalAvg?: string | null;
         };
         SelfTradePreventionDefaultResponse: {
             /**
@@ -13211,10 +13246,29 @@ export interface operations {
                 /** @description Trading pair identifier (UUID) */
                 tradingPairId?: string;
                 state?: string;
-                /** @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 Pagination cursor with three distinct states:
+                 *       - Omitted: legacy page-number pagination via `page`.
+                 *       - Empty string (""): start a cursor walk with no prior position, from
+                 *         the newest conditional order.
+                 *       - 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 and
+                 *      `total` is not populated — both come back 0, because cursor mode runs no
+                 *      COUNT (AIP-158). Cursor pages are keyset seeks on `(createdAt, id)`, so a
+                 *      page size up to 1000 is allowed. Filters must match the request that
+                 *      produced the token; a token replayed against different filters is
+                 *      rejected.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;
@@ -13303,13 +13357,32 @@ export interface operations {
     list_twap_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;
                 state?: string;
                 /** @description Trading pair identifier (UUID) */
                 tradingPairId?: string;
+                /**
+                 * @description Pagination cursor with three distinct states:
+                 *       - Omitted: legacy page-number pagination via `page`.
+                 *       - Empty string (""): start a cursor walk with no prior position, from
+                 *         the newest TWAP parent.
+                 *       - 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 and
+                 *      `total` is not populated — both come back 0, because cursor mode runs no
+                 *      COUNT (AIP-158). Cursor pages are keyset seeks on `(createdAt, id)`, so a
+                 *      page size up to 1000 is allowed. Filters must match the request that
+                 *      produced the token; a token replayed against different filters is
+                 *      rejected.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.66",
+	"version": "1.0.67",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.66",
+		"@0xmonaco/contracts": "1.0.67",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {