@0xmonaco/types 1.0.66 → 1.0.69

package/dist/buildercodes/index.d.ts

@@ -18,9 +18,9 @@ import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, Ge
 export interface BuildercodesAPI extends BaseAPI {
     /** Read this authenticated frontend's enrollment, payout address, and live budget. */
     getConfig(): Promise<GetBuildercodesConfigResponse>;
-    /** List this authenticated frontend's per-trade BuilderCodes credits. */
+    /** List this authenticated frontend's per-trade BuilderCodes credits, optionally of one payout `kind`. */
     listPayouts(params?: ListBuildercodePayoutsParams): Promise<ListBuildercodePayoutsResponse>;
-    /** Summarize this authenticated frontend's BuilderCodes credits by token. */
+    /** Summarize this authenticated frontend's BuilderCodes credits by token, and by token and payout kind. */
     getPayoutSummary(): Promise<GetBuildercodePayoutSummaryResponse>;
     /** Read the authenticated wallet's available reserved reward balances. */
     getRewardsBalance(): Promise<GetBuildercodeRewardsBalanceResponse>;
@@ -67,5 +67,5 @@ export interface BuildercodesAPI extends BaseAPI {
      */
     claimBuildercodeRewards(params: ClaimBuildercodeRewardsParams): Promise<ClaimBuildercodeRewardsResponse>;
 }
-export type { BuildercodePayout, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, } from "./responses";
-export { BuildercodePayoutSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export type { BuildercodePayout, BuildercodePayoutKind, BuildercodePayoutTokenKindTotal, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";

package/dist/buildercodes/index.js

@@ -4,4 +4,4 @@
  * Types for the BuilderCodes API: reading and claiming an enrolled frontend's
  * per-trade revenue share.
  */
-export { BuildercodePayoutSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";

package/dist/buildercodes/responses.d.ts

@@ -13,10 +13,23 @@ export declare const GetBuildercodesConfigResponseSchema: z.ZodObject<{
     buildercodesEnabled: z.ZodBoolean;
     buildercodesBudgetBps: z.ZodNumber;
 }, z.core.$strip>;
-/** Pagination accepted by the per-trade payout history endpoint. */
+/**
+ * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` is the
+ * frontend's share of Monaco's fee; `BUILDER_FEE` is the frontend's own builder
+ * fee, paid by the taker. Both land in the same claimable balance.
+ */
+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. */
 export declare const ListBuildercodePayoutsParamsSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>>;
 }, z.core.$strip>;
 /** One per-trade BuilderCodes credit. Amounts are RAW atomic units. */
 export declare const BuildercodePayoutSchema: z.ZodObject<{
@@ -26,6 +39,10 @@ export declare const BuildercodePayoutSchema: z.ZodObject<{
     amount: z.ZodString;
     appliedBps: z.ZodNumber;
     createdAt: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>>;
 }, z.core.$strip>;
 /** Schema for the paginated per-trade payout history. */
 export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
@@ -36,6 +53,10 @@ export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
         amount: z.ZodString;
         appliedBps: z.ZodNumber;
         createdAt: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<{
+            REVENUE_SHARE: "REVENUE_SHARE";
+            BUILDER_FEE: "BUILDER_FEE";
+        }>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
     page: z.ZodNumber;
@@ -49,6 +70,17 @@ export declare const BuildercodePayoutTokenTotalSchema: z.ZodObject<{
     payoutCount: z.ZodNumber;
     lastCreditedAt: z.ZodString;
 }, z.core.$strip>;
+/** One token-denominated BuilderCodes earnings total for one payout kind. */
+export declare const BuildercodePayoutTokenKindTotalSchema: z.ZodObject<{
+    token: z.ZodString;
+    kind: z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>;
+    totalAmount: z.ZodString;
+    payoutCount: z.ZodNumber;
+    lastCreditedAt: z.ZodString;
+}, z.core.$strip>;
 /** Schema for this frontend's payout summary. */
 export declare const GetBuildercodePayoutSummaryResponseSchema: z.ZodObject<{
     totalPayouts: z.ZodNumber;
@@ -59,6 +91,16 @@ export declare const GetBuildercodePayoutSummaryResponseSchema: z.ZodObject<{
         payoutCount: z.ZodNumber;
         lastCreditedAt: z.ZodString;
     }, z.core.$strip>>;
+    byTokenAndKind: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        token: z.ZodString;
+        kind: z.ZodEnum<{
+            REVENUE_SHARE: "REVENUE_SHARE";
+            BUILDER_FEE: "BUILDER_FEE";
+        }>;
+        totalAmount: z.ZodString;
+        payoutCount: z.ZodNumber;
+        lastCreditedAt: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 /** One available balance in the reserved BuilderCodes reward bucket. */
 export declare const BuildercodeRewardsBalanceSchema: z.ZodObject<{
@@ -86,9 +128,11 @@ export type ClaimBuildercodeRewardsParams = z.infer<typeof ClaimBuildercodeRewar
 export type ClaimBuildercodeRewardsResponse = z.infer<typeof ClaimBuildercodeRewardsResponseSchema>;
 export type GetBuildercodesConfigResponse = z.infer<typeof GetBuildercodesConfigResponseSchema>;
 export type ListBuildercodePayoutsParams = z.infer<typeof ListBuildercodePayoutsParamsSchema>;
+export type BuildercodePayoutKind = z.infer<typeof BuildercodePayoutKindSchema>;
 export type BuildercodePayout = z.infer<typeof BuildercodePayoutSchema>;
 export type ListBuildercodePayoutsResponse = z.infer<typeof ListBuildercodePayoutsResponseSchema>;
 export type BuildercodePayoutTokenTotal = z.infer<typeof BuildercodePayoutTokenTotalSchema>;
+export type BuildercodePayoutTokenKindTotal = z.infer<typeof BuildercodePayoutTokenKindTotalSchema>;
 export type GetBuildercodePayoutSummaryResponse = z.infer<typeof GetBuildercodePayoutSummaryResponseSchema>;
 export type BuildercodeRewardsBalance = z.infer<typeof BuildercodeRewardsBalanceSchema>;
 export type GetBuildercodeRewardsBalanceResponse = z.infer<typeof GetBuildercodeRewardsBalanceResponseSchema>;

package/dist/buildercodes/responses.js

@@ -17,10 +17,18 @@ export const GetBuildercodesConfigResponseSchema = z.object({
     buildercodesEnabled: z.boolean(),
     buildercodesBudgetBps: z.number().int().min(0).max(10_000),
 });
-/** Pagination accepted by the per-trade payout history endpoint. */
+/**
+ * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` is the
+ * frontend's share of Monaco's fee; `BUILDER_FEE` is the frontend's own builder
+ * fee, paid by the taker. Both land in the same claimable balance.
+ */
+export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE"]);
+/** Pagination and filter accepted by the per-trade payout history endpoint. */
 export const ListBuildercodePayoutsParamsSchema = z.object({
     page: z.number().int().min(1).max(10_000).optional(),
     pageSize: z.number().int().min(1).max(100).optional(),
+    /** Only return credits of this kind; `total` counts the filtered rows. Omit for every kind. */
+    kind: BuildercodePayoutKindSchema.optional(),
 });
 /** One per-trade BuilderCodes credit. Amounts are RAW atomic units. */
 export const BuildercodePayoutSchema = z.object({
@@ -30,6 +38,8 @@ export const BuildercodePayoutSchema = z.object({
     amount: z.string(),
     appliedBps: z.number().int(),
     createdAt: z.string(),
+    /** Payout stream of this credit. Absent from servers older than this field, whose credits are all `REVENUE_SHARE`. */
+    kind: BuildercodePayoutKindSchema.optional(),
 });
 /** Schema for the paginated per-trade payout history. */
 export const ListBuildercodePayoutsResponseSchema = z.object({
@@ -46,11 +56,25 @@ export const BuildercodePayoutTokenTotalSchema = z.object({
     payoutCount: z.number().int().nonnegative(),
     lastCreditedAt: z.string(),
 });
+/** One token-denominated BuilderCodes earnings total for one payout kind. */
+export const BuildercodePayoutTokenKindTotalSchema = z.object({
+    token: z.string(),
+    kind: BuildercodePayoutKindSchema,
+    totalAmount: z.string(),
+    payoutCount: z.number().int().nonnegative(),
+    lastCreditedAt: z.string(),
+});
 /** Schema for this frontend's payout summary. */
 export const GetBuildercodePayoutSummaryResponseSchema = z.object({
     totalPayouts: z.number().int().nonnegative(),
     lastCreditedAt: z.string().nullable().optional(),
+    /** Per-token totals, summed across every payout kind. */
     byToken: z.array(BuildercodePayoutTokenTotalSchema),
+    /**
+     * The same totals split by token AND kind; a token's rows sum to its
+     * `byToken` total. Absent from servers older than this field.
+     */
+    byTokenAndKind: z.array(BuildercodePayoutTokenKindTotalSchema).optional(),
 });
 /** One available balance in the reserved BuilderCodes reward bucket. */
 export const BuildercodeRewardsBalanceSchema = z.object({

package/dist/faucet/index.d.ts

@@ -117,8 +117,9 @@ export interface FaucetAPI extends BaseAPI {
      * Fetches the authenticated wallet's faucet quota and recent requests.
      *
      * Read-only: remaining requests in the rolling 24h window, when the next
-     * request becomes available, and the 5 most recent requests. Wallet-scoped
-     * across apps, matching mint enforcement.
+     * request becomes available, and the 5 most recent requests. Scoped to the
+     * wallet on this app (each app has its own quota), matching mint
+     * enforcement.
      *
      * @returns Promise resolving to the quota and recent-request history
      */

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;
@@ -69,11 +66,16 @@ export interface Position {
     /**
      * Lifetime realized PnL net of trading fees and funding. Terminal rows
      * only; absent when the position's reducing executions are unavailable.
+     * Deducts whole-life `cumFees` once. Also absent until its final close is
+     * recorded in the PnL sample and fee history is complete; poll again while
+     * pending. With no sample, remains absent for 28 days after close, then
+     * falls back to closing-execution net without unavailable opening fees.
      */
     netRealizedPnl?: string;
     /**
      * Lifetime realized return on the total allocated initial margin, as a
-     * percentage. Terminal rows only; absent when unavailable.
+     * percentage. Terminal rows only; absent when unavailable, including under
+     * the same conditions as `netRealizedPnl`.
      */
     realizedRoe?: string;
     /**
@@ -104,7 +106,8 @@ export interface Position {
      * terminal rows alike. Null when the opening-fill fees are unavailable —
      * before the position's first PnL sample flushes, after its samples age out
      * of PnL retention, or for positions predating the PnL service — rather than
-     * an understated partial.
+     * an understated partial. On a terminal row it is also null until the
+     * final close is recorded in its PnL sample, or while fee data is incomplete.
      */
     cumFees?: string;
     /**

package/dist/profile/index.d.ts

@@ -235,8 +235,21 @@ export interface UserTrade {
     quoteVolume: string;
     /** Side of the trade */
     side: OrderSide;
-    /** Fee paid for this trade (as string to preserve precision) */
+    /**
+     * Total fee paid for this trade (as string to preserve precision). For a
+     * taker this is Monaco's taker fee plus the frontend's builder fee; for a
+     * maker it is the maker fee (negative for a rebate). Equals
+     * `monacoFee + builderFee`.
+     */
     fee: string;
+    /** Monaco's component of `fee`. Absent from servers older than this field. */
+    monacoFee?: string;
+    /**
+     * The frontend's builder fee component of `fee`. Always `"0"` for a maker:
+     * builder fees are charged to takers only. Absent from servers older than
+     * this field.
+     */
+    builderFee?: string;
     /** Timestamp when the trade was executed (ISO string) */
     executedAt: string;
 }

package/dist/sdk/index.d.ts

@@ -120,7 +120,7 @@ export interface MonacoSDK {
     /** Deposit-address registration (sweeper) API; requires a session */
     sweeper: SweeperAPI;
     managedMarkets: ManagedMarketsAPI;
-    /** Public whitelist (waitlist) submission API */
+    /** @deprecated Public whitelist applications are closed; submissions return HTTP 403. */
     whitelist: WhitelistAPI;
     /** Profile operations API */
     profile: ProfileAPI;

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

@@ -125,6 +125,12 @@ export interface Order {
      * close means unknown, not "placed by hand". Wire: `conditionalOrderId`.
      */
     conditionalOrderId?: string;
+    /**
+     * Present only on a TWAP child order: the TWAP parent that placed it. The
+     * same id the `orders` WebSocket frames and snapshot rows carry for the
+     * child. Wire: `parentOrderId`.
+     */
+    parentOrderId?: string;
     /**
      * Opaque, compare-only revision counter for this order's state: a strictly
      * higher value is strictly newer state for that order, and equal values

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
@@ -586,18 +609,14 @@ export interface ConditionalOrder {
      * the sequencer step that wrote it (0XM-2440). A strictly higher value is
      * strictly newer state for that conditional order.
      *
-     * Present on REST reads and on the subscribe-time `conditional_orders`
-     * snapshot frame. **Absent on live conditional events**, by design: those are
-     * emitted from a model captured before the sequencer acted, so the only value
-     * available there is the one the row held *before* the change being
-     * announced — a client merging on `>=` would let a snapshot read at that
-     * version win the tie and undo the transition.
-     *
-     * So seed conditional state from the snapshot and REST, comparing with
-     * `snapshot.version >= local.version`, and apply live events as state without
-     * ranking them. `>=` rather than `>`: one sequencer step can write several
+     * Present on REST reads, on live `conditionalOrders` updates and on the
+     * subscribe-time snapshot frame, always the version of the row described.
+     * When both sides carry one, merge with `incoming.version >= local.version`:
+     * `>=` rather than `>`, because one sequencer step can write several
      * conditional rows (a trigger writes the triggered row and cancels its OCO
-     * sibling), so equal means "same step", not identical state.
+     * sibling), so equal means "same step", not identical state. Never compare
+     * an absent version numerically: a versioned row supersedes an unversioned
+     * one, and two unversioned rows compare on `updatedAt`.
      *
      * Absent means unknown — a row last written before the field existed — never
      * zero. Wire: `version`.
@@ -618,14 +637,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 +914,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 +946,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";
 /**