@0xmonaco/types 1.0.39-develop.71e039b → 1.0.39-prerelease.19d492d

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

@@ -41,7 +41,7 @@ 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;

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;
@@ -134,7 +134,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

@@ -354,7 +354,7 @@ 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.
      */

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({

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/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

@@ -140,14 +140,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 +209,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 +249,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 +267,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/schema.d.ts

@@ -2670,7 +2670,7 @@ 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;
@@ -2744,7 +2744,7 @@ 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;
@@ -3143,7 +3143,7 @@ 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;
@@ -3828,6 +3828,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: {
@@ -4229,9 +4234,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;
@@ -4239,6 +4252,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"];
@@ -5921,7 +5949,7 @@ 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.
+             * @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;
@@ -6095,6 +6123,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: {

package/package.json

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