@0xmonaco/types 1.0.65 → 1.0.67

package/dist/market/index.d.ts

@@ -191,6 +191,8 @@ export interface ScreenerSnapshotPoint {
     quoteVolume: string;
     /** Percent price change (close - open) / open * 100 for the day */
     priceChangePercent: string;
+    /** Daily average of the valued completed-UTC-minute open interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
+    openInterestNotionalAvg: string | null;
 }
 /**
  * Per-pair screener row. Window fields are null when there is insufficient history.
@@ -251,6 +253,12 @@ export interface ScreenerItem {
      * getOpenInterest
      */
     openInterestNotional: string | null;
+    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
+    openInterestNotionalAvg1h: string | null;
+    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
+    openInterestNotionalAvg24h: string | null;
+    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
+    openInterestNotionalAvg7d: string | null;
 }
 /**
  * Paginated screener response, sorted by quoteVolume24h desc (nulls last)

package/dist/positions/index.d.ts

@@ -32,16 +32,13 @@ export interface Position {
     unrealizedPnl: string;
     realizedPnl: string;
     /**
-     * Open ISOLATED rows: the position's current backing — its risk bucket's
-     * allocated collateral adjusted by settled realized PnL and funding paid,
-     * net of collateral reserved for the bucket's open orders, clamped at zero
-     * (0XM-2558). Partial closes shrink the posted margin pro-rata while the
-     * realized loss stays in the bucket, so this is the unrealized-return
-     * denominator. Not a hard -100% bound: liquidation measures the bucket's
-     * whole equity, order reserves included, and a mark can gap past the
-     * backing. Open CROSS rows: the position's posted margin. Terminal rows:
-     * total initial margin allocated across the position's reducing executions
-     * when available — the margin basis for lifetime realized return.
+     * Open ISOLATED rows: principal committed to the filled position, adjusted
+     * by settled realized PnL, fees and funding, clamped at zero. Unfilled-order
+     * collateral is excluded. This is the unrealized-return denominator and
+     * the same backing used by isolated liquidation, on live and persisted reads.
+     * A price gap can pass the backing before asynchronous liquidation occurs.
+     * Open CROSS rows: posted margin. Terminal rows: total initial margin
+     * allocated across reducing executions, the lifetime-return denominator.
      */
     isolatedMargin: string;
     leverage?: string;
@@ -249,16 +246,56 @@ export interface TpSlLeg {
     slippageToleranceBps?: number;
     expiresAt?: string;
 }
+/**
+ * A trailing stop attached to an open position (0XM-2827).
+ *
+ * A reduce-only MARKET close whose trigger trails the best mark price reached
+ * since it armed (the watermark) by `trailBps`: for a long, trigger =
+ * watermark × (1 − trailBps/10000) and it fires when the mark falls to or below
+ * it; a short mirrors it. The trigger only ever moves in the position's
+ * favour. One trailing stop per position — a second attach is rejected with
+ * HTTP 409. It coexists with `takeProfit` / `stopLoss` and never joins `oco`.
+ * There is no modify: cancel and recreate. Fires through the standard
+ * conditional market close (1,200 bps protective band, optional slippage cap).
+ */
+export interface TrailingStopLeg {
+    /** Retracement behind the watermark in basis points; integer, 10 to 2000 inclusive */
+    trailBps: number;
+    /**
+     * Mark level at which tracking starts, seeding the watermark there. Omitted,
+     * tracking starts at the current mark. Rejected if the mark has already
+     * reached it. The row stays `ACTIVE` while waiting and `trailArmedAt` is set
+     * once it arms.
+     */
+    activationPrice?: string;
+    /**
+     * Deliberate partial size that never resizes. Mutually exclusive with
+     * `closePosition: true`; required when `closePosition: false`.
+     */
+    quantity?: string;
+    /**
+     * Resolve the full live position size when triggered. Mutually exclusive
+     * with `quantity`. Omitting both also means full-position close.
+     */
+    closePosition?: boolean;
+    /** Slippage cap for the triggered MARKET close, 0 to 10000 basis points */
+    slippageToleranceBps?: number;
+    /** Optional conditional order expiry timestamp (ISO 8601) */
+    expiresAt?: string;
+}
 export interface AttachPositionTpSlRequest {
     takeProfit?: TpSlLeg;
     stopLoss?: TpSlLeg;
-    /** Cancel the sibling after one leg triggers. Requires both legs. */
+    /** Trailing stop; may be the only leg. Never part of `oco`. */
+    trailingStop?: TrailingStopLeg;
+    /** Cancel the sibling after one leg triggers. Requires both fixed legs. */
     oco?: boolean;
 }
 export interface AttachPositionTpSlResponse {
     positionId: string;
     takeProfitOrderId?: string;
     stopLossOrderId?: string;
+    trailingStopOrderId?: string;
     status: "SUCCESS" | "FAILED";
     message: string;
 }

package/dist/trading/index.d.ts

@@ -6,7 +6,7 @@
 import type { BaseAPI } from "../api/index";
 import type { MarginMode } from "../margin-accounts";
 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";
+import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CancelTwapOrderResponse, ConditionalOrder, CreateOrderResponse, CreateTwapOrderOptions, CreateTwapOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, GetTwapOrderTcaResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ListTwapOrdersParams, ListTwapOrdersResponse, ParentTpSlLegParams, ParentTrailingStopLegParams, ReplaceOrderResponse, TwapOrder } from "./responses";
 /**
  * Trading API interface.
  * Provides methods for placing and managing orders.
@@ -32,6 +32,7 @@ export interface TradingAPI extends BaseAPI {
         marginAccountId?: string;
         marginMode?: MarginMode;
         riskBucketId?: string;
+        /** Initial order budget; unfilled funds do not back the isolated position. */
         riskBucketCollateral?: string;
         strategyKey?: string;
         /** @deprecated Order side is authoritative. */
@@ -66,6 +67,8 @@ export interface TradingAPI extends BaseAPI {
         idempotencyKey?: string;
         takeProfit?: ParentTpSlLegParams;
         stopLoss?: ParentTpSlLegParams;
+        /** Trailing stop that arms when this order fully fills; margin entry orders only. */
+        trailingStop?: ParentTrailingStopLegParams;
     }): Promise<CreateOrderResponse>;
     /**
      * Places a market order for immediate execution.
@@ -83,6 +86,7 @@ export interface TradingAPI extends BaseAPI {
         marginAccountId?: string;
         marginMode?: MarginMode;
         riskBucketId?: string;
+        /** Initial order budget; unfilled funds do not back the isolated position. */
         riskBucketCollateral?: string;
         strategyKey?: string;
         /** @deprecated Order side is authoritative. */
@@ -110,6 +114,8 @@ export interface TradingAPI extends BaseAPI {
         idempotencyKey?: string;
         takeProfit?: ParentTpSlLegParams;
         stopLoss?: ParentTpSlLegParams;
+        /** Trailing stop that arms when this order fully fills; margin entry orders only. */
+        trailingStop?: ParentTrailingStopLegParams;
     }): Promise<CreateOrderResponse>;
     /**
      * Cancels an existing order.
@@ -263,4 +269,4 @@ export interface TradingAPI extends BaseAPI {
 }
 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, TriggeredOrderSummary, TwapOrder, UpdatedFields, } from "./responses";
+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, ParentTrailingStopLegParams, ReplaceOrderResponse, TriggeredOrderSummary, TwapOrder, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -265,9 +265,11 @@ export type TimeInForce = "GTC" | "IOC" | "FOK" | "GTD";
  */
 export type SelfTradePreventionMode = "CANCEL_MAKER" | "CANCEL_TAKER" | "CANCEL_BOTH" | "SKIP";
 /**
- * Conditional TP/SL condition type.
+ * Conditional order condition type: a fixed stop-loss or take-profit, or a
+ * trailing stop whose trigger follows the best mark reached since it armed
+ * (0XM-2827).
  */
-export type ConditionalOrderConditionType = "STOP_LOSS" | "TAKE_PROFIT";
+export type ConditionalOrderConditionType = "STOP_LOSS" | "TAKE_PROFIT" | "TRAILING_STOP";
 /**
  * Conditional order trigger source. v1 supports mark-price triggers.
  */

package/dist/trading/responses.d.ts

@@ -71,6 +71,42 @@ export interface ParentTpSlLegParams {
      */
     closePosition?: boolean;
 }
+/**
+ * A trailing stop attached to a margin entry order at placement (0XM-2827).
+ *
+ * A reduce-only MARKET close whose trigger trails the best mark price reached
+ * since it armed (the watermark) by `trailBps`: for a long, trigger =
+ * watermark × (1 − trailBps/10000) and it fires when the mark falls to or below
+ * it; a short mirrors it. The trigger only ever moves in the position's
+ * favour. It arms only when the entry order FULLY fills and is cancelled with
+ * the order otherwise. One trailing stop per position — a second is rejected
+ * with HTTP 409. It coexists with `takeProfit` / `stopLoss` and never joins
+ * their OCO link. There is no modify: cancel and recreate.
+ */
+export interface ParentTrailingStopLegParams {
+    /** Retracement behind the watermark in basis points; integer, 10 to 2000 inclusive */
+    trailBps: number;
+    /**
+     * Mark level at which tracking starts, seeding the watermark there. Omitted,
+     * tracking starts at the first mark after the fill. Rejected if the mark has
+     * already reached it.
+     */
+    activationPrice?: string;
+    /**
+     * Deliberate partial size that never resizes. Mutually exclusive with
+     * `closePosition: true`; required when `closePosition: false`.
+     */
+    quantity?: string;
+    /**
+     * Resolve the full live position size when triggered. Mutually exclusive
+     * with `quantity`. Omitting both also means full-position close.
+     */
+    closePosition?: boolean;
+    /** Slippage cap for the triggered MARKET close, 0 to 10000 basis points */
+    slippageToleranceBps?: number;
+    /** Optional conditional order expiry timestamp (ISO 8601) */
+    expiresAt?: string;
+}
 /**
  * Response from creating an order.
  *
@@ -99,6 +135,8 @@ export interface CreateOrderResponse {
     takeProfitOrderId?: string;
     /** Conditional order ID for an attached stop-loss leg */
     stopLossOrderId?: string;
+    /** Conditional order ID for an attached trailing stop */
+    trailingStopOrderId?: string;
 }
 /**
  * Response from cancelling an order.
@@ -449,8 +487,31 @@ export interface ListConditionalOrdersParams {
     marginAccountId?: string;
     tradingPairId?: string;
     state?: ConditionalOrderState;
+    /**
+     * Page number for legacy offset pagination.
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode; omitting both `page` and `pageToken`
+     * drives cursor mode.
+     */
     page?: number;
+    /** Items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     pageSize?: number;
+    /**
+     * Pagination cursor with three distinct states:
+     * - Omitted (`undefined`): the SDK starts a cursor walk (it sends
+     *   `pageToken=""`) unless the deprecated `page` param was passed, in which
+     *   case the request uses legacy page-number pagination.
+     * - Empty string (`""`): start a cursor walk with no prior position, from
+     *   the newest conditional order.
+     * - Non-empty: an opaque cursor from a previous response's `nextPageToken`;
+     *   results resume immediately after that position.
+     *
+     * In either cursor-walk state, `page` and `total` come back as 0 — cursor
+     * mode runs no COUNT (AIP-158). Follow `nextPageToken` until it comes back
+     * empty. Filters must match the request that produced the token.
+     */
+    pageToken?: string;
 }
 /**
  * What the order a conditional fired into has done so far — a projection of
@@ -518,6 +579,29 @@ export interface ConditionalOrder {
     cancelledAt?: string;
     expiresAt?: string;
     failureReason?: string;
+    /**
+     * `TRAILING_STOP` only: retracement in basis points behind the watermark.
+     * Absent on TP/SL rows. Wire: `trailBps`.
+     */
+    trailBps?: number;
+    /**
+     * `TRAILING_STOP` only: the mark level that starts tracking. Absent when the
+     * stop armed immediately. Wire: `activationPrice`.
+     */
+    activationPrice?: string;
+    /**
+     * `TRAILING_STOP` only: best mark (highest for a long, lowest for a short)
+     * observed since arming. `triggerPrice` is derived from it and only ever
+     * moves in the position's favour. Absent until the first mark is observed
+     * after arming. Wire: `watermarkPrice`.
+     */
+    watermarkPrice?: string;
+    /**
+     * `TRAILING_STOP` only: when tracking began (ISO 8601). Absent while the
+     * stop is still waiting for `activationPrice` — `state` stays `ACTIVE` in
+     * both phases. Wire: `trailArmedAt`.
+     */
+    trailArmedAt?: string;
     createdAt: string;
     updatedAt: string;
     /**
@@ -557,14 +641,28 @@ export interface ConditionalOrder {
 export interface ListConditionalOrdersResponse {
     orders: ConditionalOrder[];
     /**
-     * Matching conditional orders. Exact up to 10,000 pages of the requested
-     * page size (`pageSize` x 10,000 rows) and saturates there, so a caller with
-     * more matching conditional orders than the listing can page through reads
-     * the cap, not its lifetime total. `page` is capped at 10,000.
+     * Matching conditional orders in page-number (offset) mode: exact up to
+     * 10,000 pages of the requested page size (`pageSize` x 10,000 rows) and
+     * saturates there, so a caller with more matching conditional orders than the
+     * listing can page through reads the cap, not its lifetime total. `0` in
+     * cursor (`pageToken`) mode, which runs no COUNT (AIP-158).
      */
     total: number;
+    /**
+     * Current page number in legacy offset mode; `0` in cursor mode.
+     *
+     * @deprecated Use cursor pagination (`pageToken`/`nextPageToken`) instead.
+     */
     page: number;
     pageSize: number;
+    /**
+     * Cursor for the next page, minted only while a further page exists (the read
+     * over-fetches one row to decide). Empty on every page-number response and on
+     * the final cursor page — an empty token is the definitive end of the walk,
+     * so no extra request is needed. Do not feed the empty token back as
+     * `pageToken`; an empty input restarts the walk from the newest row.
+     */
+    nextPageToken: string;
 }
 /**
  * Options for creating a server-side TWAP parent order.
@@ -820,10 +918,31 @@ export interface ListTwapOrdersParams {
     state?: TwapOrderState;
     /** Filter by trading pair UUID */
     tradingPairId?: string;
-    /** Page number (1-indexed) */
+    /**
+     * Page number for legacy offset pagination.
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode; omitting both `page` and `pageToken`
+     * drives cursor mode.
+     */
     page?: number;
-    /** Items per page (max 100) */
+    /** Items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     pageSize?: number;
+    /**
+     * Pagination cursor with three distinct states:
+     * - Omitted (`undefined`): the SDK starts a cursor walk (it sends
+     *   `pageToken=""`) unless the deprecated `page` param was passed, in which
+     *   case the request uses legacy page-number pagination.
+     * - Empty string (`""`): start a cursor walk with no prior position, from
+     *   the newest TWAP parent.
+     * - Non-empty: an opaque cursor from a previous response's `nextPageToken`;
+     *   results resume immediately after that position.
+     *
+     * In either cursor-walk state, `page` and `total` come back as 0 — cursor
+     * mode runs no COUNT (AIP-158). Follow `nextPageToken` until it comes back
+     * empty. Filters must match the request that produced the token.
+     */
+    pageToken?: string;
 }
 /**
  * Response from listing TWAP parent orders.
@@ -831,14 +950,27 @@ export interface ListTwapOrdersParams {
 export interface ListTwapOrdersResponse {
     orders: TwapOrder[];
     /**
-     * Matching TWAP orders. Exact up to 10,000 pages of the requested page size
-     * (`pageSize` x 10,000 rows) and saturates there, so a caller with more
-     * matching TWAP orders than the listing can page through reads the cap, not
-     * its lifetime total. `page` is capped at 10,000.
+     * Matching TWAP orders in page-number (offset) mode: exact up to 10,000 pages
+     * of the requested page size (`pageSize` x 10,000 rows) and saturates there,
+     * so a caller with more matching TWAP orders than the listing can page through
+     * reads the cap, not its lifetime total. `0` in cursor (`pageToken`) mode,
+     * which runs no COUNT (AIP-158).
      */
     total: number;
-    /** Current page number */
+    /**
+     * Current page number in legacy offset mode; `0` in cursor mode.
+     *
+     * @deprecated Use cursor pagination (`pageToken`/`nextPageToken`) instead.
+     */
     page: number;
     /** Items per page */
     pageSize: number;
+    /**
+     * Cursor for the next page, minted only while a further page exists (the read
+     * over-fetches one row to decide). Empty on every page-number response and on
+     * the final cursor page — an empty token is the definitive end of the walk,
+     * so no extra request is needed. Do not feed the empty token back as
+     * `pageToken`; an empty input restarts the walk from the newest row.
+     */
+    nextPageToken: string;
 }

package/dist/validation/positions.d.ts

@@ -72,6 +72,14 @@ export declare const AttachPositionTpSlSchema: z.ZodObject<{
             slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
             expiresAt: z.ZodOptional<z.ZodISODateTime>;
         }, z.core.$strip>>;
+        trailingStop: z.ZodOptional<z.ZodObject<{
+            trailBps: z.ZodNumber;
+            activationPrice: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
+            slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strip>>;
         oco: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 }, z.core.$strip>;

package/dist/validation/positions.js

@@ -2,7 +2,7 @@
  * Positions API Validation Schemas
  */
 import { z } from "zod";
-import { ConditionalTimeInForceSchema, ISO8601DateSchema, OrderTypeSchema, PositiveDecimalStringSchema, SlippageToleranceBpsSchema, UUIDSchema, } from "./trading";
+import { ConditionalTimeInForceSchema, ISO8601DateSchema, OrderTypeSchema, PositiveDecimalStringSchema, SlippageToleranceBpsSchema, TrailingStopLegSchema, UUIDSchema, } from "./trading";
 const PaginationSchema = z.object({
     page: z.number().int().min(1, "Page must be at least 1").optional(),
     pageSize: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
@@ -88,11 +88,13 @@ export const AttachPositionTpSlSchema = PositionIdSchema.extend({
         .object({
         takeProfit: TpSlLegSchema.optional(),
         stopLoss: TpSlLegSchema.optional(),
+        trailingStop: TrailingStopLegSchema.optional(),
         oco: z.boolean().optional(),
     })
-        .refine((data) => data.takeProfit !== undefined || data.stopLoss !== undefined, {
-        message: "At least one of takeProfit or stopLoss is required",
+        .refine((data) => data.takeProfit !== undefined || data.stopLoss !== undefined || data.trailingStop !== undefined, {
+        message: "At least one of takeProfit, stopLoss, or trailingStop is required",
     })
+        // A trailing stop never takes part in OCO: the pair is the two fixed legs.
         .refine((data) => data.oco !== true || (data.takeProfit !== undefined && data.stopLoss !== undefined), {
         message: "oco=true requires both takeProfit and stopLoss",
         path: ["oco"],

package/dist/validation/trading.d.ts

@@ -101,6 +101,31 @@ export declare const ParentTpSlLegSchema: z.ZodObject<{
     slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
     expiresAt: z.ZodOptional<z.ZodISODateTime>;
 }, z.core.$strip>;
+/** Trailing-stop retracement: an integer from 10 to 2000 basis points (0XM-2827). */
+export declare const TrailBpsSchema: z.ZodNumber;
+/**
+ * The trailing-stop leg, shared by the position-attached rail and the
+ * entry-order rail: the shape is identical on both. The close is always a
+ * reduce-only MARKET order, so there is no order type, limit price or time in
+ * force to check — only the ratchet distance, the optional activation level,
+ * the same sizing contract a TP/SL leg carries, and the slippage cap.
+ */
+export declare const TrailingStopLegSchema: z.ZodObject<{
+    trailBps: z.ZodNumber;
+    activationPrice: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodOptional<z.ZodString>;
+    closePosition: z.ZodOptional<z.ZodBoolean>;
+    slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export declare const ParentTrailingStopLegSchema: z.ZodObject<{
+    trailBps: z.ZodNumber;
+    activationPrice: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodOptional<z.ZodString>;
+    closePosition: z.ZodOptional<z.ZodBoolean>;
+    slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
 /**
  * Place Limit Order validation schema
  */
@@ -180,6 +205,14 @@ export declare const PlaceLimitOrderSchema: z.ZodObject<{
             slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
             expiresAt: z.ZodOptional<z.ZodISODateTime>;
         }, z.core.$strip>>;
+        trailingStop: z.ZodOptional<z.ZodObject<{
+            trailBps: z.ZodNumber;
+            activationPrice: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
+            slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -252,6 +285,14 @@ export declare const PlaceMarketOrderSchema: z.ZodObject<{
             slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
             expiresAt: z.ZodOptional<z.ZodISODateTime>;
         }, z.core.$strip>>;
+        trailingStop: z.ZodOptional<z.ZodObject<{
+            trailBps: z.ZodNumber;
+            activationPrice: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodOptional<z.ZodString>;
+            closePosition: z.ZodOptional<z.ZodBoolean>;
+            slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -327,6 +368,7 @@ export declare const GetPaginatedOrdersSchema: z.ZodObject<{
 export declare const ConditionalOrderConditionTypeSchema: z.ZodEnum<{
     STOP_LOSS: "STOP_LOSS";
     TAKE_PROFIT: "TAKE_PROFIT";
+    TRAILING_STOP: "TRAILING_STOP";
 }>;
 export declare const ConditionalOrderTriggerSourceSchema: z.ZodEnum<{
     MARK_PRICE: "MARK_PRICE";
@@ -361,6 +403,7 @@ export declare const ListConditionalOrdersSchema: z.ZodObject<{
     }>>;
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const TwapOrderStateSchema: z.ZodEnum<{
     CANCELLED: "CANCELLED";
@@ -422,6 +465,7 @@ export declare const ListTwapOrdersSchema: z.ZodObject<{
     tradingPairId: z.ZodOptional<z.ZodUUID>;
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Single batch create order item validation schema

package/dist/validation/trading.js

@@ -138,7 +138,38 @@ export const ParentTpSlLegSchema = z
     message: "quantity is required when closePosition is false",
     path: ["closePosition"],
 });
-const hasParentTpSl = (options) => options?.takeProfit !== undefined || options?.stopLoss !== undefined;
+/** Trailing-stop retracement: an integer from 10 to 2000 basis points (0XM-2827). */
+export const TrailBpsSchema = z
+    .number()
+    .int("trailBps must be an integer number of basis points")
+    .min(10, "trailBps must be at least 10 bps")
+    .max(2000, "trailBps cannot exceed 2000 bps");
+/**
+ * The trailing-stop leg, shared by the position-attached rail and the
+ * entry-order rail: the shape is identical on both. The close is always a
+ * reduce-only MARKET order, so there is no order type, limit price or time in
+ * force to check — only the ratchet distance, the optional activation level,
+ * the same sizing contract a TP/SL leg carries, and the slippage cap.
+ */
+export const TrailingStopLegSchema = z
+    .object({
+    trailBps: TrailBpsSchema,
+    activationPrice: PositiveDecimalStringSchema.optional(),
+    quantity: PositiveDecimalStringSchema.optional(),
+    closePosition: z.boolean().optional(),
+    slippageToleranceBps: SlippageToleranceBpsSchema.optional(),
+    expiresAt: ISO8601DateSchema.optional(),
+})
+    .refine((data) => data.closePosition !== true || data.quantity === undefined, {
+    message: "quantity must be omitted when closePosition is true",
+    path: ["quantity"],
+})
+    .refine((data) => data.quantity !== undefined || data.closePosition !== false, {
+    message: "quantity is required when closePosition is false",
+    path: ["closePosition"],
+});
+export const ParentTrailingStopLegSchema = TrailingStopLegSchema;
+const hasParentTpSl = (options) => options?.takeProfit !== undefined || options?.stopLoss !== undefined || options?.trailingStop !== undefined;
 const legacyPositionSideMatchesOrderSide = (side, positionSide) => positionSide === undefined || (positionSide !== "NONE" && ((side === "BUY" && positionSide === "LONG") || (side === "SELL" && positionSide === "SHORT")));
 /**
  * Place Limit Order validation schema
@@ -173,6 +204,7 @@ export const PlaceLimitOrderSchema = z
         selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
         takeProfit: ParentTpSlLegSchema.optional(),
         stopLoss: ParentTpSlLegSchema.optional(),
+        trailingStop: ParentTrailingStopLegSchema.optional(),
     })
         .optional(),
 })
@@ -185,11 +217,11 @@ export const PlaceLimitOrderSchema = z
     path: ["options", "leverage"],
 })
     .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
-    message: "takeProfit/stopLoss are only supported for MARGIN orders",
+    message: "takeProfit/stopLoss/trailingStop are only supported for MARGIN orders",
     path: ["options"],
 })
     .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
-    message: "takeProfit/stopLoss cannot be attached to reduce-only orders",
+    message: "takeProfit/stopLoss/trailingStop cannot be attached to reduce-only orders",
     path: ["options"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
@@ -252,6 +284,7 @@ export const PlaceMarketOrderSchema = z
         selfTradePreventionMode: SelfTradePreventionModeSchema.optional(),
         takeProfit: ParentTpSlLegSchema.optional(),
         stopLoss: ParentTpSlLegSchema.optional(),
+        trailingStop: ParentTrailingStopLegSchema.optional(),
     })
         .optional(),
 })
@@ -264,11 +297,11 @@ export const PlaceMarketOrderSchema = z
     path: ["options", "leverage"],
 })
     .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
-    message: "takeProfit/stopLoss are only supported for MARGIN orders",
+    message: "takeProfit/stopLoss/trailingStop are only supported for MARGIN orders",
     path: ["options"],
 })
     .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
-    message: "takeProfit/stopLoss cannot be attached to reduce-only orders",
+    message: "takeProfit/stopLoss/trailingStop cannot be attached to reduce-only orders",
     path: ["options"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
@@ -372,8 +405,8 @@ export const GetPaginatedOrdersSchema = z
         });
     }
 });
-export const ConditionalOrderConditionTypeSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"], {
-    message: 'conditionType must be "STOP_LOSS" or "TAKE_PROFIT"',
+export const ConditionalOrderConditionTypeSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT", "TRAILING_STOP"], {
+    message: 'conditionType must be "STOP_LOSS", "TAKE_PROFIT", or "TRAILING_STOP"',
 });
 export const ConditionalOrderTriggerSourceSchema = z.enum(["MARK_PRICE"], {
     message: 'triggerSource must be "MARK_PRICE"',
@@ -387,12 +420,27 @@ export const ClosePositionSideSchema = z.enum(["LONG", "SHORT"], {
 export const CancelConditionalOrderSchema = z.object({
     conditionalOrderId: UUIDSchema,
 });
-export const ListConditionalOrdersSchema = z.object({
+export const ListConditionalOrdersSchema = z
+    .object({
     marginAccountId: UUIDSchema.optional(),
     tradingPairId: UUIDSchema.optional(),
     state: ConditionalOrderStateSchema.optional(),
     page: z.number().int().min(1, "Page must be at least 1").optional(),
-    pageSize: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    pageSize: z.number().int().min(1, "Page size must be at least 1").max(1000, "Page size cannot exceed 1000").optional(),
+    pageToken: z.string().optional(),
+})
+    .superRefine((params, ctx) => {
+    // The higher 1000 cap only applies to cursor (pageToken) requests; the
+    // server keeps the 100 cap for page-number requests (offset scans).
+    // Legacy page-number mode is selected only by passing `page` without
+    // `pageToken` — omitting both starts a cursor walk.
+    if (params.page !== undefined && params.pageToken === undefined && params.pageSize !== undefined && params.pageSize > 100) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Page size cannot exceed 100 in page-number mode (page without pageToken)",
+            path: ["pageSize"],
+        });
+    }
 });
 export const TwapOrderStateSchema = z.enum(["PENDING", "ACTIVE", "COMPLETED", "CANCELLED"], {
     message: "Invalid TWAP order state",
@@ -516,11 +564,26 @@ export const CreateTwapOrderSchema = z
 export const CancelTwapOrderSchema = z.object({
     twapOrderId: UUIDSchema,
 });
-export const ListTwapOrdersSchema = z.object({
+export const ListTwapOrdersSchema = z
+    .object({
     state: TwapOrderStateSchema.optional(),
     tradingPairId: UUIDSchema.optional(),
     page: z.number().int().min(1, "Page must be at least 1").optional(),
-    pageSize: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    pageSize: z.number().int().min(1, "Page size must be at least 1").max(1000, "Page size cannot exceed 1000").optional(),
+    pageToken: z.string().optional(),
+})
+    .superRefine((params, ctx) => {
+    // The higher 1000 cap only applies to cursor (pageToken) requests; the
+    // server keeps the 100 cap for page-number requests (offset scans).
+    // Legacy page-number mode is selected only by passing `page` without
+    // `pageToken` — omitting both starts a cursor walk.
+    if (params.page !== undefined && params.pageToken === undefined && params.pageSize !== undefined && params.pageSize > 100) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Page size cannot exceed 100 in page-number mode (page without pageToken)",
+            path: ["pageSize"],
+        });
+    }
 });
 /**
  * Single batch create order item validation schema