@0xmonaco/types 1.0.56 → 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, 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

@@ -3,6 +3,7 @@
  *
  * Types for trading operations and order management.
  */
+import type { ConditionalOrder, TwapOrder } from "./responses";
 /**
  * Standard order structure used across all order-related responses.
  * This represents the complete order information as returned by the API.
@@ -13,6 +14,13 @@
  * Orders can transition to `CANCELLED`, `REJECTED`, or `EXPIRED` at various stages.
  * Fee fields are only populated after order fills occur.
  *
+ * The order listing returns every kind of order in one stream, so a row here
+ * may be a book order, a TWAP parent (`orderType: "TWAP"`) or a conditional
+ * order (`orderType: "CONDITIONAL"`). Switch on `orderType`: the kind-specific
+ * detail hangs off `twap` / `conditional`, and the fields above are populated
+ * for every kind — a parent's `quantity` is its total, `filledQuantity` what
+ * it has executed so far, and `status` its state expressed as an order status.
+ *
  * @example
  * To calculate remaining quantity:
  * ```typescript
@@ -26,8 +34,8 @@ export interface Order {
     tradingPairId: string;
     /** Order side (BUY or SELL) */
     side: OrderSide;
-    /** Order type - see OrderType for all supported types */
-    orderType: OrderType;
+    /** What kind of order this row is - see ListedOrderType */
+    orderType: ListedOrderType;
     /** Order status - see OrderStatus for lifecycle details */
     status: OrderStatus;
     /** Order price - null for market orders, required for limit orders */
@@ -70,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
@@ -82,6 +98,18 @@ export interface Order {
     clientOrderId?: string;
     /** Position ID linked to the order, when available */
     positionId?: string;
+    /**
+     * The TWAP parent behind this row - its schedule, slice counters and
+     * progress - present only when `orderType` is `"TWAP"`. Identical to what
+     * `getTwapOrder` returns for the same id.
+     */
+    twap?: TwapOrder;
+    /**
+     * The conditional order behind this row - its trigger and the order it fires
+     * - present only when `orderType` is `"CONDITIONAL"`. Identical to what the
+     * conditional-order endpoints return for the same id.
+     */
+    conditional?: ConditionalOrder;
     /** Stable cause when status is CANCELLED */
     terminalReason?: OrderTerminalReason;
     /**
@@ -131,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
  */
@@ -154,6 +182,16 @@ export type PositionSide = "LONG" | "SHORT" | "NONE";
  * - TRAILING_STOP: Stop order that trails the market price
  */
 export type OrderType = "LIMIT" | "MARKET";
+/**
+ * What kind of order a listed row is.
+ *
+ * Wider than {@link OrderType}, which is what you can place: the order listing
+ * serves book orders, TWAP parents and conditional orders as one stream, and
+ * `"TWAP"` / `"CONDITIONAL"` name the two kinds that are created through their
+ * own endpoints rather than `createOrder`. A row of either kind carries its
+ * detail on {@link Order.twap} or {@link Order.conditional}.
+ */
+export type ListedOrderType = OrderType | "TWAP" | "CONDITIONAL";
 /**
  * Source-of-truth order status values used by runtime validation schemas.
  */
@@ -195,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>;
 /**
@@ -300,11 +327,11 @@ export declare const ConditionalOrderTriggerSourceSchema: z.ZodEnum<{
 export declare const ConditionalOrderStateSchema: z.ZodEnum<{
     CANCELLED: "CANCELLED";
     EXPIRED: "EXPIRED";
+    FAILED: "FAILED";
     PENDING_PARENT: "PENDING_PARENT";
     ACTIVE: "ACTIVE";
     TRIGGERING: "TRIGGERING";
     TRIGGERED: "TRIGGERED";
-    FAILED: "FAILED";
 }>;
 export declare const ClosePositionSideSchema: z.ZodEnum<{
     LONG: "LONG";
@@ -319,11 +346,11 @@ export declare const ListConditionalOrdersSchema: z.ZodObject<{
     state: z.ZodOptional<z.ZodEnum<{
         CANCELLED: "CANCELLED";
         EXPIRED: "EXPIRED";
+        FAILED: "FAILED";
         PENDING_PARENT: "PENDING_PARENT";
         ACTIVE: "ACTIVE";
         TRIGGERING: "TRIGGERING";
         TRIGGERED: "TRIGGERED";
-        FAILED: "FAILED";
     }>>;
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
@@ -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",