@0xmonaco/types 0.7.8 → 0.8.1

package/dist/trading/index.d.ts

@@ -5,7 +5,7 @@
  */
 import type { BaseAPI } from "../api/index";
 import type { OrderSide, PositionSide, TimeInForce, TradingMode } from "./orders";
-import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CreateConditionalOrderParams, CreateConditionalOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ReplaceOrderResponse } from "./responses";
+import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CreateConditionalOrderParams, CreateConditionalOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ParentTpSlLegParams, ReplaceOrderResponse } from "./responses";
 /**
  * Trading API interface.
  * Provides methods for placing and managing orders.
@@ -32,6 +32,8 @@ export interface TradingAPI extends BaseAPI {
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
+        takeProfit?: ParentTpSlLegParams;
+        stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
     /**
      * Places a market order for immediate execution.
@@ -50,6 +52,8 @@ export interface TradingAPI extends BaseAPI {
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
+        takeProfit?: ParentTpSlLegParams;
+        stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
     /**
      * Cancels an existing order.
@@ -129,4 +133,4 @@ export interface TradingAPI extends BaseAPI {
 }
 export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderType, PositionSide, TimeInForce, TradingMode, } from "./orders";
 export { ORDER_STATUS_VALUES } from "./orders";
-export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, ConditionalOrder, CreateConditionalOrderParams, CreateConditionalOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, MatchResult, ReplaceOrderResponse, UpdatedFields, } from "./responses";
+export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, ConditionalOrder, CreateConditionalOrderParams, CreateConditionalOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, MatchResult, ParentTpSlLegParams, ReplaceOrderResponse, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -134,4 +134,4 @@ export type ConditionalOrderTriggerSource = "MARK_PRICE";
 /**
  * Conditional TP/SL lifecycle state.
  */
-export type ConditionalOrderState = "ACTIVE" | "TRIGGERING" | "TRIGGERED" | "CANCELLED" | "EXPIRED" | "FAILED";
+export type ConditionalOrderState = "PENDING_PARENT" | "ACTIVE" | "TRIGGERING" | "TRIGGERED" | "CANCELLED" | "EXPIRED" | "FAILED";

package/dist/trading/responses.d.ts

@@ -36,6 +36,26 @@ export interface MatchResult {
         worst_price: string;
     } | null;
 }
+/**
+ * Parent TP/SL leg attached to a normal margin order.
+ *
+ * Parent TP/SL follows the parent order quantity and becomes active once the
+ * parent order creates or extends a position.
+ */
+export interface ParentTpSlLegParams {
+    /** Mark price that arms the close order */
+    triggerPrice: string;
+    /** Triggered close order type */
+    orderType: OrderType;
+    /** Required for LIMIT TP/SL, omitted for MARKET TP/SL */
+    limitPrice?: string;
+    /** LIMIT-only time in force */
+    timeInForce?: Extract<TimeInForce, "GTC" | "IOC">;
+    /** MARKET-only slippage tolerance in basis points */
+    slippageToleranceBps?: number;
+    /** Optional conditional order expiry timestamp (ISO 8601) */
+    expiresAt?: string;
+}
 /**
  * Response from creating an order.
  *
@@ -52,6 +72,10 @@ export interface CreateOrderResponse {
     message: string;
     /** Match result information if order was processed by matching engine */
     match_result?: MatchResult;
+    /** Conditional order ID for an attached take-profit leg */
+    take_profit_order_id?: string;
+    /** Conditional order ID for an attached stop-loss leg */
+    stop_loss_order_id?: string;
 }
 /**
  * Response from cancelling an order.
@@ -318,6 +342,8 @@ export interface ConditionalOrder {
     trading_pair_id: string;
     margin_account_id: string;
     position_id?: string;
+    parent_order_id?: string;
+    association_type?: "POSITION" | "PARENT_ORDER";
     linked_group_id?: string;
     condition_type: ConditionalOrderConditionType;
     trigger_source: ConditionalOrderTriggerSource;
@@ -333,6 +359,7 @@ export interface ConditionalOrder {
     state: ConditionalOrderState;
     triggered_order_id?: string;
     triggered_at?: string;
+    activated_at?: string;
     cancelled_at?: string;
     expires_at?: string;
     failure_reason?: string;

package/dist/validation/trading.d.ts

@@ -39,6 +39,13 @@ export declare const ConditionalTimeInForceSchema: z.ZodEnum<{
     GTC: "GTC";
     IOC: "IOC";
 }>;
+/**
+ * Order type validation
+ */
+export declare const OrderTypeSchema: z.ZodEnum<{
+    LIMIT: "LIMIT";
+    MARKET: "MARKET";
+}>;
 /**
  * Positive decimal string validation (for quantities and prices)
  */
@@ -55,6 +62,21 @@ export declare const ISO8601DateSchema: z.ZodISODateTime;
  * Slippage tolerance validation (0 to 1, where 0.01 = 1%)
  */
 export declare const SlippageToleranceSchema: z.ZodOptional<z.ZodNumber>;
+export declare const SlippageToleranceBpsSchema: z.ZodNumber;
+export declare const ParentTpSlLegSchema: z.ZodObject<{
+    triggerPrice: z.ZodString;
+    orderType: z.ZodEnum<{
+        LIMIT: "LIMIT";
+        MARKET: "MARKET";
+    }>;
+    limitPrice: z.ZodOptional<z.ZodString>;
+    timeInForce: z.ZodOptional<z.ZodEnum<{
+        GTC: "GTC";
+        IOC: "IOC";
+    }>>;
+    slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
 /**
  * Place Limit Order validation schema
  */
@@ -86,6 +108,34 @@ export declare const PlaceLimitOrderSchema: z.ZodObject<{
         }>>;
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
+        takeProfit: z.ZodOptional<z.ZodObject<{
+            triggerPrice: z.ZodString;
+            orderType: z.ZodEnum<{
+                LIMIT: "LIMIT";
+                MARKET: "MARKET";
+            }>;
+            limitPrice: z.ZodOptional<z.ZodString>;
+            timeInForce: z.ZodOptional<z.ZodEnum<{
+                GTC: "GTC";
+                IOC: "IOC";
+            }>>;
+            slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strip>>;
+        stopLoss: z.ZodOptional<z.ZodObject<{
+            triggerPrice: z.ZodString;
+            orderType: z.ZodEnum<{
+                LIMIT: "LIMIT";
+                MARKET: "MARKET";
+            }>;
+            limitPrice: z.ZodOptional<z.ZodString>;
+            timeInForce: z.ZodOptional<z.ZodEnum<{
+                GTC: "GTC";
+                IOC: "IOC";
+            }>>;
+            slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -112,6 +162,34 @@ export declare const PlaceMarketOrderSchema: z.ZodObject<{
         }>>;
         leverage: z.ZodOptional<z.ZodString>;
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
+        takeProfit: z.ZodOptional<z.ZodObject<{
+            triggerPrice: z.ZodString;
+            orderType: z.ZodEnum<{
+                LIMIT: "LIMIT";
+                MARKET: "MARKET";
+            }>;
+            limitPrice: z.ZodOptional<z.ZodString>;
+            timeInForce: z.ZodOptional<z.ZodEnum<{
+                GTC: "GTC";
+                IOC: "IOC";
+            }>>;
+            slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strip>>;
+        stopLoss: z.ZodOptional<z.ZodObject<{
+            triggerPrice: z.ZodString;
+            orderType: z.ZodEnum<{
+                LIMIT: "LIMIT";
+                MARKET: "MARKET";
+            }>;
+            limitPrice: z.ZodOptional<z.ZodString>;
+            timeInForce: z.ZodOptional<z.ZodEnum<{
+                GTC: "GTC";
+                IOC: "IOC";
+            }>>;
+            slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -166,13 +244,6 @@ export declare const GetPaginatedOrdersSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;
     page_size: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-/**
- * Order type validation
- */
-export declare const OrderTypeSchema: z.ZodEnum<{
-    LIMIT: "LIMIT";
-    MARKET: "MARKET";
-}>;
 export declare const ConditionalOrderConditionTypeSchema: z.ZodEnum<{
     STOP_LOSS: "STOP_LOSS";
     TAKE_PROFIT: "TAKE_PROFIT";
@@ -183,6 +254,7 @@ export declare const ConditionalOrderTriggerSourceSchema: z.ZodEnum<{
 export declare const ConditionalOrderStateSchema: z.ZodEnum<{
     CANCELLED: "CANCELLED";
     EXPIRED: "EXPIRED";
+    PENDING_PARENT: "PENDING_PARENT";
     ACTIVE: "ACTIVE";
     TRIGGERING: "TRIGGERING";
     TRIGGERED: "TRIGGERED";
@@ -192,7 +264,6 @@ export declare const ClosePositionSideSchema: z.ZodEnum<{
     LONG: "LONG";
     SHORT: "SHORT";
 }>;
-export declare const SlippageToleranceBpsSchema: z.ZodNumber;
 export declare const CreateConditionalOrderSchema: z.ZodObject<{
     tradingPairId: z.ZodUUID;
     marginAccountId: z.ZodUUID;
@@ -235,6 +306,7 @@ export declare const ListConditionalOrdersSchema: z.ZodObject<{
     state: z.ZodOptional<z.ZodEnum<{
         CANCELLED: "CANCELLED";
         EXPIRED: "EXPIRED";
+        PENDING_PARENT: "PENDING_PARENT";
         ACTIVE: "ACTIVE";
         TRIGGERING: "TRIGGERING";
         TRIGGERED: "TRIGGERED";

package/dist/validation/trading.js

@@ -33,6 +33,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"',
 });
+/**
+ * Order type validation
+ */
+export const OrderTypeSchema = z.enum(["LIMIT", "MARKET"], {
+    message: 'Order type must be "LIMIT" or "MARKET"',
+});
 /**
  * Positive decimal string validation (for quantities and prices)
  */
@@ -64,6 +70,37 @@ export const SlippageToleranceSchema = z
     .min(0, "Slippage tolerance must be at least 0 (no slippage)")
     .max(1, "Slippage tolerance cannot exceed 1 (100%)")
     .optional();
+export const SlippageToleranceBpsSchema = z
+    .number()
+    .int()
+    .min(0, "Slippage tolerance must be at least 0 bps")
+    .max(10000, "Slippage tolerance cannot exceed 10000 bps");
+export const ParentTpSlLegSchema = z
+    .object({
+    triggerPrice: PositiveDecimalStringSchema,
+    orderType: OrderTypeSchema,
+    limitPrice: PositiveDecimalStringSchema.optional(),
+    timeInForce: ConditionalTimeInForceSchema.optional(),
+    slippageToleranceBps: SlippageToleranceBpsSchema.optional(),
+    expiresAt: ISO8601DateSchema.optional(),
+})
+    .refine((data) => data.orderType !== "LIMIT" || data.limitPrice !== undefined, {
+    message: "limitPrice is required for LIMIT parent TP/SL",
+    path: ["limitPrice"],
+})
+    .refine((data) => data.orderType !== "MARKET" || data.limitPrice === undefined, {
+    message: "limitPrice must not be provided for MARKET parent TP/SL",
+    path: ["limitPrice"],
+})
+    .refine((data) => data.orderType !== "MARKET" || data.timeInForce === undefined, {
+    message: "timeInForce is only allowed for LIMIT parent TP/SL",
+    path: ["timeInForce"],
+})
+    .refine((data) => data.orderType !== "LIMIT" || data.slippageToleranceBps === undefined, {
+    message: "slippageToleranceBps is only allowed for MARKET parent TP/SL",
+    path: ["slippageToleranceBps"],
+});
+const hasParentTpSl = (options) => options?.takeProfit !== undefined || options?.stopLoss !== undefined;
 /**
  * Place Limit Order validation schema
  */
@@ -83,6 +120,8 @@ export const PlaceLimitOrderSchema = z
         positionSide: PositionSideSchema.optional(),
         leverage: PositiveDecimalStringSchema.optional(),
         reduceOnly: z.boolean().optional(),
+        takeProfit: ParentTpSlLegSchema.optional(),
+        stopLoss: ParentTpSlLegSchema.optional(),
     })
         .optional(),
 })
@@ -97,6 +136,18 @@ export const PlaceLimitOrderSchema = z
     .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.leverage !== undefined, {
     message: "leverage is required for MARGIN orders",
     path: ["options", "leverage"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
+    message: "Parent TP/SL is only supported for MARGIN orders",
+    path: ["options", "tradingMode"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.positionSide !== "NONE", {
+    message: "Parent TP/SL requires positionSide to be LONG or SHORT",
+    path: ["options", "positionSide"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
+    message: "Parent TP/SL cannot be attached to reduceOnly orders",
+    path: ["options", "reduceOnly"],
 });
 /**
  * Place Market Order validation schema
@@ -114,6 +165,8 @@ export const PlaceMarketOrderSchema = z
         positionSide: PositionSideSchema.optional(),
         leverage: PositiveDecimalStringSchema.optional(),
         reduceOnly: z.boolean().optional(),
+        takeProfit: ParentTpSlLegSchema.optional(),
+        stopLoss: ParentTpSlLegSchema.optional(),
     })
         .optional(),
 })
@@ -128,6 +181,18 @@ export const PlaceMarketOrderSchema = z
     .refine((data) => data.options?.tradingMode !== "MARGIN" || data.options.leverage !== undefined, {
     message: "leverage is required for MARGIN orders",
     path: ["options", "leverage"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
+    message: "Parent TP/SL is only supported for MARGIN orders",
+    path: ["options", "tradingMode"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.positionSide !== "NONE", {
+    message: "Parent TP/SL requires positionSide to be LONG or SHORT",
+    path: ["options", "positionSide"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
+    message: "Parent TP/SL cannot be attached to reduceOnly orders",
+    path: ["options", "reduceOnly"],
 });
 /**
  * Cancel Order validation schema
@@ -169,29 +234,18 @@ export const GetPaginatedOrdersSchema = z.object({
     page: z.number().int().min(1, "Page must be at least 1").optional(),
     page_size: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
 });
-/**
- * Order type validation
- */
-export const OrderTypeSchema = z.enum(["LIMIT", "MARKET"], {
-    message: 'Order type must be "LIMIT" or "MARKET"',
-});
 export const ConditionalOrderConditionTypeSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"], {
     message: 'conditionType must be "STOP_LOSS" or "TAKE_PROFIT"',
 });
 export const ConditionalOrderTriggerSourceSchema = z.enum(["MARK_PRICE"], {
     message: 'triggerSource must be "MARK_PRICE"',
 });
-export const ConditionalOrderStateSchema = z.enum(["ACTIVE", "TRIGGERING", "TRIGGERED", "CANCELLED", "EXPIRED", "FAILED"], {
+export const ConditionalOrderStateSchema = z.enum(["PENDING_PARENT", "ACTIVE", "TRIGGERING", "TRIGGERED", "CANCELLED", "EXPIRED", "FAILED"], {
     message: "Invalid conditional order state",
 });
 export const ClosePositionSideSchema = z.enum(["LONG", "SHORT"], {
     message: 'Position side must be "LONG" or "SHORT"',
 });
-export const SlippageToleranceBpsSchema = z
-    .number()
-    .int()
-    .min(0, "Slippage tolerance must be at least 0 bps")
-    .max(10000, "Slippage tolerance cannot exceed 10000 bps");
 export const CreateConditionalOrderSchema = z
     .object({
     tradingPairId: UUIDSchema,

package/dist/websocket/events/conditional-order-events.d.ts

@@ -1,10 +1,12 @@
 import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, OrderSide, OrderType, PositionSide, TimeInForce } from "../../trading";
-export type ConditionalOrderEventReason = "created" | "cancelled" | "triggered" | "failed" | "oco_cancelled";
+export type ConditionalOrderEventReason = "created" | "activated" | "cancelled" | "parent_cancelled" | "triggered" | "failed" | "oco_cancelled";
 export interface ConditionalOrderEventData {
     conditionalOrderId: string;
     tradingPairId: string;
     marginAccountId: string;
     positionId?: string;
+    parentOrderId?: string;
+    associationType?: "POSITION" | "PARENT_ORDER";
     linkedGroupId?: string;
     conditionType: ConditionalOrderConditionType;
     triggerSource: ConditionalOrderTriggerSource;
@@ -20,6 +22,7 @@ export interface ConditionalOrderEventData {
     state: ConditionalOrderState;
     triggeredOrderId?: string;
     triggeredAt?: string;
+    activatedAt?: string;
     cancelledAt?: string;
     expiresAt?: string;
     failureReason?: string;

package/package.json

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