@0xmonaco/types 0.7.7 → 0.7.9

package/dist/validation/profile.js

@@ -0,0 +1,44 @@
+/**
+ * Profile API Validation Schemas
+ *
+ * Zod schemas for validating profile API inputs before making requests.
+ * Provides clear, actionable error messages for invalid parameters.
+ */
+import { z } from "zod";
+import { UUIDSchema } from "./trading.js";
+/**
+ * Ledger entry type validation
+ */
+export const LedgerEntryTypeSchema = z.enum(["CREDIT", "DEBIT", "LOCK", "UNLOCK", "FEE"], {
+    message: 'Entry type must be "CREDIT", "DEBIT", "LOCK", "UNLOCK", or "FEE"',
+});
+/**
+ * Transaction type validation
+ */
+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"',
+});
+/**
+ * Get User Movements validation schema
+ *
+ * Validates parameters for fetching paginated user movements.
+ * All fields are optional — an empty object or undefined is valid.
+ */
+export const GetUserMovementsSchema = z.object({
+    page: z.number().int("Page must be an integer").min(1, "Page must be at least 1").optional(),
+    page_size: z.number().int("Page size must be an integer").min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    entry_type: LedgerEntryTypeSchema.optional(),
+    transaction_type: TransactionTypeSchema.optional(),
+    asset_id: UUIDSchema.optional(),
+});
+/**
+ * Get User Trades validation schema
+ *
+ * Validates parameters for fetching paginated user trades.
+ * All fields are optional — an empty object or undefined is valid.
+ */
+export const GetUserTradesSchema = z.object({
+    page: z.number().int("Page must be an integer").min(1, "Page must be at least 1").optional(),
+    page_size: z.number().int("Page size must be an integer").min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    trading_pair_id: UUIDSchema.optional(),
+});

package/dist/validation/trading.d.ts

@@ -0,0 +1,422 @@
+/**
+ * Trading API Validation Schemas
+ *
+ * Zod schemas for validating trading API inputs before making requests.
+ * Provides clear, actionable error messages for invalid parameters.
+ */
+import { z } from "zod";
+/**
+ * Order side validation
+ */
+export declare const OrderSideSchema: z.ZodEnum<{
+    BUY: "BUY";
+    SELL: "SELL";
+}>;
+/**
+ * Trading mode validation
+ */
+export declare const TradingModeSchema: z.ZodEnum<{
+    SPOT: "SPOT";
+    MARGIN: "MARGIN";
+}>;
+/**
+ * Position side validation
+ */
+export declare const PositionSideSchema: z.ZodEnum<{
+    LONG: "LONG";
+    SHORT: "SHORT";
+    NONE: "NONE";
+}>;
+/**
+ * Time in force validation
+ */
+export declare const TimeInForceSchema: z.ZodEnum<{
+    GTC: "GTC";
+    IOC: "IOC";
+    FOK: "FOK";
+}>;
+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)
+ */
+export declare const PositiveDecimalStringSchema: z.ZodString;
+/**
+ * UUID validation
+ */
+export declare const UUIDSchema: z.ZodUUID;
+/**
+ * ISO 8601 date string validation
+ */
+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
+ */
+export declare const PlaceLimitOrderSchema: z.ZodObject<{
+    tradingPairId: z.ZodUUID;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    quantity: z.ZodString;
+    price: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        tradingMode: z.ZodOptional<z.ZodEnum<{
+            SPOT: "SPOT";
+            MARGIN: "MARGIN";
+        }>>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+        expirationDate: z.ZodOptional<z.ZodISODateTime>;
+        timeInForce: z.ZodOptional<z.ZodEnum<{
+            GTC: "GTC";
+            IOC: "IOC";
+            FOK: "FOK";
+        }>>;
+        marginAccountId: z.ZodOptional<z.ZodUUID>;
+        positionSide: z.ZodOptional<z.ZodEnum<{
+            LONG: "LONG";
+            SHORT: "SHORT";
+            NONE: "NONE";
+        }>>;
+        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>;
+/**
+ * Place Market Order validation schema
+ */
+export declare const PlaceMarketOrderSchema: z.ZodObject<{
+    tradingPairId: z.ZodUUID;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    quantity: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        tradingMode: z.ZodOptional<z.ZodEnum<{
+            SPOT: "SPOT";
+            MARGIN: "MARGIN";
+        }>>;
+        slippageTolerance: z.ZodOptional<z.ZodNumber>;
+        marginAccountId: z.ZodOptional<z.ZodUUID>;
+        positionSide: z.ZodOptional<z.ZodEnum<{
+            LONG: "LONG";
+            SHORT: "SHORT";
+            NONE: "NONE";
+        }>>;
+        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>;
+/**
+ * Cancel Order validation schema
+ */
+export declare const CancelOrderSchema: z.ZodObject<{
+    orderId: z.ZodUUID;
+}, z.core.$strip>;
+/**
+ * Replace Order validation schema
+ *
+ * Validates parameters for replacing an existing order.
+ * Matches the replaceOrder method signature which accepts:
+ * - orderId: string (UUID)
+ * - newOrder: { price?: string, quantity?: string, useMasterBalance?: boolean }
+ */
+export declare const ReplaceOrderSchema: z.ZodObject<{
+    orderId: z.ZodUUID;
+    newOrder: z.ZodObject<{
+        price: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodOptional<z.ZodString>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Get Paginated Orders validation schema
+ *
+ * Validates parameters for fetching paginated orders.
+ * Matches the getPaginatedOrders method signature which accepts:
+ * - status: OrderStatus (optional filter)
+ * - trading_pair_id: trading pair UUID (optional filter)
+ * - page: number (default: 1)
+ * - page_size: number (default: 10, max: 100)
+ */
+export declare const GetPaginatedOrdersSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        SUBMITTED: "SUBMITTED";
+        PARTIALLY_FILLED: "PARTIALLY_FILLED";
+        FILLED: "FILLED";
+        SETTLED_ON_CHAIN: "SETTLED_ON_CHAIN";
+        SETTLED: "SETTLED";
+        CANCELLED: "CANCELLED";
+        REJECTED: "REJECTED";
+        EXPIRED: "EXPIRED";
+    }>>;
+    trading_pair_id: z.ZodOptional<z.ZodUUID>;
+    trading_mode: z.ZodOptional<z.ZodEnum<{
+        SPOT: "SPOT";
+        MARGIN: "MARGIN";
+    }>>;
+    margin_account_id: z.ZodOptional<z.ZodUUID>;
+    page: z.ZodOptional<z.ZodNumber>;
+    page_size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ConditionalOrderConditionTypeSchema: z.ZodEnum<{
+    STOP_LOSS: "STOP_LOSS";
+    TAKE_PROFIT: "TAKE_PROFIT";
+}>;
+export declare const ConditionalOrderTriggerSourceSchema: z.ZodEnum<{
+    MARK_PRICE: "MARK_PRICE";
+}>;
+export declare const ConditionalOrderStateSchema: z.ZodEnum<{
+    CANCELLED: "CANCELLED";
+    EXPIRED: "EXPIRED";
+    PENDING_PARENT: "PENDING_PARENT";
+    ACTIVE: "ACTIVE";
+    TRIGGERING: "TRIGGERING";
+    TRIGGERED: "TRIGGERED";
+    FAILED: "FAILED";
+}>;
+export declare const ClosePositionSideSchema: z.ZodEnum<{
+    LONG: "LONG";
+    SHORT: "SHORT";
+}>;
+export declare const CreateConditionalOrderSchema: z.ZodObject<{
+    tradingPairId: z.ZodUUID;
+    marginAccountId: z.ZodUUID;
+    conditionType: z.ZodEnum<{
+        STOP_LOSS: "STOP_LOSS";
+        TAKE_PROFIT: "TAKE_PROFIT";
+    }>;
+    triggerPrice: z.ZodString;
+    triggerSource: z.ZodOptional<z.ZodEnum<{
+        MARK_PRICE: "MARK_PRICE";
+    }>>;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    positionSide: z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+    }>;
+    orderType: z.ZodEnum<{
+        LIMIT: "LIMIT";
+        MARKET: "MARKET";
+    }>;
+    limitPrice: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodOptional<z.ZodString>;
+    reduceOnly: z.ZodOptional<z.ZodBoolean>;
+    timeInForce: z.ZodOptional<z.ZodEnum<{
+        GTC: "GTC";
+        IOC: "IOC";
+    }>>;
+    slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export declare const CancelConditionalOrderSchema: z.ZodObject<{
+    conditionalOrderId: z.ZodUUID;
+}, z.core.$strip>;
+export declare const ListConditionalOrdersSchema: z.ZodObject<{
+    margin_account_id: z.ZodOptional<z.ZodUUID>;
+    trading_pair_id: z.ZodOptional<z.ZodUUID>;
+    state: z.ZodOptional<z.ZodEnum<{
+        CANCELLED: "CANCELLED";
+        EXPIRED: "EXPIRED";
+        PENDING_PARENT: "PENDING_PARENT";
+        ACTIVE: "ACTIVE";
+        TRIGGERING: "TRIGGERING";
+        TRIGGERED: "TRIGGERED";
+        FAILED: "FAILED";
+    }>>;
+    page: z.ZodOptional<z.ZodNumber>;
+    page_size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Single batch create order item validation schema
+ *
+ * Validates each order in a batch create request.
+ * - LIMIT orders require a price
+ * - MARKET orders must not have a price
+ */
+export declare const BatchCreateOrderItemSchema: z.ZodObject<{
+    tradingPairId: z.ZodUUID;
+    orderType: z.ZodEnum<{
+        LIMIT: "LIMIT";
+        MARKET: "MARKET";
+    }>;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    price: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodString;
+    tradingMode: z.ZodOptional<z.ZodEnum<{
+        SPOT: "SPOT";
+        MARGIN: "MARGIN";
+    }>>;
+    slippageTolerance: z.ZodOptional<z.ZodNumber>;
+    useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+    expirationDate: z.ZodOptional<z.ZodISODateTime>;
+    timeInForce: z.ZodOptional<z.ZodEnum<{
+        GTC: "GTC";
+        IOC: "IOC";
+        FOK: "FOK";
+    }>>;
+    marginAccountId: z.ZodOptional<z.ZodUUID>;
+    positionSide: z.ZodOptional<z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+        NONE: "NONE";
+    }>>;
+    leverage: z.ZodOptional<z.ZodString>;
+    reduceOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Batch Create Orders validation schema
+ *
+ * Validates the full array of orders for a batch create request.
+ */
+export declare const BatchCreateOrdersSchema: z.ZodObject<{
+    orders: z.ZodArray<z.ZodObject<{
+        tradingPairId: z.ZodUUID;
+        orderType: z.ZodEnum<{
+            LIMIT: "LIMIT";
+            MARKET: "MARKET";
+        }>;
+        side: z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>;
+        price: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodString;
+        tradingMode: z.ZodOptional<z.ZodEnum<{
+            SPOT: "SPOT";
+            MARGIN: "MARGIN";
+        }>>;
+        slippageTolerance: z.ZodOptional<z.ZodNumber>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+        expirationDate: z.ZodOptional<z.ZodISODateTime>;
+        timeInForce: z.ZodOptional<z.ZodEnum<{
+            GTC: "GTC";
+            IOC: "IOC";
+            FOK: "FOK";
+        }>>;
+        marginAccountId: z.ZodOptional<z.ZodUUID>;
+        positionSide: z.ZodOptional<z.ZodEnum<{
+            LONG: "LONG";
+            SHORT: "SHORT";
+            NONE: "NONE";
+        }>>;
+        leverage: z.ZodOptional<z.ZodString>;
+        reduceOnly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Single batch replace order item validation schema
+ *
+ * Validates each order in a batch replace request.
+ * At least one of price or quantity must be provided.
+ */
+export declare const BatchReplaceOrderItemSchema: z.ZodObject<{
+    orderId: z.ZodUUID;
+    price: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodOptional<z.ZodString>;
+    useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Batch Replace Orders validation schema
+ *
+ * Validates the full array of orders for a batch replace request.
+ */
+export declare const BatchReplaceOrdersSchema: z.ZodObject<{
+    orders: z.ZodArray<z.ZodObject<{
+        orderId: z.ZodUUID;
+        price: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodOptional<z.ZodString>;
+        useMasterBalance: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;