@0xmonaco/types 1.0.38 → 1.0.39-prerelease.19d492d

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

@@ -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[];
     /**
@@ -359,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/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

@@ -360,6 +360,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

@@ -429,13 +429,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 +472,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/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/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/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,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;
@@ -2789,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;
@@ -3188,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;
@@ -3873,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: {
@@ -4274,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;
@@ -4284,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"];
@@ -5925,17 +5908,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,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;
@@ -6151,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: {
@@ -6703,6 +6685,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 +10822,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.38",
+	"version": "1.0.39-prerelease.19d492d",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.38",
+		"@0xmonaco/contracts": "1.0.39-prerelease.19d492d",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {