@0xmonaco/types 1.0.57 → 1.0.58

package/dist/profile/index.d.ts

@@ -5,7 +5,7 @@
  */
 import type { Address } from "viem";
 import type { BaseAPI } from "../api";
-import type { OrderSide, OrderStatus, OrderType, TimeInForce } from "../trading";
+import type { OrderSide, OrderStatus, OrderType, SelfTradePreventionMode, TimeInForce } from "../trading";
 /**
  * Account movement/transaction information.
  * Represents transactions/movements returned in the profile's recent_movements array.
@@ -502,6 +502,17 @@ export interface UserProfile {
     /** Additional maker fee in basis points contributed by the application (if any) */
     applicationMakerFeeBps?: number;
 }
+/**
+ * The wallet's self-trade-prevention default — the mode applied when an order
+ * from this wallet family would match the family's own resting order and the
+ * order itself names no override.
+ */
+export interface SelfTradePreventionDefault {
+    /** The wallet's effective mode. */
+    mode: SelfTradePreventionMode;
+    /** True when this wallet has explicitly set a default; false when the platform default (`CANCEL_MAKER`) is in effect. */
+    isCustom: boolean;
+}
 /**
  * Profile API interface.
  * Provides methods for fetching and managing user profile information.
@@ -612,4 +623,27 @@ export interface ProfileAPI extends BaseAPI {
      * @throws ValidationError If pagination params or a UUID filter are invalid; this may occur before any network request.
      */
     listFundingPayments(params?: ListFundingPaymentsParams): Promise<ListFundingPaymentsResponse>;
+    /**
+     * Get the wallet's self-trade-prevention default.
+     *
+     * Fetches the setting from the /api/v1/accounts/self-trade-prevention endpoint.
+     * Requires a valid access token to be set. The default is wallet-scoped: it
+     * covers every application and account sharing the wallet address.
+     *
+     * @returns Promise resolving to the effective mode plus whether it was explicitly set
+     */
+    getSelfTradePreventionDefault(): Promise<SelfTradePreventionDefault>;
+    /**
+     * Set the wallet's self-trade-prevention default.
+     *
+     * Sends a PUT to the /api/v1/accounts/self-trade-prevention endpoint. The
+     * write is sequenced through the matching engine; on success the wallet
+     * family's next order already resolves the new mode. Delegated-agent
+     * sessions cannot change it (403).
+     *
+     * @param mode - One of "CANCEL_MAKER", "CANCEL_TAKER", "CANCEL_BOTH", "SKIP"
+     * @returns Promise resolving to the setting now in force
+     * @throws ValidationError If mode is not a known token; this occurs before any network request.
+     */
+    setSelfTradePreventionDefault(mode: SelfTradePreventionMode): Promise<SelfTradePreventionDefault>;
 }

package/dist/trading/index.d.ts

@@ -5,7 +5,7 @@
  */
 import type { BaseAPI } from "../api/index";
 import type { MarginMode } from "../margin-accounts";
-import type { Order, OrderSide, PositionSide, TimeInForce, TradingMode } from "./orders";
+import type { Order, OrderSide, PositionSide, SelfTradePreventionMode, TimeInForce, TradingMode } from "./orders";
 import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrdersParams, ListTwapOrdersResponse, ParentTpSlLegParams, ReplaceOrderResponse, TwapOrder } from "./responses";
 /**
  * Trading API interface.
@@ -45,6 +45,13 @@ export interface TradingAPI extends BaseAPI {
          * Echoed back as `postOnly` on order detail and list reads.
          */
         postOnly?: boolean;
+        /**
+         * Per-order self-trade-prevention override: CANCEL_MAKER, CANCEL_TAKER,
+         * CANCEL_BOTH, or SKIP. Omitted, your wallet's configured default
+         * applies, else the platform default CANCEL_MAKER. Echoed back as
+         * `selfTradePreventionMode` on order reads.
+         */
+        selfTradePreventionMode?: SelfTradePreventionMode;
         /**
          * Client-assigned correlation handle, echoed back on order reads and
          * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
@@ -82,6 +89,13 @@ export interface TradingAPI extends BaseAPI {
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
+        /**
+         * Per-order self-trade-prevention override: CANCEL_MAKER, CANCEL_TAKER,
+         * CANCEL_BOTH, or SKIP. Omitted, your wallet's configured default
+         * applies, else the platform default CANCEL_MAKER. Echoed back as
+         * `selfTradePreventionMode` on order reads.
+         */
+        selfTradePreventionMode?: SelfTradePreventionMode;
         /**
          * Client-assigned correlation handle, echoed back on order reads and
          * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
@@ -149,6 +163,12 @@ export interface TradingAPI extends BaseAPI {
         quantity?: string;
         useMasterBalance?: boolean;
         postOnly?: boolean;
+        /**
+         * Re-states the self-trade-prevention override for the replacement:
+         * nothing is inherited from the original order. Omitted, your wallet's
+         * configured default applies, else the platform default CANCEL_MAKER.
+         */
+        selfTradePreventionMode?: SelfTradePreventionMode;
         /**
          * Client-assigned correlation handle, echoed back on order reads and
          * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
@@ -238,6 +258,6 @@ export interface TradingAPI extends BaseAPI {
      */
     listTwapOrders(params?: ListTwapOrdersParams): Promise<ListTwapOrdersResponse>;
 }
-export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, ListedOrderType, Order, OrderRole, OrderSide, OrderStatus, OrderStatusFilter, OrderTerminalReason, OrderType, PositionSide, TimeInForce, TradingMode, TwapExecutionStyle, TwapOrderState, } from "./orders";
+export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, ListedOrderType, Order, OrderRole, OrderSide, OrderStatus, OrderStatusFilter, OrderTerminalReason, OrderType, PositionSide, SelfTradePreventionMode, TimeInForce, TradingMode, TwapExecutionStyle, TwapOrderState, } from "./orders";
 export { ORDER_STATUS_VALUES } from "./orders";
 export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrdersParams, ListTwapOrdersResponse, MatchResult, ParentTpSlLegParams, ReplaceOrderResponse, TwapOrder, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -78,6 +78,14 @@ export interface Order {
     reduceOnly?: boolean;
     /** Whether the order was placed post-only (maker-only). Absent for orders placed before the flag was persisted. */
     postOnly?: boolean;
+    /**
+     * The per-order self-trade-prevention override REQUESTED when this order was
+     * placed or replaced. Absent when the order carried no override — including
+     * every order placed before the field was accepted on write — even though a
+     * wallet or platform default still governed its matching: this echoes the
+     * request, not the resolved default.
+     */
+    selfTradePreventionMode?: SelfTradePreventionMode;
     /**
      * Client-assigned correlation handle as stored: the value supplied on create
      * or replace, with surrounding whitespace trimmed. Absent when the order
@@ -151,7 +159,7 @@ export interface Order {
     version?: number;
 }
 /** Stable terminal causes for accepted orders that end as CANCELLED. */
-export type OrderTerminalReason = "USER_REQUESTED" | "REPLACED" | "LIQUIDATION" | "INSUFFICIENT_MARGIN" | "REDUCE_ONLY_EXHAUSTED" | "POSITION_CLOSED" | "OCO_SIBLING_TRIGGERED" | "SYSTEM";
+export type OrderTerminalReason = "USER_REQUESTED" | "REPLACED" | "LIQUIDATION" | "INSUFFICIENT_MARGIN" | "REDUCE_ONLY_EXHAUSTED" | "POSITION_CLOSED" | "OCO_SIBLING_TRIGGERED" | "SELF_TRADE_PREVENTION" | "SYSTEM";
 /**
  * Role of the creator or order
  */
@@ -225,6 +233,24 @@ export type TradingMode = "SPOT" | "MARGIN";
  *   `GTC` together with `expirationDate`.
  */
 export type TimeInForce = "GTC" | "IOC" | "FOK" | "GTD";
+/**
+ * Per-order self-trade-prevention override: how the engine resolves the order
+ * matching against one of your own resting orders (whole wallet family,
+ * subaccounts included; the incoming order's mode governs the step).
+ * - CANCEL_MAKER: cancel each of your resting orders encountered and keep
+ *   matching (the platform default when no override or wallet default is set)
+ * - CANCEL_TAKER: fill third-party liquidity up to the first self-touch, then
+ *   cancel the incoming order's remainder (zero-fill CANCELLED possible)
+ * - CANCEL_BOTH: CANCEL_TAKER plus cancelling the encountered resting orders;
+ *   an FOK order with your own order in the fill path is rejected with
+ *   SELF_TRADE_NOT_ALLOWED
+ * - SKIP: trade around your resting orders; a remainder that would rest
+ *   crossing one of your surviving orders is cancelled instead of resting
+ *
+ * STP cancellations carry `terminalReason: "SELF_TRADE_PREVENTION"` and
+ * `stpCounterpartyOrderId` on order reads and WebSocket events.
+ */
+export type SelfTradePreventionMode = "CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP";
 /**
  * Conditional TP/SL condition type.
  */

package/dist/trading/responses.d.ts

@@ -4,7 +4,7 @@
  * Response types for trading operations.
  */
 import type { MarginMode } from "../margin-accounts";
-import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderSide, OrderStatus, OrderStatusFilter, OrderType, PositionSide, TimeInForce, TradingMode, TwapExecutionStyle, TwapOrderState } from "./orders";
+import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderSide, OrderStatus, OrderStatusFilter, OrderType, PositionSide, SelfTradePreventionMode, TimeInForce, TradingMode, TwapExecutionStyle, TwapOrderState } from "./orders";
 /**
  * Match result information for order execution.
  * Contains detailed information about trades, fills, and execution quality.
@@ -375,6 +375,16 @@ export interface BatchCreateOrderParams {
      * detail and list reads.
      */
     postOnly?: boolean;
+    /**
+     * Per-order self-trade-prevention override. An unknown value fails only this
+     * item, with a structured `error.code` of
+     * `INVALID_SELF_TRADE_PREVENTION_MODE`; an FOK item under CANCEL_BOTH with
+     * your own order in the fill path fails with `SELF_TRADE_NOT_ALLOWED`.
+     * Omitted, your wallet's configured default applies, else the platform
+     * default CANCEL_MAKER. Echoed back as `selfTradePreventionMode` on order
+     * reads.
+     */
+    selfTradePreventionMode?: SelfTradePreventionMode;
     /**
      * Client-assigned correlation handle, echoed back on order reads and on
      * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].
@@ -405,6 +415,12 @@ export interface BatchReplaceOrderParams {
      * inherited from the original order — see `TradingAPI.replaceOrder`.
      */
     postOnly?: boolean;
+    /**
+     * Re-states the self-trade-prevention override for the replacement
+     * (optional). Nothing is inherited from the original order; an unknown value
+     * fails only this item with `INVALID_SELF_TRADE_PREVENTION_MODE`.
+     */
+    selfTradePreventionMode?: SelfTradePreventionMode;
     /**
      * Client-assigned correlation handle, echoed back on order reads and on
      * order WebSocket events. At most 64 characters from [A-Za-z0-9._:-].

package/dist/validation/profile.d.ts

@@ -28,6 +28,19 @@ export declare const TransactionTypeSchema: z.ZodEnum<{
     INTEREST: "INTEREST";
     REWARD: "REWARD";
 }>;
+/**
+ * Set Self-Trade-Prevention Default validation schema
+ *
+ * Validates the body of PUT /api/v1/accounts/self-trade-prevention.
+ */
+export declare const SetSelfTradePreventionDefaultSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        CANCEL_MAKER: "CANCEL_MAKER";
+        CANCEL_TAKER: "CANCEL_TAKER";
+        CANCEL_BOTH: "CANCEL_BOTH";
+        SKIP: "SKIP";
+    }>;
+}, z.core.$strip>;
 /**
  * Get User Movements validation schema
  *

package/dist/validation/profile.js

@@ -5,7 +5,7 @@
  * Provides clear, actionable error messages for invalid parameters.
  */
 import { z } from "zod";
-import { UUIDSchema } from "./trading.js";
+import { SelfTradePreventionModeSchema, UUIDSchema } from "./trading.js";
 /**
  * Ledger entry type validation
  */
@@ -18,6 +18,14 @@ export const LedgerEntryTypeSchema = z.enum(["CREDIT", "DEBIT", "LOCK", "UNLOCK"
 export const TransactionTypeSchema = z.enum(["DEPOSIT", "WITHDRAWAL", "TRADE", "FEE", "FUNDING", "LIQUIDATION", "INTEREST", "REWARD"], {
     message: 'Transaction type must be "DEPOSIT", "WITHDRAWAL", "TRADE", "FEE", "FUNDING", "LIQUIDATION", "INTEREST", or "REWARD"',
 });
+/**
+ * Set Self-Trade-Prevention Default validation schema
+ *
+ * Validates the body of PUT /api/v1/accounts/self-trade-prevention.
+ */
+export const SetSelfTradePreventionDefaultSchema = z.object({
+    mode: SelfTradePreventionModeSchema,
+});
 /**
  * Get User Movements validation schema
  *

package/dist/validation/trading.d.ts

@@ -43,6 +43,15 @@ export declare const ConditionalTimeInForceSchema: z.ZodEnum<{
     GTC: "GTC";
     IOC: "IOC";
 }>;
+/**
+ * Per-order self-trade-prevention override validation
+ */
+export declare const SelfTradePreventionModeSchema: z.ZodEnum<{
+    CANCEL_MAKER: "CANCEL_MAKER";
+    CANCEL_TAKER: "CANCEL_TAKER";
+    CANCEL_BOTH: "CANCEL_BOTH";
+    SKIP: "SKIP";
+}>;
 /**
  * Order type validation
  */
@@ -126,6 +135,12 @@ export declare const PlaceLimitOrderSchema: z.ZodObject<{
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
         takeProfit: z.ZodOptional<z.ZodObject<{
             triggerPrice: z.ZodString;
             orderType: z.ZodEnum<{
@@ -192,6 +207,12 @@ export declare const PlaceMarketOrderSchema: z.ZodObject<{
         }>>;
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
         takeProfit: z.ZodOptional<z.ZodObject<{
             triggerPrice: z.ZodString;
             orderType: z.ZodEnum<{
@@ -248,6 +269,12 @@ export declare const ReplaceOrderSchema: z.ZodObject<{
         quantity: z.ZodOptional<z.ZodString>;
         useMasterBalance: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
@@ -437,6 +464,12 @@ export declare const BatchCreateOrderItemSchema: z.ZodObject<{
     leverage: z.ZodOptional<z.ZodString>;
     reduceOnly: z.ZodOptional<z.ZodBoolean>;
     postOnly: z.ZodOptional<z.ZodBoolean>;
+    selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+        CANCEL_MAKER: "CANCEL_MAKER";
+        CANCEL_TAKER: "CANCEL_TAKER";
+        CANCEL_BOTH: "CANCEL_BOTH";
+        SKIP: "SKIP";
+    }>>;
 }, z.core.$strip>;
 /**
  * Maximum items per batch create/replace/cancel request. Mirrors the server's
@@ -491,6 +524,12 @@ export declare const BatchCreateOrdersSchema: z.ZodObject<{
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -505,6 +544,12 @@ export declare const BatchReplaceOrderItemSchema: z.ZodObject<{
     quantity: z.ZodOptional<z.ZodString>;
     useMasterBalance: z.ZodOptional<z.ZodBoolean>;
     postOnly: z.ZodOptional<z.ZodBoolean>;
+    selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+        CANCEL_MAKER: "CANCEL_MAKER";
+        CANCEL_TAKER: "CANCEL_TAKER";
+        CANCEL_BOTH: "CANCEL_BOTH";
+        SKIP: "SKIP";
+    }>>;
 }, z.core.$strip>;
 /**
  * Batch Replace Orders validation schema
@@ -518,5 +563,11 @@ export declare const BatchReplaceOrdersSchema: z.ZodObject<{
         quantity: z.ZodOptional<z.ZodString>;
         useMasterBalance: z.ZodOptional<z.ZodBoolean>;
         postOnly: z.ZodOptional<z.ZodBoolean>;
+        selfTradePreventionMode: z.ZodOptional<z.ZodEnum<{
+            CANCEL_MAKER: "CANCEL_MAKER";
+            CANCEL_TAKER: "CANCEL_TAKER";
+            CANCEL_BOTH: "CANCEL_BOTH";
+            SKIP: "SKIP";
+        }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/validation/trading.js

@@ -36,6 +36,12 @@ export const TimeInForceSchema = z.enum(["GTC", "IOC", "FOK"], {
 export const ConditionalTimeInForceSchema = z.enum(["GTC", "IOC"], {
     message: 'Conditional order time in force must be "GTC" or "IOC"',
 });
+/**
+ * Per-order self-trade-prevention override validation
+ */
+export const SelfTradePreventionModeSchema = z.enum(["CANCEL_MAKER", "CANCEL_TAKER", "CANCEL_BOTH", "SKIP"], {
+    message: 'Self-trade prevention mode must be "CANCEL_MAKER", "CANCEL_TAKER", "CANCEL_BOTH", or "SKIP"',
+});
 /**
  * Order type validation
  */
@@ -153,6 +159,7 @@ export const PlaceLimitOrderSchema = z
         leverage: PositiveDecimalStringSchema.optional(),
         reduceOnly: z.boolean().optional(),
         postOnly: z.boolean().optional(),
+        selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
         takeProfit: ParentTpSlLegSchema.optional(),
         stopLoss: ParentTpSlLegSchema.optional(),
     })
@@ -231,6 +238,7 @@ export const PlaceMarketOrderSchema = z
         positionSide: PositionSideSchema.optional(),
         leverage: PositiveDecimalStringSchema.optional(),
         reduceOnly: z.boolean().optional(),
+        selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
         takeProfit: ParentTpSlLegSchema.optional(),
         stopLoss: ParentTpSlLegSchema.optional(),
     })
@@ -316,6 +324,8 @@ export const ReplaceOrderSchema = z.object({
         // replaceable fields — the server validates postOnly against the
         // persisted original order, which this client-side schema cannot see.
         postOnly: z.boolean().optional(),
+        // Re-stated per replace, never inherited from the original order.
+        selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
     }),
 });
 /**
@@ -530,6 +540,7 @@ export const BatchCreateOrderItemSchema = z
     leverage: PositiveDecimalStringSchema.optional(),
     reduceOnly: z.boolean().optional(),
     postOnly: z.boolean().optional(),
+    selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
 })
     .refine((data) => data.orderType !== "LIMIT" || data.price !== undefined, {
     message: "Price is required for LIMIT orders",
@@ -624,6 +635,8 @@ export const BatchReplaceOrderItemSchema = z
     // replaceable fields — the server validates postOnly against the
     // persisted original order, which this client-side schema cannot see.
     postOnly: z.boolean().optional(),
+    // Re-stated per replace, never inherited from the original order.
+    selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
 })
     .refine((data) => data.price !== undefined || data.quantity !== undefined, {
     message: "At least one of price or quantity must be provided",

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

@@ -4,7 +4,7 @@
  * TypeScript types for order websocket events matching the Rust backend definitions.
  * Each event type has specific data fields based on the event context.
  */
-import type { OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, TimeInForce, TradingMode } from "../../trading";
+import type { OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, SelfTradePreventionMode, TimeInForce, TradingMode } from "../../trading";
 import type { RawEventMessage } from "../base";
 /**
  * Order event types
@@ -137,6 +137,19 @@ export interface CommonOrderEventData {
      * Wire: `post_only`.
      */
     postOnly?: boolean;
+    /**
+     * The self-trade-prevention override REQUESTED on the order
+     * (`"CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP"`), echoed so a
+     * subscriber can confirm what was accepted without a round trip to
+     * `getOrder`. Carried on the `OrderPlaced` acknowledgement, taker fills and
+     * remainder cancels, maker fills (the maker's OWN requested mode), the
+     * resting order's lifecycle frames, and the `orders` snapshot frame. Omitted
+     * when the order carried none — including every order that merely matched
+     * under a wallet or platform default, and every event emitted by a server
+     * predating the field: this echoes the request, never the resolved default.
+     * Wire: `self_trade_prevention_mode`.
+     */
+    selfTradePreventionMode?: SelfTradePreventionMode | (string & {});
 }
 /**
  * OrderPlaced event - emitted when a new order is placed
@@ -389,6 +402,21 @@ export interface OrderCancelledEvent extends OrderEvent {
         reason?: string;
         /** Stable machine-readable cancellation cause */
         terminalReason?: OrderTerminalReason | (string & {});
+        /**
+         * The counterparty order behind a self-trade-prevention cancellation: for
+         * a resting order cancelled because an order of the same owner arrived
+         * against it, the arriving order's id; for an arriving order whose
+         * remainder was cancelled instead, the owner's resting order it would
+         * have matched. The same audit back-pointer Bybit publishes as
+         * `smpOrderId`.
+         *
+         * Present ONLY when `terminalReason` is `SELF_TRADE_PREVENTION`, so
+         * presence is the whole signal. Absent means this was not an STP
+         * cancellation — or the event predates the field, including every event
+         * until the STP modes ship, since nothing emits it yet. Wire:
+         * `stp_counterparty_order_id`.
+         */
+        stpCounterpartyOrderId?: string;
         /**
          * Cumulative order fill at cancellation, mirroring `filledQuantity` on the
          * taker/maker fill events so consumers read one field across every order
@@ -481,6 +509,15 @@ export interface OrderPartiallyCancelledEvent extends OrderEvent {
         remainingQuantityRaw: string;
         /** Caller-supplied cancel reason; explicit `null` when none was given */
         reason: string | null;
+        /**
+         * Reserved: the counterparty order behind a self-trade-prevention
+         * REDUCTION. No shipped STP mode reduces a resting order — the four modes
+         * cancel in full, and DECREMENT/TRANSFER are out of scope — so nothing
+         * emits this today; the field exists so a future reducing mode needs no
+         * wire change. Same contract as `OrderCancelledEvent`'s field when it is
+         * present. Wire: `stp_counterparty_order_id`.
+         */
+        stpCounterpartyOrderId?: string;
         /** When the reduction happened (RFC3339 `Z`). Wire: `reduced_at`. */
         reducedAt: string;
     };

package/dist/websocket/snapshots.d.ts

@@ -24,7 +24,7 @@
  * frame, so its callback is never invoked. That is a silent no-op, never an
  * error.
  */
-import type { OrderSide, OrderType, TimeInForce, TradingMode } from "../trading";
+import type { OrderSide, OrderType, SelfTradePreventionMode, TimeInForce, TradingMode } from "../trading";
 /**
  * Receives one channel's complete subscribe-time state.
  *
@@ -59,8 +59,8 @@ export type SnapshotHandler<T> = (items: T[]) => void;
  * Nullability mirrors the wire exactly. Every optional field below is a Rust
  * `Option` serialized WITHOUT `skip_serializing_if`, so the key is always
  * present and carries `null` when unset — hence `| null` rather than `?`.
- * `clientOrderId` is the sole field the server omits outright, so it is the
- * sole `?`.
+ * `clientOrderId`, `selfTradePreventionMode` and `version` are the fields the
+ * server omits outright, so they are the `?`s.
  *
  * The value unions are widened (`Union | (string & {})`) for the same reason
  * the order event's are: the parser hands an unrecognized value through rather
@@ -122,6 +122,14 @@ export interface OrderSnapshotItem {
      * when the order carried none, matching the live event payload.
      */
     clientOrderId?: string;
+    /**
+     * The self-trade-prevention override REQUESTED on the order
+     * (`"CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP"`), carried for
+     * the `clientOrderId` reason above. Omitted — not `null` — when the order
+     * carried none, matching the live event payload: this echoes the request,
+     * never the resolved wallet or platform default.
+     */
+    selfTradePreventionMode?: SelfTradePreventionMode | (string & {});
     /**
      * Sequencer step this order's state was last written by — the SAME counter
      * the live order events and the REST endpoints carry (0XM-2440).

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 ["attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "cancel_twap_order", "check_trader_code_availability", "clear_trader_code", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "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_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_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", "list_twap_orders", "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"];
+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", "cancel_twap_order", "check_trader_code_availability", "clear_trader_code", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "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_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_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", "list_twap_orders", "mint_tokens", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_self_trade_prevention_default", "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

@@ -66,6 +66,7 @@ export const OPERATION_IDS = [
     "get_pulse",
     "get_rewards_balance",
     "get_screener",
+    "get_self_trade_prevention_default",
     "get_sub_account_limits",
     "get_sweeper_chains",
     "get_trade_by_id",
@@ -105,6 +106,7 @@ export const OPERATION_IDS = [
     "replace_order",
     "revoke_delegated_agent",
     "revoke_session",
+    "set_self_trade_prevention_default",
     "set_trader_code",
     "simulate_fees",
     "simulate_order_risk",

package/dist/wire/schema.d.ts

@@ -267,6 +267,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/accounts/self-trade-prevention": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get your self-trade-prevention default
+         * @description Get your self-trade-prevention default.
+         *
+         *      Return the authenticated wallet's self-trade-prevention default — the mode
+         *      applied when an order from this wallet family (every account sharing the
+         *      wallet address, across applications) would match against the family's own
+         *      resting order and the order itself names no override. `is_custom` is true
+         *      when the wallet has explicitly set a default; false means the platform
+         *      default (`CANCEL_MAKER`) is in effect.
+         */
+        get: operations["get_self_trade_prevention_default"];
+        /**
+         * Set your self-trade-prevention default
+         * @description Set your self-trade-prevention default.
+         *
+         *      Set the authenticated wallet's self-trade-prevention default to one of
+         *      `CANCEL_MAKER`, `CANCEL_TAKER`, `CANCEL_BOTH`, or `SKIP` (input is
+         *      case-insensitive; responses always carry these spellings). The default is
+         *      wallet-scoped — it covers every application and account sharing the wallet
+         *      address — and a per-order mode always overrides it. The write is sequenced
+         *      through the matching engine; on success the next order from the wallet
+         *      family already resolves the new mode. Delegated-agent sessions cannot
+         *      change it.
+         */
+        put: operations["set_self_trade_prevention_default"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/accounts/sub-accounts": {
         parameters: {
             query?: never;
@@ -2869,6 +2909,12 @@ export interface components {
             clientOrderId?: string | null;
             /** @description Optional submission identity, distinct from clientOrderId. Use 1-64 characters from [A-Za-z0-9._:-], without whitespace. Scoped to your authenticated user/subaccount and application, shared by create and batch-create items. Retrying the same key and normalized order payload within 24 hours of the original acceptance returns the original committed submission result, even after a fill or cancellation, without executing again. A full response cache does not prevent new keyed submissions: durable responses may be evicted while exact key history remains retained. If response capacity is protected by pending durability or persistence, a new key is refused with ORDER_SUBMISSION_CAPACITY_EXCEEDED. A retry whose original response cannot currently be retrieved returns ORDER_SUBMISSION_UNAVAILABLE and never executes again. Both are HTTP 503 / gRPC UNAVAILABLE, or per-item errors in batches. Retry the same key and payload; for previously accepted keys, stay within 24 hours of the original acceptance. A capacity refusal does not accept or reserve a new key. Different payload returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS; per-item error in batches). Validation failures before acceptance do not reserve the key. The window does not extend on retries; after it expires the key may execute a new order, so never retry an unresolved submission after 24 hours. Generate a fresh key for each intended new order and retain it across transport retries. Without a key, a timeout or 5xx leaves the outcome unknown and must not be blindly retried. */
             idempotencyKey?: string | null;
+            /**
+             * @description Per-order self-trade-prevention override: how the engine resolves this order matching against one of your own resting orders (your whole wallet family, subaccounts included; the incoming order's mode governs the step and resting orders' modes are never consulted). CANCEL_MAKER cancels each of your resting orders encountered and keeps matching. CANCEL_TAKER fills third-party liquidity up to the first self-touch, then cancels the incoming order's remainder — a zero-fill CANCELLED outcome is possible. CANCEL_BOTH additionally cancels the encountered resting orders. SKIP trades around your resting orders; a remainder that would rest crossing one of your surviving orders is cancelled instead of resting. Omitted, your wallet's configured default applies, else the platform default CANCEL_MAKER. STP cancellations carry terminalReason SELF_TRADE_PREVENTION and stpCounterpartyOrderId on reads and WebSocket events. With time_in_force FOK: CANCEL_MAKER cancels your makers first and then fills or kills; CANCEL_TAKER and SKIP cancel the whole order when self is in the fill path; CANCEL_BOTH fails only this item with a per-item SELF_TRADE_NOT_ALLOWED error — the batch itself still returns 2xx / OK. An unknown value likewise fails only this item, with error.code INVALID_SELF_TRADE_PREVENTION_MODE. The requested value is echoed back as selfTradePreventionMode on order reads, absent when omitted here.
+             * @example CANCEL_TAKER
+             * @enum {string|null}
+             */
+            selfTradePreventionMode?: "CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP" | null;
         };
         BatchCreateOrdersRequest: {
             orders: components["schemas"]["BatchCreateOrderItem"][];
@@ -2948,6 +2994,12 @@ export interface components {
              * @example quote-btc-1130-a
              */
             clientOrderId?: string | null;
+            /**
+             * @description Per-order self-trade-prevention override for the replacement: CANCEL_MAKER, CANCEL_TAKER, CANCEL_BOTH, or SKIP (see the create-order field for the full semantics). A replacement is a new order with a new id, so it carries its own value and inherits nothing from the original — restate it to keep the override. Omitted, your wallet's configured default applies, else the platform default CANCEL_MAKER. An unknown value fails only this item, with error.code INVALID_SELF_TRADE_PREVENTION_MODE. The requested value is echoed back as selfTradePreventionMode on order reads, absent when omitted here.
+             * @example CANCEL_TAKER
+             * @enum {string|null}
+             */
+            selfTradePreventionMode?: "CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP" | null;
         };
         BatchReplaceOrdersRequest: {
             orders: components["schemas"]["BatchReplaceOrderItem"][];
@@ -3383,6 +3435,12 @@ export interface components {
             clientOrderId?: string | null;
             /** @description Optional submission identity, distinct from clientOrderId. Use 1-64 characters from [A-Za-z0-9._:-], without whitespace. Scoped to your authenticated user/subaccount and application, shared by create and batch-create items. Retrying the same key and normalized order payload within 24 hours of the original acceptance returns the original committed submission result, even after a fill or cancellation, without executing again. A full response cache does not prevent new keyed submissions: durable responses may be evicted while exact key history remains retained. If response capacity is protected by pending durability or persistence, a new key is refused with ORDER_SUBMISSION_CAPACITY_EXCEEDED. A retry whose original response cannot currently be retrieved returns ORDER_SUBMISSION_UNAVAILABLE and never executes again. Both are HTTP 503 / gRPC UNAVAILABLE, or per-item errors in batches. Retry the same key and payload; for previously accepted keys, stay within 24 hours of the original acceptance. A capacity refusal does not accept or reserve a new key. Different payload returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS; per-item error in batches). Validation failures before acceptance do not reserve the key. The window does not extend on retries; after it expires the key may execute a new order, so never retry an unresolved submission after 24 hours. Generate a fresh key for each intended new order and retain it across transport retries. Without a key, a timeout or 5xx leaves the outcome unknown and must not be blindly retried. */
             idempotencyKey?: string | null;
+            /**
+             * @description Per-order self-trade-prevention override: how the engine resolves this order matching against one of your own resting orders (your whole wallet family, subaccounts included; the incoming order's mode governs the step and resting orders' modes are never consulted). CANCEL_MAKER cancels each of your resting orders encountered and keeps matching. CANCEL_TAKER fills third-party liquidity up to the first self-touch, then cancels the incoming order's remainder — a zero-fill CANCELLED outcome is possible. CANCEL_BOTH additionally cancels the encountered resting orders. SKIP trades around your resting orders; a remainder that would rest crossing one of your surviving orders is cancelled instead of resting. Omitted, your wallet's configured default applies, else the platform default CANCEL_MAKER. STP cancellations carry terminalReason SELF_TRADE_PREVENTION and stpCounterpartyOrderId on reads and WebSocket events. With time_in_force FOK: CANCEL_MAKER cancels your makers first and then fills or kills; CANCEL_TAKER and SKIP cancel the whole order when self is in the fill path; CANCEL_BOTH rejects the placement with SELF_TRADE_NOT_ALLOWED. The requested value is echoed back as selfTradePreventionMode on order reads, absent when omitted here.
+             * @example CANCEL_TAKER
+             * @enum {string|null}
+             */
+            selfTradePreventionMode?: "CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP" | null;
         };
         CreateOrderResponse: {
             /**
@@ -4598,6 +4656,12 @@ export interface components {
              * @example 918342
              */
             version?: number | null;
+            /**
+             * @description The per-order self-trade-prevention override REQUESTED when this order was placed or replaced: CANCEL_MAKER, CANCEL_TAKER, CANCEL_BOTH, or SKIP. Absent when the order carried no override — including every order placed before the field was accepted on write — even though a wallet or platform default still governed its matching. This echoes the request, not the resolved default.
+             * @example CANCEL_TAKER
+             * @enum {string|null}
+             */
+            selfTradePreventionMode?: "CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP" | null;
         };
         /** @description Orderbook snapshot with token metadata and sequence number. */
         GetOrderbookResponse: {
@@ -6686,10 +6750,11 @@ export interface components {
         };
         ReplaceOrderRequest: {
             /**
-             * @description Client-assigned correlation handle, echoed back on order reads (detail and list) and on order WebSocket events. At most 64 characters from [A-Za-z0-9._:-]; surrounding whitespace is trimmed before storage, and a blank or whitespace-only value is treated as absent. Uniqueness is enforced only among your orders that are RESTING on the book: a create or replace reusing a value another of your resting orders still holds is rejected with HTTP 409 / gRPC ALREADY_EXISTS and the code CLIENT_ORDER_ID_CONFLICT. An order that never rests — MARKET, IOC/FOK, or a LIMIT that fills completely on arrival — does not take the handle, and the value is released the moment any order reaches a terminal state. It is therefore NOT an idempotency key, though on this replace path a retry cannot double-execute: the request names the original order id, and the sequencer revalidates that original in memory and on the book at sequence time, so once the first replacement succeeds the original is gone and a retry is rejected with ORDER_NOT_FOUND rather than placing a second order. That code is itself ambiguous — the original may instead have filled or been cancelled — so the risk here is acting on a stale view, not duplicate execution. Reconcile a lost response against the order WebSocket stream, which carries this value on the submit acknowledgement and on fills, including for orders that never rest; order history is replica-backed and can omit an order that did land. The stream is not replayable and has no sequence number to backfill from, and its fan-out is non-persistent Core NATS: the service can re-establish an ended upstream subscription without closing your socket, so events can be missed while your connection still looks healthy. A matching event is therefore positive proof the order was accepted, but silence is NEVER evidence it was not, and no client-observable condition makes it so. Absent positive evidence the outcome is unresolved: hold and escalate rather than resubmitting. A replacement carries no order type or time-in-force and its original must still be RESTING, so the post-acceptance rejection shapes are unreachable here: the reachable failures are all pre-acceptance — malformed, post-only would cross, handle conflict, or the original no longer resting (ORDER_NOT_FOUND) — and each fails the request, emits no event and is never written to order history (an order rejected AFTER acceptance is persisted with status REJECTED, so only the pre-acceptance class is absent). Where no surface is conclusive, do not resubmit. A replacement is a new order with a new id, so it carries its own value and inherits nothing from the original — restate it to keep the handle.
-             * @example quote-btc-1130-a
+             * @description Per-order self-trade-prevention override for the replacement: CANCEL_MAKER, CANCEL_TAKER, CANCEL_BOTH, or SKIP (see the create-order field for the full semantics). A replacement is a new order with a new id, so it carries its own value and inherits nothing from the original — restate it to keep the override. Omitted, your wallet's configured default applies, else the platform default CANCEL_MAKER. The requested value is echoed back as selfTradePreventionMode on order reads, absent when omitted here.
+             * @example CANCEL_TAKER
+             * @enum {string|null}
              */
-            clientOrderId?: string | null;
+            selfTradePreventionMode?: "CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP" | null;
             /**
              * @description New limit price (if changing)
              * @example 35500.00
@@ -6710,6 +6775,11 @@ export interface components {
              * @example false
              */
             postOnly?: boolean | null;
+            /**
+             * @description Client-assigned correlation handle, echoed back on order reads (detail and list) and on order WebSocket events. At most 64 characters from [A-Za-z0-9._:-]; surrounding whitespace is trimmed before storage, and a blank or whitespace-only value is treated as absent. Uniqueness is enforced only among your orders that are RESTING on the book: a create or replace reusing a value another of your resting orders still holds is rejected with HTTP 409 / gRPC ALREADY_EXISTS and the code CLIENT_ORDER_ID_CONFLICT. An order that never rests — MARKET, IOC/FOK, or a LIMIT that fills completely on arrival — does not take the handle, and the value is released the moment any order reaches a terminal state. It is therefore NOT an idempotency key, though on this replace path a retry cannot double-execute: the request names the original order id, and the sequencer revalidates that original in memory and on the book at sequence time, so once the first replacement succeeds the original is gone and a retry is rejected with ORDER_NOT_FOUND rather than placing a second order. That code is itself ambiguous — the original may instead have filled or been cancelled — so the risk here is acting on a stale view, not duplicate execution. Reconcile a lost response against the order WebSocket stream, which carries this value on the submit acknowledgement and on fills, including for orders that never rest; order history is replica-backed and can omit an order that did land. The stream is not replayable and has no sequence number to backfill from, and its fan-out is non-persistent Core NATS: the service can re-establish an ended upstream subscription without closing your socket, so events can be missed while your connection still looks healthy. A matching event is therefore positive proof the order was accepted, but silence is NEVER evidence it was not, and no client-observable condition makes it so. Absent positive evidence the outcome is unresolved: hold and escalate rather than resubmitting. A replacement carries no order type or time-in-force and its original must still be RESTING, so the post-acceptance rejection shapes are unreachable here: the reachable failures are all pre-acceptance — malformed, post-only would cross, handle conflict, or the original no longer resting (ORDER_NOT_FOUND) — and each fails the request, emits no event and is never written to order history (an order rejected AFTER acceptance is persisted with status REJECTED, so only the pre-acceptance class is absent). Where no surface is conclusive, do not resubmit. A replacement is a new order with a new id, so it carries its own value and inherits nothing from the original — restate it to keep the handle.
+             * @example quote-btc-1130-a
+             */
+            clientOrderId?: string | null;
         };
         ReplaceOrderResponse: {
             /**
@@ -6895,6 +6965,25 @@ export interface components {
              */
             priceChangePercent?: string | null;
         };
+        SelfTradePreventionDefaultResponse: {
+            /**
+             * @description The wallet's effective self-trade-prevention default: `CANCEL_MAKER`, `CANCEL_TAKER`, `CANCEL_BOTH`, or `SKIP`.
+             * @example CANCEL_MAKER
+             */
+            mode?: string | null;
+            /**
+             * @description True when this wallet has explicitly set a default; false when the platform default (`CANCEL_MAKER`) is in effect.
+             * @example false
+             */
+            isCustom?: boolean | null;
+        };
+        SetSelfTradePreventionDefaultRequest: {
+            /**
+             * @description The self-trade-prevention mode applied when an order from this wallet would match the wallet family's own resting order and the order names no override: `CANCEL_MAKER` (cancel the resting order — the platform default), `CANCEL_TAKER` (cancel the incoming order), `CANCEL_BOTH`, or `SKIP` (trade around own orders). Input is case-insensitive.
+             * @example SKIP
+             */
+            mode: string;
+        };
         SetTraderCodeRequest: {
             /**
              * @description The custom handle to claim or edit to: `[A-Za-z0-9_]`, must start with a letter, 5–20 characters. Case is preserved on store; uniqueness is case-insensitive.
@@ -8707,6 +8796,92 @@ export interface operations {
             };
         };
     };
+    get_self_trade_prevention_default: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SelfTradePreventionDefaultResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    set_self_trade_prevention_default: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SetSelfTradePreventionDefaultRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SelfTradePreventionDefaultResponse"];
+                };
+            };
+            /** @description Unknown mode */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Delegated-agent sessions cannot change account settings */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     list_sub_accounts_with_balances: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.57",
+	"version": "1.0.58",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.57",
+		"@0xmonaco/contracts": "1.0.58",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {