@0xmonaco/types 0.6.3 → 0.7.0

package/dist/index.d.ts

@@ -9,7 +9,9 @@ export * from "./applications";
 export * from "./auth";
 export * from "./contracts";
 export * from "./fees";
+export * from "./margin-accounts";
 export * from "./market";
+export * from "./positions";
 export * from "./profile";
 export * from "./sdk";
 export * from "./trading";

package/dist/index.js

@@ -10,7 +10,9 @@ export * from "./applications";
 export * from "./auth";
 export * from "./contracts";
 export * from "./fees";
+export * from "./margin-accounts";
 export * from "./market";
+export * from "./positions";
 export * from "./profile";
 export * from "./sdk";
 export * from "./trading";

package/dist/margin-accounts/index.d.ts

@@ -0,0 +1,106 @@
+import type { BaseAPI } from "../api";
+import type { OrderSide, OrderType, PositionSide } from "../trading";
+export interface MarginAccountSummary {
+    margin_account_id: string;
+    account_state: string;
+    equity: string;
+    initial_margin_required: string;
+    maintenance_margin_required: string;
+    free_collateral: string;
+    withdrawable_collateral: string;
+    total_position_notional: string;
+    unrealized_pnl: string;
+    realized_pnl: string;
+    updated_at: string;
+}
+export interface ListMarginAccountsParams {
+    page?: number;
+    page_size?: number;
+    state?: string;
+}
+export interface ListMarginAccountsResponse {
+    accounts: MarginAccountSummary[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface CreateMarginAccountRequest {
+    label?: string;
+    collateralAsset?: string;
+}
+export interface CreateMarginAccountResponse {
+    margin_account_id: string;
+    account_state: string;
+    collateral_asset: string;
+    created_at: string;
+}
+export interface GetAvailableCollateralParams {
+    asset?: string;
+}
+export interface GetAvailableCollateralResponse {
+    asset: string;
+    wallet_available: string;
+    wallet_locked: string;
+    margin_transferable?: string;
+}
+export interface TransferCollateralRequest {
+    asset: string;
+    amount: string;
+}
+export interface TransferCollateralResponse {
+    movement_id: string;
+    margin_account_id: string;
+    asset: string;
+    amount: string;
+    status: string;
+    new_equity: string;
+}
+export interface GetMarginAccountMovementsParams {
+    movement_type?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface MarginAccountMovement {
+    movement_id: string;
+    margin_account_id: string;
+    movement_type: string;
+    asset: string;
+    amount: string;
+    created_at: string;
+}
+export interface GetMarginAccountMovementsResponse {
+    movements: MarginAccountMovement[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface SimulateOrderRiskRequest {
+    tradingPairId: string;
+    side: OrderSide;
+    positionSide: PositionSide;
+    orderType: OrderType;
+    price?: string;
+    quantity: string;
+    leverage: string;
+    reduceOnly?: boolean;
+}
+export interface SimulateOrderRiskResponse {
+    accepted: boolean;
+    reject_reason?: string;
+    equity_after: string;
+    initial_margin_required_after: string;
+    maintenance_margin_required_after: string;
+    free_collateral_after: string;
+    estimated_fee?: string;
+    estimated_liquidation_price?: string;
+}
+export interface MarginAccountsAPI extends BaseAPI {
+    listMarginAccounts(params?: ListMarginAccountsParams): Promise<ListMarginAccountsResponse>;
+    createMarginAccount(request?: CreateMarginAccountRequest): Promise<CreateMarginAccountResponse>;
+    getMarginAccountSummary(marginAccountId: string): Promise<MarginAccountSummary>;
+    getAvailableCollateral(params?: GetAvailableCollateralParams): Promise<GetAvailableCollateralResponse>;
+    transferCollateralToMarginAccount(marginAccountId: string, request: TransferCollateralRequest): Promise<TransferCollateralResponse>;
+    transferCollateralFromMarginAccount(marginAccountId: string, request: TransferCollateralRequest): Promise<TransferCollateralResponse>;
+    getMarginAccountMovements(marginAccountId: string, params?: GetMarginAccountMovementsParams): Promise<GetMarginAccountMovementsResponse>;
+    simulateOrderRisk(marginAccountId: string, request: SimulateOrderRiskRequest): Promise<SimulateOrderRiskResponse>;
+}

package/dist/market/index.d.ts

@@ -113,7 +113,7 @@ export interface GetTradingPairsParams {
     /** Page number (starts from 1) */
     page?: number;
     /** Number of items per page (max 100) */
-    limit?: number;
+    page_size?: number;
     /** Filter by market type (SPOT, MARGIN) */
     market_type?: string;
     /** Filter by base token symbol */
@@ -124,35 +124,26 @@ export interface GetTradingPairsParams {
     is_active?: boolean;
 }
 /**
- * Paginated response for trading pairs
+ * Response for listing trading pairs with pagination
  */
-export interface PaginatedTradingPairs {
-    data: TradingPair[];
-    limit: number;
+export interface GetTradingPairsResponse {
+    trading_pairs: TradingPair[];
     page: number;
+    page_size: number;
     total: number;
     total_pages: number;
 }
 /**
- * API response wrapper for trading pairs
- */
-export interface GetTradingPairsResponse {
-    data: PaginatedTradingPairs;
-    success: boolean;
-}
-/**
- * API response wrapper for single trading pair
+ * Response for a single trading pair
  */
 export interface GetTradingPairResponse {
-    data: TradingPair;
-    success: boolean;
+    trading_pair: TradingPair;
 }
 /**
  * API response wrapper for single trading pair
  */
 export interface GetCandlestickResponse {
     data: Candlestick[];
-    success: boolean;
 }
 /**
  * Market metadata with 24-hour statistics
@@ -181,6 +172,97 @@ export interface MarketMetadata {
     /** Unix timestamp (ms) when market started trading (null if not available) */
     market_initialization_timestamp: number | null;
 }
+export interface RiskTier {
+    notional_floor: string;
+    notional_cap?: string;
+    initial_margin_ratio: string;
+    maintenance_margin_ratio: string;
+    max_leverage: string;
+}
+export interface PerpMarketConfig {
+    trading_pair_id: string;
+    symbol: string;
+    min_leverage: string;
+    max_leverage: string;
+    initial_margin_ratio: string;
+    maintenance_margin_ratio: string;
+    funding_interval_seconds: number;
+    liquidation_fee_bps?: string;
+    risk_tiers: RiskTier[];
+    updated_at: string;
+}
+export interface PerpMarketSummary {
+    trading_pair_id: string;
+    symbol: string;
+    last_price: string;
+    mark_price: string;
+    index_price: string;
+    high_24h?: string;
+    low_24h?: string;
+    volume_24h?: string;
+    price_change_24h?: string;
+    price_change_percent_24h?: string;
+    open_interest: string;
+    current_funding_rate?: string;
+    estimated_next_funding_rate?: string;
+    next_funding_time?: string;
+    market_status: string;
+    market_regime: string;
+    updated_at: string;
+}
+export interface MarkPrice {
+    trading_pair_id: string;
+    mark_price: string;
+    oracle_provider: string;
+    oracle_epoch?: string;
+    updated_at: string;
+    regime: string;
+}
+export interface IndexComponent {
+    provider: string;
+    price: string;
+    weight?: string;
+    updated_at?: string;
+}
+export interface IndexPrice {
+    trading_pair_id: string;
+    index_price: string;
+    components: IndexComponent[];
+    updated_at: string;
+}
+export interface FundingState {
+    trading_pair_id: string;
+    current_funding_rate: string;
+    estimated_next_funding_rate?: string;
+    next_funding_time: string;
+    funding_interval_seconds: number;
+    last_funding_time?: string;
+    updated_at: string;
+}
+export interface FundingRecord {
+    trading_pair_id: string;
+    funding_rate: string;
+    funding_time: string;
+    cumulative_funding_per_unit?: string;
+}
+export interface ListFundingHistoryParams {
+    start_time?: string;
+    end_time?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface ListFundingHistoryResponse {
+    records: FundingRecord[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface OpenInterest {
+    trading_pair_id: string;
+    open_interest_base: string;
+    open_interest_notional: string;
+    updated_at: string;
+}
 /**
  * Market API interface.
  * Provides methods for fetching market metadata and trading pair information.
@@ -220,4 +302,11 @@ export interface MarketAPI extends BaseAPI {
      * @throws {Error} If pair not found or no data available
      */
     getMarketMetadata(tradingPairId: string): Promise<MarketMetadata>;
+    getPerpMarketConfig(tradingPairId: string): Promise<PerpMarketConfig>;
+    getPerpMarketSummary(tradingPairId: string): Promise<PerpMarketSummary>;
+    getMarkPrice(tradingPairId: string): Promise<MarkPrice>;
+    getIndexPrice(tradingPairId: string): Promise<IndexPrice>;
+    getFundingState(tradingPairId: string): Promise<FundingState>;
+    listFundingHistory(tradingPairId: string, params?: ListFundingHistoryParams): Promise<ListFundingHistoryResponse>;
+    getOpenInterest(tradingPairId: string): Promise<OpenInterest>;
 }

package/dist/positions/index.d.ts

@@ -0,0 +1,128 @@
+import type { BaseAPI } from "../api";
+import type { OrderType, PositionSide, TimeInForce } from "../trading";
+export type PositionStatus = "OPEN" | "CLOSED" | "LIQUIDATING";
+export type ClosePositionType = "MARKET" | "LIMIT" | "IOC";
+export interface Position {
+    position_id: string;
+    margin_account_id: string;
+    trading_pair_id: string;
+    side: PositionSide;
+    size: string;
+    entry_price: string;
+    mark_price: string;
+    index_price?: string;
+    unrealized_pnl: string;
+    realized_pnl: string;
+    isolated_margin: string;
+    leverage?: string;
+    maintenance_margin_required: string;
+    initial_margin_required?: string;
+    liquidation_price: string;
+    status: PositionStatus;
+    updated_at: string;
+}
+export interface ListPositionsParams {
+    margin_account_id?: string;
+    trading_pair_id?: string;
+    status?: PositionStatus;
+    page?: number;
+    page_size?: number;
+}
+export interface ListPositionsResponse {
+    positions: Position[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export type GetPositionResponse = Position;
+export interface ClosePositionRequest {
+    closeType: ClosePositionType;
+    limitPrice?: string;
+    slippageToleranceBps?: number;
+    quantity?: string;
+}
+export interface ClosePositionResponse {
+    close_order_id: string;
+    status: string;
+    message: string;
+    submitted_quantity: string;
+}
+export interface PositionRisk {
+    position_id: string;
+    mark_price: string;
+    index_price?: string;
+    unrealized_pnl: string;
+    liquidation_price: string;
+    margin_ratio: string;
+    maintenance_margin_required: string;
+    initial_margin_required?: string;
+    updated_at: string;
+}
+export interface AddPositionMarginRequest {
+    amount: string;
+    asset: string;
+}
+export interface ReducePositionMarginRequest {
+    amount: string;
+}
+export interface PositionMarginResponse {
+    position_id: string;
+    margin_account_id: string;
+    new_isolated_margin: string;
+    status: string;
+    message: string;
+}
+export interface TpSlLeg {
+    triggerPrice: string;
+    orderType: OrderType;
+    limitPrice?: string;
+    quantity?: string;
+    timeInForce?: Extract<TimeInForce, "GTC" | "IOC">;
+    slippageToleranceBps?: number;
+    expiresAt?: string;
+}
+export interface AttachPositionTpSlRequest {
+    takeProfit?: TpSlLeg;
+    stopLoss?: TpSlLeg;
+}
+export interface AttachPositionTpSlResponse {
+    position_id: string;
+    take_profit_order_id?: string;
+    stop_loss_order_id?: string;
+    status: "SUCCESS" | "FAILED";
+    message: string;
+}
+export interface ListPositionHistoryParams {
+    position_id?: string;
+    margin_account_id?: string;
+    trading_pair_id?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface PositionHistoryEvent {
+    event_id: string;
+    position_id?: string;
+    margin_account_id?: string;
+    trading_pair_id?: string;
+    event_type: string;
+    quantity?: string;
+    price?: string;
+    realized_pnl?: string;
+    timestamp: string;
+}
+export interface ListPositionHistoryResponse {
+    events: PositionHistoryEvent[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface PositionsAPI extends BaseAPI {
+    listPositions(params?: ListPositionsParams): Promise<ListPositionsResponse>;
+    getPosition(positionId: string): Promise<GetPositionResponse>;
+    closePosition(positionId: string, request: ClosePositionRequest): Promise<ClosePositionResponse>;
+    getPositionRisk(positionId: string): Promise<PositionRisk>;
+    addPositionMargin(positionId: string, request: AddPositionMarginRequest): Promise<PositionMarginResponse>;
+    reducePositionMargin(positionId: string, request: ReducePositionMarginRequest): Promise<PositionMarginResponse>;
+    attachPositionTpSl(positionId: string, request: AttachPositionTpSlRequest): Promise<AttachPositionTpSlResponse>;
+    listPositionHistory(params?: ListPositionHistoryParams): Promise<ListPositionHistoryResponse>;
+}

package/dist/profile/index.d.ts

@@ -94,7 +94,7 @@ export interface GetUserMovementsParams {
     /** Page number (starts from 1) */
     page?: number;
     /** Number of items per page (max 100) */
-    limit?: number;
+    page_size?: number;
     /** Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE) */
     entry_type?: LedgerEntryType;
     /** Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, FEE, FUNDING, LIQUIDATION, INTEREST, REWARD) */
@@ -106,10 +106,10 @@ export interface GetUserMovementsParams {
  * Query parameters for getting user balances
  */
 export interface GetUserBalancesParams {
-    /** Number of items to return */
-    limit?: number;
-    /** Number of items to skip */
-    offset?: number;
+    /** Page number (starts from 1) */
+    page?: number;
+    /** Number of items per page (max 100) */
+    page_size?: number;
 }
 /**
  * Response from getting user movements
@@ -126,9 +126,9 @@ export interface GetPaginatedUserMovementsResponse {
     /** Current page number */
     page: number;
     /** Items per page */
-    limit: number;
+    page_size: number;
     /** Total number of movements in PostgreSQL */
-    total_count: number;
+    total: number;
     /** Total number of pages */
     total_pages: number;
 }
@@ -139,11 +139,13 @@ export interface GetUserBalancesResponse {
     /** List of token balances for the user */
     balances: AccountBalance[];
     /** Total number of balances */
-    total_count: number;
-    /** Number of items returned */
-    limit: number;
-    /** Number of items skipped */
-    offset: number;
+    total: number;
+    /** Items per page */
+    page_size: number;
+    /** Current page number */
+    page: number;
+    /** Total number of pages */
+    total_pages: number;
 }
 /**
  * Order information for recent orders.
@@ -152,8 +154,8 @@ export interface GetUserBalancesResponse {
 export interface ProfileOrder {
     /** Order identifier */
     id: string;
-    /** Trading pair/market identifier (e.g., "ETH-USD") */
-    trading_pair: string;
+    /** Trading pair symbol (e.g., "ETH-USD") */
+    symbol: string;
     /** Order side */
     side: OrderSide;
     /** Order type */
@@ -223,7 +225,7 @@ export interface GetUserTradesParams {
     /** Page number (starts from 1) */
     page?: number;
     /** Number of items per page (max 100) */
-    limit?: number;
+    page_size?: number;
     /** Filter by trading pair ID (UUID) */
     trading_pair_id?: string;
 }
@@ -236,9 +238,9 @@ export interface GetUserTradesResponse {
     /** Current page number */
     page: number;
     /** Items per page */
-    limit: number;
+    page_size: number;
     /** Total number of trades */
-    total_count: number;
+    total: number;
     /** Total number of pages */
     total_pages: number;
 }

package/dist/sdk/index.d.ts

@@ -2,11 +2,13 @@ import type { PublicClient, TransactionReceipt, WalletClient } from "viem";
 import type { ApplicationsAPI } from "../applications";
 import type { AuthAPI, AuthState } from "../auth/index";
 import type { FeesAPI } from "../fees";
+import type { MarginAccountsAPI } from "../margin-accounts";
 import type { Interval, MarketAPI } from "../market";
+import type { PositionsAPI } from "../positions";
 import type { ProfileAPI } from "../profile";
 import type { TradingAPI, TradingMode } from "../trading";
 import type { VaultAPI } from "../vault";
-import type { OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, UserBalanceEvent, UserMovementEvent } from "../websocket";
+import type { ConditionalOrderEvent, OHLCVEvent, OrderbookEvent, OrderbookQuotationMode, OrderEvent, TradeEvent, UserBalanceEvent, UserMovementEvent } from "../websocket";
 import type { Network } from "./network";
 /**
  * Configuration options for the Monaco SDK.
@@ -47,6 +49,10 @@ export interface MonacoSDK {
     trading: TradingAPI;
     /** Market metadata API */
     market: MarketAPI;
+    /** Margin account operations API */
+    marginAccounts: MarginAccountsAPI;
+    /** Perp position operations API */
+    positions: PositionsAPI;
     /** Profile operations API */
     profile: ProfileAPI;
     /** Orderbook REST API for fetching orderbook snapshots */
@@ -65,10 +71,10 @@ export interface MonacoSDK {
     /** Trades REST API for fetching historical trades */
     trades: {
         getTrades: (tradingPairId: string, options?: {
-            /** 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;
         }) => Promise<TradeEvent[]>;
     };
     /** WebSocket client for real-time data (orders, orderbook, ohlcv) */
@@ -85,6 +91,7 @@ export interface MonacoSDK {
         movements: (handler: (event: UserMovementEvent) => void) => () => void;
         userOrders: (handler: (event: OrderEvent) => void) => () => void;
         balances: (handler: (event: UserBalanceEvent) => void) => () => void;
+        conditionalOrders: (handler: (event: ConditionalOrderEvent) => void, tradingPairId?: string) => () => void;
     };
     /** Wallet client for all blockchain operations (undefined until set) */
     walletClient: WalletClient | undefined;

package/dist/trading/index.d.ts

@@ -4,8 +4,8 @@
  * Types for trading operations including order placement and management.
  */
 import type { BaseAPI } from "../api/index";
-import type { OrderSide, TimeInForce, TradingMode } from "./orders";
-import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ReplaceOrderResponse } from "./responses";
+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";
 /**
  * Trading API interface.
  * Provides methods for placing and managing orders.
@@ -28,6 +28,10 @@ export interface TradingAPI extends BaseAPI {
         useMasterBalance?: boolean;
         expirationDate?: string;
         timeInForce?: TimeInForce;
+        marginAccountId?: string;
+        positionSide?: PositionSide;
+        leverage?: string;
+        reduceOnly?: boolean;
     }): Promise<CreateOrderResponse>;
     /**
      * Places a market order for immediate execution.
@@ -42,6 +46,10 @@ export interface TradingAPI extends BaseAPI {
     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.
@@ -49,6 +57,18 @@ export interface TradingAPI extends BaseAPI {
      * @returns Promise resolving to the cancellation result
      */
     cancelOrder(orderId: string): Promise<CancelOrderResponse>;
+    /**
+     * Creates a standalone conditional TP/SL order.
+     */
+    createConditionalOrder(params: CreateConditionalOrderParams): Promise<CreateConditionalOrderResponse>;
+    /**
+     * Cancels an active conditional TP/SL order.
+     */
+    cancelConditionalOrder(conditionalOrderId: string): Promise<CancelConditionalOrderResponse>;
+    /**
+     * Lists conditional TP/SL orders for the authenticated user.
+     */
+    listConditionalOrders(params?: ListConditionalOrdersParams): Promise<ListConditionalOrdersResponse>;
     /**
      * Batch cancels specific orders by their IDs.
      * @param orderIds - Array of order IDs to cancel
@@ -94,7 +114,7 @@ export interface TradingAPI extends BaseAPI {
      * Gets paginated orders based on query parameters.
      * @param params - Query parameters for filtering orders
      * @param params.status - Filter by order status (optional)
-     * @param params.trading_pair - Filter by trading pair (optional)
+     * @param params.trading_pair_id - Filter by trading pair UUID (optional)
      * @param params.page - Page number for pagination (optional)
      * @param params.page_size - Number of orders per page (optional)
      * @returns Promise resolving to the paginated orders result
@@ -107,6 +127,6 @@ export interface TradingAPI extends BaseAPI {
      */
     getOrder(orderId: string): Promise<GetOrderResponse>;
 }
-export type { Order, OrderRole, OrderSide, OrderStatus, OrderType, TimeInForce, TradingMode, } from "./orders";
+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, CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, 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, ReplaceOrderResponse, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -23,7 +23,7 @@ export interface Order {
     /** Order identifier (UUID) */
     id: string;
     /** Trading pair ID (UUID format, e.g., "456e7890-e12b-12d3-a456-426614174000") */
-    trading_pair: string;
+    trading_pair_id: string;
     /** Order side (BUY or SELL) */
     side: OrderSide;
     /** Order type - see OrderType for all supported types */
@@ -60,6 +60,16 @@ export interface Order {
     taker_total_payment?: string;
     /** Total receipt for maker after rebates in quote currency - populated after fills */
     maker_total_receipt?: string;
+    /** Margin account ID for margin/perp orders */
+    margin_account_id?: string;
+    /** Position side for margin/perp orders */
+    position_side?: PositionSide;
+    /** Leverage used for margin/perp orders */
+    leverage?: string;
+    /** Whether the order can only reduce existing exposure */
+    reduce_only?: boolean;
+    /** Position ID linked to the order, when available */
+    position_id?: string;
 }
 /**
  * Role of the creator or order
@@ -69,6 +79,10 @@ export type OrderRole = "maker" | "taker";
  * Order side for trading operations
  */
 export type OrderSide = "BUY" | "SELL";
+/**
+ * Position side for margin/perp trading
+ */
+export type PositionSide = "LONG" | "SHORT" | "NONE";
 /**
  * Order type for different order strategies
  * - LIMIT: Execute only at specified price or better
@@ -109,3 +123,15 @@ export type TradingMode = "SPOT" | "MARGIN";
  * - GTD: Good Till Date - remains active until specified expiration date
  */
 export type TimeInForce = "GTC" | "IOC" | "FOK" | "GTD";
+/**
+ * Conditional TP/SL condition type.
+ */
+export type ConditionalOrderConditionType = "STOP_LOSS" | "TAKE_PROFIT";
+/**
+ * Conditional order trigger source. v1 supports mark-price triggers.
+ */
+export type ConditionalOrderTriggerSource = "MARK_PRICE";
+/**
+ * Conditional TP/SL lifecycle state.
+ */
+export type ConditionalOrderState = "ACTIVE" | "TRIGGERING" | "TRIGGERED" | "CANCELLED" | "EXPIRED" | "FAILED";