@0xmonaco/types 1.0.37 → 1.0.38-develop.ebf8e8c

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

@@ -13,7 +13,20 @@ export interface MarginAccountSummary {
     equity: string;
     initialMarginRequired: string;
     maintenanceMarginRequired: string;
+    /** Equity headroom: equity less the initial margin requirement. */
     freeCollateral: string;
+    /**
+     * The largest amount a transfer-out of this scope will actually accept.
+     *
+     * Not a clamped `freeCollateral`. Free collateral is equity headroom, and
+     * equity includes realized PnL, accrued funding and mark-to-market gains
+     * that are not principal a transfer can move — so the two can differ
+     * without limit. An unrealized gain never counts toward this figure.
+     *
+     * For a risk bucket this is capped by the bucket's allocated collateral;
+     * for a parent margin account, by deposited collateral that no risk bucket
+     * has earmarked. Size transfers against this field, not `freeCollateral`.
+     */
     withdrawableCollateral: string;
     totalPositionNotional: string;
     unrealizedPnl: string;
@@ -44,10 +57,21 @@ export interface GetAvailableCollateralResponse {
     walletLocked: string;
     marginTransferable?: string;
     /**
-     * Free collateral held in the user's parent margin account for this asset
-     * (equity minus initial margin required) — collateral already inside margin
-     * and available to open new positions or transfer back out. Absent when the
-     * user has no margin account yet.
+     * The largest amount that can currently leave the user's parent margin
+     * account for this asset — the same bound as
+     * `MarginAccountSummary.withdrawableCollateral`, and served from the same
+     * value, so the two surfaces cannot disagree. Absent when the user has no
+     * margin account yet.
+     *
+     * This is **not** trading headroom. It is bounded by allocation (principal
+     * not earmarked by risk buckets) as well as by margin requirements, and an
+     * unrealized gain does not raise it: a mark-to-market gain is initial margin
+     * for new positions but may not fund an exit. Size new positions from
+     * `MarginAccountSummary.freeCollateral`, which credits that gain in full.
+     *
+     * Note the two `margin*` fields answer opposite questions:
+     * {@link marginTransferable} is wallet-to-margin capacity, this is the
+     * amount that can come back out.
      */
     marginAvailableCollateral?: string;
 }

package/dist/profile/index.d.ts

@@ -122,12 +122,6 @@ export interface GetUserBalancesParams {
  * Response from getting user movements
  */
 export interface GetPaginatedUserMovementsResponse {
-    /**
-     * Latest movements from the live engine cache (real-time, instant updates).
-     * These are the most recent movements that may not yet be in PostgreSQL.
-     * Only populated on page 1; empty for subsequent pages.
-     */
-    latest_movements?: LedgerMovement[];
     /** All movements from PostgreSQL (historical, paginated) */
     movements: LedgerMovement[];
     /** Current page number */

package/dist/sdk/index.d.ts

@@ -15,7 +15,7 @@ import type { SubAccountsAPI } from "../sub-accounts";
 import type { SweeperAPI } from "../sweeper";
 import type { TradingAPI, TradingMode } from "../trading";
 import type { VaultAPI } from "../vault";
-import type { ConditionalOrderEvent, OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, UserBalanceEvent, UserMovementEvent } from "../websocket";
+import type { ConditionalOrderEvent, MonacoWebSocketConfig, OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, UserBalanceEvent, UserMovementEvent } from "../websocket";
 import type { WhitelistAPI } from "../whitelist";
 import type { WithdrawalsAPI } from "../withdrawals";
 import type { Network } from "./network";
@@ -66,6 +66,16 @@ export interface SDKConfig {
      * 750ms when omitted. Must be a positive finite number when provided.
      */
     pollingInterval?: number;
+    /**
+     * WebSocket reconnect/resync configuration. The `onStatusChange` /
+     * `onResync` callbacks and the reconnect knobs (`autoReconnect`,
+     * `maxReconnectAttempts`, `reconnectBaseDelayMs`, `connectionTimeoutMs`) are
+     * threaded into the WebSocket client the SDK builds internally, so an app can
+     * observe connection status and drive snapshot resyncs without dropping to
+     * the low-level `createMonacoWebSocket` factory. The session keypair is not
+     * part of this surface — it flows from {@link MonacoSDK.login}.
+     */
+    ws?: MonacoWebSocketConfig;
 }
 /**
  * Core SDK interface providing access to all Monaco functionality.

package/dist/trading/index.d.ts

@@ -39,9 +39,10 @@ export interface TradingAPI extends BaseAPI {
         leverage?: string;
         reduceOnly?: boolean;
         /**
-         * Maker-only: rejected with a 400 whose message contains
-         * `post-only order would cross` if this limit order would cross the
-         * book. LIMIT orders with GTC/GTD only; rejected together with IOC/FOK.
+         * 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.
+         * Echoed back as `postOnly` on order detail and list reads.
          */
         postOnly?: boolean;
         takeProfit?: ParentTpSlLegParams;

package/dist/trading/orders.d.ts

@@ -68,6 +68,8 @@ export interface Order {
     leverage?: string;
     /** Whether the order can only reduce existing exposure */
     reduceOnly?: boolean;
+    /** Whether the order was placed post-only (maker-only). Absent for orders placed before the flag was persisted. */
+    postOnly?: boolean;
     /** Position ID linked to the order, when available */
     positionId?: string;
     /** Stable cause when status is CANCELLED */

package/dist/trading/responses.d.ts

@@ -167,11 +167,6 @@ export interface GetPaginatedOrdersParams {
  * Response from getting paginated orders
  */
 export interface GetPaginatedOrdersResponse {
-    /** Latest orders from the live engine cache (real-time, instant updates).
-     * These are the most recently created/updated orders that may not yet be in PostgreSQL.
-     * Only populated on page 1.
-     */
-    latest_orders?: Order[];
     /** Array of historical orders from PostgreSQL (paginated) */
     orders: Order[];
     /**
@@ -357,10 +352,11 @@ export interface BatchCreateOrderParams {
     /** Whether the order can only reduce existing exposure */
     reduceOnly?: boolean;
     /**
-     * Maker-only: rejected with a 400 whose message contains
-     * `post-only order would cross` if this limit order would cross the book.
-     * LIMIT orders with GTC/GTD only; rejected on MARKET orders and combined
-     * with IOC/FOK.
+     * 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
+     * orders and combined with IOC/FOK. Echoed back as `postOnly` on order
+     * detail and list reads.
      */
     postOnly?: boolean;
 }

package/dist/websocket/base.d.ts

@@ -7,6 +7,62 @@
  * WebSocket connection status
  */
 export type WebSocketStatus = "connected" | "connecting" | "disconnected" | "reconnecting";
+/** Handler invoked whenever the WebSocket connection status changes. */
+export type StatusHandler = (status: WebSocketStatus) => void;
+/**
+ * Why the connection was re-established. Delivered by
+ * {@link MonacoWebSocketConfig.onResync} after the client has reconnected,
+ * re-authenticated, and re-subscribed — the point where the app should refetch
+ * REST snapshots and reconcile by `(id, updatedAt)`.
+ */
+export interface WebSocketResyncInfo {
+    /** WebSocket close code of the connection that was lost. */
+    code: number;
+    /**
+     * True when the server closed with 1013 (try again later): the client fell
+     * behind a sequential stream (orders, conditional orders, liquidations,
+     * trades, movements) and the stream has a gap. There is no wire sequence
+     * number — the 1013 close is the gap signal, and a snapshot refetch is the
+     * only safe repair.
+     */
+    slowClient: boolean;
+}
+/** Handler invoked after a reconnect resumes the live stream. */
+export type ResyncHandler = (info: WebSocketResyncInfo) => void;
+/**
+ * Reconnect/resync knobs and callbacks for the Monaco WebSocket client.
+ *
+ * These are settable from the main SDK config ({@link SDKConfig.ws}) so an app
+ * can observe connection status and drive snapshot resyncs without reaching for
+ * the low-level `createMonacoWebSocket` factory. The session keypair is not
+ * part of this surface — it flows from {@link MonacoSDK.login}.
+ */
+export interface MonacoWebSocketConfig {
+    /** Enable auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /**
+     * Maximum reconnection attempts (default: unlimited). Retry delay is
+     * full-jitter exponential backoff capped at 30s, so unlimited retries are
+     * capped-rate, not a tight loop.
+     */
+    maxReconnectAttempts?: number;
+    /** Base delay for the exponential backoff in milliseconds (default: 1000) */
+    reconnectBaseDelayMs?: number;
+    /**
+     * How long a connection attempt may stay CONNECTING before it is failed and
+     * retried, in milliseconds (default: 10000)
+     */
+    connectionTimeoutMs?: number;
+    /** Callback for connection status changes */
+    onStatusChange?: StatusHandler;
+    /**
+     * Called after every automatic reconnect once the live stream is resumed
+     * (re-authenticated and re-subscribed). Refetch REST snapshots here and
+     * reconcile by `(id, updatedAt)`, last-writer-wins; events that arrived while
+     * the snapshot was in flight are newer than the snapshot rows they duplicate.
+     */
+    onResync?: ResyncHandler;
+}
 /**
  * Raw event message interface
  * This is the raw message received from the backend

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

@@ -1,7 +1,9 @@
 export * from "./balance-events";
 export * from "./conditional-order-events";
+export * from "./liquidation-events";
 export * from "./movement-events";
 export * from "./ohlcv-events";
 export * from "./orderbook-events";
 export * from "./orders-events";
+export * from "./position-events";
 export * from "./trade-events";

package/dist/websocket/events/index.js

@@ -1,7 +1,9 @@
 export * from "./balance-events";
 export * from "./conditional-order-events";
+export * from "./liquidation-events";
 export * from "./movement-events";
 export * from "./ohlcv-events";
 export * from "./orderbook-events";
 export * from "./orders-events";
+export * from "./position-events";
 export * from "./trade-events";

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

@@ -0,0 +1,54 @@
+/**
+ * Liquidation WebSocket Event Types
+ *
+ * Types for real-time liquidation alerts (an account crossed a maintenance
+ * threshold and a liquidation record was opened / advanced).
+ *
+ * This is an authenticated channel - requires the signed session-key handshake.
+ * Lag policy is Disconnect: a subscriber that falls behind is closed with
+ * `1013` (try again later). There is no wire sequence number, so the `1013`
+ * close is the gap signal - resync by refetching a REST/SDK snapshot.
+ */
+/**
+ * Liquidation alert event data.
+ *
+ * `status` and `accountState` are free-form strings on the wire (they mirror
+ * server-side enums that carry no wire-level rename), so they are typed as
+ * `string` rather than a closed union to avoid dropping a risk-critical alert
+ * on an unexpected value.
+ */
+export interface LiquidationEventData {
+    /** Liquidation record identifier (UUID) */
+    liquidationId: string;
+    /** Margin account under liquidation (UUID) */
+    marginAccountId: string;
+    /** Position being liquidated, when the alert is position-scoped (UUID) */
+    positionId?: string;
+    /** Trading pair of the liquidated position, when position-scoped (UUID) */
+    tradingPairId?: string;
+    /** Liquidation record status (e.g. "UNRESOLVED", free-form) */
+    status: string;
+    /** Margin-account risk state at alert time (e.g. "PENDING", free-form) */
+    accountState: string;
+    /** Position liquidation price, when known (decimal string) */
+    liquidationPrice?: string;
+    /** Mark price at alert time, when known (decimal string) */
+    markPrice?: string;
+    /** Estimated collateral shortfall (decimal string) */
+    estimatedShortfall: string;
+    /** Human-readable alert message */
+    message: string;
+    /** Timestamp when the alert was triggered (ISO 8601) */
+    triggeredAt: string;
+}
+/**
+ * Liquidation alert event emitted when a user's account is being liquidated.
+ */
+export interface LiquidationEvent {
+    /** Event type identifier */
+    eventType: "liquidation_alert";
+    /** User ID (UUID) */
+    userId: string;
+    /** Liquidation data */
+    data: LiquidationEventData;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * Liquidation WebSocket Event Types
+ *
+ * Types for real-time liquidation alerts (an account crossed a maintenance
+ * threshold and a liquidation record was opened / advanced).
+ *
+ * This is an authenticated channel - requires the signed session-key handshake.
+ * Lag policy is Disconnect: a subscriber that falls behind is closed with
+ * `1013` (try again later). There is no wire sequence number, so the `1013`
+ * close is the gap signal - resync by refetching a REST/SDK snapshot.
+ */

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

@@ -37,8 +37,14 @@ export interface CommonOrderEventData {
     tradingPairId?: string;
     /** Application ID (UUID) - present in several events */
     applicationId?: string;
-    /** Trading pair symbol (e.g., "BTC/USDC") */
-    symbol: string;
+    /**
+     * Trading pair symbol (e.g., "BTC/USDC").
+     *
+     * The wire field is `trading_pair` (→ `tradingPair` after camelCasing), not
+     * `symbol`; the previous `symbol` declaration never matched what the matching
+     * engine emits.
+     */
+    tradingPair: string;
     /** Trading mode (e.g., "SPOT", "MARGIN") */
     tradingMode: TradingMode;
     /** Order type - present in most events */
@@ -49,6 +55,8 @@ export interface CommonOrderEventData {
     price?: string;
     /** Order quantity - present in most events */
     quantity?: string;
+    /** Order quantity in RAW (integer, base-unit) precision. Wire: `quantity_raw`. */
+    quantityRaw?: string;
     /** Time in force - present in most events */
     timeInForce?: TimeInForce;
 }
@@ -131,10 +139,22 @@ export interface OrderPartiallyFilledEvent extends OrderEvent {
         tradeId?: string;
         /** Execution price (maker orders only) */
         executionPrice?: string;
-        /** Execution quantity (maker orders only) */
-        executionQuantity?: string;
-        /** Maker fee (maker orders only) */
-        makerFee?: 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.
+         */
+        filledQuantity?: string;
+        /** `filledQuantity` in RAW (integer, base-unit) precision. Wire: `filled_quantity_raw`. */
+        filledQuantityRaw?: string;
+        /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
+        remainingQuantityRaw?: string;
+        /**
+         * Fee charged for this fill (maker orders only). The wire field is `fee`
+         * (→ `fee`), not `makerFee`; taker fills carry the same `fee` field.
+         */
+        fee?: string;
         /** Trade execution timestamp (maker orders only) */
         executedAt?: string;
         /** Role of the order in the trade (taker or maker) */
@@ -179,10 +199,22 @@ export interface OrderFilledEvent extends OrderEvent {
         tradeId?: string;
         /** Execution price (maker orders only) */
         executionPrice?: string;
-        /** Execution quantity (maker orders only) */
-        executionQuantity?: string;
-        /** Maker fee (maker orders only) */
-        makerFee?: 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.
+         */
+        filledQuantity?: string;
+        /** `filledQuantity` in RAW (integer, base-unit) precision. Wire: `filled_quantity_raw`. */
+        filledQuantityRaw?: string;
+        /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
+        remainingQuantityRaw?: string;
+        /**
+         * Fee charged for this fill (maker orders only). The wire field is `fee`
+         * (→ `fee`), not `makerFee`; taker fills carry the same `fee` field.
+         */
+        fee?: string;
         /** Trade execution timestamp (maker orders only) */
         executedAt?: string;
         /** Role of the order in the trade (taker or maker) */
@@ -201,8 +233,12 @@ export interface OrderCancelledEvent extends OrderEvent {
         terminalReason?: OrderTerminalReason;
         /** Total filled quantity before cancellation */
         totalFilled?: string;
+        /** `totalFilled` in RAW (integer, base-unit) precision. Wire: `total_filled_raw`. */
+        totalFilledRaw?: string;
         /** Remaining quantity when canceled */
         remainingQuantity?: string;
+        /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
+        remainingQuantityRaw?: string;
         /** Number of trades executed before cancellation */
         tradesCount?: number;
     };
@@ -279,8 +315,8 @@ export interface BackendCommonOrderEventData {
     user_id: string;
     /** Trading pair ID (UUID) */
     trading_pair_id?: string;
-    /** Trading pair symbol (e.g., "BTC/USDC") */
-    symbol: string;
+    /** Trading pair symbol (e.g., "BTC/USDC"), from the wire `trading_pair` field. */
+    trading_pair: string;
     /** Trading mode (e.g., "Spot", "Margin") */
     trading_mode: string;
 }

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

@@ -0,0 +1,66 @@
+/**
+ * Position WebSocket Event Types
+ *
+ * Types for real-time position state updates (open/close, mark price, PnL,
+ * liquidation price, isolated margin, leverage).
+ *
+ * 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.
+ */
+/**
+ * Position side. The server emits `LONG` or `SHORT` for an open position.
+ */
+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.
+ */
+export type PositionEventStatus = "Open" | "Closing" | "Closed" | "Liquidated" | "Expired";
+/**
+ * Position event data containing the current state of a single position.
+ */
+export interface PositionEventData {
+    /** Position identifier (UUID) */
+    positionId: string;
+    /** Margin account that owns the position (UUID) */
+    marginAccountId: string;
+    /** Trading pair identifier (UUID) */
+    tradingPairId: string;
+    /** Position side */
+    side: PositionEventSide;
+    /** Position lifecycle status (PascalCase on the wire) */
+    status: PositionEventStatus;
+    /** Absolute position size (decimal string) */
+    size: string;
+    /** Average entry price (decimal string) */
+    entryPrice: string;
+    /** Current mark price (decimal string) */
+    markPrice?: string;
+    /** Unrealized PnL at the current mark price (decimal string) */
+    unrealizedPnl?: string;
+    /** Estimated liquidation price (decimal string) */
+    liquidationPrice?: string;
+    /** Isolated margin / collateral backing the position (decimal string) */
+    isolatedMargin: string;
+    /** Effective leverage (decimal string) */
+    leverage: string;
+    /** What triggered the update (e.g. "trade", free-form) */
+    reason: string;
+    /** Timestamp when the position state was updated (ISO 8601) */
+    updatedAt: string;
+}
+/**
+ * Position event emitted when a user's position state changes.
+ */
+export interface PositionEvent {
+    /** Event type identifier */
+    eventType: "position_update";
+    /** User ID (UUID) */
+    userId: string;
+    /** Position data */
+    data: PositionEventData;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Position WebSocket Event Types
+ *
+ * Types for real-time position state updates (open/close, mark price, PnL,
+ * liquidation price, isolated margin, leverage).
+ *
+ * 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.
+ */

package/dist/wire/assert.d.ts

@@ -51,4 +51,15 @@ export type WireCovered<Ergo, Wire> = [MissingWireFields<Ergo, Wire>] extends [n
  * `tsc` reports the missing wire fields at this line.
  */
 export type Expect<T extends true> = T;
+/**
+ * Resolves to `true` when `K` is NOT a key of `T`, otherwise `false`. Pair with
+ * {@link Expect} to guard that a field stays absent from a public type, so a
+ * removed field cannot silently reappear:
+ *
+ *   type _NoLatestOrders = Expect<KeyAbsent<GetPaginatedOrdersResponse, "latest_orders">>;
+ *
+ * If the key is present, `KeyAbsent` resolves to `false`, `T extends true`
+ * fails, and `tsc` reports the reintroduced field at this line.
+ */
+export type KeyAbsent<T, K extends PropertyKey> = K extends keyof T ? false : true;
 export {};

package/dist/wire/index.d.ts

@@ -13,7 +13,7 @@
  * It also exports the generated runtime `OPERATION_IDS` list and the
  * `auditSurface` helper that power the MON-1489 endpoint-coverage gate.
  */
-export type { Expect, MissingWireFields, WireCovered, WireSchema, WireSchemas } from "./assert";
+export type { Expect, KeyAbsent, MissingWireFields, WireCovered, WireSchema, WireSchemas } from "./assert";
 export type { CoverageAudit, SurfaceClassification } from "./audit";
 export { auditSurface } from "./audit";
 export type { OperationId } from "./operations";

package/dist/wire/schema.d.ts

@@ -2715,7 +2715,7 @@ export interface components {
              */
             marginMode?: "ISOLATED" | "CROSS" | null;
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book (HTTP 400 / gRPC INVALID_ARGUMENT; the error message contains 'post-only order would cross'). 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/GTD only; rejected on MARKET orders and IOC/FOK.
              * @example false
              */
             postOnly?: boolean | null;
@@ -2789,7 +2789,7 @@ export interface components {
              */
             useMasterBalance?: boolean | null;
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book (HTTP 400 / gRPC INVALID_ARGUMENT; the error message contains 'post-only order would cross'). 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/GTD only; rejected on MARKET orders and IOC/FOK.
              * @example false
              */
             postOnly?: boolean | null;
@@ -3188,7 +3188,7 @@ export interface components {
              */
             marginMode?: "ISOLATED" | "CROSS" | null;
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book (HTTP 400 / gRPC INVALID_ARGUMENT; the error message contains 'post-only order would cross'). 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/GTD only; rejected on MARKET orders and IOC/FOK.
              * @example false
              */
             postOnly?: boolean | null;
@@ -3530,10 +3530,21 @@ export interface components {
             walletLocked?: string | null;
             marginTransferable?: string | null;
             /**
-             * @description Free collateral currently held in the user's parent margin account for this
-             *      asset (equity minus initial margin required), i.e. collateral already inside
-             *      margin and available to open new positions or transfer back out. Absent when
-             *      the user has no margin account yet.
+             * @description The largest amount that can currently leave the user's parent margin
+             *      account for this asset — the same bound as
+             *      `MarginAccountSummary.withdrawable_collateral`, and served from the same
+             *      value, so the two surfaces cannot disagree. Absent when the user has no
+             *      margin account yet.
+             *
+             *      This is NOT trading headroom. It is bounded by allocation (principal not
+             *      earmarked by risk buckets) as well as by margin requirements, and an
+             *      unrealized gain does not raise it: a mark-to-market gain is initial margin
+             *      for new positions but may not fund an exit. Size new positions from
+             *      `MarginAccountSummary.free_collateral`, which credits that gain in full.
+             *
+             *      Note the two `margin_*` fields answer opposite questions:
+             *      `margin_transferable` is wallet-to-margin capacity, this is the amount that
+             *      can come back out.
              */
             marginAvailableCollateral?: string | null;
         };
@@ -3726,6 +3737,28 @@ export interface components {
             initialMarginRequired?: string | null;
             maintenanceMarginRequired?: string | null;
             freeCollateral?: string | null;
+            /**
+             * @description The largest amount a transfer-out of this scope will actually accept.
+             *
+             *      NOT a clamped `free_collateral`. Free collateral is equity headroom, and
+             *      equity includes realized PnL, accrued funding and mark-to-market gains
+             *      that are not principal a transfer can move — so the two can differ
+             *      without limit. An unrealized gain never counts toward this figure.
+             *
+             *      For a risk bucket this is capped by the bucket's allocated collateral;
+             *      for a parent margin account, by deposited collateral that no risk bucket
+             *      has earmarked.
+             *
+             *      This is the largest accepted transfer-out, NOT a promise that every
+             *      smaller one is accepted. Acceptance is not monotone in the amount: a risk
+             *      bucket whose realized loss exceeds its remaining value accepts the full
+             *      close-out reported here — which settles that loss to the parent margin
+             *      account — while refusing a partial withdrawal that would leave the bucket
+             *      holding less collateral than the loss it has already taken. For such a
+             *      bucket the accepted amounts are everything up to its equity, plus this
+             *      figure itself, with a gap in between. Size a transfer directly from this
+             *      field rather than shaving a margin off it.
+             */
             withdrawableCollateral?: string | null;
             totalPositionNotional?: string | null;
             unrealizedPnl?: string | null;
@@ -4154,6 +4187,11 @@ export interface components {
              * @example REDUCE_ONLY_EXHAUSTED
              */
             terminalReason?: string | null;
+            /**
+             * @description Whether the order was placed post-only (maker-only). Absent for orders placed before the flag was persisted.
+             * @example false
+             */
+            postOnly?: boolean | null;
         };
         /** @description Orderbook snapshot with token metadata and sequence number. */
         GetOrderbookResponse: {
@@ -5187,6 +5225,28 @@ export interface components {
             initialMarginRequired?: string | null;
             maintenanceMarginRequired?: string | null;
             freeCollateral?: string | null;
+            /**
+             * @description The largest amount a transfer-out of this scope will actually accept.
+             *
+             *      NOT a clamped `free_collateral`. Free collateral is equity headroom, and
+             *      equity includes realized PnL, accrued funding and mark-to-market gains
+             *      that are not principal a transfer can move — so the two can differ
+             *      without limit. An unrealized gain never counts toward this figure.
+             *
+             *      For a risk bucket this is capped by the bucket's allocated collateral;
+             *      for a parent margin account, by deposited collateral that no risk bucket
+             *      has earmarked.
+             *
+             *      This is the largest accepted transfer-out, NOT a promise that every
+             *      smaller one is accepted. Acceptance is not monotone in the amount: a risk
+             *      bucket whose realized loss exceeds its remaining value accepts the full
+             *      close-out reported here — which settles that loss to the parent margin
+             *      account — while refusing a partial withdrawal that would leave the bucket
+             *      holding less collateral than the loss it has already taken. For such a
+             *      bucket the accepted amounts are everything up to its equity, plus this
+             *      figure itself, with a gap in between. Size a transfer directly from this
+             *      field rather than shaving a margin off it.
+             */
             withdrawableCollateral?: string | null;
             totalPositionNotional?: string | null;
             unrealizedPnl?: string | null;
@@ -5917,7 +5977,7 @@ export interface components {
         };
         ReplaceOrderRequest: {
             /**
-             * @description Post-only: reject instead of matching if this limit order would cross the book (HTTP 400 / gRPC INVALID_ARGUMENT; the error message contains 'post-only order would cross'). 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/GTD only; rejected on MARKET orders and IOC/FOK.
              * @example false
              */
             postOnly?: boolean | null;
@@ -6652,6 +6712,11 @@ export interface components {
             status?: string | null;
             newEquity?: string | null;
             newTotalCollateralValue?: string | null;
+            /**
+             * @description The largest amount a further transfer-out will accept after this one.
+             *      See `MarginAccountSummary.withdrawable_collateral`: this is an
+             *      allocation-bounded figure, not clamped equity headroom.
+             */
             newWithdrawableCollateral?: string | null;
             strategyKey?: string | null;
         };
@@ -6682,6 +6747,11 @@ export interface components {
             status?: string | null;
             newEquity?: string | null;
             newTotalCollateralValue?: string | null;
+            /**
+             * @description The largest amount a further transfer-out will accept after this one.
+             *      See `MarginAccountSummary.withdrawable_collateral`: this is an
+             *      allocation-bounded figure, not clamped equity headroom.
+             */
             newWithdrawableCollateral?: string | null;
             strategyKey?: string | null;
             /** @description Present when collateral was allocated to a risk bucket. */
@@ -7961,7 +8031,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Unauthorized - Invalid or missing JWT */
+            /** @description Authentication required */
             401: {
                 headers: {
                     [name: string]: unknown;

package/package.json

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