@0xmonaco/types 1.0.81 → 1.0.83

package/dist/tradercodes/index.d.ts

@@ -0,0 +1,142 @@
+/**
+ * TraderCodes Types (`sdk.tradercodes`)
+ *
+ * Types for the TraderCodes API: code lookup, rewards balance, and transfer.
+ */
+import type { BaseAPI } from "../api";
+import type { GetMyReferralDownlineParams, GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "./responses";
+/**
+ * TraderCodes API interface (`sdk.tradercodes`).
+ *
+ * Provides methods for reading your wallet-derived TraderCode, looking up a
+ * referral code at sign-up, reading your accrued rewards balance, and
+ * transferring rewards into a tradeable balance.
+ */
+export interface TraderCodesAPI extends BaseAPI {
+    /**
+     * Return the authenticated caller's TraderCode.
+     *
+     * Never 404s — every signed-in wallet has a derivable code. Ensures the
+     * backing row so referrals attributed to this wallet have a code to link.
+     * The response carries both the permanent wallet-derived `code` and the
+     * custom-handle fields (`customCode`, `isCustom`, `display`).
+     *
+     * @returns Promise resolving to the caller's TraderCode identity and its creation timestamp
+     */
+    getMyTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Claim or edit the authenticated caller's custom (vanity) TraderCode handle.
+     *
+     * The handle is stored exactly as entered (case preserved); uniqueness is
+     * enforced case-insensitively by the server. The client validates the handle
+     * (letter-first `[A-Za-z0-9_]`, length 5–20) before sending. The server is
+     * the authoritative gate: it returns 409 when the handle is taken, 422 with a
+     * reason on validation failure, 429 when the per-hour edit limit is hit, and
+     * 403 when the feature is disabled.
+     *
+     * @param code - The custom handle to claim or edit to, exactly as entered
+     * @returns Promise resolving to the caller's updated TraderCode identity
+     */
+    setTraderCode(code: string): Promise<TraderCodeResponse>;
+    /**
+     * Clear the caller's custom TraderCode handle, reverting to the
+     * wallet-derived default. The freed handle enters a cooldown before anyone
+     * else can claim it.
+     *
+     * @returns Promise resolving to the caller's TraderCode identity after the revert
+     */
+    clearTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Public, unauthenticated advisory check of whether a custom TraderCode
+     * handle is available (as-you-type UX).
+     *
+     * Advisory only — the authoritative gate is the atomic claim in
+     * {@link setTraderCode}, so a positive result here is not a reservation.
+     * Returns `available` plus, when unavailable, a `reason` code.
+     *
+     * @param code - The custom handle to check
+     * @returns Promise resolving to availability and, when unavailable, the reason
+     */
+    checkTraderCodeAvailability(code: string): Promise<TraderCodeAvailabilityResponse>;
+    /**
+     * Public, unauthenticated lookup of a TraderCode.
+     *
+     * Used to validate a referral code at sign-up. The code is a wallet address
+     * (the `Monaco - <address>` display form is also accepted). Returns the
+     * normalized code when it resolves to a known wallet, or throws a 404 when
+     * the code does not resolve to any user.
+     *
+     * @param code - The TraderCode (wallet address or `Monaco - <address>` form) to look up
+     * @returns Promise resolving to the normalized TraderCode
+     */
+    getTraderCodeInfo(code: string): Promise<TraderCodeInfoResponse>;
+    /**
+     * Return the caller's current TraderCodes rewards-bucket balances.
+     *
+     * Rewards accumulate here as referred users trade. Call
+     * {@link transferRewards} to move them into a tradeable balance.
+     * Returns an empty `balances` array when no rewards have been earned yet.
+     *
+     * @returns Promise resolving to the list of per-token reward balances
+     */
+    getRewardsBalance(): Promise<GetRewardsBalanceResponse>;
+    /**
+     * Transfer earned TraderCodes rewards into a trading balance.
+     *
+     * Moves the specified amount of a reward token from the caller's rewards
+     * bucket into their trading balance under the authenticated application.
+     * Ledger-only — no on-chain transaction, immediately tradeable.
+     *
+     * @param params - Token address and raw-unit amount to transfer
+     * @returns Promise resolving to the post-transfer rewards and trading balances
+     */
+    transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
+    /**
+     * Read your own referral position: your referral chain upward (`upline`, L1
+     * then L2 and onward, as many levels as your trades on this client
+     * application pay), your direct referrer, total earned, and most recent
+     * reward rows.
+     *
+     * Self-scoped — the server derives your identity from the session, so you can
+     * only ever read your own chain. `referrer` is the empty string when you were
+     * not referred (use it to gate the "already referred" UX). Every other user is
+     * identified by their public wallet address (with a `display` handle-or-wallet
+     * variant), never an internal id.
+     *
+     * @returns Promise resolving to your upline, referrer, total earned, and recent rewards
+     */
+    getMyReferralPosition(): Promise<GetMyReferralPositionResponse>;
+    /**
+     * Read your own downline: one page of who you earn from and how much
+     * (earnings by source across every reward level, largest first), your L1
+     * direct-referee roster (including referees who have not traded yet), and a
+     * per-level earnings summary that covers every level and source on every
+     * page. Without `pageSize` / `pageToken` you get the first page (100 rows),
+     * not every row: follow `nextPageToken` until it is empty.
+     *
+     * Self-scoped and read-only. Every source and referee is a public wallet
+     * address plus a `display` handle-or-wallet variant, never an internal id.
+     *
+     * @param params - Optional `pageSize` (1-500, default 100) and `pageToken`
+     * @returns Promise resolving to the earnings page, the direct-referee roster, a summary, and the next page token
+     */
+    getMyReferralDownline(params?: GetMyReferralDownlineParams): Promise<GetMyReferralDownlineResponse>;
+    /**
+     * Read one level of your own referral tree: the wallets `parent` directly
+     * referred (yourself when `parent` is omitted), a page at a time, newest
+     * first. Expand a node by calling again with `parent` set to its wallet;
+     * nodes with `refereeCount > 0` are expandable, down to the deepest level
+     * any client application rewards (at most 10). Your direct referees (L1)
+     * are always listed.
+     *
+     * Self-scoped: `parent` must be you or one of your own referees above that
+     * deepest level — any other wallet is a 404. Each wallet appears once, under the referrer that
+     * earns from it.
+     *
+     * @param params - Optional `parent` wallet, `pageSize` (1-200), and `pageToken`
+     * @returns Promise resolving to the page of nodes and the next page token
+     */
+    getMyReferralTree(params?: GetMyReferralTreeParams): Promise<GetMyReferralTreeResponse>;
+}
+export type { GetMyReferralDownlineParams, GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, LevelEarnings, ReferralDirectReferee, ReferralEarningsSource, ReferralEarningsSummary, ReferralRewardEntry, ReferralTreeNode, ReferralUplineEntry, RewardsBalanceEntry, SetTraderCodeParams, TraderCodeAvailabilityReason, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse, } from "./responses";
+export { GetMyReferralDownlineParamsSchema, GetMyReferralDownlineResponseSchema, GetMyReferralPositionResponseSchema, GetMyReferralTreeParamsSchema, GetMyReferralTreeResponseSchema, GetRewardsBalanceResponseSchema, LevelEarningsSchema, ReferralDirectRefereeSchema, ReferralEarningsSourceSchema, ReferralEarningsSummarySchema, ReferralRewardEntrySchema, ReferralTreeNodeSchema, ReferralUplineEntrySchema, RewardsBalanceEntrySchema, SetTraderCodeParamsSchema, TraderCodeAvailabilityReasonSchema, TraderCodeAvailabilityResponseSchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/tradercodes/index.js

@@ -0,0 +1,6 @@
+/**
+ * TraderCodes Types (`sdk.tradercodes`)
+ *
+ * Types for the TraderCodes API: code lookup, rewards balance, and transfer.
+ */
+export { GetMyReferralDownlineParamsSchema, GetMyReferralDownlineResponseSchema, GetMyReferralPositionResponseSchema, GetMyReferralTreeParamsSchema, GetMyReferralTreeResponseSchema, GetRewardsBalanceResponseSchema, LevelEarningsSchema, ReferralDirectRefereeSchema, ReferralEarningsSourceSchema, ReferralEarningsSummarySchema, ReferralRewardEntrySchema, ReferralTreeNodeSchema, ReferralUplineEntrySchema, RewardsBalanceEntrySchema, SetTraderCodeParamsSchema, TraderCodeAvailabilityReasonSchema, TraderCodeAvailabilityResponseSchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/trading/index.d.ts

@@ -6,7 +6,7 @@
 import type { BaseAPI } from "../api/index";
 import type { MarginMode } from "../margin-accounts";
 import type { Order, OrderSide, PositionSide, SelfTradePreventionMode, TimeInForce, TradingMode } from "./orders";
-import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrdersParams, ListTwapOrdersResponse, ParentTpSlLegParams, ParentTrailingStopLegParams, ReplaceOrderResponse, TwapOrder } from "./responses";
+import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrderSlicesParams, ListTwapOrderSlicesResponse, ListTwapOrdersParams, ListTwapOrdersResponse, ParentTpSlLegParams, ParentTrailingStopLegParams, ReplaceOrderResponse, TwapOrder } from "./responses";
 /**
  * Trading API interface.
  * Provides methods for placing and managing orders.
@@ -281,7 +281,13 @@ export interface TradingAPI extends BaseAPI {
      * optional state / trading pair filters.
      */
     listTwapOrders(params?: ListTwapOrdersParams): Promise<ListTwapOrdersResponse>;
+    /**
+     * Lists one TWAP parent's slices: the child orders it placed, each as
+     * `getOrder` returns it, oldest first by default. Users can only access
+     * their own TWAP orders.
+     */
+    listTwapOrderSlices(twapOrderId: string, params?: ListTwapOrderSlicesParams): Promise<ListTwapOrderSlicesResponse>;
 }
 export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderStatusFilter, OrderTerminalReason, OrderType, PositionSide, SelfTradePreventionMode, TimeInForce, TradingMode, TwapExecutionStyle, TwapOrderState, } from "./orders";
 export { ORDER_STATUS_VALUES } from "./orders";
-export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrdersParams, ListTwapOrdersResponse, MatchResult, ParentTpSlLegParams, ParentTrailingStopLegParams, ReplaceOrderResponse, TriggeredOrderSummary, TwapOrder, UpdatedFields, } from "./responses";
+export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrderSlicesParams, ListTwapOrderSlicesResponse, ListTwapOrdersParams, ListTwapOrdersResponse, MatchResult, ParentTpSlLegParams, ParentTrailingStopLegParams, ReplaceOrderResponse, TriggeredOrderSummary, TwapOrder, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -3,6 +3,7 @@
  *
  * Types for trading operations and order management.
  */
+import type { OrderOrigin } from "../websocket/events/orders-events";
 /**
  * Standard order structure used across all order-related responses.
  * This represents the complete order information as returned by the API.
@@ -55,17 +56,17 @@ export interface Order {
     updatedAt?: string;
     /** Optional expiry for a GTC order (ISO 8601, max 1 year) */
     expirationDate?: string;
-    /** Application taker fee in basis points (e.g., "100" = 1%) - populated after fills */
+    /** Application (builder) taker fee paid, in quote currency, summed over the fills where this order was the taker. A replacement also includes the fills of the order it replaced; 0 on a liquidation order. An amount, not a rate */
     applicationTakerFee?: string;
-    /** Monaco protocol taker fee in basis points - populated after fills */
+    /** Monaco protocol taker fee paid, in quote currency, summed over the fills where this order was the taker. A replacement also includes the fills of the order it replaced; a liquidation order carries the liquidation fee it was charged instead. An amount, not a rate */
     monacoTakerFee?: string;
-    /** Monaco protocol maker rebate in basis points - populated after fills */
+    /** Monaco maker fee, in quote currency, summed over the fills where this order was the maker; negative is a rebate. A replacement also includes the fills of the order it replaced. An amount, not a rate */
     monacoMakerRebate?: string;
     /** Total taker fees paid in quote currency - populated after fills */
     totalTakerFees?: string;
-    /** Total payment for taker including fees in quote currency - populated after fills */
+    /** Total the taker paid, in quote currency: the filled notional as the ledger booked it (each fill rounded down to the smallest unit) plus totalTakerFees. A replacement also includes the fills of the order it replaced */
     takerTotalPayment?: string;
-    /** Total receipt for maker after rebates in quote currency - populated after fills */
+    /** Total the maker received, in quote currency: the notional of its maker fills as the ledger booked it minus monacoMakerRebate (a rebate adds). A replacement also includes the fills of the order it replaced */
     makerTotalReceipt?: string;
     /** Margin account ID for margin/perp orders */
     marginAccountId?: string;
@@ -118,6 +119,24 @@ export interface Order {
      * child. Wire: `parentOrderId`.
      */
     parentOrderId?: string;
+    /**
+     * What placed the order: `"USER"` (the account itself, including its TP/SL
+     * triggers and TWAP slices), `"LIQUIDATION"` (the liquidation engine
+     * closing the account's position), `"ADL"` (an auto-deleveraging close),
+     * `"COPY"` (the copy trading engine, for one of the account's follows) or
+     * `"SYSTEM"`.
+     *
+     * Use it to label a row in order history. A liquidation is a reduce-only
+     * IOC limit order, so `orderType`, `timeInForce` and `reduceOnly` alone read
+     * the same as an order the user placed; this is the only field that tells
+     * them apart. The same labels as `origin` on the order WebSocket events.
+     *
+     * Present on every book order. Absent on a TWAP parent row and a
+     * conditional order row (the account's own instructions), and from servers
+     * predating the field. Widened past {@link OrderOrigin} so a value this
+     * SDK version does not know still reaches you. Wire: `origin`.
+     */
+    origin?: OrderOrigin | (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

@@ -933,3 +933,41 @@ export interface ListTwapOrdersResponse {
      */
     nextPageToken: string;
 }
+/**
+ * Query parameters for listing one TWAP parent's slices.
+ */
+export interface ListTwapOrderSlicesParams {
+    /** Sort direction for `createdAt`: `"ASC"` (oldest slice first, the default) or `"DESC"` */
+    orderBy?: "ASC" | "DESC";
+    /** Items per page (max 1000, default 20) */
+    pageSize?: number;
+    /**
+     * Pagination cursor:
+     * - Omitted or empty string (`""`): start a cursor walk from the first slice
+     *   in `orderBy` order.
+     * - Non-empty: an opaque cursor from a previous response's `nextPageToken`;
+     *   results resume immediately after that position.
+     *
+     * A token is pinned to the TWAP order and `orderBy` that minted it.
+     */
+    pageToken?: string;
+}
+/**
+ * Response from listing one TWAP parent's slices.
+ */
+export interface ListTwapOrderSlicesResponse {
+    /**
+     * The parent's child orders, each as `getOrder` returns it and carrying the
+     * parent's id in `parentOrderId`. A `PASSIVE` parent's reprices and deadline
+     * sweeps are child orders too, so there can be more than `slicesPlaced`.
+     */
+    slices: Order[];
+    /** Items per page */
+    pageSize: number;
+    /**
+     * Cursor for the next page, minted only while a further page exists. Empty on
+     * the final page — the definitive end of the walk. Do not feed the empty
+     * token back as `pageToken`; an empty input restarts the walk.
+     */
+    nextPageToken: string;
+}

package/dist/validation/positions.d.ts

@@ -33,8 +33,13 @@ export declare const ClosePositionSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const BatchCloseAllSchema: z.ZodObject<{
     tradingPairId: z.ZodOptional<z.ZodUUID>;
+    tradingPairIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    side: z.ZodOptional<z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+    }>>;
     slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export declare const GetPositionRiskSchema: z.ZodObject<{
     positionId: z.ZodUUID;
 }, z.core.$strip>;

package/dist/validation/positions.js

@@ -2,7 +2,7 @@
  * Positions API Validation Schemas
  */
 import { z } from "zod";
-import { ConditionalTimeInForceSchema, ISO8601DateSchema, OrderTypeSchema, PositiveDecimalStringSchema, SlippageToleranceBpsSchema, TrailingStopLegSchema, UUIDSchema, } from "./trading";
+import { ClosePositionSideSchema, ConditionalTimeInForceSchema, ISO8601DateSchema, OrderTypeSchema, PositiveDecimalStringSchema, SlippageToleranceBpsSchema, TrailingStopLegSchema, UUIDSchema, } from "./trading";
 const CursorPaginationSchema = z.object({
     /**
      * Rejected, not ignored. A non-strict object would let a JS or `any` caller
@@ -50,9 +50,25 @@ export const ClosePositionSchema = PositionIdSchema.extend({
     message: "limitPrice is not allowed for MARKET close requests",
     path: ["request", "limitPrice"],
 });
-export const BatchCloseAllSchema = z.object({
+export const BatchCloseAllSchema = z
+    .object({
     tradingPairId: UUIDSchema.optional(),
+    // At least one id: the server reads an empty set as no pair filter, so a
+    // caller whose own filter matched no pair would close every position.
+    tradingPairIds: z
+        .array(UUIDSchema)
+        .min(1, { message: "tradingPairIds must list at least one trading pair; omit it to close every pair" })
+        .max(256, { message: "tradingPairIds accepts at most 256 trading pairs" })
+        .optional(),
+    side: ClosePositionSideSchema.optional(),
     slippageToleranceBps: SlippageToleranceBpsSchema.optional(),
+})
+    // Strict: the client builds the body from the known fields, so a misspelled
+    // filter would be dropped and the close would cover every position.
+    .strict()
+    .refine((data) => data.tradingPairId === undefined || data.tradingPairIds === undefined, {
+    message: "Pass tradingPairId or tradingPairIds, not both",
+    path: ["tradingPairIds"],
 });
 export const GetPositionRiskSchema = PositionIdSchema;
 const TpSlLegSchema = z

package/dist/validation/trading.d.ts

@@ -375,11 +375,11 @@ export declare const ConditionalOrderTriggerSourceSchema: z.ZodEnum<{
 export declare const ConditionalOrderStateSchema: z.ZodEnum<{
     CANCELLED: "CANCELLED";
     EXPIRED: "EXPIRED";
+    FAILED: "FAILED";
     PENDING_PARENT: "PENDING_PARENT";
     ACTIVE: "ACTIVE";
     TRIGGERING: "TRIGGERING";
     TRIGGERED: "TRIGGERED";
-    FAILED: "FAILED";
 }>;
 export declare const ClosePositionSideSchema: z.ZodEnum<{
     LONG: "LONG";
@@ -395,11 +395,11 @@ export declare const ListConditionalOrdersSchema: z.ZodObject<{
     state: z.ZodOptional<z.ZodEnum<{
         CANCELLED: "CANCELLED";
         EXPIRED: "EXPIRED";
+        FAILED: "FAILED";
         PENDING_PARENT: "PENDING_PARENT";
         ACTIVE: "ACTIVE";
         TRIGGERING: "TRIGGERING";
         TRIGGERED: "TRIGGERED";
-        FAILED: "FAILED";
     }>>;
     pageSize: z.ZodOptional<z.ZodNumber>;
     pageToken: z.ZodOptional<z.ZodString>;
@@ -466,6 +466,16 @@ export declare const ListTwapOrdersSchema: z.ZodObject<{
     pageSize: z.ZodOptional<z.ZodNumber>;
     pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const ListTwapOrderSlicesSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNever>;
+    twapOrderId: z.ZodUUID;
+    orderBy: z.ZodOptional<z.ZodEnum<{
+        ASC: "ASC";
+        DESC: "DESC";
+    }>>;
+    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

@@ -560,6 +560,15 @@ export const ListTwapOrdersSchema = z.object({
     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(),
 });
+export const ListTwapOrderSlicesSchema = z.object({
+    // Rejected, not ignored, as on the sibling cursor listings: a caller
+    // looping on `page` would otherwise re-fetch the first page forever.
+    page: z.never().optional(),
+    twapOrderId: UUIDSchema,
+    orderBy: z.enum(["ASC", "DESC"]).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(),
+});
 /**
  * Single batch create order item validation schema
  *

package/dist/websocket/base.d.ts

@@ -7,6 +7,35 @@
  * WebSocket connection status
  */
 export type WebSocketStatus = "connected" | "connecting" | "disconnected" | "reconnecting";
+/**
+ * Where one channel stands between what this client asked for and what the
+ * server confirmed, from `MonacoWebSocket.getSubscriptionState`:
+ *
+ * - `"idle"` — not wanted, and not held server-side.
+ * - `"pending"` — wanted; a `Subscribe` was sent and its acknowledgement has
+ *   not arrived yet.
+ * - `"subscribed"` — wanted, and the server's acknowledgement named it.
+ * - `"unconfirmed"` — wanted, but not held: the server rejected it (its
+ *   `Error` reached `onError`), or the connection that held it closed. A
+ *   channel rejected with `AUTH_REQUIRED` is retried once the connection
+ *   authenticates; a reconnect re-sends every wanted channel.
+ * - `"unsubscribing"` — released; an `Unsubscribe` was sent and the server
+ *   still holds the channel until its acknowledgement arrives.
+ */
+export type WebSocketSubscriptionState = "idle" | "pending" | "subscribed" | "unconfirmed" | "unsubscribing";
+/**
+ * A server-confirmed change to one channel, delivered to every
+ * `MonacoWebSocket.onSubscriptionChange` listener: `"subscribed"` when a
+ * `Subscribed` acknowledgement names a channel this client still wants, and
+ * `"unsubscribed"` when an `Unsubscribed` acknowledgement names one.
+ * `channel` is the exact channel string this client sent.
+ */
+export interface WebSocketSubscriptionChange {
+    channel: string;
+    state: "subscribed" | "unsubscribed";
+}
+/** Listener for {@link WebSocketSubscriptionChange}. */
+export type SubscriptionChangeHandler = (change: WebSocketSubscriptionChange) => void;
 /**
  * Connection-attempt context delivered with every status change.
  *
@@ -215,11 +244,11 @@ export interface MonacoWebSocketConfig {
      * - `SESSION_INVALID` — the session was revoked or expired; the connection
      *   closes and {@link onReauthenticationRequired} follows. No `channel`.
      * - `AUTH_REQUIRED` — a rejected SUBSCRIBE of `channel`, not an invalidated
-     *   session: it was never registered, and this client still holds your
-     *   handler, so it treats the channel as subscribed and sends no new
-     *   `Subscribe`. Re-authenticating alone leaves it dead. Release the last
-     *   handler for that channel and subscribe again after authenticating
-     *   (0XM-2644 tracks doing this automatically).
+     *   session: it was never registered. This client keeps your handler and
+     *   reports the channel as `"unconfirmed"`; once the connection
+     *   authenticates (`setSessionKeypair`, or the SDK's `login`) it re-sends
+     *   the `Subscribe` once, and the channel becomes `"subscribed"` when the
+     *   server acknowledges it.
      */
     onError?: ErrorHandler;
     /**

package/dist/websocket/client.d.ts

@@ -55,7 +55,7 @@
 import type { SessionCredentials } from "../auth/index";
 import type { Interval } from "../market";
 import type { TradingMode } from "../trading";
-import type { WebSocketStatus } from "./base";
+import type { SubscriptionChangeHandler, WebSocketStatus, WebSocketSubscriptionState } from "./base";
 import type { OrderbookQuotationMode } from "./clients/orderbook-client";
 import type { AccountEvent, AccountEventData, ConditionalOrderEvent, ConditionalOrderEventData, CopyEvent, CopyRelationshipEventData, InstrumentEvent, InstrumentEventData, LiquidationEvent, LiquidationEventData, MarketStatsAllEvent, MarketStatsData, MarketStatsEvent, MarketStatsSummary, OHLCVEvent, OHLCVPriceType, OrderbookEvent, OrderEvent, PositionEvent, PositionEventData, PositionValuationEvent, TradeEvent, TradeEventData, TwapOrderEvent, TwapOrderEventData, UserBalanceEvent, UserBalanceEventData, UserMovementEvent } from "./events";
 import type { OHLCVSnapshotCandle, OrderSnapshotItem, SnapshotHandler } from "./snapshots";
@@ -71,6 +71,22 @@ export interface MonacoWebSocket {
     getStatus: () => WebSocketStatus;
     /** Set (or clear) the session keypair used to authenticate the connection */
     setSessionKeypair: (credentials: SessionCredentials | undefined) => void;
+    /**
+     * Where `channel` (the exact channel string a helper subscribes to, e.g.
+     * `trades:<tradingPairId>`) stands between what this client asked for and
+     * what the server confirmed. Calling a subscription helper only REQUESTS a
+     * channel: it reads `"pending"` until the server's acknowledgement names it.
+     */
+    getSubscriptionState: (channel: string) => WebSocketSubscriptionState;
+    /**
+     * Register a listener for server-confirmed subscription changes; returns a
+     * function that removes it. Fires `"subscribed"` when the server
+     * acknowledges a channel this client still wants, and `"unsubscribed"`
+     * when it acknowledges an unsubscribe. A rejected channel fires nothing
+     * here; its `Error` reaches `onError`. An error thrown by a listener is
+     * logged and does not affect the connection or other listeners.
+     */
+    onSubscriptionChange: (listener: SubscriptionChangeHandler) => () => void;
     /** Subscribe to order events (requires authentication); `onSnapshot` receives every resting order on the pair */
     orders: (tradingPairId: string, tradingMode: TradingMode, handler: MessageHandler<OrderEvent>, onSnapshot?: SnapshotHandler<OrderSnapshotItem>) => () => void;
     /** Subscribe to orderbook events (public) */

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

@@ -45,8 +45,9 @@ export interface MarketStatsData {
     /** Best ask price (decimal string) */
     bestAskPrice?: string;
     /**
-     * Open interest (decimal string). Perp-only; omitted for spot, and omitted
-     * (never zero) until the market's open interest is known.
+     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * Perp-only; omitted for spot, and omitted (never zero) until the market's
+     * open interest is known.
      */
     openInterest?: string;
     /**
@@ -57,9 +58,10 @@ export interface MarketStatsData {
     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.
+     * never below zero (decimal string): the cap minus the gross `openInterest`
+     * × `markPrice`. 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) */
@@ -145,8 +147,9 @@ export interface MarketStatsSummary {
     /** 24h low price (decimal string) */
     dailyPriceLow?: string;
     /**
-     * Open interest (decimal string). Perp-only; omitted for spot, and omitted
-     * (never zero) until the market's open interest is known.
+     * Gross open interest (longs plus shorts) in base units (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. */
@@ -166,8 +169,9 @@ export interface MarketStatsSummary {
     /** Funding premium (decimal string). Perp-only; omitted for spot. */
     premium?: string;
     /**
-     * Open interest in quote notional (decimal string): `openInterest` priced at
-     * the mark, falling back to the last trade price. Perp-only; omitted for spot,
+     * Gross open interest (longs plus shorts) in quote notional (decimal
+     * string): `openInterest` priced at the mark, falling back to the last trade
+     * price. Perp-only; omitted for spot,
      * and omitted (never zero) until both open interest and a price are known.
      */
     openInterestNotional?: string;

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_follow_position_margin", "attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_all_copy_positions", "close_follow_positions", "close_position", "close_sub_account", "create_challenge", "create_delegated_session", "create_order", "create_sub_account", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_margin_account_movements", "get_margin_account_pnl", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "get_my_referral_tree", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_builder_fee_changes", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_builder_fee", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_from_sub_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_collateral_to_sub_account", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_follow_position_margin", "attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_all_copy_positions", "close_follow_positions", "close_position", "close_sub_account", "create_challenge", "create_delegated_session", "create_order", "create_sub_account", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_margin_account_movements", "get_margin_account_pnl", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "get_my_referral_tree", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_builder_fee_changes", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_order_slices", "list_twap_orders", "mint_tokens", "pitpass_check_trader_code_availability", "pitpass_clear_trader_code", "pitpass_get_my_referral_downline", "pitpass_get_my_referral_position", "pitpass_get_my_referral_tree", "pitpass_get_my_trader_code", "pitpass_get_rewards_balance", "pitpass_get_trader_code_info", "pitpass_set_trader_code", "pitpass_transfer_rewards", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_builder_fee", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_from_sub_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_collateral_to_sub_account", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -125,8 +125,19 @@ export const OPERATION_IDS = [
     "list_positions",
     "list_sub_accounts_with_balances",
     "list_trading_pairs",
+    "list_twap_order_slices",
     "list_twap_orders",
     "mint_tokens",
+    "pitpass_check_trader_code_availability",
+    "pitpass_clear_trader_code",
+    "pitpass_get_my_referral_downline",
+    "pitpass_get_my_referral_position",
+    "pitpass_get_my_referral_tree",
+    "pitpass_get_my_trader_code",
+    "pitpass_get_rewards_balance",
+    "pitpass_get_trader_code_info",
+    "pitpass_set_trader_code",
+    "pitpass_transfer_rewards",
     "preview_follow",
     "refresh_managed_market_quotes",
     "refresh_session",