@0xmonaco/types 1.0.75 → 1.0.76

package/dist/buildercodes/index.d.ts

@@ -51,10 +51,9 @@ export interface BuildercodesAPI extends BaseAPI {
      * A wallet that *used to be* a payout address keeps what it accrued back then
      * and can still claim it — payout-address changes are not retroactive.
      *
-     * Throws 403 when the caller is refused: BuilderCodes is not enabled, or
-     * the session is a delegated agent — which is rejected before the feature is
-     * checked, so it is a permanent restriction on that session type, not a
-     * rollout state. Throws 409 when the payout balance is insufficient for the
+     * Throws 403 when the session is a delegated agent — a permanent
+     * restriction on that session type, not a rollout state. No program switch
+     * gates the claim, so a balance already credited stays claimable. Throws 409 when the payout balance is insufficient for the
      * requested amount. Throws 503 when the matching engine is unreachable,
      * restarting, or slow to answer — an UNKNOWN outcome, not a rejection: the
      * claim is admitted to the sequencer before its reply is sent, so it may

package/dist/buildercodes/responses.d.ts

@@ -72,10 +72,17 @@ export declare const BuildercodePayoutKindSchema: z.ZodEnum<{
     REVENUE_SHARE: "REVENUE_SHARE";
     BUILDER_FEE: "BUILDER_FEE";
 }>;
-/** Pagination and filter accepted by the per-trade payout history endpoint. */
+/**
+ * Pagination and filter accepted by the per-trade payout history endpoint.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted, so a caller
+ * still looping on it fails loudly instead of being handed the first cursor page
+ * on every call.
+ */
 export declare const ListBuildercodePayoutsParamsSchema: z.ZodObject<{
-    page: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNever>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
     kind: z.ZodOptional<z.ZodEnum<{
         REVENUE_SHARE: "REVENUE_SHARE";
         BUILDER_FEE: "BUILDER_FEE";
@@ -109,9 +116,9 @@ export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
-    page: z.ZodNumber;
     pageSize: z.ZodNumber;
     totalPages: z.ZodNumber;
+    nextPageToken: z.ZodString;
 }, z.core.$strip>;
 /** One token-denominated BuilderCodes earnings total. */
 export declare const BuildercodePayoutTokenTotalSchema: z.ZodObject<{

package/dist/buildercodes/responses.js

@@ -58,10 +58,24 @@ export const ListBuilderFeeChangesResponseSchema = z.object({
  * Monaco revenue share; `BUILDER_FEE` records builder fees charged to takers.
  */
 export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE"]);
-/** Pagination and filter accepted by the per-trade payout history endpoint. */
+/**
+ * Pagination and filter accepted by the per-trade payout history endpoint.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted, so a caller
+ * still looping on it fails loudly instead of being handed the first cursor page
+ * on every call.
+ */
 export const ListBuildercodePayoutsParamsSchema = z.object({
-    page: z.number().int().min(1).max(10_000).optional(),
-    pageSize: z.number().int().min(1).max(100).optional(),
+    page: z.never().optional(),
+    pageSize: z.number().int().min(1).max(1000).optional(),
+    /**
+     * Cursor with two states: omitted or `""` starts a walk from the newest
+     * credit; a previous response's `nextPageToken` resumes it. The walk seeks on
+     * `(createdAt, id)` descending — both NOT NULL and fixed for a credit's
+     * lifetime. The filter must match the request that minted the token, or the
+     * request is rejected with a `400`.
+     */
+    pageToken: z.string().optional(),
     /** Only return credits of this kind; `total` counts the filtered rows. Omit for every kind. */
     kind: BuildercodePayoutKindSchema.optional(),
 });
@@ -80,9 +94,15 @@ export const BuildercodePayoutSchema = z.object({
 export const ListBuildercodePayoutsResponseSchema = z.object({
     payouts: z.array(BuildercodePayoutSchema),
     total: z.number().int().nonnegative(),
-    page: z.number().int().positive(),
     pageSize: z.number().int().positive(),
     totalPages: z.number().int().nonnegative(),
+    /**
+     * Cursor for the next page, minted from the last row of an over-fetched read:
+     * this listing is one ordered read, so an empty string is a definitive end.
+     * Pass it back as `pageToken`; do not drive the walk off `total` or
+     * `totalPages`.
+     */
+    nextPageToken: z.string(),
 });
 /** One token-denominated BuilderCodes earnings total. */
 export const BuildercodePayoutTokenTotalSchema = z.object({

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

@@ -23,15 +23,34 @@ export interface ManagedMarketAssignment {
     quoteEnabled: boolean;
 }
 export interface ListManagedMarketAssignmentsRequest {
-    page?: number;
+    /**
+     * Items per page (1–1000). This listing defaults it to **100**, not the
+     * shared 20. A larger value is rejected, not clamped.
+     */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states: omitted or `""` starts a walk from the
+     * OLDEST assignment; a previous response's `nextPageToken` resumes it.
+     *
+     * The walk seeks on `(createdAt, id)` **ascending** — oldest first, the order
+     * this listing already read in — served by
+     * `idx_market_launch_maker_inventory (makerUserId, makerApplicationId,
+     * createdAt, id)`; both key columns are fixed for an assignment's lifetime.
+     * Page-number pagination was removed (0XM-2788).
+     */
+    pageToken?: string;
 }
 export interface ListManagedMarketAssignmentsResponse {
     items: ManagedMarketAssignment[];
     total: number;
-    page: number;
     pageSize: number;
     inventoryObservedAt: string;
+    /**
+     * Cursor for the next page, minted from the last row of an over-fetched read:
+     * this listing is one ordered read, so an empty string is a definitive end.
+     * Pass it back as `pageToken`.
+     */
+    nextPageToken: string;
 }
 export interface ClaimManagedMarketLeaseRequest {
     ownerId: string;

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/validation/index.d.ts

@@ -16,6 +16,7 @@
 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

@@ -17,6 +17,7 @@
 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/market.d.ts

@@ -244,3 +244,24 @@ export declare const ListAllFundingHistorySchema: z.ZodObject<{
         DESC: "DESC";
     }>>;
 }, z.core.$strip>;
+/**
+ * Public trades-feed listing validation schema.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted, but NOT for
+ * the same reason as {@link ListFundingHistorySchema}. That one is built on a
+ * query builder that serializes whatever keys the params object carries, so a
+ * leftover `page` reaches the wire and comes back as the server's `400`.
+ * `getTrades` instead sets `pageSize` and `pageToken` explicitly, so a stray
+ * `page` never leaves the client at all — which makes rejecting it more
+ * important here, not less. Stripped silently, it would leave the caller
+ * requesting page 2, 3, 4 and receiving the FIRST cursor page every time, with
+ * no error from either side to reveal the loop. `z.never()` turns that silent
+ * non-advancing walk into an immediate `ValidationError`.
+ *
+ * The ceiling is the cursor-mode 1000; the historical default of 25 stays.
+ */
+export declare const GetTradesSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNever>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/validation/market.js

@@ -246,3 +246,24 @@ const FundingHistoryCursorSchema = z.object({
 export const ListFundingHistorySchema = FundingHistoryCursorSchema;
 /** All-markets funding history. */
 export const ListAllFundingHistorySchema = FundingHistoryCursorSchema;
+/**
+ * Public trades-feed listing validation schema.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted, but NOT for
+ * the same reason as {@link ListFundingHistorySchema}. That one is built on a
+ * query builder that serializes whatever keys the params object carries, so a
+ * leftover `page` reaches the wire and comes back as the server's `400`.
+ * `getTrades` instead sets `pageSize` and `pageToken` explicitly, so a stray
+ * `page` never leaves the client at all — which makes rejecting it more
+ * important here, not less. Stripped silently, it would leave the caller
+ * requesting page 2, 3, 4 and receiving the FIRST cursor page every time, with
+ * no error from either side to reveal the loop. `z.never()` turns that silent
+ * non-advancing walk into an immediate `ValidationError`.
+ *
+ * The ceiling is the cursor-mode 1000; the historical default of 25 stays.
+ */
+export const GetTradesSchema = 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/vault.d.ts

@@ -75,3 +75,17 @@ export declare const WithdrawSchema: z.ZodObject<{
 export declare const GetBalanceSchema: z.ZodObject<{
     assetId: z.ZodUUID;
 }, z.core.$strip>;
+/**
+ * Pending-withdrawals listing validation schema.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted: the client
+ * forwards the params field by field, which would drop a stray `page` before it
+ * reached the wire, so a JavaScript or `any` caller looping on `{ page: n }`
+ * would be handed the FIRST cursor page on every call and would never advance —
+ * the exact failure the REST 400 exists to surface.
+ */
+export declare const ListPendingWithdrawalsSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNever>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/validation/vault.js

@@ -86,3 +86,17 @@ export const WithdrawSchema = z.object({
 export const GetBalanceSchema = z.object({
     assetId: UUIDSchema,
 });
+/**
+ * Pending-withdrawals listing validation schema.
+ *
+ * Cursor paged (0XM-2821). `page` is REJECTED rather than omitted: the client
+ * forwards the params field by field, which would drop a stray `page` before it
+ * reached the wire, so a JavaScript or `any` caller looping on `{ page: n }`
+ * would be handed the FIRST cursor page on every call and would never advance —
+ * the exact failure the REST 400 exists to surface.
+ */
+export const ListPendingWithdrawalsSchema = 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/websocket/events/instrument-events.d.ts

@@ -15,13 +15,18 @@
  * A subscriber receives a subscribe-time snapshot of the current active-pair
  * configuration list (each frame a `Listing` baseline) before the live diffs.
  *
- * Perp-only fields (`maxLeverage`, `initialMarginRate`, `maintenanceMarginRate`)
+ * Perp-only fields (`minLeverage`, `maxLeverage`, `initialMarginRate`, `maintenanceMarginRate`)
  * are optional and omitted on the wire for spot markets, which have no leverage
  * or margin parameters. All numeric quantities are decimal strings.
  *
  * Every frame (snapshot and live) carries `baseIconUrl` and `quoteIconUrl` for
  * the market's two assets, each `null` when that asset has no icon configured,
  * so a client can render a position's asset icons from the instrument row alone.
+ *
+ * Every frame also carries the market's asset identity: `baseAssetId`,
+ * `quoteAssetId`, `baseToken`, `quoteToken`, `baseAssetName`, `quoteAssetName`,
+ * `baseDecimals` and `quoteDecimals`. Perp frames add `minLeverage`. These are
+ * declared optional because a server that predates them omits them.
  */
 /**
  * The kind of instrument change a frame reports.
@@ -69,6 +74,25 @@ export interface InstrumentEventData {
     marketType: string;
     /** Asset-class category, e.g. "crypto", "equities", "commodities" */
     category: string;
+    /**
+     * Base asset identifier (UUID). The server sends this on every market (spot
+     * and perp); declared optional because an older server omits it.
+     */
+    baseAssetId?: string;
+    /** Quote asset identifier (UUID). See {@link InstrumentEventData.baseAssetId}. */
+    quoteAssetId?: string;
+    /** Base asset ticker symbol, e.g. "BTC". Sent on every market. */
+    baseToken?: string;
+    /** Quote asset ticker symbol, e.g. "USDC". Sent on every market. */
+    quoteToken?: string;
+    /** Base asset display name, e.g. "Bitcoin". Sent on every market. */
+    baseAssetName?: string;
+    /** Quote asset display name, e.g. "USD Coin". Sent on every market. */
+    quoteAssetName?: string;
+    /** Base asset decimals (integer). Sent on every market. */
+    baseDecimals?: number;
+    /** Quote asset decimals (integer). Sent on every market. */
+    quoteDecimals?: number;
     /**
      * Base asset icon URL, or `null` when the asset has no icon configured.
      * The server sends this on every market (spot and perp) as an explicit `null`
@@ -83,6 +107,8 @@ export interface InstrumentEventData {
      * {@link InstrumentEventData.baseIconUrl}.
      */
     quoteIconUrl?: string | null;
+    /** Minimum leverage (decimal string). Perp-only; omitted for spot. */
+    minLeverage?: string;
     /** Maximum leverage (decimal string). Perp-only; omitted for spot. */
     maxLeverage?: string;
     /** Initial margin rate (decimal string). Perp-only; omitted for spot. */

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

@@ -15,11 +15,16 @@
  * A subscriber receives a subscribe-time snapshot of the current active-pair
  * configuration list (each frame a `Listing` baseline) before the live diffs.
  *
- * Perp-only fields (`maxLeverage`, `initialMarginRate`, `maintenanceMarginRate`)
+ * Perp-only fields (`minLeverage`, `maxLeverage`, `initialMarginRate`, `maintenanceMarginRate`)
  * are optional and omitted on the wire for spot markets, which have no leverage
  * or margin parameters. All numeric quantities are decimal strings.
  *
  * Every frame (snapshot and live) carries `baseIconUrl` and `quoteIconUrl` for
  * the market's two assets, each `null` when that asset has no icon configured,
  * so a client can render a position's asset icons from the instrument row alone.
+ *
+ * Every frame also carries the market's asset identity: `baseAssetId`,
+ * `quoteAssetId`, `baseToken`, `quoteToken`, `baseAssetName`, `quoteAssetName`,
+ * `baseDecimals` and `quoteDecimals`. Perp frames add `minLeverage`. These are
+ * declared optional because a server that predates them omits them.
  */

package/dist/websocket/events/market-stats-events.d.ts

@@ -13,8 +13,9 @@
  *
  * Perp-only fields (index/mark price, open interest, funding) are optional and
  * omitted on the wire for spot markets, which have no positions or funding.
- * All numeric quantities are decimal strings except `fundingTimestamp`, which
- * is a millisecond epoch number.
+ * All numeric quantities are decimal strings except `fundingTimestamp` and
+ * `lastFundingTime` (millisecond epoch numbers) and `fundingIntervalSeconds`
+ * (whole seconds).
  */
 /**
  * Market tradability label, derived from the oracle market status. Spot markets
@@ -23,6 +24,10 @@
 export type MarketStatus = "TRADABLE" | "POST_ONLY" | "HALTED" | "NOT_READY" | "UNKNOWN";
 /**
  * Full per-market statistics for the `market_stats:<tradingPairId>` channel.
+ *
+ * `marketStatus` is typed `MarketStatus | (string & {})` for the same reason as
+ * on {@link MarketStatsSummary}: an unrecognized status is passed through
+ * rather than dropping the frame. Match it with a `default` branch.
  */
 export interface MarketStatsData {
     /** Market symbol, e.g. "BTC/USDC" */
@@ -39,10 +44,24 @@ export interface MarketStatsData {
     bestBidPrice?: string;
     /** Best ask price (decimal string) */
     bestAskPrice?: string;
-    /** Open interest (decimal string). Perp-only; omitted for spot. */
+    /**
+     * Open interest (decimal string). Perp-only; omitted for spot, and omitted
+     * (never zero) until the market's open interest is known.
+     */
     openInterest?: string;
-    /** Open interest limit (decimal string). Perp-only; omitted for spot. */
+    /**
+     * The market's gross open-interest cap, in quote (USD) notional (decimal
+     * string). `openInterest` is in base units: multiply it by `markPrice` to
+     * compare. Perp-only; omitted for spot.
+     */
     openInterestLimit?: string;
+    /**
+     * What is left of `openInterestLimit` at the mark, in quote (USD) notional,
+     * never below zero (decimal string). At zero, orders that open exposure are
+     * refused until open interest or the mark falls. Perp-only; omitted for spot,
+     * when there is no mark, and until open interest is known.
+     */
+    openInterestHeadroom?: string;
     /** Last trade price (decimal string) */
     lastTradePrice?: string;
     /** 24h base-token volume (decimal string) */
@@ -71,6 +90,20 @@ export interface MarketStatsData {
     fundingClampSmall?: string;
     /** Live funding cap, upper bound (decimal string). Perp-only; omitted for spot. */
     fundingClampBig?: string;
+    /**
+     * Tradability label, the same value the all-markets summary carries for this
+     * market. Perp markets report any {@link MarketStatus}; spot markets report
+     * `TRADABLE` or `HALTED`. Always present on frames from current servers.
+     */
+    marketStatus?: MarketStatus | (string & {});
+    /** Funding settlement interval in whole seconds. Perp-only; omitted for spot. */
+    fundingIntervalSeconds?: number;
+    /**
+     * When the latest funding window settled, as a millisecond epoch number
+     * (REST `getFundingState` returns the same instant as an RFC 3339 string).
+     * Perp-only; omitted for spot and for a market that has not settled yet.
+     */
+    lastFundingTime?: number;
 }
 /**
  * Per-market statistics event on the `market_stats:<tradingPairId>` channel.
@@ -111,7 +144,10 @@ export interface MarketStatsSummary {
     dailyPriceHigh?: string;
     /** 24h low price (decimal string) */
     dailyPriceLow?: string;
-    /** Open interest (decimal string). Perp-only; omitted for spot. */
+    /**
+     * Open interest (decimal string). Perp-only; omitted for spot, and omitted
+     * (never zero) until the market's open interest is known.
+     */
     openInterest?: string;
     /** Current (last settled) funding rate (decimal string). Perp-only; omitted for spot. */
     currentFundingRate?: string;

package/dist/websocket/events/market-stats-events.js

@@ -13,6 +13,7 @@
  *
  * Perp-only fields (index/mark price, open interest, funding) are optional and
  * omitted on the wire for spot markets, which have no positions or funding.
- * All numeric quantities are decimal strings except `fundingTimestamp`, which
- * is a millisecond epoch number.
+ * All numeric quantities are decimal strings except `fundingTimestamp` and
+ * `lastFundingTime` (millisecond epoch numbers) and `fundingIntervalSeconds`
+ * (whole seconds).
  */

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

@@ -227,6 +227,21 @@ export interface OrderPlacedEvent extends OrderEvent {
          * spot. Wire: `reduce_only`.
          */
         reduceOnly?: boolean;
+        /**
+         * The fill an edit carried over from the original order (decimal string).
+         * Sent only when the order is a replacement of a partly filled order; its
+         * `quantity` is then the order's total and its `status` is
+         * `PARTIALLY_FILLED`, as REST reports the edited order. Omitted on any
+         * other `OrderPlaced`. Wire: `filled_quantity`.
+         */
+        filledQuantity?: string;
+        /** `filledQuantity` in RAW (integer, base-unit) precision. Wire: `filled_quantity_raw`. */
+        filledQuantityRaw?: string;
+        /**
+         * Average fill price of the carried fill (decimal string). Sent with
+         * `filledQuantity`, omitted otherwise. Wire: `average_fill_price`.
+         */
+        averageFillPrice?: string;
     };
 }
 /**
@@ -311,7 +326,11 @@ export interface OrderMatchedEvent extends OrderEvent {
         tradesCount: number;
         /** Remaining quantity to be filled. */
         remainingQuantity: string;
-        /** Average fill price across all trades. `null` when there is none. */
+        /**
+         * The order's cumulative average fill price, across every fill — those an
+         * edit carried over from the original order included, matching REST.
+         * `null` when there is none. This match's own price is `executionPrice`.
+         */
         averageFillPrice: string | null;
         /** Order status. */
         status: OrderStatus | (string & {});
@@ -345,7 +364,11 @@ export interface OrderPartiallyFilledEvent extends OrderEvent {
         tradesCount?: number;
         /** Remaining quantity (present for both taker and maker) */
         remainingQuantity?: string;
-        /** Average fill price (taker orders only) */
+        /**
+         * The order's cumulative average fill price, on both roles: the average
+         * across every fill of the order (an edit's carried fills included), as
+         * REST reports it — not this trade's price, which is `executionPrice`.
+         */
         averageFillPrice?: string;
         /** Order status (taker orders only) */
         status?: OrderStatus | (string & {});
@@ -439,7 +462,11 @@ export interface OrderFilledEvent extends OrderEvent {
         tradesCount?: number;
         /** Remaining quantity (present for both, should be 0 for filled orders) */
         remainingQuantity?: string;
-        /** Average fill price (taker orders only) */
+        /**
+         * The order's cumulative average fill price, on both roles: the average
+         * across every fill of the order (an edit's carried fills included), as
+         * REST reports it — not this trade's price, which is `executionPrice`.
+         */
         averageFillPrice?: string;
         /** Order status (taker orders only) */
         status?: OrderStatus | (string & {});

package/dist/wire/schema.d.ts

@@ -732,9 +732,10 @@ export interface paths {
          *      application's behalf do not count. Setting the fee it already has is a
          *      no-op that succeeds and does not use up a change.
          *
-         *      The fee can be set while builder fees are switched off
-         *      (`builderFeeEnabled` false): it is stored and nothing is charged until they
-         *      are switched on. A newly stored fee reaches order requests within a few
+         *      The fee can be set while the revenue share or builder fees are switched
+         *      on, and is refused (**HTTP 403** / **PERMISSION_DENIED**) while both are
+         *      off. With builder fees off (`builderFeeEnabled` false) it is stored and
+         *      nothing is charged until they are switched on. A newly stored fee reaches order requests within a few
          *      seconds. Sequencer ordering is authoritative for matching-engine policy and
          *      enrollment state: an order processed before one of those sequenced changes
          *      uses the earlier state, and a later order uses the new state.
@@ -790,8 +791,7 @@ export interface paths {
          *
          *      The application is taken from the authenticated session; there is no
          *      application id in the request. The caller must be the application's
-         *      configured payout wallet. This method is gated by `buildercodes_enabled`
-         *      like the rest of the service.
+         *      configured payout wallet.
          */
         get: operations["get_buildercodes_config"];
         put?: never;
@@ -912,13 +912,13 @@ export interface paths {
          *
          *      Delegated-agent sessions are refused: a delegated grant conveys only
          *      order-management authority, and this claim converts reserved balance into a
-         *      tradeable one. The refusal happens before the feature check, so a delegated
-         *      caller is refused whether or not BuilderCodes is enabled.
+         *      tradeable one. No program switch gates the claim: a balance already
+         *      credited stays claimable whether or not the revenue share is on.
          *
          *      Transport contracts differ, and this comment is emitted into the generated
          *      gRPC SDK where HTTP statuses do not exist. An insufficient payout balance
          *      is **HTTP 409** on REST and **FAILED_PRECONDITION** on gRPC; a refused
-         *      caller (delegated session, or BuilderCodes disabled) is **HTTP 403** on
+         *      caller (delegated session) is **HTTP 403** on
          *      REST and **PERMISSION_DENIED** on gRPC.
          *
          *      A claim can also fail as **HTTP 503** / **UNAVAILABLE** when the matching
@@ -5517,7 +5517,7 @@ export interface components {
              * @example 0x0000000000000000000000000000000000000001
              */
             payoutAddress?: string | null;
-            /** @description Current BuilderCodes feature-flag state. Successful responses are true because this endpoint is gated by the flag. */
+            /** @description Whether the BuilderCodes revenue share is switched on. While false no new share accrues; balances already credited stay readable and claimable. */
             buildercodesEnabled?: boolean | null;
             /**
              * Format: uint32
@@ -6896,18 +6896,36 @@ export interface components {
         /** @description Recent trades for a trading pair. */
         GetTradesResponse: {
             trades?: components["schemas"]["PublicTrade"][] | null;
-            /**
-             * Format: uint32
-             * @description Current page number
-             * @example 1
-             */
-            page?: number | null;
             /**
              * Format: uint32
              * @description Maximum number of trades returned
              * @example 25
              */
             pageSize?: number | null;
+            /**
+             * @description Cursor for the next page, under **proven** semantics: the read over-fetches
+             *      one row past `page_size`, so an empty token means the walk is finished and
+             *      a non-empty token means a further trade was actually seen. Unlike
+             *      `ListUserTradesResponse.next_page_token` (AIP-158 "maybe more"), a client
+             *      can stop here on the empty token without a confirming extra request — this
+             *      listing reads one table, so there is no hot/archive interleave that could
+             *      hide rows behind a short page.
+             *
+             *      That one table is the hot `trades` table, so a walk reaches the end of the
+             *      archiver's retention window rather than the end of the pair's history. This
+             *      is the endpoint's long-standing scope, unchanged by the cursor.
+             *
+             *      There is no public walk over a pair's ARCHIVED history, and this endpoint is
+             *      not a partial one — do not point market-data consumers at the user trade
+             *      listings to continue it. `GetUserTrades` / `ListUserTrades` do merge the
+             *      archive, but they are authenticated and user-scoped (`auth.user_id` is the
+             *      read's first mandatory filter), so they return only trades where the caller
+             *      was maker or taker. Following them to extend a public pair tape would
+             *      silently drop every fill between two other parties. An individual archived
+             *      trade does stay publicly reachable by id: `GetTradeById` falls back to the
+             *      archive table on a hot miss.
+             */
+            nextPageToken?: string | null;
         };
         /** @description Single trading pair details. */
         GetTradingPairResponse: {
@@ -7442,11 +7460,6 @@ export interface components {
              * @description Total payout rows for this application.
              */
             total?: number | null;
-            /**
-             * Format: uint32
-             * @description Current page number.
-             */
-            page?: number | null;
             /**
              * Format: uint32
              * @description Items per page.
@@ -7457,6 +7470,12 @@ export interface components {
              * @description Total number of pages.
              */
             totalPages?: number | null;
+            /**
+             * @description 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
+             *      `page_size` proves the walk is exhausted and this is empty.
+             */
+            nextPageToken?: string | null;
         };
         ListConditionalOrdersResponse: {
             orders?: components["schemas"]["ConditionalOrder"][] | null;
@@ -7563,13 +7582,20 @@ export interface components {
         ListManagedMarketAssignmentsResponse: {
             /** @description Expected assignments, including phases currently unable to quote. */
             items?: components["schemas"]["ManagedMarketAssignment"][] | null;
-            /** Format: uint32 */
+            /**
+             * Format: uint32
+             * @description Exact: a maker's assignment inventory is a small bounded set.
+             */
             total?: number | null;
             /** Format: uint32 */
-            page?: number | null;
-            /** Format: uint32 */
             pageSize?: number | null;
             inventoryObservedAt?: string | null;
+            /**
+             * @description 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
+             *      `page_size` proves the walk is exhausted and this is empty.
+             */
+            nextPageToken?: string | null;
         };
         ListMarginAccountsResponse: {
             accounts?: components["schemas"]["MarginAccountSummary"][] | null;
@@ -7641,12 +7667,6 @@ export interface components {
              * @example 3
              */
             total?: number | null;
-            /**
-             * Format: uint32
-             * @description Current page number
-             * @example 1
-             */
-            page?: number | null;
             /**
              * Format: uint32
              * @description Items per page
@@ -7659,6 +7679,12 @@ export interface components {
              * @example 1
              */
             totalPages?: number | null;
+            /**
+             * @description 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
+             *      `page_size` proves the walk is exhausted and this is empty.
+             */
+            nextPageToken?: string | null;
         };
         ListPositionHistoryResponse: {
             events?: components["schemas"]["PositionHistoryEvent"][] | null;
@@ -9215,11 +9241,14 @@ export interface components {
              */
             maintenanceMarginRatio?: string | null;
             /**
-             * @deprecated
-             * @description DEPRECATED compatibility alias. This value is a maximum absolute base-asset quantity, not a notional. Use maxPositionSize.
+             * @description The most USD notional a position may hold at this bracket's max leverage: the next bracket's lowerBoundNotional, or the market's position cap on the top bracket. A position is valued at the order's price. Below the top bracket the cap is exclusive, since a notional at the next bound already sits in the next bracket. An order at a given leverage may take its position up to the cap of the highest bracket whose maxLeverage allows that leverage.
+             * @example 100000000
              */
             maxPositionNotional?: string | null;
-            /** @description Maximum authoritative absolute position size in base-asset quantity. A market-wide cap, repeated on every tier rather than varying per bracket. */
+            /**
+             * @deprecated
+             * @description DEPRECATED and no longer set: positions are capped in notional per bracket. Use maxPositionNotional.
+             */
             maxPositionSize?: string | null;
             /**
              * Format: uint32
@@ -12802,7 +12831,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            /** @description Refused: neither the revenue share nor builder fees are switched on, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -12872,7 +12901,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            /** @description Refused: the caller is delegated or is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -12920,7 +12949,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            /** @description Refused: the caller is delegated or is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -12946,10 +12975,48 @@ export interface operations {
     list_buildercode_payouts: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
-                page?: number;
-                /** @description Items per page (max 100) */
+                /** @description Items per page (max 1000) */
                 pageSize?: number;
+                /**
+                 * @description Pagination cursor with two states:
+                 *       - Omitted or empty string (""): start a cursor walk with no prior
+                 *         position, from the newest credit.
+                 *       - Non-empty: an opaque cursor from a previous response's
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      The walk seeks on `(created_at, id)` descending, served by
+                 *      `idx_buildercode_payouts_application_created_id`, whose leading key is the
+                 *      caller's own application and whose remaining keys are this seek's, both
+                 *      descending. Both key columns are NOT NULL and fixed for a credit's
+                 *      lifetime. (Spelled without the column list on purpose: the read contract
+                 *      test asserts this request message never mentions a caller-selected
+                 *      identity.)
+                 *
+                 *      This REPLACES the removed mode's `(sequence, sequence_ordinal, created_at,
+                 *      id)` order, whose two leading columns are nullable — no backfill exists
+                 *      for credits written before they did — and a nullable leading key cannot be
+                 *      a total cursor key: the NULL rows sort together at one end, and a seek
+                 *      through them would need a COALESCE no index covers.
+                 *
+                 *      ORDERING CHANGE, not just a pagination change. The new key is total and
+                 *      stable — a page can neither skip nor duplicate a credit — but it is NOT
+                 *      chronological inside one persistor batch. `created_at` defaults to `NOW()`,
+                 *      which is transaction-start time, so every credit one batch writes shares an
+                 *      identical timestamp; the `id` tie-break defaults to `gen_random_uuid()`,
+                 *      which the persistor leaves alone. So within a batch the order is arbitrary
+                 *      and a LATER fill can be listed ahead of an earlier one. The removed order
+                 *      led with `sequence` and `sequence_ordinal` precisely because those carry
+                 *      the engine's fill order, and one entry routinely holds several credits (a
+                 *      taker sweeping N makers, or a flattened `BatchCreateOrders`). Preserving
+                 *      fill chronology would need those columns backfilled first, which is not
+                 *      possible for credits written before they existed. Across batches the order
+                 *      is still newest-first.
+                 *
+                 *      `total` and `total_pages` are populated and exact, and count the rows the
+                 *      `kind` filter selects. Filters must match the request that produced the
+                 *      token, or the request is rejected 400.
+                 */
+                pageToken?: string;
                 /** @description Only return BuilderCodes payouts of this payout kind: REVENUE_SHARE (the frontend's share of Monaco's fee) or BUILDER_FEE (ordinary builder fees charged to takers and credited to enrolled applications). Omit for every kind. */
                 kind?: "REVENUE_SHARE" | "BUILDER_FEE";
             };
@@ -12982,7 +13049,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            /** @description Refused: the caller is delegated or is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -13030,7 +13097,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            /** @description Refused: the caller is delegated or is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -13078,7 +13145,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Refused: BuilderCodes is disabled or the caller is delegated (gRPC: PERMISSION_DENIED) */
+            /** @description Refused: the caller is delegated (gRPC: PERMISSION_DENIED) */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -13130,7 +13197,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Refused: BuilderCodes is not enabled, or the caller is a delegated-agent session (gRPC: PERMISSION_DENIED) */
+            /** @description Refused: the caller is a delegated-agent session (gRPC: PERMISSION_DENIED) */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -14678,10 +14745,24 @@ export interface operations {
     list_managed_market_assignments: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
-                page?: number;
-                /** @description Items per page (max 100) */
+                /** @description Items per page (max 1000) */
                 pageSize?: number;
+                /**
+                 * @description Pagination cursor with two states:
+                 *       - Omitted or empty string (""): start a cursor walk with no prior
+                 *         position, from the oldest assignment.
+                 *       - Non-empty: an opaque cursor from a previous response's
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      The walk seeks on `(created_at, id)` ascending — the order this listing
+                 *      already read in, and the order
+                 *      `idx_market_launch_maker_inventory (maker_user_id, maker_application_id,
+                 *      created_at, id)` is built for, so the seek stays an index scan. Both
+                 *      columns are NOT NULL and fixed for a launch's lifetime. `total` is
+                 *      populated and exact: a maker's assignment inventory is a small bounded
+                 *      set.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;
@@ -18034,10 +18115,24 @@ export interface operations {
     get_trades: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
-                page?: number;
-                /** @description Max trades to return (max 100) */
+                /** @description Max trades to return (max 1000) */
                 pageSize?: number;
+                /**
+                 * @description Pagination cursor with two states:
+                 *       - Omitted or empty string (""): start a cursor walk with no prior
+                 *         position, from the most recent trade (this listing always sorts
+                 *         newest-first).
+                 *       - Non-empty: an opaque cursor from a previous response's
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      The walk is a keyset seek on `(executed_at, id)`, both immutable once a
+                 *      trade is written, so a page can neither repeat nor skip a trade when new
+                 *      fills land mid-walk — the failure the removed page number had by
+                 *      construction on a table this endpoint appends to continuously.
+                 *      `trading_pair_id` is pinned inside the token, so a token minted for one
+                 *      pair is rejected rather than seeking into another pair's history.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path: {
@@ -18128,10 +18223,24 @@ export interface operations {
     list_pending_withdrawals: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
-                page?: number;
-                /** @description Items per page (max 100) */
+                /** @description Items per page (max 1000) */
                 pageSize?: number;
+                /**
+                 * @description Pagination cursor with two states:
+                 *       - Omitted or empty string (""): start a cursor walk with no prior
+                 *         position, from the newest pending withdrawal.
+                 *       - Non-empty: an opaque cursor from a previous response's
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      The walk seeks on `(created_at, withdrawal_index)` descending — the order
+                 *      this listing already read in, served by
+                 *      `idx_withdrawals_user_created (user_id, created_at DESC)`. `created_at` is
+                 *      NOT NULL and `withdrawal_index` is the table's primary key, assigned by
+                 *      the vault in request order, so the key is total and immutable. `total` is
+                 *      populated and exact: a user's unexecuted withdrawals are a small bounded
+                 *      set.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;

package/dist/withdrawals/index.d.ts

@@ -60,16 +60,32 @@ export interface WithdrawalsAPI extends BaseAPI {
     getWithdrawal(withdrawalIndex: number): Promise<WithdrawalResponse>;
     /**
      * List the caller's pending withdrawals (those still awaiting on-chain root
-     * confirmation). Authenticated and scoped to the caller. Newest first, paged.
+     * confirmation). Authenticated and scoped to the caller. Newest first.
+     *
+     * Cursor-paged: omit `pageToken` (or send `""`) to start, then follow
+     * `nextPageToken` until it comes back empty. Page-number pagination was
+     * removed (0XM-2788).
      */
     listPendingWithdrawals(params?: ListPendingWithdrawalsParams): Promise<ListPendingWithdrawalsResponse>;
 }
 /** Query parameters for {@link WithdrawalsAPI.listPendingWithdrawals}. */
 export interface ListPendingWithdrawalsParams {
-    /** Page number, 1-based. Defaults to 1. */
-    page?: number;
-    /** Items per page (1–100). Defaults to 20. */
+    /** Items per page (1–1000). Defaults to 20. A larger value is rejected, not clamped. */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     *
+     * - Omitted or `""`: start a walk from the newest pending withdrawal.
+     * - Non-empty: an opaque cursor from a previous response's `nextPageToken`;
+     *   the walk resumes immediately after that position.
+     *
+     * The walk seeks on `(createdAt, withdrawalIndex)` descending. `createdAt` is
+     * always set and `withdrawalIndex` is the row's primary key, so the key is
+     * total and immutable and a withdrawal requested mid-walk cannot make the
+     * walk repeat or drop a row. The filters must match the request that minted
+     * the token, or the request is rejected with a `400`.
+     */
+    pageToken?: string;
 }
 /**
  * A single pending withdrawal in a {@link ListPendingWithdrawalsResponse}. A
@@ -105,10 +121,15 @@ export interface ListPendingWithdrawalsResponse {
     withdrawals: PendingWithdrawal[];
     /** Total number of pending withdrawals for the caller. */
     total: number;
-    /** Current page number. */
-    page: number;
     /** Items per page. */
     pageSize: number;
     /** Total number of pages. */
     totalPages: number;
+    /**
+     * Cursor for the next page, minted from the last row of an over-fetched read:
+     * this listing is one ordered read, so a page shorter than `pageSize` proves
+     * the walk is exhausted and an empty string here is definitive. Pass it back
+     * as `pageToken`; do not drive the walk off `total` or `totalPages`.
+     */
+    nextPageToken: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.75",
+	"version": "1.0.76",
 	"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.75",
+		"@0xmonaco/contracts": "1.0.76",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {