@0xmonaco/types 0.8.16 → 0.8.19

package/dist/fees/index.d.ts

@@ -4,7 +4,7 @@
  * Types for fees operations including fee simulation.
  */
 import type { BaseAPI } from "../api/index";
-import type { SimulateFeeParams, SimulateFeeResponse } from "./responses";
+import type { GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse } from "./responses";
 /**
  * Fees API interface.
  * Provides methods for simulating and calculating trading fees.
@@ -34,6 +34,28 @@ export interface FeesAPI extends BaseAPI {
      * ```
      */
     simulateFees(params: SimulateFeeParams): Promise<SimulateFeeResponse>;
+    /**
+     * Get the caller's current fee tier, rolling 14-day volumes, and a pair's schedule.
+     *
+     * Returns the caller's resolved tier (1–6) and weighted 14-day volume (with the
+     * spot/perp breakdown), the volume still needed to reach the next tier, and the
+     * requested pair's six-row fee schedule (threshold plus maker/taker bps).
+     *
+     * @param params - Parameters for the lookup
+     * @param params.tradingPairId - Trading pair whose fee schedule to return
+     * @returns Promise resolving to the caller's tier and the pair's schedule
+     *
+     * @example
+     * ```typescript
+     * const tier = await feesAPI.getMyFeeTier({
+     *   tradingPairId: "123e4567-e89b-12d3-a456-426614174000",
+     * });
+     * console.log(`Current tier: ${tier.currentTierLevel}`);
+     * console.log(`14d volume: ${tier.weightedVolume14d}`);
+     * console.log(`To next tier: ${tier.volumeToNextTier ?? "already at top tier"}`);
+     * ```
+     */
+    getMyFeeTier(params: GetMyFeeTierParams): Promise<GetMyFeeTierResponse>;
 }
-export type { SimulateFeeParams, SimulateFeeResponse } from "./responses";
-export { SimulateFeeParamsSchema, SimulateFeeResponseSchema } from "./responses";
+export type { FeeTierScheduleRow, GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse, } from "./responses";
+export { FeeTierScheduleRowSchema, GetMyFeeTierParamsSchema, GetMyFeeTierResponseSchema, SimulateFeeParamsSchema, SimulateFeeResponseSchema, } from "./responses";

package/dist/fees/index.js

@@ -3,4 +3,4 @@
  *
  * Types for fees operations including fee simulation.
  */
-export { SimulateFeeParamsSchema, SimulateFeeResponseSchema } from "./responses";
+export { FeeTierScheduleRowSchema, GetMyFeeTierParamsSchema, GetMyFeeTierResponseSchema, SimulateFeeParamsSchema, SimulateFeeResponseSchema, } from "./responses";

package/dist/fees/responses.d.ts

@@ -52,3 +52,50 @@ export type SimulateFeeParams = z.infer<typeof SimulateFeeParamsSchema>;
  * @remarks Type is inferred from SimulateFeeResponseSchema
  */
 export type SimulateFeeResponse = z.infer<typeof SimulateFeeResponseSchema>;
+/**
+ * Zod schema for the parameters of a "my fee tier" lookup
+ */
+export declare const GetMyFeeTierParamsSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for one row of a pair's fee-tier schedule
+ */
+export declare const FeeTierScheduleRowSchema: z.ZodObject<{
+    tierLevel: z.ZodNumber;
+    minVolumeThreshold: z.ZodString;
+    makerFeeBps: z.ZodString;
+    takerFeeBps: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for the "my fee tier" response
+ */
+export declare const GetMyFeeTierResponseSchema: z.ZodObject<{
+    currentTierLevel: z.ZodNumber;
+    weightedVolume14d: z.ZodString;
+    spotVolume14d: z.ZodString;
+    perpVolume14d: z.ZodString;
+    volumeToNextTier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nextTierLevel: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    feeSchedule: z.ZodArray<z.ZodObject<{
+        tierLevel: z.ZodNumber;
+        minVolumeThreshold: z.ZodString;
+        makerFeeBps: z.ZodString;
+        takerFeeBps: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Parameters for a "my fee tier" lookup
+ * @remarks Type is inferred from GetMyFeeTierParamsSchema
+ */
+export type GetMyFeeTierParams = z.infer<typeof GetMyFeeTierParamsSchema>;
+/**
+ * One row of a pair's fee-tier schedule
+ * @remarks Type is inferred from FeeTierScheduleRowSchema
+ */
+export type FeeTierScheduleRow = z.infer<typeof FeeTierScheduleRowSchema>;
+/**
+ * The caller's current fee tier, rolling 14-day volumes, and a pair's schedule
+ * @remarks Type is inferred from GetMyFeeTierResponseSchema
+ */
+export type GetMyFeeTierResponse = z.infer<typeof GetMyFeeTierResponseSchema>;

package/dist/fees/responses.js

@@ -84,3 +84,42 @@ export const SimulateFeeResponseSchema = z.object({
     /** Slippage tolerance used in the calculation, echoed back for MARKET orders (null for LIMIT orders) */
     slippageToleranceBps: z.number().nullable(),
 });
+/**
+ * Zod schema for the parameters of a "my fee tier" lookup
+ */
+export const GetMyFeeTierParamsSchema = z.object({
+    /** Trading pair ID whose six-row fee schedule to return */
+    tradingPairId: z.string().trim().min(1, "Trading pair ID is required and cannot be empty"),
+});
+/**
+ * Zod schema for one row of a pair's fee-tier schedule
+ */
+export const FeeTierScheduleRowSchema = z.object({
+    /** Tier level, 1 (lowest volume) through 6 (highest) */
+    tierLevel: z.number().int(),
+    /** Weighted 14-day volume floor for this tier, in quote/USD units */
+    minVolumeThreshold: z.string(),
+    /** Maker fee in human basis points; negative is a rebate */
+    makerFeeBps: z.string(),
+    /** Taker fee in human basis points */
+    takerFeeBps: z.string(),
+});
+/**
+ * Zod schema for the "my fee tier" response
+ */
+export const GetMyFeeTierResponseSchema = z.object({
+    /** Caller's resolved tier (1–6) from stored weighted 14-day volume */
+    currentTierLevel: z.number().int(),
+    /** Caller's weighted 14-day volume (perp + 2.5× spot) */
+    weightedVolume14d: z.string(),
+    /** Caller's rolling 14-day spot volume */
+    spotVolume14d: z.string(),
+    /** Caller's rolling 14-day perp volume */
+    perpVolume14d: z.string(),
+    /** Additional weighted volume needed to reach the next tier; absent at tier 6 */
+    volumeToNextTier: z.string().nullable().optional(),
+    /** Next tier level; absent when already at tier 6 */
+    nextTierLevel: z.number().int().nullable().optional(),
+    /** Six-row fee schedule for the requested pair, ascending by tier */
+    feeSchedule: z.array(FeeTierScheduleRowSchema),
+});

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

@@ -1,10 +1,12 @@
 import type { BaseAPI } from "../api";
 import type { OrderSide, OrderType, PositionSide } from "../trading";
+export type MarginMode = "ISOLATED" | "CROSS";
 export interface MarginAccountSummary {
     marginAccountId: string;
     label?: string;
     riskBucketId?: string;
-    marginMode?: "ISOLATED" | "CROSS";
+    marginMode?: MarginMode;
+    selectedTradingPairIds?: string[];
     tradingPairId?: string;
     strategyKey?: string;
     accountState: string;
@@ -59,10 +61,19 @@ export interface TransferCollateralToParentMarginAccountRequest {
     asset: string;
     amount: string;
 }
-export interface TransferCollateralToRiskBucketRequest extends TransferCollateralToParentMarginAccountRequest {
+export interface TransferCollateralToIsolatedRiskBucketRequest extends TransferCollateralToParentMarginAccountRequest {
+    marginMode?: "ISOLATED";
     tradingPairId: string;
     strategyKey?: string;
+    selectedTradingPairIds?: never;
 }
+export interface TransferCollateralToCrossRiskBucketRequest extends TransferCollateralToParentMarginAccountRequest {
+    marginMode: "CROSS";
+    selectedTradingPairIds: string[];
+    tradingPairId?: never;
+    strategyKey?: never;
+}
+export type TransferCollateralToRiskBucketRequest = TransferCollateralToIsolatedRiskBucketRequest | TransferCollateralToCrossRiskBucketRequest;
 export interface TransferCollateralFromParentMarginAccountRequest {
     asset: string;
     amount: string;
@@ -71,6 +82,9 @@ export interface TransferCollateralResponse {
     movementId: string;
     marginAccountId: string;
     strategyKey?: string;
+    riskBucketId?: string;
+    marginMode?: MarginMode;
+    selectedTradingPairIds?: string[];
     asset: string;
     amount: string;
     status: string;
@@ -107,14 +121,25 @@ export interface SimulateOrderRiskRequest {
     leverage: string;
     reduceOnly?: boolean;
 }
-export interface SimulateRiskBucketOrderRiskRequest extends SimulateOrderRiskRequest {
+export type SimulateIsolatedRiskBucketOrderRiskRequest = SimulateOrderRiskRequest & {
+    marginMode?: "ISOLATED";
     strategyKey?: string;
-}
+    selectedTradingPairIds?: never;
+};
+export type SimulateCrossRiskBucketOrderRiskRequest = SimulateOrderRiskRequest & {
+    marginMode: "CROSS";
+    selectedTradingPairIds: string[];
+    strategyKey?: never;
+};
+export type SimulateRiskBucketOrderRiskRequest = SimulateIsolatedRiskBucketOrderRiskRequest | SimulateCrossRiskBucketOrderRiskRequest;
 export interface SimulateOrderRiskResponse {
     accepted: boolean;
     rejectReason?: string;
     marginAccountId: string;
     strategyKey?: string;
+    riskBucketId?: string;
+    marginMode?: MarginMode;
+    selectedTradingPairIds?: string[];
     equityAfter: string;
     initialMarginRequiredAfter: string;
     maintenanceMarginRequiredAfter: string;

package/dist/positions/index.d.ts

@@ -1,4 +1,5 @@
 import type { BaseAPI } from "../api";
+import type { MarginMode } from "../margin-accounts";
 import type { OrderType, PositionSide, TimeInForce } from "../trading";
 export type PositionStatus = "OPEN" | "CLOSED" | "LIQUIDATING";
 export type ClosePositionType = "MARKET" | "LIMIT" | "IOC";
@@ -6,6 +7,7 @@ export interface Position {
     positionId: string;
     marginAccountId: string;
     riskBucketId?: string;
+    marginMode?: MarginMode;
     tradingPairId: string;
     side: PositionSide;
     size: string;

package/dist/trading/index.d.ts

@@ -4,6 +4,7 @@
  * Types for trading operations including order placement and management.
  */
 import type { BaseAPI } from "../api/index";
+import type { MarginMode } from "../margin-accounts";
 import type { OrderSide, PositionSide, TimeInForce, TradingMode } from "./orders";
 import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ParentTpSlLegParams, ReplaceOrderResponse } from "./responses";
 /**
@@ -29,6 +30,7 @@ export interface TradingAPI extends BaseAPI {
         expirationDate?: string;
         timeInForce?: TimeInForce;
         marginAccountId?: string;
+        marginMode?: MarginMode;
         riskBucketId?: string;
         riskBucketCollateral?: string;
         strategyKey?: string;
@@ -52,6 +54,7 @@ export interface TradingAPI extends BaseAPI {
         tradingMode?: TradingMode;
         slippageTolerance?: number;
         marginAccountId?: string;
+        marginMode?: MarginMode;
         riskBucketId?: string;
         riskBucketCollateral?: string;
         strategyKey?: string;

package/dist/trading/responses.d.ts

@@ -3,6 +3,7 @@
  *
  * Response types for trading operations.
  */
+import type { MarginMode } from "../margin-accounts";
 import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderSide, OrderStatus, OrderType, PositionSide, TimeInForce, TradingMode } from "./orders";
 /**
  * Match result information for order execution.
@@ -288,6 +289,8 @@ export interface BatchCreateOrderParams {
     timeInForce?: Extract<TimeInForce, "GTC" | "IOC" | "FOK">;
     /** Margin account UUID for margin/perp orders */
     marginAccountId?: string;
+    /** Risk bucket mode for margin/perp orders */
+    marginMode?: MarginMode;
     /** Existing isolated risk bucket UUID for risk-bucket-scoped margin orders */
     riskBucketId?: string;
     /** Collateral to allocate into a new isolated risk bucket */

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

@@ -34,12 +34,21 @@ export declare const TransferCollateralToParentMarginAccountSchema: z.ZodObject<
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const TransferCollateralToRiskBucketSchema: z.ZodObject<{
-    request: z.ZodObject<{
+    request: z.ZodUnion<readonly [z.ZodObject<{
         asset: z.ZodString;
         amount: z.ZodString;
         tradingPairId: z.ZodUUID;
         strategyKey: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
+        marginMode: z.ZodOptional<z.ZodLiteral<"ISOLATED">>;
+        selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>, z.ZodObject<{
+        asset: z.ZodString;
+        amount: z.ZodString;
+        marginMode: z.ZodLiteral<"CROSS">;
+        selectedTradingPairIds: z.ZodArray<z.ZodUUID>;
+        strategyKey: z.ZodOptional<z.ZodNever>;
+        tradingPairId: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>]>;
 }, z.core.$strip>;
 export declare const TransferCollateralFromParentMarginAccountSchema: z.ZodObject<{
     request: z.ZodObject<{
@@ -104,7 +113,7 @@ export declare const SimulateParentMarginOrderRiskSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strip>;
 export declare const SimulateRiskBucketOrderRiskSchema: z.ZodObject<{
-    request: z.ZodObject<{
+    request: z.ZodUnion<readonly [z.ZodObject<{
         side: z.ZodEnum<{
             BUY: "BUY";
             SELL: "SELL";
@@ -124,5 +133,29 @@ export declare const SimulateRiskBucketOrderRiskSchema: z.ZodObject<{
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         tradingPairId: z.ZodUUID;
         strategyKey: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
+        marginMode: z.ZodOptional<z.ZodLiteral<"ISOLATED">>;
+        selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>, z.ZodObject<{
+        tradingPairId: z.ZodUUID;
+        side: z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>;
+        positionSide: z.ZodEnum<{
+            LONG: "LONG";
+            SHORT: "SHORT";
+            NONE: "NONE";
+        }>;
+        orderType: z.ZodEnum<{
+            LIMIT: "LIMIT";
+            MARKET: "MARKET";
+        }>;
+        price: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodString;
+        leverage: z.ZodString;
+        reduceOnly: z.ZodOptional<z.ZodBoolean>;
+        marginMode: z.ZodLiteral<"CROSS">;
+        selectedTradingPairIds: z.ZodArray<z.ZodUUID>;
+        strategyKey: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>]>;
 }, z.core.$strip>;

package/dist/validation/margin-accounts.js

@@ -39,6 +39,19 @@ const RiskBucketRequestSchema = z.object({
     tradingPairId: UUIDSchema,
     strategyKey: z.string().trim().min(1, "Strategy key cannot be empty").optional(),
 });
+const SelectedCrossTradingPairIdsSchema = z.array(UUIDSchema).min(1, "selectedTradingPairIds is required for CROSS risk buckets");
+const IsolatedRiskBucketRequestSchema = RiskBucketRequestSchema.extend({
+    marginMode: z.literal("ISOLATED").optional(),
+    selectedTradingPairIds: z.never().optional(),
+});
+const CrossRiskBucketScopeSchema = z.object({
+    marginMode: z.literal("CROSS"),
+    selectedTradingPairIds: SelectedCrossTradingPairIdsSchema,
+    strategyKey: z.never().optional(),
+});
+const CrossRiskBucketRequestSchema = CrossRiskBucketScopeSchema.extend({
+    tradingPairId: z.never().optional(),
+});
 export const TransferCollateralSchema = z.object({
     marginAccountId: UUIDSchema,
     request: TransferCollateralRequestSchema,
@@ -47,7 +60,10 @@ export const TransferCollateralToParentMarginAccountSchema = z.object({
     request: ParentMarginAccountCollateralRequestSchema,
 });
 export const TransferCollateralToRiskBucketSchema = z.object({
-    request: ParentMarginAccountCollateralRequestSchema.merge(RiskBucketRequestSchema),
+    request: z.union([
+        ParentMarginAccountCollateralRequestSchema.merge(IsolatedRiskBucketRequestSchema).strict(),
+        ParentMarginAccountCollateralRequestSchema.merge(CrossRiskBucketRequestSchema).strict(),
+    ]),
 });
 export const TransferCollateralFromParentMarginAccountSchema = z.object({
     request: ParentMarginAccountCollateralRequestSchema,
@@ -70,7 +86,14 @@ const BaseSimulateOrderRiskRequestSchema = z.object({
     reduceOnly: z.boolean().optional(),
 });
 const SimulateOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.strict();
-const SimulateRiskBucketOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.merge(RiskBucketRequestSchema).strict();
+const SimulateIsolatedRiskBucketOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.merge(IsolatedRiskBucketRequestSchema).strict();
+const SimulateCrossRiskBucketOrderRiskRequestSchema = BaseSimulateOrderRiskRequestSchema.merge(CrossRiskBucketScopeSchema)
+    .strict()
+    .refine((data) => data.selectedTradingPairIds.includes(data.tradingPairId), {
+    message: "tradingPairId must be included in selectedTradingPairIds for CROSS risk buckets",
+    path: ["selectedTradingPairIds"],
+});
+const SimulateRiskBucketOrderRiskRequestSchema = z.union([SimulateIsolatedRiskBucketOrderRiskRequestSchema, SimulateCrossRiskBucketOrderRiskRequestSchema]);
 export const SimulateOrderRiskSchema = z
     .object({
     marginAccountId: UUIDSchema,

package/dist/validation/trading.d.ts

@@ -19,6 +19,10 @@ export declare const TradingModeSchema: z.ZodEnum<{
     SPOT: "SPOT";
     MARGIN: "MARGIN";
 }>;
+export declare const MarginModeSchema: z.ZodEnum<{
+    ISOLATED: "ISOLATED";
+    CROSS: "CROSS";
+}>;
 /**
  * Position side validation
  */
@@ -101,6 +105,10 @@ export declare const PlaceLimitOrderSchema: z.ZodObject<{
             FOK: "FOK";
         }>>;
         marginAccountId: z.ZodOptional<z.ZodUUID>;
+        marginMode: z.ZodOptional<z.ZodEnum<{
+            ISOLATED: "ISOLATED";
+            CROSS: "CROSS";
+        }>>;
         riskBucketId: z.ZodOptional<z.ZodUUID>;
         riskBucketCollateral: z.ZodOptional<z.ZodString>;
         strategyKey: z.ZodOptional<z.ZodString>;
@@ -158,6 +166,10 @@ export declare const PlaceMarketOrderSchema: z.ZodObject<{
         }>>;
         slippageTolerance: z.ZodOptional<z.ZodNumber>;
         marginAccountId: z.ZodOptional<z.ZodUUID>;
+        marginMode: z.ZodOptional<z.ZodEnum<{
+            ISOLATED: "ISOLATED";
+            CROSS: "CROSS";
+        }>>;
         riskBucketId: z.ZodOptional<z.ZodUUID>;
         riskBucketCollateral: z.ZodOptional<z.ZodString>;
         strategyKey: z.ZodOptional<z.ZodString>;
@@ -320,6 +332,10 @@ export declare const BatchCreateOrderItemSchema: z.ZodObject<{
         FOK: "FOK";
     }>>;
     marginAccountId: z.ZodOptional<z.ZodUUID>;
+    marginMode: z.ZodOptional<z.ZodEnum<{
+        ISOLATED: "ISOLATED";
+        CROSS: "CROSS";
+    }>>;
     riskBucketId: z.ZodOptional<z.ZodUUID>;
     riskBucketCollateral: z.ZodOptional<z.ZodString>;
     strategyKey: z.ZodOptional<z.ZodString>;
@@ -362,6 +378,10 @@ export declare const BatchCreateOrdersSchema: z.ZodObject<{
             FOK: "FOK";
         }>>;
         marginAccountId: z.ZodOptional<z.ZodUUID>;
+        marginMode: z.ZodOptional<z.ZodEnum<{
+            ISOLATED: "ISOLATED";
+            CROSS: "CROSS";
+        }>>;
         riskBucketId: z.ZodOptional<z.ZodUUID>;
         riskBucketCollateral: z.ZodOptional<z.ZodString>;
         strategyKey: z.ZodOptional<z.ZodString>;

package/dist/validation/trading.js

@@ -18,6 +18,9 @@ export const OrderSideSchema = z.enum(["BUY", "SELL"], {
 export const TradingModeSchema = z.enum(["SPOT", "MARGIN"], {
     message: 'Trading mode must be "SPOT" or "MARGIN"',
 });
+export const MarginModeSchema = z.enum(["ISOLATED", "CROSS"], {
+    message: 'Margin mode must be "ISOLATED" or "CROSS"',
+});
 /**
  * Position side validation
  */
@@ -117,6 +120,7 @@ export const PlaceLimitOrderSchema = z
         expirationDate: ISO8601DateSchema.optional(),
         timeInForce: TimeInForceSchema.optional(),
         marginAccountId: UUIDSchema.optional(),
+        marginMode: MarginModeSchema.optional(),
         riskBucketId: UUIDSchema.optional(),
         riskBucketCollateral: PositiveDecimalStringSchema.optional(),
         strategyKey: z.string().min(1).max(128).optional(),
@@ -151,6 +155,26 @@ export const PlaceLimitOrderSchema = z
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
     message: "riskBucketCollateral is only supported for MARGIN orders",
     path: ["options", "tradingMode"],
+})
+    .refine((data) => data.options?.marginMode === undefined || data.options?.tradingMode === "MARGIN", {
+    message: "marginMode is only supported for MARGIN orders",
+    path: ["options", "tradingMode"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.marginAccountId !== undefined, {
+    message: "marginAccountId is required for CROSS margin orders",
+    path: ["options", "marginAccountId"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.riskBucketId === undefined, {
+    message: "marginMode CROSS cannot be combined with riskBucketId",
+    path: ["options", "riskBucketId"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.riskBucketCollateral === undefined, {
+    message: "marginMode CROSS cannot be combined with riskBucketCollateral",
+    path: ["options", "riskBucketCollateral"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.strategyKey === undefined, {
+    message: "marginMode CROSS cannot be combined with strategyKey",
+    path: ["options", "strategyKey"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.riskBucketId === undefined, {
     message: "riskBucketCollateral creates a new risk bucket and cannot be combined with riskBucketId",
@@ -173,6 +197,7 @@ export const PlaceMarketOrderSchema = z
         tradingMode: TradingModeSchema.optional(),
         slippageTolerance: SlippageToleranceSchema,
         marginAccountId: UUIDSchema.optional(),
+        marginMode: MarginModeSchema.optional(),
         riskBucketId: UUIDSchema.optional(),
         riskBucketCollateral: PositiveDecimalStringSchema.optional(),
         strategyKey: z.string().min(1).max(128).optional(),
@@ -207,6 +232,26 @@ export const PlaceMarketOrderSchema = z
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
     message: "riskBucketCollateral is only supported for MARGIN orders",
     path: ["options", "tradingMode"],
+})
+    .refine((data) => data.options?.marginMode === undefined || data.options?.tradingMode === "MARGIN", {
+    message: "marginMode is only supported for MARGIN orders",
+    path: ["options", "tradingMode"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.marginAccountId !== undefined, {
+    message: "marginAccountId is required for CROSS margin orders",
+    path: ["options", "marginAccountId"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.riskBucketId === undefined, {
+    message: "marginMode CROSS cannot be combined with riskBucketId",
+    path: ["options", "riskBucketId"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.riskBucketCollateral === undefined, {
+    message: "marginMode CROSS cannot be combined with riskBucketCollateral",
+    path: ["options", "riskBucketCollateral"],
+})
+    .refine((data) => data.options?.marginMode !== "CROSS" || data.options?.strategyKey === undefined, {
+    message: "marginMode CROSS cannot be combined with strategyKey",
+    path: ["options", "strategyKey"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.riskBucketId === undefined, {
     message: "riskBucketCollateral creates a new risk bucket and cannot be combined with riskBucketId",
@@ -298,6 +343,7 @@ export const BatchCreateOrderItemSchema = z
     expirationDate: ISO8601DateSchema.optional(),
     timeInForce: TimeInForceSchema.optional(),
     marginAccountId: UUIDSchema.optional(),
+    marginMode: MarginModeSchema.optional(),
     riskBucketId: UUIDSchema.optional(),
     riskBucketCollateral: PositiveDecimalStringSchema.optional(),
     strategyKey: z.string().min(1).max(128).optional(),
@@ -316,6 +362,26 @@ export const BatchCreateOrderItemSchema = z
     .refine((data) => data.riskBucketCollateral === undefined || data.tradingMode === "MARGIN", {
     message: "riskBucketCollateral is only supported for MARGIN orders",
     path: ["tradingMode"],
+})
+    .refine((data) => data.marginMode === undefined || data.tradingMode === "MARGIN", {
+    message: "marginMode is only supported for MARGIN orders",
+    path: ["tradingMode"],
+})
+    .refine((data) => data.marginMode !== "CROSS" || data.marginAccountId !== undefined, {
+    message: "marginAccountId is required for CROSS margin orders",
+    path: ["marginAccountId"],
+})
+    .refine((data) => data.marginMode !== "CROSS" || data.riskBucketId === undefined, {
+    message: "marginMode CROSS cannot be combined with riskBucketId",
+    path: ["riskBucketId"],
+})
+    .refine((data) => data.marginMode !== "CROSS" || data.riskBucketCollateral === undefined, {
+    message: "marginMode CROSS cannot be combined with riskBucketCollateral",
+    path: ["riskBucketCollateral"],
+})
+    .refine((data) => data.marginMode !== "CROSS" || data.strategyKey === undefined, {
+    message: "marginMode CROSS cannot be combined with strategyKey",
+    path: ["strategyKey"],
 })
     .refine((data) => data.riskBucketCollateral === undefined || data.riskBucketId === undefined, {
     message: "riskBucketCollateral creates a new risk bucket and cannot be combined with riskBucketId",

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -39,6 +39,7 @@ export const OPERATION_IDS = [
     "get_mark_price",
     "get_market_metadata",
     "get_market_stats",
+    "get_my_fee_tier",
     "get_open_interest",
     "get_order_by_id",
     "get_orderbook_snapshot",

package/dist/wire/schema.d.ts

@@ -704,6 +704,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/fees/tier": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get my fee tier and pair schedule
+         * @description Return the caller's current fee tier, rolling 14-day volumes, and a pair's schedule.
+         */
+        get: operations["get_my_fee_tier"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/margin/accounts": {
         parameters: {
             query?: never;
@@ -2310,6 +2330,12 @@ export interface components {
              * @example my-strategy
              */
             strategyKey?: string | null;
+            /**
+             * @description Risk bucket mode for margin orders. Defaults to ISOLATED. Values: ISOLATED, CROSS.
+             * @example CROSS
+             * @enum {string|null}
+             */
+            marginMode?: "ISOLATED" | "CROSS" | null;
         };
         BatchCreateOrdersRequest: {
             orders: components["schemas"]["BatchCreateOrderItem"][];
@@ -2739,6 +2765,12 @@ export interface components {
              * @example my-strategy
              */
             strategyKey?: string | null;
+            /**
+             * @description Risk bucket mode for margin orders. Defaults to ISOLATED. Values: ISOLATED, CROSS.
+             * @example CROSS
+             * @enum {string|null}
+             */
+            marginMode?: "ISOLATED" | "CROSS" | null;
         };
         CreateOrderResponse: {
             /**
@@ -2884,6 +2916,29 @@ export interface components {
              */
             error?: string | null;
         };
+        FeeTierScheduleRow: {
+            /**
+             * Format: int32
+             * @description Tier level 1 (lowest volume) through 6 (highest)
+             * @example 1
+             */
+            tierLevel?: number | null;
+            /**
+             * @description Weighted 14-day volume floor for this tier, in quote/USD units
+             * @example 5000000
+             */
+            minVolumeThreshold?: string | null;
+            /**
+             * @description Maker fee in human basis points; negative is a rebate
+             * @example -1.15
+             */
+            makerFeeBps?: string | null;
+            /**
+             * @description Taker fee in human basis points
+             * @example 6.5
+             */
+            takerFeeBps?: string | null;
+        };
         FundingPaymentRecord: {
             /**
              * Format: uuid
@@ -3149,6 +3204,7 @@ export interface components {
             strategyKey?: string | null;
             riskBucketId?: string | null;
             marginMode?: string | null;
+            selectedTradingPairIds?: string[] | null;
         };
         GetMarkPriceResponse: {
             /** Format: uuid */
@@ -3292,6 +3348,42 @@ export interface components {
              */
             totalPages?: number | null;
         };
+        GetMyFeeTierResponse: {
+            /**
+             * Format: int32
+             * @description Caller's resolved tier (1–6) from stored weighted 14-day volume
+             * @example 2
+             */
+            currentTierLevel?: number | null;
+            /**
+             * @description Caller's weighted 14-day volume (perp + 2.5× spot)
+             * @example 7500000
+             */
+            weightedVolume14d?: string | null;
+            /**
+             * @description Caller's rolling 14-day spot volume
+             * @example 1000000
+             */
+            spotVolume14d?: string | null;
+            /**
+             * @description Caller's rolling 14-day perp volume
+             * @example 5000000
+             */
+            perpVolume14d?: string | null;
+            /**
+             * @description Additional weighted volume needed to reach the next tier; omitted at tier 6
+             * @example 17500000
+             */
+            volumeToNextTier?: string | null;
+            /**
+             * Format: int32
+             * @description Next tier level when not already at 6
+             * @example 3
+             */
+            nextTierLevel?: number | null;
+            /** @description Six-row fee schedule for the requested pair, ascending by tier */
+            feeSchedule?: components["schemas"]["FeeTierScheduleRow"][] | null;
+        };
         /** @description Latest public open interest for a trading pair. */
         GetOpenInterestResponse: {
             /**
@@ -3703,6 +3795,7 @@ export interface components {
             status?: string | null;
             updatedAt?: string | null;
             riskBucketId?: string | null;
+            marginMode?: string | null;
         };
         GetPositionRiskResponse: {
             positionId?: string | null;
@@ -4305,6 +4398,8 @@ export interface components {
             riskBucketId?: string | null;
             /** @description Present only for risk-bucket summary rows. Values: ISOLATED, CROSS. */
             marginMode?: string | null;
+            /** @description Present for cross risk-bucket summary rows. */
+            selectedTradingPairIds?: string[] | null;
         };
         MatchResult: {
             /**
@@ -4494,6 +4589,7 @@ export interface components {
             status?: string | null;
             updatedAt?: string | null;
             riskBucketId?: string | null;
+            marginMode?: string | null;
         };
         PositionHistoryEvent: {
             id?: string | null;
@@ -4881,6 +4977,12 @@ export interface components {
             marginAccountId?: string | null;
             /** @description Populated when the simulated account is an auto-resolved bucket. */
             strategyKey?: string | null;
+            /** @description Present when the simulation resolved against a risk bucket. */
+            riskBucketId?: string | null;
+            /** @description Present when the simulation resolved against a risk bucket. Values: ISOLATED, CROSS. */
+            marginMode?: string | null;
+            /** @description Present for cross risk-bucket simulations. */
+            selectedTradingPairIds?: string[] | null;
         };
         SimulateParentMarginOrderRiskRequest: {
             /** Format: uuid */
@@ -4904,6 +5006,10 @@ export interface components {
             quantity?: string | null;
             leverage?: string | null;
             reduceOnly?: boolean | null;
+            /** @description Risk bucket mode. Defaults to ISOLATED. Values: ISOLATED, CROSS. */
+            marginMode?: string | null;
+            /** @description Trading pair UUIDs selected into the cross risk bucket. Required when marginMode is CROSS. */
+            selectedTradingPairIds?: string[] | null;
         };
         SubAccount: {
             /**
@@ -5234,6 +5340,12 @@ export interface components {
             newTotalCollateralValue?: string | null;
             newWithdrawableCollateral?: string | null;
             strategyKey?: string | null;
+            /** @description Present when collateral was allocated to a risk bucket. */
+            riskBucketId?: string | null;
+            /** @description Present when collateral was allocated to a risk bucket. Values: ISOLATED, CROSS. */
+            marginMode?: string | null;
+            /** @description Present for cross risk-bucket transfers. */
+            selectedTradingPairIds?: string[] | null;
         };
         TransferCollateralToParentMarginAccountRequest: {
             asset?: string | null;
@@ -5244,10 +5356,15 @@ export interface components {
             amount?: string | null;
             /**
              * Format: uuid
-             * @description Trading pair UUID whose risk bucket receives collateral.
+             * @description Trading pair UUID whose isolated risk bucket receives collateral.
+             *      Required for isolated risk buckets; omitted for cross risk buckets.
              */
             tradingPairId?: string | null;
             strategyKey?: string | null;
+            /** @description Risk bucket mode. Defaults to ISOLATED. Values: ISOLATED, CROSS. */
+            marginMode?: string | null;
+            /** @description Trading pair UUIDs selected into the cross risk bucket. Required when marginMode is CROSS. */
+            selectedTradingPairIds?: string[] | null;
         };
         UpdateLimitRequest: {
             /**
@@ -7013,6 +7130,57 @@ export interface operations {
             };
         };
     };
+    get_my_fee_tier: {
+        parameters: {
+            query?: {
+                /** @description Trading pair identifier (UUID) */
+                tradingPairId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetMyFeeTierResponse"];
+                };
+            };
+            /** @description Bad request (invalid trading pair id) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Trading pair or fee schedule not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     list_margin_accounts: {
         parameters: {
             query?: {

package/package.json

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