@0xmonaco/core 0.6.3 → 0.7.0

package/dist/api/profile/api.js

@@ -64,12 +64,12 @@ export class ProfileAPIImpl extends BaseAPI {
      *
      * @example
      * ```typescript
-     * // Get first page with default limit (20)
+     * // Get first page with default page_size (20)
      * const movements = await profileAPI.getPaginatedUserMovements();
-     * console.log(`Total movements: ${movements.total_count}`);
+     * console.log(`Total movements: ${movements.total}`);
      *
-     * // Get second page with custom limit
-     * const page2 = await profileAPI.getPaginatedUserMovements({ page: 2, limit: 50 });
+     * // Get second page with custom page_size
+     * const page2 = await profileAPI.getPaginatedUserMovements({ page: 2, page_size: 50 });
      * console.log(`Page ${page2.page} of ${page2.total_pages}`);
      *
      * // Filter by entry type and transaction type
@@ -87,8 +87,8 @@ export class ProfileAPIImpl extends BaseAPI {
         if (params?.page !== undefined) {
             searchParams.append("page", params.page.toString());
         }
-        if (params?.limit !== undefined) {
-            searchParams.append("limit", params.limit.toString());
+        if (params?.page_size !== undefined) {
+            searchParams.append("page_size", params.page_size.toString());
         }
         if (params?.entry_type !== undefined) {
             searchParams.append("entry_type", params.entry_type);
@@ -110,8 +110,8 @@ export class ProfileAPIImpl extends BaseAPI {
      * Requires a valid access token to be set.
      *
      * @param params - Optional query parameters for pagination
-     * @param params.limit - Number of items to return (default: 20)
-     * @param params.offset - Number of items to skip (default: 0)
+     * @param params.page - Page number (starts from 1, default: 1)
+     * @param params.page_size - Number of items per page (default: 20, max: 100)
      * @returns Promise resolving to paginated balances response
      * @throws {APIError} When the request fails or user is not authenticated
      *
@@ -124,18 +124,18 @@ export class ProfileAPIImpl extends BaseAPI {
      *   console.log(`${balance.symbol}: ${balance.available_balance}`);
      * });
      *
-     * // Get next 50 balances with offset
-     * const nextBalances = await profileAPI.getUserBalances({ limit: 50, offset: 20 });
+     * // Get page 2 with 50 items per page
+     * const nextBalances = await profileAPI.getUserBalances({ page: 2, page_size: 50 });
      * console.log(`Returned ${nextBalances.balances.length} balances`);
      * ```
      */
     async getUserBalances(params) {
         const searchParams = new URLSearchParams();
-        if (params?.limit !== undefined) {
-            searchParams.append("limit", params.limit.toString());
+        if (params?.page !== undefined) {
+            searchParams.append("page", params.page.toString());
         }
-        if (params?.offset !== undefined) {
-            searchParams.append("offset", params.offset.toString());
+        if (params?.page_size !== undefined) {
+            searchParams.append("page_size", params.page_size.toString());
         }
         const queryString = searchParams.toString();
         const url = queryString ? `/api/v1/accounts/balances?${queryString}` : "/api/v1/accounts/balances";
@@ -222,7 +222,7 @@ export class ProfileAPIImpl extends BaseAPI {
      *
      * @param params - Optional query parameters for pagination and filtering
      * @param params.page - Page number (starts from 1, default: 1)
-     * @param params.limit - Number of items per page (default: 20, max: 100)
+     * @param params.page_size - Number of items per page (default: 20, max: 100)
      * @param params.trading_pair_id - Filter by trading pair ID (UUID)
      * @returns Promise resolving to paginated trades response
      * @throws {ValidationError} When the provided params fail client-side validation
@@ -232,7 +232,7 @@ export class ProfileAPIImpl extends BaseAPI {
      * ```typescript
      * // Get first page of trades
      * const trades = await profileAPI.getUserTrades();
-     * console.log(`Total trades: ${trades.total_count}`);
+     * console.log(`Total trades: ${trades.total}`);
      *
      * // Filter by trading pair
      * const pairTrades = await profileAPI.getUserTrades({ trading_pair_id: "550e8400-e29b-41d4-a716-446655440000" });
@@ -246,8 +246,8 @@ export class ProfileAPIImpl extends BaseAPI {
         if (params?.page !== undefined) {
             searchParams.append("page", params.page.toString());
         }
-        if (params?.limit !== undefined) {
-            searchParams.append("limit", params.limit.toString());
+        if (params?.page_size !== undefined) {
+            searchParams.append("page_size", params.page_size.toString());
         }
         if (params?.trading_pair_id !== undefined) {
             searchParams.append("trading_pair_id", params.trading_pair_id);

package/dist/api/trades/api.d.ts

@@ -5,7 +5,7 @@ import { BaseAPI } from "../base";
  */
 interface RawTradeEvent {
     event_type: string;
-    pair_id: string;
+    trading_pair_id: string;
     trading_mode: string;
     data: {
         trade_id: string;
@@ -23,10 +23,10 @@ export declare function parseRawTradeEvent(raw: RawTradeEvent): TradeEvent;
  * Options for fetching trades
  */
 export interface GetTradesOptions {
-    /** Number of records to skip (default: 0) */
-    skip?: number;
+    /** Page number (starts from 1, default: 1) */
+    page?: number;
     /** Maximum number of records to return (default: 25, max: 100) */
-    limit?: number;
+    page_size?: number;
 }
 /**
  * Trades API for fetching historical trade data

package/dist/api/trades/api.js

@@ -5,7 +5,7 @@ import { BaseAPI } from "../base";
 export function parseRawTradeEvent(raw) {
     return {
         eventType: "trade",
-        tradingPairId: raw.pair_id,
+        tradingPairId: raw.trading_pair_id,
         tradingMode: raw.trading_mode.toUpperCase(),
         data: {
             tradeId: raw.data.trade_id,
@@ -28,15 +28,15 @@ export class TradesAPIImpl extends BaseAPI {
      * @returns Array of TradeEvent records sorted by executed_at descending (newest first)
      */
     async getTrades(tradingPairId, options = {}) {
-        const { skip = 0 } = options;
-        // Ensure limit is a positive number between 1 and 100, defaulting to 25
-        const limit = options.limit != null && options.limit > 0 ? Math.min(options.limit, 100) : 25;
+        const { page = 1 } = options;
+        // Ensure page_size is a positive number between 1 and 100, defaulting to 25
+        const page_size = options.page_size != null && options.page_size > 0 ? Math.min(options.page_size, 100) : 25;
         const params = new URLSearchParams();
-        if (skip > 0) {
-            params.set("skip", String(skip));
+        if (page > 1) {
+            params.set("page", String(page));
         }
-        params.set("limit", String(limit));
+        params.set("page_size", String(page_size));
         const response = await this.makePublicRequest(`/api/v1/trades/${encodeURIComponent(tradingPairId)}?${params.toString()}`);
-        return response.data.trades.map(parseRawTradeEvent);
+        return response.trades.map(parseRawTradeEvent);
     }
 }

package/dist/api/trading/api.d.ts

@@ -21,7 +21,7 @@
  * );
  * ```
  */
-import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, OrderSide, ReplaceOrderResponse, TimeInForce, TradingAPI, TradingMode } from "@0xmonaco/types";
+import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CreateConditionalOrderParams, CreateConditionalOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, OrderSide, PositionSide, ReplaceOrderResponse, TimeInForce, TradingAPI, TradingMode } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
     /**
@@ -79,6 +79,10 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
         useMasterBalance?: boolean;
         expirationDate?: string;
         timeInForce?: TimeInForce;
+        marginAccountId?: string;
+        positionSide?: PositionSide;
+        leverage?: string;
+        reduceOnly?: boolean;
     }): Promise<CreateOrderResponse>;
     /**
      * Places a market order for immediate execution.
@@ -124,6 +128,10 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
     placeMarketOrder(tradingPairId: string, side: OrderSide, quantity: string, options?: {
         tradingMode?: TradingMode;
         slippageTolerance?: number;
+        marginAccountId?: string;
+        positionSide?: PositionSide;
+        leverage?: string;
+        reduceOnly?: boolean;
     }): Promise<CreateOrderResponse>;
     /**
      * Cancels an existing order.
@@ -142,6 +150,9 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * ```
      */
     cancelOrder(orderId: string): Promise<CancelOrderResponse>;
+    createConditionalOrder(params: CreateConditionalOrderParams): Promise<CreateConditionalOrderResponse>;
+    cancelConditionalOrder(conditionalOrderId: string): Promise<CancelConditionalOrderResponse>;
+    listConditionalOrders(params?: ListConditionalOrdersParams): Promise<ListConditionalOrdersResponse>;
     /**
      * Batch cancels specific orders by their IDs.
      *
@@ -242,7 +253,7 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      *
      * @param params - Query parameters for filtering orders
      * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED") (optional)
-     * @param params.trading_pair - Filter by trading pair (e.g., "USDCo/MTK") (optional)
+     * @param params.trading_pair_id - Filter by trading pair UUID (optional)
      * @param params.page - Page number for pagination (defaults to 1, must be > 0)
      * @param params.page_size - Number of orders per page (defaults to 10, max 100, must be > 0)
      * @returns Promise resolving to GetPaginatedOrdersResponse with orders and pagination info
@@ -253,7 +264,7 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * // Get submitted orders for a specific trading pair with custom pagination
      * const orders = await tradingAPI.getPaginatedOrders({
      *   status: "SUBMITTED",
-     *   trading_pair: "USDCo/MTK",
+     *   trading_pair_id: "456e7890-e12b-12d3-a456-426614174000",
      *   page: 1,
      *   page_size: 20
      * });

package/dist/api/trading/api.js

@@ -21,8 +21,9 @@
  * );
  * ```
  */
-import { BatchCreateOrdersSchema, BatchReplaceOrdersSchema, CancelOrderSchema, GetPaginatedOrdersSchema, PlaceLimitOrderSchema, PlaceMarketOrderSchema, ReplaceOrderSchema, validate, } from "@0xmonaco/types";
+import { BatchCreateOrdersSchema, BatchReplaceOrdersSchema, CancelConditionalOrderSchema, CancelOrderSchema, CreateConditionalOrderSchema, GetPaginatedOrdersSchema, ListConditionalOrdersSchema, PlaceLimitOrderSchema, PlaceMarketOrderSchema, ReplaceOrderSchema, validate, } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
+import { perpRoutes } from "../perp";
 export class TradingAPIImpl extends BaseAPI {
     /**
      * Places a limit order on the order book.
@@ -93,8 +94,12 @@ export class TradingAPIImpl extends BaseAPI {
             use_master_balance: options?.useMasterBalance,
             expiration_date: options?.expirationDate,
             time_in_force: options?.timeInForce,
+            margin_account_id: options?.marginAccountId,
+            position_side: options?.positionSide,
+            leverage: options?.leverage,
+            reduce_only: options?.reduceOnly,
         };
-        return await this.makeAuthenticatedRequest("/api/v1/orders", {
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.create(), {
             method: "POST",
             body: JSON.stringify(requestBody),
         });
@@ -156,8 +161,12 @@ export class TradingAPIImpl extends BaseAPI {
             price: null, // Market orders don't need price
             quantity,
             trading_mode: options?.tradingMode || "SPOT",
+            margin_account_id: options?.marginAccountId,
+            position_side: options?.positionSide,
+            leverage: options?.leverage,
+            reduce_only: options?.reduceOnly,
         };
-        return await this.makeAuthenticatedRequest("/api/v1/orders", {
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.create(), {
             method: "POST",
             body: JSON.stringify(requestBody),
         });
@@ -184,11 +193,53 @@ export class TradingAPIImpl extends BaseAPI {
         const requestBody = {
             order_id: orderId,
         };
-        return await this.makeAuthenticatedRequest("/api/v1/orders/cancel", {
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.cancel(), {
             method: "POST",
             body: JSON.stringify(requestBody),
         });
     }
+    async createConditionalOrder(params) {
+        validate(CreateConditionalOrderSchema, params);
+        const requestBody = {
+            trading_pair_id: params.tradingPairId,
+            margin_account_id: params.marginAccountId,
+            condition_type: params.conditionType,
+            trigger_price: params.triggerPrice,
+            trigger_source: params.triggerSource ?? "MARK_PRICE",
+            side: params.side,
+            position_side: params.positionSide,
+            order_type: params.orderType,
+            limit_price: params.limitPrice,
+            quantity: params.quantity,
+            reduce_only: params.reduceOnly ?? true,
+            time_in_force: params.timeInForce,
+            slippage_tolerance_bps: params.slippageToleranceBps,
+            expires_at: params.expiresAt,
+        };
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.createConditional(), {
+            method: "POST",
+            body: JSON.stringify(requestBody),
+        });
+    }
+    async cancelConditionalOrder(conditionalOrderId) {
+        validate(CancelConditionalOrderSchema, { conditionalOrderId });
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.cancelConditional(conditionalOrderId), {
+            method: "DELETE",
+        });
+    }
+    async listConditionalOrders(params) {
+        if (params) {
+            validate(ListConditionalOrdersSchema, params);
+        }
+        const { page = 1, page_size = 20, margin_account_id, trading_pair_id, state } = params || {};
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.listConditional({
+            page,
+            page_size: Math.min(Math.max(page_size, 1), 100),
+            margin_account_id,
+            trading_pair_id,
+            state,
+        }), { method: "GET" });
+    }
     /**
      * Batch cancels specific orders by their IDs.
      *
@@ -205,7 +256,7 @@ export class TradingAPIImpl extends BaseAPI {
         if (!orderIds || orderIds.length === 0) {
             throw new Error("orderIds is required and must not be empty");
         }
-        return this.makeAuthenticatedRequest("/api/v1/orders/batch-cancel", {
+        return this.makeAuthenticatedRequest(perpRoutes.orders.batchCancel(), {
             method: "POST",
             body: JSON.stringify({ order_ids: orderIds }),
         });
@@ -227,7 +278,7 @@ export class TradingAPIImpl extends BaseAPI {
      * ```
      */
     async batchCancelAll(tradingPairId) {
-        const endpoint = tradingPairId ? `/api/v1/orders/batch-cancel-all/${tradingPairId}` : "/api/v1/orders/batch-cancel-all";
+        const endpoint = tradingPairId ? perpRoutes.orders.batchCancelAllByPair(tradingPairId) : perpRoutes.orders.batchCancelAll();
         return this.makeAuthenticatedRequest(endpoint, {
             method: "POST",
         });
@@ -244,7 +295,7 @@ export class TradingAPIImpl extends BaseAPI {
         if (newOrder.quantity !== undefined) {
             requestBody.quantity = newOrder.quantity;
         }
-        return await this.makeAuthenticatedRequest(`/api/v1/orders/${orderId}`, {
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.replace(orderId), {
             method: "PUT",
             body: JSON.stringify(requestBody),
         });
@@ -293,9 +344,13 @@ export class TradingAPIImpl extends BaseAPI {
                 use_master_balance: order.useMasterBalance,
                 expiration_date: order.expirationDate,
                 time_in_force: order.timeInForce,
+                margin_account_id: order.marginAccountId,
+                position_side: order.positionSide,
+                leverage: order.leverage,
+                reduce_only: order.reduceOnly,
             })),
         };
-        return this.makeAuthenticatedRequest("/api/v1/orders/batch-create", {
+        return this.makeAuthenticatedRequest(perpRoutes.orders.batchCreate(), {
             method: "POST",
             body: JSON.stringify(requestBody),
         });
@@ -335,7 +390,7 @@ export class TradingAPIImpl extends BaseAPI {
                 use_master_balance: order.useMasterBalance,
             })),
         };
-        return this.makeAuthenticatedRequest("/api/v1/orders/batch-replace", {
+        return this.makeAuthenticatedRequest(perpRoutes.orders.batchReplace(), {
             method: "POST",
             body: JSON.stringify(requestBody),
         });
@@ -348,7 +403,7 @@ export class TradingAPIImpl extends BaseAPI {
      *
      * @param params - Query parameters for filtering orders
      * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED") (optional)
-     * @param params.trading_pair - Filter by trading pair (e.g., "USDCo/MTK") (optional)
+     * @param params.trading_pair_id - Filter by trading pair UUID (optional)
      * @param params.page - Page number for pagination (defaults to 1, must be > 0)
      * @param params.page_size - Number of orders per page (defaults to 10, max 100, must be > 0)
      * @returns Promise resolving to GetPaginatedOrdersResponse with orders and pagination info
@@ -359,7 +414,7 @@ export class TradingAPIImpl extends BaseAPI {
      * // Get submitted orders for a specific trading pair with custom pagination
      * const orders = await tradingAPI.getPaginatedOrders({
      *   status: "SUBMITTED",
-     *   trading_pair: "USDCo/MTK",
+     *   trading_pair_id: "456e7890-e12b-12d3-a456-426614174000",
      *   page: 1,
      *   page_size: 20
      * });
@@ -375,7 +430,7 @@ export class TradingAPIImpl extends BaseAPI {
             validate(GetPaginatedOrdersSchema, params);
         }
         // Set pagination defaults with destructuring and validation
-        const { page = 1, page_size = 10, status, trading_pair } = params || {};
+        const { page = 1, page_size = 10, status, trading_pair_id, trading_mode, margin_account_id } = params || {};
         const validPage = page > 0 ? page : 1;
         const validPageSize = page_size > 0 ? page_size : 10;
         const pageSize = Math.min(validPageSize, 100);
@@ -386,8 +441,14 @@ export class TradingAPIImpl extends BaseAPI {
         if (status) {
             searchParams.append("status", status);
         }
-        if (trading_pair) {
-            searchParams.append("trading_pair", trading_pair);
+        if (trading_pair_id) {
+            searchParams.append("trading_pair_id", trading_pair_id);
+        }
+        if (trading_mode) {
+            searchParams.append("trading_mode", trading_mode);
+        }
+        if (margin_account_id) {
+            searchParams.append("margin_account_id", margin_account_id);
         }
         const endpoint = `/api/v1/orders?${searchParams.toString()}`;
         return await this.makeAuthenticatedRequest(endpoint, {
@@ -413,7 +474,7 @@ export class TradingAPIImpl extends BaseAPI {
      * ```
      */
     async getOrder(orderId) {
-        return await this.makeAuthenticatedRequest(`/api/v1/orders/${orderId}`, {
+        return await this.makeAuthenticatedRequest(perpRoutes.orders.get(orderId), {
             method: "GET",
         });
     }

package/dist/api/websocket/types.d.ts

@@ -1,4 +1,4 @@
-import type { Interval, OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, TradingMode, UserBalanceEvent, UserMovementEvent, WebSocketStatus } from "@0xmonaco/types";
+import type { ConditionalOrderEvent, Interval, OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, TradingMode, UserBalanceEvent, UserMovementEvent, WebSocketStatus } from "@0xmonaco/types";
 export type StatusHandler = (status: WebSocketStatus) => void;
 export type MessageHandler<T> = (data: T) => void;
 export interface MonacoWebSocketOptions {
@@ -36,4 +36,6 @@ export interface MonacoWebSocket {
     userOrders: (handler: MessageHandler<OrderEvent>) => () => void;
     /** Subscribe to user balance events (requires authentication) */
     balances: (handler: MessageHandler<UserBalanceEvent>) => () => void;
+    /** Subscribe to conditional TP/SL lifecycle events (requires authentication) */
+    conditionalOrders: (handler: MessageHandler<ConditionalOrderEvent>, tradingPairId?: string) => () => void;
 }