@0xmonaco/types 1.0.39 → 1.0.41

package/dist/margin-accounts/index.d.ts

@@ -80,6 +80,12 @@ export interface TransferCollateralRequest {
     amount: string;
     tradingPairId?: string;
     strategyKey?: string;
+    /**
+     * Risk bucket mode. Defaults to ISOLATED, which is selected by
+     * `tradingPairId`. Pass `"CROSS"` to release from the account's cross risk
+     * bucket, which has no trading pair and so cannot be named any other way.
+     */
+    marginMode?: MarginMode;
 }
 export interface TransferCollateralToParentMarginAccountRequest {
     asset: string;

package/dist/market/index.d.ts

@@ -232,6 +232,18 @@ export interface ScreenerItem {
      * null for spot pairs and margin pairs with no settled funding window yet
      */
     lastFundingTime: string | null;
+    /**
+     * Open interest in base-asset units (e.g. BTC); null for spot pairs, "0" for
+     * a margin pair with no open positions
+     */
+    openInterestBase: string | null;
+    /**
+     * Open interest notional in quote units (openInterestBase × latest trade
+     * price); null for spot pairs. Valued at the pair's latest trade price (a
+     * snapshot); the mark-accurate notional lives on getPerpMarketSummary /
+     * getOpenInterest
+     */
+    openInterestNotional: string | null;
 }
 /**
  * Paginated screener response, sorted by quoteVolume24h desc (nulls last)
@@ -269,6 +281,8 @@ export interface MarketMetadata {
     low24h: string | null;
     /** 24h volume in base asset (null if <24h data) */
     volume24h: string | null;
+    /** Quote-token (notional) volume over the rolling 24h window; absent/null when unavailable */
+    quoteVolume24h?: string | null;
     /** Absolute price change in 24h (null if <24h data) */
     priceChange24h: string | null;
     /** Percentage price change in 24h (2 decimals, null if <24h data) */
@@ -319,10 +333,18 @@ export interface PerpMarketSummary {
     indexPrice: string;
     high24h?: string;
     low24h?: string;
+    /** 24h volume in base asset */
     volume24h?: string;
+    /** 24h quote-token (notional) volume */
+    quoteVolume24h?: string;
     priceChange24h?: string;
     priceChangePercent24h?: string;
+    /** Open interest in base-asset units (legacy alias of openInterestBase) */
     openInterest: string;
+    /** Open interest in base-asset units (e.g. BTC) */
+    openInterestBase?: string;
+    /** Open interest notional in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
+    openInterestNotional?: string;
     currentFundingRate?: string;
     estimatedNextFundingRate?: string;
     nextFundingTime?: string;

package/dist/positions/index.d.ts

@@ -164,20 +164,6 @@ export interface PositionRisk {
     initialMarginRequired?: string;
     updatedAt: string;
 }
-export interface AddPositionMarginRequest {
-    amount: string;
-    asset: string;
-}
-export interface ReducePositionMarginRequest {
-    amount: string;
-}
-export interface PositionMarginResponse {
-    positionId: string;
-    marginAccountId: string;
-    newIsolatedMargin: string;
-    status: string;
-    message: string;
-}
 export interface TpSlLeg {
     triggerPrice: string;
     orderType: OrderType;
@@ -311,8 +297,6 @@ export interface PositionsAPI extends BaseAPI {
     closePosition(positionId: string, request: ClosePositionRequest): Promise<ClosePositionResponse>;
     batchCloseAllPositions(request?: BatchCloseAllRequest): Promise<BatchCloseAllResponse>;
     getPositionRisk(positionId: string): Promise<PositionRisk>;
-    addPositionMargin(positionId: string, request: AddPositionMarginRequest): Promise<PositionMarginResponse>;
-    reducePositionMargin(positionId: string, request: ReducePositionMarginRequest): Promise<PositionMarginResponse>;
     attachPositionTpSl(positionId: string, request: AttachPositionTpSlRequest): Promise<AttachPositionTpSlResponse>;
     listPositionHistory(params?: ListPositionHistoryParams): Promise<ListPositionHistoryResponse>;
     getPositionPnlHistory(positionId: string, params: GetPositionPnlHistoryParams): Promise<GetPositionPnlHistoryResponse>;

package/dist/trading/index.d.ts

@@ -41,10 +41,17 @@ export interface TradingAPI extends BaseAPI {
         /**
          * Maker-only: rejected with a 400 carrying the structured error code
          * `POST_ONLY_WOULD_CROSS` if this limit order would cross the book.
-         * LIMIT orders with GTC/GTD only; rejected together with IOC/FOK.
+         * LIMIT orders with GTC only; rejected together with IOC/FOK.
          * Echoed back as `postOnly` on order detail and list reads.
          */
         postOnly?: boolean;
+        /**
+         * Client-assigned correlation handle, echoed back on order reads and
+         * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
+         * Not de-duplicated and not unique — a replacement re-states it and
+         * inherits nothing from the original order.
+         */
+        clientOrderId?: string;
         takeProfit?: ParentTpSlLegParams;
         stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
@@ -70,6 +77,13 @@ export interface TradingAPI extends BaseAPI {
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
+        /**
+         * Client-assigned correlation handle, echoed back on order reads and
+         * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
+         * Not de-duplicated and not unique — a replacement re-states it and
+         * inherits nothing from the original order.
+         */
+        clientOrderId?: string;
         takeProfit?: ParentTpSlLegParams;
         stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
@@ -119,6 +133,13 @@ export interface TradingAPI extends BaseAPI {
         quantity?: string;
         useMasterBalance?: boolean;
         postOnly?: boolean;
+        /**
+         * Client-assigned correlation handle, echoed back on order reads and
+         * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
+         * Not de-duplicated and not unique — a replacement re-states it and
+         * inherits nothing from the original order.
+         */
+        clientOrderId?: string;
     }): Promise<ReplaceOrderResponse>;
     /**
      * Batch creates multiple orders in a single request.

package/dist/trading/orders.d.ts

@@ -40,13 +40,13 @@ export interface Order {
     averageFillPrice?: string;
     /** Trading mode (SPOT or MARGIN) */
     tradingMode: TradingMode;
-    /** Time in force - GTC, IOC, FOK, or GTD */
+    /** Time in force - GTC, IOC, or FOK (GTD is deprecated and rejected) */
     timeInForce?: TimeInForce;
     /** Order creation timestamp (ISO 8601) */
     createdAt: string;
     /** Order last update timestamp (ISO 8601) */
     updatedAt?: string;
-    /** Optional expiration date for GTD orders (ISO 8601, max 1 year) */
+    /** 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 */
     applicationTakerFee?: string;
@@ -70,6 +70,14 @@ export interface Order {
     reduceOnly?: boolean;
     /** Whether the order was placed post-only (maker-only). Absent for orders placed before the flag was persisted. */
     postOnly?: boolean;
+    /**
+     * Client-assigned correlation handle as stored: the value supplied on create
+     * or replace, with surrounding whitespace trimmed. Absent when the order
+     * carried none, including every order placed before the field was accepted on
+     * write. Not unique — several orders may share one value, so a lookup by it
+     * can be ambiguous.
+     */
+    clientOrderId?: string;
     /** Position ID linked to the order, when available */
     positionId?: string;
     /** Stable cause when status is CANCELLED */
@@ -134,7 +142,10 @@ export type TradingMode = "SPOT" | "MARGIN";
  * - GTC: Good Till Cancel - remains active until filled or canceled
  * - IOC: Immediate or Cancel - execute immediately and cancel unfilled portion
  * - FOK: Fill or Kill - execute completely or cancel entirely
- * - GTD: Good Till Date - remains active until specified expiration date
+ * - GTD: **deprecated, never implemented** - the server rejects it with HTTP
+ *   400 (`Time in force must be GTC, IOC, or FOK`). The variant is retained so
+ *   existing code keeps compiling. For an order that expires at a set time, use
+ *   `GTC` together with `expirationDate`.
  */
 export type TimeInForce = "GTC" | "IOC" | "FOK" | "GTD";
 /**

package/dist/trading/responses.d.ts

@@ -38,8 +38,12 @@ export interface MatchResult {
     } | null;
 }
 /**
- * Parent TP/SL follows the parent order quantity and becomes active once the
- * parent order creates or extends a position.
+ * A take-profit / stop-loss leg attached to an order at placement. It becomes
+ * active once the parent order creates or extends a position.
+ *
+ * Sizing is the leg's own, set by `quantity` / `closePosition` below — it does
+ * NOT follow the parent order's quantity. Sizing from the parent is what let a
+ * leg freeze at the order's size and under-cover a position that later grew.
  */
 export interface ParentTpSlLegParams {
     /** Mark price that arms the close order */
@@ -54,6 +58,18 @@ export interface ParentTpSlLegParams {
     slippageToleranceBps?: number;
     /** Optional conditional order expiry timestamp (ISO 8601) */
     expiresAt?: string;
+    /**
+     * Deliberate partial size: this leg closes exactly this much and never
+     * resizes, however the position grows. Mutually exclusive with
+     * `closePosition: true`; required when `closePosition: false`.
+     */
+    quantity?: string;
+    /**
+     * Resolve the full live position size when triggered, so the leg keeps
+     * covering the position as it grows. Mutually exclusive with `quantity`.
+     * Omitting both also means full-position close.
+     */
+    closePosition?: boolean;
 }
 /**
  * Response from creating an order.
@@ -354,11 +370,18 @@ export interface BatchCreateOrderParams {
     /**
      * Maker-only: rejected with a structured `error.code` of
      * `POST_ONLY_WOULD_CROSS` on this item's result if the limit order would
-     * cross the book. LIMIT orders with GTC/GTD only; rejected on MARKET
+     * cross the book. LIMIT orders with GTC only; rejected on MARKET
      * orders and combined with IOC/FOK. Echoed back as `postOnly` on order
      * detail and list reads.
      */
     postOnly?: boolean;
+    /**
+     * Client-assigned correlation handle, echoed back on order reads and on
+     * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
+     * Monaco does not de-duplicate on it and does not enforce uniqueness —
+     * it correlates a response to a request, it does not make a retry safe.
+     */
+    clientOrderId?: string;
 }
 /**
  * Parameters for a single order in a batch replace request
@@ -377,6 +400,13 @@ export interface BatchReplaceOrderParams {
      * inherited from the original order — see `TradingAPI.replaceOrder`.
      */
     postOnly?: boolean;
+    /**
+     * Client-assigned correlation handle, echoed back on order reads and on
+     * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
+     * Monaco does not de-duplicate on it and does not enforce uniqueness —
+     * it correlates a response to a request, it does not make a retry safe.
+     */
+    clientOrderId?: string;
 }
 export interface CancelConditionalOrderResponse {
     conditionalOrderId: string;

package/dist/validation/margin-accounts.d.ts

@@ -25,6 +25,10 @@ export declare const TransferCollateralSchema: z.ZodObject<{
         amount: z.ZodString;
         tradingPairId: z.ZodOptional<z.ZodUUID>;
         strategyKey: z.ZodOptional<z.ZodString>;
+        marginMode: z.ZodOptional<z.ZodEnum<{
+            ISOLATED: "ISOLATED";
+            CROSS: "CROSS";
+        }>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const TransferCollateralToParentMarginAccountSchema: z.ZodObject<{

package/dist/validation/margin-accounts.js

@@ -25,11 +25,19 @@ export const GetAvailableCollateralSchema = z
     asset: z.string().trim().min(1, "Asset cannot be empty").optional(),
 })
     .optional();
-const TransferCollateralRequestSchema = z.object({
+const TransferCollateralRequestSchema = z
+    .object({
     asset: z.string().trim().min(1, "Asset cannot be empty"),
     amount: PositiveDecimalStringSchema,
     tradingPairId: UUIDSchema.optional(),
     strategyKey: z.string().trim().min(1, "Strategy key cannot be empty").optional(),
+    // A cross risk bucket has no trading pair, so CROSS is the only way to name
+    // one on the way out (0XM-2420). The two never combine.
+    marginMode: z.enum(["ISOLATED", "CROSS"]).optional(),
+})
+    .refine((request) => !(request.marginMode === "CROSS" && request.tradingPairId !== undefined), {
+    message: "tradingPairId is not supported for CROSS risk buckets",
+    path: ["tradingPairId"],
 });
 const ParentMarginAccountCollateralRequestSchema = z.object({
     asset: z.string().trim().min(1, "Asset cannot be empty"),

package/dist/validation/positions.d.ts

@@ -37,19 +37,6 @@ export declare const BatchCloseAllSchema: z.ZodObject<{
 export declare const GetPositionRiskSchema: z.ZodObject<{
     positionId: z.ZodUUID;
 }, z.core.$strip>;
-export declare const AddPositionMarginSchema: z.ZodObject<{
-    positionId: z.ZodUUID;
-    request: z.ZodObject<{
-        amount: z.ZodString;
-        asset: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export declare const ReducePositionMarginSchema: z.ZodObject<{
-    positionId: z.ZodUUID;
-    request: z.ZodObject<{
-        amount: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>;
 export declare const AttachPositionTpSlSchema: z.ZodObject<{
     positionId: z.ZodUUID;
     request: z.ZodObject<{

package/dist/validation/positions.js

@@ -33,12 +33,14 @@ export const ClosePositionSchema = PositionIdSchema.extend({
         quantity: PositiveDecimalStringSchema.optional(),
     }),
 })
-    .refine((data) => data.request.closeType !== "LIMIT" || data.request.limitPrice !== undefined, {
-    message: "limitPrice is required for LIMIT close requests",
+    // An IOC close is a LIMIT+IOC order server-side (`close_order_shape`), so it
+    // needs a price exactly like a LIMIT close does; only MARKET forbids one.
+    .refine((data) => data.request.closeType === "MARKET" || data.request.limitPrice !== undefined, {
+    message: "limitPrice is required for LIMIT and IOC close requests",
     path: ["request", "limitPrice"],
 })
-    .refine((data) => data.request.closeType === "LIMIT" || data.request.limitPrice === undefined, {
-    message: "limitPrice is only allowed for LIMIT close requests",
+    .refine((data) => data.request.closeType !== "MARKET" || data.request.limitPrice === undefined, {
+    message: "limitPrice is not allowed for MARKET close requests",
     path: ["request", "limitPrice"],
 });
 export const BatchCloseAllSchema = z.object({
@@ -46,17 +48,6 @@ export const BatchCloseAllSchema = z.object({
     slippageToleranceBps: SlippageToleranceBpsSchema.optional(),
 });
 export const GetPositionRiskSchema = PositionIdSchema;
-export const AddPositionMarginSchema = PositionIdSchema.extend({
-    request: z.object({
-        amount: PositiveDecimalStringSchema,
-        asset: z.string().trim().min(1, "Asset cannot be empty"),
-    }),
-});
-export const ReducePositionMarginSchema = PositionIdSchema.extend({
-    request: z.object({
-        amount: PositiveDecimalStringSchema,
-    }),
-});
 const TpSlLegSchema = z
     .object({
     triggerPrice: PositiveDecimalStringSchema,

package/dist/validation/trading.d.ts

@@ -74,6 +74,8 @@ export declare const ParentTpSlLegSchema: z.ZodObject<{
         MARKET: "MARKET";
     }>;
     limitPrice: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodOptional<z.ZodString>;
+    closePosition: z.ZodOptional<z.ZodBoolean>;
     timeInForce: z.ZodOptional<z.ZodEnum<{
         GTC: "GTC";
         IOC: "IOC";
@@ -127,6 +129,8 @@ export declare const PlaceLimitOrderSchema: z.ZodObject<{
                 MARKET: "MARKET";
             }>;
             limitPrice: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
             timeInForce: z.ZodOptional<z.ZodEnum<{
                 GTC: "GTC";
                 IOC: "IOC";
@@ -141,6 +145,8 @@ export declare const PlaceLimitOrderSchema: z.ZodObject<{
                 MARKET: "MARKET";
             }>;
             limitPrice: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
             timeInForce: z.ZodOptional<z.ZodEnum<{
                 GTC: "GTC";
                 IOC: "IOC";
@@ -188,6 +194,8 @@ export declare const PlaceMarketOrderSchema: z.ZodObject<{
                 MARKET: "MARKET";
             }>;
             limitPrice: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
             timeInForce: z.ZodOptional<z.ZodEnum<{
                 GTC: "GTC";
                 IOC: "IOC";
@@ -202,6 +210,8 @@ export declare const PlaceMarketOrderSchema: z.ZodObject<{
                 MARKET: "MARKET";
             }>;
             limitPrice: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
             timeInForce: z.ZodOptional<z.ZodEnum<{
                 GTC: "GTC";
                 IOC: "IOC";
@@ -360,6 +370,12 @@ export declare const BatchCreateOrderItemSchema: z.ZodObject<{
     reduceOnly: z.ZodOptional<z.ZodBoolean>;
     postOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+/**
+ * Maximum items per batch create/replace/cancel request. Mirrors the server's
+ * cap (Zenith #11): a batch is one matching-engine sequencer command, so its
+ * item count is bounded independent of the transport message-size limit.
+ */
+export declare const MAX_BATCH_ORDER_ITEMS = 100;
 /**
  * Batch Create Orders validation schema
  *

package/dist/validation/trading.js

@@ -83,6 +83,8 @@ export const ParentTpSlLegSchema = z
     triggerPrice: PositiveDecimalStringSchema,
     orderType: OrderTypeSchema,
     limitPrice: PositiveDecimalStringSchema.optional(),
+    quantity: PositiveDecimalStringSchema.optional(),
+    closePosition: z.boolean().optional(),
     timeInForce: ConditionalTimeInForceSchema.optional(),
     slippageToleranceBps: SlippageToleranceBpsSchema.optional(),
     expiresAt: ISO8601DateSchema.optional(),
@@ -102,6 +104,16 @@ export const ParentTpSlLegSchema = z
     .refine((data) => data.orderType !== "LIMIT" || data.slippageToleranceBps === undefined, {
     message: "slippageToleranceBps is only allowed for MARKET parent TP/SL",
     path: ["slippageToleranceBps"],
+})
+    // Same sizing contract the position-attached rail enforces: omit both to
+    // track the live position, or name a deliberate partial that never resizes.
+    .refine((data) => data.closePosition !== true || data.quantity === undefined, {
+    message: "quantity must be omitted when closePosition is true",
+    path: ["quantity"],
+})
+    .refine((data) => data.quantity !== undefined || data.closePosition !== false, {
+    message: "quantity is required when closePosition is false",
+    path: ["closePosition"],
 });
 const hasParentTpSl = (options) => options?.takeProfit !== undefined || options?.stopLoss !== undefined;
 const legacyPositionSideMatchesOrderSide = (side, positionSide) => positionSide === undefined || (positionSide !== "NONE" && ((side === "BUY" && positionSide === "LONG") || (side === "SELL" && positionSide === "SHORT")));
@@ -429,13 +441,22 @@ export const BatchCreateOrderItemSchema = z
     message: "leverage is required for normal MARGIN orders",
     path: ["leverage"],
 });
+/**
+ * Maximum items per batch create/replace/cancel request. Mirrors the server's
+ * cap (Zenith #11): a batch is one matching-engine sequencer command, so its
+ * item count is bounded independent of the transport message-size limit.
+ */
+export const MAX_BATCH_ORDER_ITEMS = 100;
 /**
  * Batch Create Orders validation schema
  *
  * Validates the full array of orders for a batch create request.
  */
 export const BatchCreateOrdersSchema = z.object({
-    orders: z.array(BatchCreateOrderItemSchema).min(1, "At least one order is required"),
+    orders: z
+        .array(BatchCreateOrderItemSchema)
+        .min(1, "At least one order is required")
+        .max(MAX_BATCH_ORDER_ITEMS, `At most ${MAX_BATCH_ORDER_ITEMS} orders per batch request`),
 });
 /**
  * Single batch replace order item validation schema
@@ -463,5 +484,8 @@ export const BatchReplaceOrderItemSchema = z
  * Validates the full array of orders for a batch replace request.
  */
 export const BatchReplaceOrdersSchema = z.object({
-    orders: z.array(BatchReplaceOrderItemSchema).min(1, "At least one order is required"),
+    orders: z
+        .array(BatchReplaceOrderItemSchema)
+        .min(1, "At least one order is required")
+        .max(MAX_BATCH_ORDER_ITEMS, `At most ${MAX_BATCH_ORDER_ITEMS} orders per batch request`),
 });

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

@@ -0,0 +1,45 @@
+/**
+ * Account WebSocket Event Types
+ *
+ * Types for real-time account-level margin updates: equity, collateral, free
+ * collateral, margin ratio, and maintenance requirement for a margin account.
+ *
+ * This is an authenticated channel - requires the signed session-key handshake.
+ * Lag policy is Conflate: a lagging subscriber is fast-forwarded to the latest
+ * state rather than disconnected, so there is no gap signal to reconcile. Each
+ * frame carries the account's full current health, so consume it as a
+ * terminal-state snapshot per margin account, never as an additive delta.
+ */
+/**
+ * Account event data carrying the current margin health of a single account.
+ */
+export interface AccountEventData {
+    /** Margin account this update describes (UUID) */
+    marginAccountId: string;
+    /** Mark-inclusive account equity: collateral + unrealized PnL + funding (decimal string) */
+    equity: string;
+    /** Raw deposited collateral in USD (decimal string) */
+    collateral: string;
+    /** Collateral available for new margin allocation (decimal string) */
+    freeCollateral: string;
+    /**
+     * Maintenance margin required divided by equity; `0` when equity is zero
+     * (decimal string).
+     */
+    marginRatio: string;
+    /** Maintenance margin required to keep the account solvent (decimal string) */
+    maintenanceRequirement: string;
+    /** Timestamp when the account state was updated (ISO 8601) */
+    updatedAt: string;
+}
+/**
+ * Account event emitted when a user's account-level margin health changes.
+ */
+export interface AccountEvent {
+    /** Event type identifier */
+    eventType: "account_update";
+    /** User ID (UUID) */
+    userId: string;
+    /** Account data */
+    data: AccountEventData;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Account WebSocket Event Types
+ *
+ * Types for real-time account-level margin updates: equity, collateral, free
+ * collateral, margin ratio, and maintenance requirement for a margin account.
+ *
+ * This is an authenticated channel - requires the signed session-key handshake.
+ * Lag policy is Conflate: a lagging subscriber is fast-forwarded to the latest
+ * state rather than disconnected, so there is no gap signal to reconcile. Each
+ * frame carries the account's full current health, so consume it as a
+ * terminal-state snapshot per margin account, never as an additive delta.
+ */

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

@@ -6,9 +6,24 @@
  */
 import type { Address } from "viem";
 /**
- * Reason for the balance update
+ * Reason for the balance update.
+ *
+ * `fee` and `rebate` accompany a fill: `fee` when a taker/application fee is
+ * charged, `rebate` when a maker rebate is credited (including perp/margin
+ * makers). `funding` accompanies a funding settlement against margin collateral
+ * (also surfaced on the movements channel with `transactionType: "funding"`).
+ * `liquidation` and `adl` accompany a forced-close on the liquidation-worker
+ * path: `liquidation` on the liquidated victim's collateral, `adl` on an
+ * account impacted by auto-deleveraging.
+ *
+ * A single fill can emit more than one `balance_update` for the same account
+ * (e.g. a `trade` frame plus a `rebate` frame). Each frame carries the
+ * account's RESULTING balance for its token — it is a terminal-state snapshot,
+ * not an additive delta — so consume it by applying the latest balance per
+ * (account, token). That makes reconnect/replay naturally idempotent: never sum
+ * the `reason` frames as if they were separate credits.
  */
-export type BalanceUpdateReason = "lock" | "unlock" | "deposit" | "withdrawal" | "trade" | "margin_transfer_in" | "margin_transfer_out";
+export type BalanceUpdateReason = "lock" | "unlock" | "deposit" | "margin_deposit" | "withdrawal" | "trade" | "fee" | "rebate" | "funding" | "liquidation" | "adl" | "margin_transfer_in" | "margin_transfer_out";
 /**
  * User balance event data containing current balance state
  */

package/dist/websocket/events/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./account-events";
 export * from "./balance-events";
 export * from "./conditional-order-events";
 export * from "./liquidation-events";

package/dist/websocket/events/index.js

@@ -1,3 +1,4 @@
+export * from "./account-events";
 export * from "./balance-events";
 export * from "./conditional-order-events";
 export * from "./liquidation-events";

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

@@ -13,10 +13,25 @@ export interface UserMovementEventData {
     id: string;
     /** Entry type (e.g., "credit", "debit") */
     entryType: string;
-    /** Transaction type (e.g., "deposit", "withdrawal", "trade") */
+    /**
+     * Transaction type (e.g., "deposit", "withdrawal", "trade", "funding").
+     * A `funding` movement records a funding payment already settled against
+     * margin collateral; it reconciles with the matching `balance_update` event
+     * whose `reason` is `funding`.
+     */
     transactionType: string;
-    /** Token contract address */
+    /** Movement status (e.g., "completed", "pending", "failed"). Wire: `status`. */
+    status?: string;
+    /** Token contract address. Wire: `token` (older payloads use the `token_address` alias). */
+    token?: Address;
+    /**
+     * Legacy alias for `token`, always populated from `token` (falling back to the
+     * `token_address` wire alias). Stays required for back-compat — every movement
+     * carries a token address — so existing consumers reading it don't break.
+     */
     tokenAddress: Address;
+    /** Asset registry id (UUID). Wire: `asset_id`. */
+    assetId?: string;
     /** Token symbol */
     symbol?: string;
     /** Token decimals */
@@ -49,6 +64,8 @@ export interface UserMovementEventData {
     description?: string;
     /** Transaction hash (if applicable) */
     txHash?: string;
+    /** Block number (if applicable). Wire: `block_number`. */
+    blockNumber?: number;
     /** Timestamp when the movement was created (ISO 8601) */
     createdAt?: string;
 }

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

@@ -59,6 +59,15 @@ export interface CommonOrderEventData {
     quantityRaw?: string;
     /** Time in force - present in most events */
     timeInForce?: TimeInForce;
+    /**
+     * Client-assigned correlation handle, echoed so an event can be matched to
+     * the request that placed the order without a round trip to `getOrder`.
+     * Carried on every order event that inherits these fields — placed, taker and
+     * maker fills, cancelled, rejected and expired — so a submit whose HTTP
+     * response was lost can be resolved from the stream alone. Omitted when the
+     * order carried none. Wire: `client_order_id`.
+     */
+    clientOrderId?: string;
 }
 /**
  * OrderPlaced event - emitted when a new order is placed
@@ -140,14 +149,23 @@ export interface OrderPartiallyFilledEvent extends OrderEvent {
         /** Execution price (maker orders only) */
         executionPrice?: string;
         /**
-         * Quantity filled in this event (maker orders only). The wire field is
-         * `filled_quantity` (→ `filledQuantity`); for a maker this is the current
-         * trade's quantity. The previous `executionQuantity` never matched the
-         * wire. For a taker the same-named field carries the cumulative order fill.
+         * Cumulative order fill so far, on EVERY role. The wire field is
+         * `filled_quantity` (→ `filledQuantity`); for both taker and maker it is
+         * the order's cumulative fill (a maker previously reported only the current
+         * trade's quantity here; the older `executionQuantity` never matched the
+         * wire at all). The per-event increment is `lastFillQuantity`.
          */
         filledQuantity?: string;
         /** `filledQuantity` in RAW (integer, base-unit) precision. Wire: `filled_quantity_raw`. */
         filledQuantityRaw?: string;
+        /**
+         * Incremental quantity filled by THIS event: for a taker the summed
+         * quantity of the trades this event covers, for a maker this single trade's
+         * quantity. Omitted when the event carries no fill. Wire: `last_fill_quantity`.
+         */
+        lastFillQuantity?: string;
+        /** `lastFillQuantity` in RAW (integer, base-unit) precision. Wire: `last_fill_quantity_raw`. */
+        lastFillQuantityRaw?: string;
         /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
         remainingQuantityRaw?: string;
         /**
@@ -200,14 +218,23 @@ export interface OrderFilledEvent extends OrderEvent {
         /** Execution price (maker orders only) */
         executionPrice?: string;
         /**
-         * Quantity filled in this event (maker orders only). The wire field is
-         * `filled_quantity` (→ `filledQuantity`); for a maker this is the current
-         * trade's quantity. The previous `executionQuantity` never matched the
-         * wire. For a taker the same-named field carries the cumulative order fill.
+         * Cumulative order fill so far, on EVERY role. The wire field is
+         * `filled_quantity` (→ `filledQuantity`); for both taker and maker it is
+         * the order's cumulative fill (a maker previously reported only the current
+         * trade's quantity here; the older `executionQuantity` never matched the
+         * wire at all). The per-event increment is `lastFillQuantity`.
          */
         filledQuantity?: string;
         /** `filledQuantity` in RAW (integer, base-unit) precision. Wire: `filled_quantity_raw`. */
         filledQuantityRaw?: string;
+        /**
+         * Incremental quantity filled by THIS event: for a taker the summed
+         * quantity of the trades this event covers, for a maker this single trade's
+         * quantity. Omitted when the event carries no fill. Wire: `last_fill_quantity`.
+         */
+        lastFillQuantity?: string;
+        /** `lastFillQuantity` in RAW (integer, base-unit) precision. Wire: `last_fill_quantity_raw`. */
+        lastFillQuantityRaw?: string;
         /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
         remainingQuantityRaw?: string;
         /**
@@ -231,6 +258,14 @@ export interface OrderCancelledEvent extends OrderEvent {
         reason?: string;
         /** Stable machine-readable cancellation cause */
         terminalReason?: OrderTerminalReason;
+        /**
+         * Cumulative order fill at cancellation, mirroring `filledQuantity` on the
+         * taker/maker fill events so consumers read one field across every order
+         * event (0XM-2389). `totalFilled` is retained as a legacy alias.
+         */
+        filledQuantity?: string;
+        /** `filledQuantity` in RAW (integer, base-unit) precision. Wire: `filled_quantity_raw`. */
+        filledQuantityRaw?: string;
         /** Total filled quantity before cancellation */
         totalFilled?: string;
         /** `totalFilled` in RAW (integer, base-unit) precision. Wire: `total_filled_raw`. */
@@ -241,6 +276,16 @@ export interface OrderCancelledEvent extends OrderEvent {
         remainingQuantityRaw?: string;
         /** Number of trades executed before cancellation */
         tradesCount?: number;
+        /**
+         * Volume-weighted average fill price of the cancelled order, on the full
+         * (resting-order) cancel payload. Wire: `average_fill_price`.
+         */
+        averageFillPrice?: string;
+        /**
+         * Cancellation timestamp on the full (resting-order) cancel payload,
+         * RFC3339 with a `Z` suffix. Wire: `cancelled_at`.
+         */
+        cancelledAt?: string;
     };
 }
 /**

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

@@ -15,11 +15,12 @@ export type PositionEventSide = "LONG" | "SHORT";
 /**
  * Position lifecycle status.
  *
- * NOTE: this is PascalCase on the wire (`Open`, not `OPEN`) - the underlying
- * enum has no serde rename, unlike side/trading-mode fields. That asymmetry is
- * the live wire format and is preserved verbatim here.
+ * Matches the REST position status strings exactly (the server previously
+ * emitted PascalCase `Open`, which diverged from REST). Values are
+ * SCREAMING_SNAKE_CASE except a closing position, which REST and the wire
+ * report as `LIQUIDATING` (not `CLOSING`).
  */
-export type PositionEventStatus = "Open" | "Closing" | "Closed" | "Liquidated" | "Expired";
+export type PositionEventStatus = "OPEN" | "LIQUIDATING" | "CLOSED" | "LIQUIDATED" | "EXPIRED";
 /**
  * Position event data containing the current state of a single position.
  */
@@ -32,7 +33,7 @@ export interface PositionEventData {
     tradingPairId: string;
     /** Position side */
     side: PositionEventSide;
-    /** Position lifecycle status (PascalCase on the wire) */
+    /** Position lifecycle status (SCREAMING_SNAKE_CASE on the wire, e.g. "OPEN") */
     status: PositionEventStatus;
     /** Absolute position size (decimal string) */
     size: string;
@@ -48,7 +49,15 @@ export interface PositionEventData {
     isolatedMargin: string;
     /** Effective leverage (decimal string) */
     leverage: string;
-    /** What triggered the update (e.g. "trade", free-form) */
+    /** Trade that caused the update, when driven by a fill (UUID). Omitted otherwise. */
+    tradeId?: string;
+    /** Order that caused the update, when driven by an order (UUID). Omitted otherwise. */
+    orderId?: string;
+    /**
+     * What triggered the update. Free-form, but the server uses a canonical set:
+     * `trade`, `close`, `liquidation`, `adl`, `funding`, `margin_added`,
+     * `margin_reduced`, `margin_collateral_transfer`.
+     */
     reason: string;
     /** Timestamp when the position state was updated (ISO 8601) */
     updatedAt: 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_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", "check_trader_code_availability", "clear_trader_code", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_faucet_info", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "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_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "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_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["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", "check_trader_code_availability", "clear_trader_code", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_faucet_info", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "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_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "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_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -11,7 +11,6 @@
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
 export const OPERATION_IDS = [
-    "add_position_margin",
     "attach_position_tp_sl",
     "batch_cancel_all",
     "batch_cancel_all_by_pair",
@@ -95,7 +94,6 @@ export const OPERATION_IDS = [
     "list_sub_accounts_with_balances",
     "list_trading_pairs",
     "mint_tokens",
-    "reduce_position_margin",
     "refresh_session",
     "register_deposit_address",
     "replace_order",

package/dist/wire/schema.d.ts

@@ -1856,38 +1856,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/positions/{positionId}/margin/add": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: operations["add_position_margin"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/positions/{positionId}/margin/reduce": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post: operations["reduce_position_margin"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/v1/positions/{positionId}/pnl/history": {
         parameters: {
             query?: never;
@@ -2224,19 +2192,6 @@ export interface components {
              */
             totalBalanceRaw?: string | null;
         };
-        AddPositionMarginRequest: {
-            /** @description Collateral asset to move into the isolated bucket. USDC is the current v1 path. */
-            asset?: string | null;
-            amount?: string | null;
-        };
-        AddPositionMarginResponse: {
-            positionId?: string | null;
-            /** @description Margin account UUID for the isolated bucket that was adjusted. */
-            marginAccountId?: string | null;
-            newIsolatedMargin?: string | null;
-            status?: string | null;
-            message?: string | null;
-        };
         AppUser: {
             /**
              * Format: uuid
@@ -2715,10 +2670,15 @@ export interface components {
              */
             marginMode?: "ISOLATED" | "CROSS" | null;
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC/GTD only; rejected on MARKET orders and IOC/FOK.
+             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC only; rejected on MARKET orders and IOC/FOK.
              * @example false
              */
             postOnly?: boolean | null;
+            /**
+             * @description Client-assigned correlation handle, echoed back on order reads (detail and list) and on order WebSocket events. At most 64 characters from [A-Za-z0-9._:-]; surrounding whitespace is trimmed before storage, and a blank or whitespace-only value is treated as absent. Monaco stores and returns this value but does NOT de-duplicate on it and does not enforce uniqueness — it correlates a response to a request, it does not make a retry safe. A create whose response was lost must still be reconciled against ListOrders before resubmitting.
+             * @example quote-btc-1130-a
+             */
+            clientOrderId?: string | null;
         };
         BatchCreateOrdersRequest: {
             orders: components["schemas"]["BatchCreateOrderItem"][];
@@ -2789,10 +2749,15 @@ export interface components {
              */
             useMasterBalance?: boolean | null;
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC/GTD only; rejected on MARKET orders and IOC/FOK.
+             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC only; rejected on MARKET orders and IOC/FOK.
              * @example false
              */
             postOnly?: boolean | null;
+            /**
+             * @description Client-assigned correlation handle, echoed back on order reads (detail and list) and on order WebSocket events. At most 64 characters from [A-Za-z0-9._:-]; surrounding whitespace is trimmed before storage, and a blank or whitespace-only value is treated as absent. Monaco stores and returns this value but does NOT de-duplicate on it and does not enforce uniqueness — it correlates a response to a request, it does not make a retry safe. A create whose response was lost must still be reconciled against ListOrders before resubmitting. A replacement is a new order with a new id, so it carries its own value and inherits nothing from the original — restate it to keep the handle.
+             * @example quote-btc-1130-a
+             */
+            clientOrderId?: string | null;
         };
         BatchReplaceOrdersRequest: {
             orders: components["schemas"]["BatchReplaceOrderItem"][];
@@ -3188,10 +3153,15 @@ export interface components {
              */
             marginMode?: "ISOLATED" | "CROSS" | null;
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC/GTD only; rejected on MARKET orders and IOC/FOK.
+             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC only; rejected on MARKET orders and IOC/FOK.
              * @example false
              */
             postOnly?: boolean | null;
+            /**
+             * @description Client-assigned correlation handle, echoed back on order reads (detail and list) and on order WebSocket events. At most 64 characters from [A-Za-z0-9._:-]; surrounding whitespace is trimmed before storage, and a blank or whitespace-only value is treated as absent. Monaco stores and returns this value but does NOT de-duplicate on it and does not enforce uniqueness — it correlates a response to a request, it does not make a retry safe. A create whose response was lost must still be reconciled against ListOrders before resubmitting.
+             * @example quote-btc-1130-a
+             */
+            clientOrderId?: string | null;
         };
         CreateOrderResponse: {
             /**
@@ -3873,6 +3843,11 @@ export interface components {
              * @example 482931
              */
             totalTradeCountLtd?: string | null;
+            /**
+             * @description Quote-token (notional) volume summed over the available candles in the rolling 24h window; null when quote volume is unavailable for the window
+             * @example 117845632.18
+             */
+            quoteVolume24h?: string | null;
         };
         /** @description Exchange-wide life-to-date cumulative market statistics across all trading pairs. */
         GetMarketStatsResponse: {
@@ -4130,7 +4105,10 @@ export interface components {
              * @example 300000000
              */
             remainingQuantityRaw?: string | null;
-            /** @description Client-assigned order identifier */
+            /**
+             * @description Client-assigned correlation handle as stored: the value supplied on create or replace, with surrounding whitespace trimmed. Absent when the order carried none, including every order placed before the field was accepted on write. Not unique: Monaco neither de-duplicates nor enforces uniqueness, so several orders may share one value and a lookup by it can be ambiguous.
+             * @example quote-btc-1130-a
+             */
             clientOrderId?: string | null;
             /**
              * @description Timestamp when the order was cancelled (ISO 8601)
@@ -4274,9 +4252,17 @@ export interface components {
             indexPrice?: string | null;
             high24h?: string | null;
             low24h?: string | null;
+            /**
+             * @description Base-asset volume in the last 24 hours
+             * @example 1234.5678
+             */
             volume24h?: string | null;
             priceChange24h?: string | null;
             priceChangePercent24h?: string | null;
+            /**
+             * @description Open interest in base-asset units (legacy alias of openInterestBase)
+             * @example 12345.67
+             */
             openInterest?: string | null;
             currentFundingRate?: string | null;
             estimatedNextFundingRate?: string | null;
@@ -4284,6 +4270,21 @@ export interface components {
             marketStatus?: string | null;
             marketRegime?: string | null;
             updatedAt?: string | null;
+            /**
+             * @description Open interest in base-asset units (e.g. BTC)
+             * @example 12345.67
+             */
+            openInterestBase?: string | null;
+            /**
+             * @description Open interest notional in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
+             * @example 1172836500.00
+             */
+            openInterestNotional?: string | null;
+            /**
+             * @description Quote-token (notional) volume summed over the available candles in the rolling 24h window; null when quote volume is unavailable
+             * @example 117845632.18
+             */
+            quoteVolume24h?: string | null;
         };
         GetPortfolioAssetsResponse: {
             window?: components["schemas"]["PortfolioSeriesWindow"];
@@ -5398,6 +5399,16 @@ export interface components {
              * @example 2026-06-01T00:00:00Z
              */
             expiresAt?: string | null;
+            /**
+             * @description Deliberate partial size: this leg closes exactly this much and never resizes, however the position grows. Omit it (or set closePosition=true) to close the whole live position at trigger time. Mutually exclusive with closePosition=true; required when closePosition=false. Same contract as TpSlLeg on the position-attached rail.
+             * @example 0.5
+             */
+            quantity?: string | null;
+            /**
+             * @description Resolve the full live position size when triggered, so the leg keeps covering the position as it grows. Mutually exclusive with quantity. Omitting both also means full-position close.
+             * @example true
+             */
+            closePosition?: boolean | null;
         };
         /**
          * @description A single pending withdrawal in a list response. A lightweight summary — the
@@ -5925,17 +5936,6 @@ export interface components {
              */
             relevance?: number | null;
         };
-        ReducePositionMarginRequest: {
-            amount?: string | null;
-        };
-        ReducePositionMarginResponse: {
-            positionId?: string | null;
-            /** @description Margin account UUID for the isolated bucket that was adjusted. */
-            marginAccountId?: string | null;
-            newIsolatedMargin?: string | null;
-            status?: string | null;
-            message?: string | null;
-        };
         RefreshRequest: Record<string, never>;
         RefreshResponse: {
             /**
@@ -5977,10 +5977,10 @@ export interface components {
         };
         ReplaceOrderRequest: {
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC/GTD only; rejected on MARKET orders and IOC/FOK.
-             * @example false
+             * @description Client-assigned correlation handle, echoed back on order reads (detail and list) and on order WebSocket events. At most 64 characters from [A-Za-z0-9._:-]; surrounding whitespace is trimmed before storage, and a blank or whitespace-only value is treated as absent. Monaco stores and returns this value but does NOT de-duplicate on it and does not enforce uniqueness — it correlates a response to a request, it does not make a retry safe. A create whose response was lost must still be reconciled against ListOrders before resubmitting. A replacement is a new order with a new id, so it carries its own value and inherits nothing from the original — restate it to keep the handle.
+             * @example quote-btc-1130-a
              */
-            postOnly?: boolean | null;
+            clientOrderId?: string | null;
             /**
              * @description New limit price (if changing)
              * @example 35500.00
@@ -5996,6 +5996,11 @@ export interface components {
              * @example false
              */
             useMasterBalance?: boolean | null;
+            /**
+             * @description Post-only: reject instead of matching if this limit order would cross the book — rejected with HTTP 400 / gRPC INVALID_ARGUMENT carrying the structured error code POST_ONLY_WOULD_CROSS (REST error-envelope 'code' field; gRPC google.rpc.ErrorInfo reason; batch per-item error.code). Matching the 'post-only order would cross' message substring is a legacy fallback. LIMIT orders with GTC only; rejected on MARKET orders and IOC/FOK.
+             * @example false
+             */
+            postOnly?: boolean | null;
         };
         ReplaceOrderResponse: {
             /**
@@ -6151,6 +6156,16 @@ export interface components {
              * @example 1745308800000
              */
             lastFundingTime?: string | null;
+            /**
+             * @description Open interest in base-asset units (e.g. BTC); null for spot pairs, "0" for a margin pair with no open positions
+             * @example 12345.67
+             */
+            openInterestBase?: string | null;
+            /**
+             * @description Open interest notional in quote units (openInterestBase x latest trade price); null for spot pairs. Valued at the pair's latest trade price (a snapshot); the mark-accurate notional lives on getPerpMarketSummary / getOpenInterest
+             * @example 1172836500.00
+             */
+            openInterestNotional?: string | null;
         };
         /** @description One UTC-day bucket in a pair's 7-day snapshot. */
         ScreenerSnapshotPoint: {
@@ -6703,6 +6718,12 @@ export interface components {
             tradingPairId?: string | null;
             /** @description Optional strategy key echoed in responses when callers scope a risk bucket. */
             strategyKey?: string | null;
+            /**
+             * @description Risk bucket mode. Defaults to ISOLATED, which is selected by tradingPairId.
+             *      Pass CROSS to release from the account's cross risk bucket, which has no
+             *      trading pair and so cannot be named any other way. Values: ISOLATED, CROSS.
+             */
+            marginMode?: string | null;
         };
         TransferCollateralFromMarginAccountResponse: {
             movementId?: string | null;
@@ -10834,66 +10855,6 @@ export interface operations {
             };
         };
     };
-    add_position_margin: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /**
-                 * @description Position UUID for the isolated bucket being adjusted.
-                 * @example 2b1a5f9c-0000-4000-8000-000000000002
-                 */
-                positionId: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["AddPositionMarginRequest"];
-            };
-        };
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AddPositionMarginResponse"];
-                };
-            };
-        };
-    };
-    reduce_position_margin: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /**
-                 * @description Position UUID for the isolated bucket being adjusted.
-                 * @example 2b1a5f9c-0000-4000-8000-000000000002
-                 */
-                positionId: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ReducePositionMarginRequest"];
-            };
-        };
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ReducePositionMarginResponse"];
-                };
-            };
-        };
-    };
     get_position_pnl_history: {
         parameters: {
             query: {

package/package.json

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