@0xmonaco/types 1.1.5 → 1.1.6

package/dist/buildercodes/responses.js

@@ -5,6 +5,7 @@
  * All types are derived from Zod schemas for runtime validation.
  */
 import { z } from "zod";
+import { OrderIdempotencyKeySchema } from "../validation/trading";
 /** Schema for this frontend's current BuilderCodes program state. */
 export const GetBuildercodesConfigResponseSchema = z.object({
     applicationId: z.string().uuid(),
@@ -189,6 +190,15 @@ export const ClaimBuildercodeRewardsParamsSchema = z.object({
         .trim()
         .min(1, "amount is required")
         .refine((v) => /^\d+$/.test(v) && BigInt(v) > 0n, "amount must be a positive integer string"),
+    /**
+     * Optional submission identity, shared with order create (1-64 characters
+     * from `[A-Za-z0-9._:-]`). Retrying the same key and claim within 15 minutes
+     * of the original acceptance returns the original claim's result without
+     * moving money again; the same key with a different claim is refused with
+     * `IDEMPOTENCY_KEY_CONFLICT` (409). Generate a fresh key for each intended
+     * claim and keep it across retries of that claim.
+     */
+    idempotencyKey: OrderIdempotencyKeySchema.optional(),
 });
 /** Schema for the claim-BuilderCodes-rewards response. */
 export const ClaimBuildercodeRewardsResponseSchema = z.object({

package/dist/index.d.ts

@@ -4,6 +4,7 @@
  * This package provides TypeScript types for the Monaco protocol.
  * It includes SDK types, vault types, trading types, contract types, and common types.
  */
+export * from "./analytics";
 export * from "./api";
 export * from "./applications";
 export * from "./auth";

package/dist/index.js

@@ -5,6 +5,7 @@
  * It includes SDK types, vault types, trading types, contract types, and common types.
  */
 // Export everything from all modules
+export * from "./analytics";
 export * from "./api";
 export * from "./applications";
 export * from "./auth";

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

@@ -223,6 +223,7 @@ export interface TransferCollateralRequest {
     asset: string;
     amount: string;
     tradingPairId?: string;
+    /** Names the margin account by its sub-account key, like `marginAccountId` (`default` is the default account). */
     strategyKey?: string;
     /**
      * Risk bucket mode. Defaults to ISOLATED, which is selected by
@@ -263,6 +264,7 @@ export interface TransferCollateralToIsolatedRiskBucketRequest extends TransferC
     /** The margin account whose bucket is funded: omit for the default account, or name an open sub-account. */
     marginAccountId?: string;
     tradingPairId: string;
+    /** Names the margin account by its sub-account key, like `marginAccountId` (`default` is the default account). */
     strategyKey?: string;
     selectedTradingPairIds?: never;
     /**
@@ -303,7 +305,8 @@ export interface TransferCollateralToCrossRiskBucketRequest extends TransferColl
      */
     selectedTradingPairIds?: never;
     tradingPairId?: never;
-    strategyKey?: never;
+    /** Names the margin account by its sub-account key, like `marginAccountId` (`default` is the default account). */
+    strategyKey?: string;
     /** Cross risk is pooled at bucket equity — there is no per-position margin; an explicit `true` is rejected. */
     applyToPositionMargin?: never;
 }
@@ -424,6 +427,7 @@ export type SimulateIsolatedRiskBucketOrderRiskRequest = SimulateOrderRiskReques
     marginMode?: "ISOLATED";
     /** The margin account previewed: omit for the default account, or name an open sub-account. */
     marginAccountId?: string;
+    /** Names the margin account by its sub-account key, like `marginAccountId` (`default` is the default account). */
     strategyKey?: string;
     selectedTradingPairIds?: never;
 };
@@ -446,7 +450,8 @@ export type SimulateCrossRiskBucketOrderRiskRequest = SimulateOrderRiskRequest &
      * compile time that it does nothing.
      */
     selectedTradingPairIds?: never;
-    strategyKey?: never;
+    /** Names the margin account by its sub-account key, like `marginAccountId` (`default` is the default account). */
+    strategyKey?: string;
 };
 export type SimulateRiskBucketOrderRiskRequest = SimulateIsolatedRiskBucketOrderRiskRequest | SimulateCrossRiskBucketOrderRiskRequest;
 export interface SimulateOrderRiskResponse {

package/dist/market/index.d.ts

@@ -54,26 +54,6 @@ export interface TradingPair {
      * `CROSS_MARGIN_NOT_ALLOWED`; open the position with `marginMode: "ISOLATED"`.
      */
     isolatedOnly: boolean;
-    /**
-     * Flat pair-level maker fee in basis points (negative = rebate).
-     *
-     * @deprecated Not the rate an order is charged: fees are tiered per account.
-     * Use `fees.getFeeSchedule(tradingPairId)` for the pair's tier schedule,
-     * `fees.getMyFeeTier({ tradingPairId })` for your own rate, and
-     * `placementMakerFeeBps` on an order for the rate it was placed at. This
-     * field will be removed in a later release.
-     */
-    makerFeeBps: number;
-    /**
-     * Flat pair-level taker fee in basis points.
-     *
-     * @deprecated Not the rate an order is charged: fees are tiered per account.
-     * Use `fees.getFeeSchedule(tradingPairId)` for the pair's tier schedule,
-     * `fees.getMyFeeTier({ tradingPairId })` for your own rate, and
-     * `placementTakerFeeBps` on an order for the rate it was placed at. This
-     * field will be removed in a later release.
-     */
-    takerFeeBps: number;
     /** Minimum order size */
     minOrderSize: string;
     /** Maximum order size */

package/dist/profile/index.d.ts

@@ -326,6 +326,16 @@ export interface UserTrade {
     liquidityRole: "MAKER" | "TAKER";
     /** Timestamp when the trade was executed (RFC 3339). Absent when none is recorded. */
     executedAt?: string;
+    /**
+     * The RFQ (block trade) this user's own order filled in. Absent on an
+     * order-book fill. Read the RFQ with `rfq.getRfq`.
+     */
+    rfqId?: string;
+    /**
+     * Set on a maker's RFQ fill only: the internal engine id of the quote
+     * version the maker's order rested for. Not the public `quoteId`.
+     */
+    rfqQuoteId?: string;
 }
 /**
  * Query parameters for getting user trades
@@ -602,23 +612,6 @@ export interface UserProfile {
     accountType: string;
     /** Whether the user can withdraw funds */
     canWithdraw: boolean;
-    /**
-     * Flat taker fee in basis points, echoed from a trading pair.
-     *
-     * @deprecated Not the rate you are charged: fees are tiered per account. Use
-     * `fees.getMyFeeTier({ tradingPairId })` for your own rate. This field will
-     * be removed in a later release.
-     */
-    takerFeeBps: number;
-    /**
-     * Flat maker fee in basis points (negative = rebate), echoed from a trading
-     * pair.
-     *
-     * @deprecated Not the rate you are charged: fees are tiered per account. Use
-     * `fees.getMyFeeTier({ tradingPairId })` for your own rate. This field will
-     * be removed in a later release.
-     */
-    makerFeeBps: number;
     /** Account creation timestamp (ISO string) */
     createdAt: string;
     /** Additional taker fee in basis points contributed by the application (if any) */

package/dist/rfq/responses.d.ts

@@ -37,6 +37,10 @@ export declare const RfqRequestTermsSchema: z.ZodObject<{
 export declare const RfqSideViewSchema: z.ZodObject<{
     vwap: z.ZodString;
     availableQuantity: z.ZodString;
+    grossVwap: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    estimatedMonacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    estimatedBuilderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    estimatedTotalFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 /** The taker's current view of the quotes. */
 export declare const RfqViewSchema: z.ZodObject<{
@@ -44,12 +48,22 @@ export declare const RfqViewSchema: z.ZodObject<{
     bid: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         vwap: z.ZodString;
         availableQuantity: z.ZodString;
+        grossVwap: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        estimatedMonacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        estimatedBuilderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        estimatedTotalFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     ask: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         vwap: z.ZodString;
         availableQuantity: z.ZodString;
+        grossVwap: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        estimatedMonacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        estimatedBuilderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        estimatedTotalFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     asOfMs: z.ZodNumber;
+    monacoFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    builderFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 /** One fill of an executed RFQ. */
 export declare const RfqFillSchema: z.ZodObject<{
@@ -57,6 +71,8 @@ export declare const RfqFillSchema: z.ZodObject<{
     price: z.ZodString;
     quantity: z.ZodString;
     fee: z.ZodString;
+    monacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    builderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 /** What an accepted RFQ executed. */
 export declare const RfqOutcomeSchema: z.ZodObject<{
@@ -68,6 +84,8 @@ export declare const RfqOutcomeSchema: z.ZodObject<{
         price: z.ZodString;
         quantity: z.ZodString;
         fee: z.ZodString;
+        monacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        builderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /** A quoted side the venue refused; nothing is reserved for it. */
@@ -111,6 +129,9 @@ export declare const RfqMakerSelectionSchema: z.ZodObject<{
         capacity: z.ZodString;
     }, z.core.$strip>>>;
     lastLookDeadlineAtMs: z.ZodNumber;
+    monacoFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    maxBuilderFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    estimatedNet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 /**
  * Authoritative RFQ status. A taker sees `view` and `outcome`; a maker sees
@@ -138,12 +159,22 @@ export declare const RfqStatusSchema: z.ZodObject<{
         bid: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             vwap: z.ZodString;
             availableQuantity: z.ZodString;
+            grossVwap: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            estimatedMonacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            estimatedBuilderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            estimatedTotalFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
         ask: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             vwap: z.ZodString;
             availableQuantity: z.ZodString;
+            grossVwap: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            estimatedMonacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            estimatedBuilderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            estimatedTotalFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
         asOfMs: z.ZodNumber;
+        monacoFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        builderFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>>>;
     ownQuote: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         rfqId: z.ZodString;
@@ -178,6 +209,9 @@ export declare const RfqStatusSchema: z.ZodObject<{
             capacity: z.ZodString;
         }, z.core.$strip>>>;
         lastLookDeadlineAtMs: z.ZodNumber;
+        monacoFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxBuilderFeeCbps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        estimatedNet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     ownLatestVersion: z.ZodNumber;
     ownQuoteWithdrawn: z.ZodBoolean;
@@ -190,6 +224,8 @@ export declare const RfqStatusSchema: z.ZodObject<{
             price: z.ZodString;
             quantity: z.ZodString;
             fee: z.ZodString;
+            monacoFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            builderFee: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
     durableSequence: z.ZodNumber;

package/dist/rfq/responses.js

@@ -51,6 +51,14 @@ export const RfqSideViewSchema = z.object({
     /** All-in volume-weighted price, fees included. */
     vwap: z.string(),
     availableQuantity: z.string(),
+    /** The volume-weighted price before fees. */
+    grossVwap: z.string().nullish(),
+    /** Estimated Monaco taker fee on availableQuantity, in the quote asset. */
+    estimatedMonacoFee: z.string().nullish(),
+    /** Estimated builder fee on availableQuantity, in the quote asset. */
+    estimatedBuilderFee: z.string().nullish(),
+    /** Estimated total taker fee on availableQuantity, in the quote asset. */
+    estimatedTotalFee: z.string().nullish(),
 });
 /** The taker's current view of the quotes. */
 export const RfqViewSchema = z.object({
@@ -59,13 +67,20 @@ export const RfqViewSchema = z.object({
     bid: RfqSideViewSchema.nullish(),
     ask: RfqSideViewSchema.nullish(),
     asOfMs: z.number(),
+    /** The taker's Monaco fee rate in this view, in centi-bps. */
+    monacoFeeCbps: z.number().nullish(),
+    /** The taker's builder fee rate in this view, in centi-bps. */
+    builderFeeCbps: z.number().nullish(),
 });
 /** One fill of an executed RFQ. */
 export const RfqFillSchema = z.object({
     executionId: z.string(),
     price: z.string(),
     quantity: z.string(),
+    /** The taker's whole fee on this fill: monacoFee plus builderFee. */
     fee: z.string(),
+    monacoFee: z.string().nullish(),
+    builderFee: z.string().nullish(),
 });
 /** What an accepted RFQ executed. */
 export const RfqOutcomeSchema = z.object({
@@ -111,6 +126,20 @@ export const RfqMakerSelectionSchema = z.object({
     quantity: z.string(),
     frozenTerms: RfqQuoteTermsResponseSchema.nullish(),
     lastLookDeadlineAtMs: z.number(),
+    /** Your Monaco maker fee rate in centi-bps, frozen at acceptance; negative for a rebate. */
+    monacoFeeCbps: z.number().nullish(),
+    /**
+     * The MOST your frontend's builder add-on charges on this fill, in centi-bps:
+     * the rate stored on your quote order. A fill charges it or nothing, never
+     * more; an IMPROVE re-places the quote at the rate configured then.
+     */
+    maxBuilderFeeCbps: z.number().nullish(),
+    /**
+     * Estimated net at the selected quantity and frozen price, in the quote
+     * asset, at monacoFeeCbps plus the maximum add-on: the least you receive
+     * when selling, the most you pay when buying.
+     */
+    estimatedNet: z.string().nullish(),
 });
 /**
  * Authoritative RFQ status. A taker sees `view` and `outcome`; a maker sees

package/dist/sdk/index.d.ts

@@ -1,4 +1,5 @@
 import type { Address, PublicClient, TransactionReceipt, WalletClient } from "viem";
+import type { AnalyticsAPI } from "../analytics";
 import type { ApplicationsAPI } from "../applications";
 import type { AuthAPI, AuthState } from "../auth/index";
 import type { BuildercodesAPI } from "../buildercodes";
@@ -134,10 +135,12 @@ export interface MonacoSDK {
     pulse: PulseAPI;
     /** Public region status API: whether Monaco is available in the caller's region */
     compliance: ComplianceAPI;
+    /** Public explorer analytics API: protocol totals and series, market volume, treasury net fees */
+    analytics: AnalyticsAPI;
     /** Orderbook REST API for fetching orderbook snapshots */
     orderbook: {
         getOrderbook: (tradingPairId: string, options?: {
-            /** Number of price levels to return (max 100). Defaults to 10. */
+            /** Number of price levels per side (max 1000). Defaults to 10. Above 100 the snapshot comes from the market-data book and carries `bookSeq`. */
             depth?: number;
             /** Trading mode: 'Spot' or 'Margin'. Defaults to 'Spot'. */
             tradingMode?: TradingMode;

package/dist/trading/index.d.ts

@@ -20,7 +20,7 @@ export interface TradingAPI extends BaseAPI {
      * @param quantity - Order quantity as string
      * @param price - Order price as string
      * @param options - Optional parameters for the limit order
-     * @param options.tradingMode - Trading mode (e.g., "SPOT")
+     * @param options.tradingMode - Trading mode ("SPOT" or "MARGIN"). Omit it to use the trading pair market type.
      * @param options.timeInForce - Time in force ("GTC", "IOC", or "FOK")
      * @returns Promise resolving to the order result
      */
@@ -42,6 +42,7 @@ export interface TradingAPI extends BaseAPI {
         riskBucketId?: string;
         /** Initial order budget; unfilled funds do not back the isolated position. */
         riskBucketCollateral?: string;
+        /** Names the margin account by its sub-account key, like `marginAccountId` (`default` is the default account). */
         strategyKey?: string;
         /** @deprecated Order side is authoritative. */
         positionSide?: PositionSide;
@@ -84,7 +85,7 @@ export interface TradingAPI extends BaseAPI {
      * @param side - Order side ("BUY" or "SELL")
      * @param quantity - Order quantity as string
      * @param options - Optional parameters for the market order
-     * @param options.tradingMode - Trading mode (e.g., "SPOT")
+     * @param options.tradingMode - Trading mode ("SPOT" or "MARGIN"). Omit it to use the trading pair market type.
      * @param options.slippageTolerance - Slippage tolerance as decimal (e.g., 0.01 for 1%, 0 for best price only, undefined for unlimited slippage)
      * @returns Promise resolving to the order result
      */
@@ -104,6 +105,7 @@ export interface TradingAPI extends BaseAPI {
         riskBucketId?: string;
         /** Initial order budget; unfilled funds do not back the isolated position. */
         riskBucketCollateral?: string;
+        /** Names the margin account by its sub-account key, like `marginAccountId` (`default` is the default account). */
         strategyKey?: string;
         /** @deprecated Order side is authoritative. */
         positionSide?: PositionSide;
@@ -154,7 +156,9 @@ export interface TradingAPI extends BaseAPI {
      */
     listConditionalOrders(params?: ListConditionalOrdersParams): Promise<ListConditionalOrdersResponse>;
     /**
-     * Batch cancels specific orders by their IDs.
+     * Batch cancels specific orders by their IDs. Every ID gets one result, in
+     * request order; an ID that is not one of your live orders fails with
+     * `ORDER_NOT_FOUND`.
      * @param orderIds - Array of order IDs to cancel
      * @returns Promise resolving to the batch cancellation result
      */

package/dist/trading/orders.d.ts

@@ -164,6 +164,17 @@ export interface Order {
      * Wire: `placementMakerFeeBps`.
      */
     placementMakerFeeBps?: string;
+    /**
+     * The RFQ (block trade) this order belongs to; set on RFQ orders only
+     * (`origin` `RFQ`). Read the RFQ with `rfq.getRfq`. Wire: `rfqId`.
+     */
+    rfqId?: string;
+    /**
+     * Set on a maker's RFQ quote order only: the internal engine id of the quote
+     * version the order rested for. Not the public `quoteId`; the taker's order,
+     * which fills from several quotes, carries none. Wire: `rfqQuoteId`.
+     */
+    rfqQuoteId?: string;
     /**
      * Opaque, compare-only revision counter for this order's state: a strictly
      * higher value is strictly newer state for that order, and equal values

package/dist/trading/responses.d.ts

@@ -284,7 +284,13 @@ export interface BatchCancelResult {
     error?: BatchCancelError;
 }
 /**
- * Response from batch cancelling orders
+ * Response from batch cancelling orders.
+ *
+ * For `batchCancel`, `results` holds one entry per requested ID, in request
+ * order (a repeated ID is answered at each occurrence), and
+ * `totalRequested === totalCancelled + totalFailed === results.length`. An ID
+ * that is not one of your live orders (unknown, another user's, or already
+ * terminal) is a failed entry with code `ORDER_NOT_FOUND`.
  */
 export interface BatchCancelOrdersResponse {
     /** Total number of orders requested to cancel */
@@ -371,7 +377,7 @@ export interface BatchCreateOrderParams {
     price?: string;
     /** Order quantity */
     quantity: string;
-    /** Trading mode (defaults to "SPOT") */
+    /** Trading mode: "SPOT" or "MARGIN". Omit it to use the trading pair market type. */
     tradingMode?: TradingMode;
     /** Maximum slippage for market orders as decimal (e.g., 0.01 for 1%) */
     slippageTolerance?: number;
@@ -684,7 +690,7 @@ export interface CreateTwapOrderOptions {
     executionStyle?: "TAKER" | "PASSIVE";
     /** Whether the TWAP parent is reduce-only (margin only). Child orders inherit it and clamp to the live position. */
     reduceOnly?: boolean;
-    /** Trading mode: "SPOT" or "MARGIN" (default: "SPOT"). */
+    /** Trading mode: "SPOT" or "MARGIN". Omit it to use the trading pair market type; a mode that does not match the pair is rejected. */
     tradingMode?: TradingMode;
     /** Margin account UUID for margin TWAP orders. Resolved once at creation and reused by every child order. */
     marginAccountId?: string;

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

@@ -64,7 +64,7 @@ export declare const TransferCollateralToRiskBucketSchema: z.ZodObject<{
         marginMode: z.ZodLiteral<"CROSS">;
         marginAccountId: z.ZodOptional<z.ZodUUID>;
         selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
-        strategyKey: z.ZodOptional<z.ZodNever>;
+        strategyKey: z.ZodOptional<z.ZodString>;
         tradingPairId: z.ZodOptional<z.ZodNever>;
     }, z.core.$strict>]>>;
 }, z.core.$strip>;
@@ -171,7 +171,7 @@ export declare const SimulateRiskBucketOrderRiskSchema: z.ZodObject<{
         marginMode: z.ZodLiteral<"CROSS">;
         marginAccountId: z.ZodOptional<z.ZodUUID>;
         selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
-        strategyKey: z.ZodOptional<z.ZodNever>;
+        strategyKey: z.ZodOptional<z.ZodString>;
         tradingPairId: z.ZodUUID;
         side: z.ZodEnum<{
             BUY: "BUY";

package/dist/validation/margin-accounts.js

@@ -2,7 +2,7 @@
  * Margin Account API Validation Schemas
  */
 import { z } from "zod";
-import { MarketSlippageToleranceBpsSchema, OrderIdempotencyKeySchema, OrderSideSchema, OrderTypeSchema, PositionSideSchema, PositiveDecimalStringSchema, UUIDSchema, } from "./trading";
+import { MarketSlippageToleranceBpsSchema, OrderIdempotencyKeySchema, OrderSideSchema, OrderTypeSchema, PositionSideSchema, PositiveDecimalStringSchema, StrategyKeySchema, UUIDSchema, } from "./trading";
 const CursorPaginationSchema = z.object({
     /**
      * Rejected, not ignored. A non-strict object would let a JS or `any` caller
@@ -37,7 +37,7 @@ const TransferCollateralRequestSchema = z
     asset: z.string().trim().min(1, "Asset cannot be empty"),
     amount: PositiveDecimalStringSchema,
     tradingPairId: UUIDSchema.optional(),
-    strategyKey: z.string().trim().min(1, "Strategy key cannot be empty").optional(),
+    strategyKey: StrategyKeySchema.optional(),
     // A cross risk bucket has no trading pair, so CROSS is the only way to name
     // one on the way out (0XM-2420). The two never combine.
     marginMode: z.enum(["ISOLATED", "CROSS"]).optional(),
@@ -54,7 +54,7 @@ const ParentMarginAccountCollateralRequestSchema = z.object({
 });
 const RiskBucketRequestSchema = z.object({
     tradingPairId: UUIDSchema,
-    strategyKey: z.string().trim().min(1, "Strategy key cannot be empty").optional(),
+    strategyKey: StrategyKeySchema.optional(),
 });
 const IsolatedRiskBucketRequestSchema = RiskBucketRequestSchema.extend({
     marginMode: z.literal("ISOLATED").optional(),
@@ -78,7 +78,7 @@ const CrossRiskBucketSimulateRequestSchema = z.object({
     marginMode: z.literal("CROSS"),
     marginAccountId: UUIDSchema.optional(),
     selectedTradingPairIds: z.never().optional(),
-    strategyKey: z.never().optional(),
+    strategyKey: StrategyKeySchema.optional(),
 });
 // A cross transfer-in names no pairs. Cross scope is derived from trading, so
 // funding has nothing to declare; `selectedTradingPairIds` used to REPLACE the
@@ -89,7 +89,7 @@ const CrossRiskBucketRequestSchema = z.object({
     marginMode: z.literal("CROSS"),
     marginAccountId: UUIDSchema.optional(),
     selectedTradingPairIds: z.never().optional(),
-    strategyKey: z.never().optional(),
+    strategyKey: StrategyKeySchema.optional(),
     tradingPairId: z.never().optional(),
 });
 export const TransferCollateralSchema = z.object({

package/dist/validation/trading.d.ts

@@ -126,6 +126,21 @@ export declare const ParentTrailingStopLegSchema: z.ZodObject<{
     slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
     expiresAt: z.ZodOptional<z.ZodISODateTime>;
 }, z.core.$strip>;
+/**
+ * An order's `strategyKey` names one of the caller's margin accounts by its
+ * sub-account key (`default` is the default margin account), as
+ * `marginAccountId` names it by id; a copy trading account's `copy:` key names
+ * it too, for the reduce-only close a copy account admits. The server refuses
+ * a key outside the sub-account key alphabet and a key naming none of the
+ * caller's open sub-accounts.
+ */
+export declare const OrderStrategyKeySchema: z.ZodString;
+/**
+ * A risk-bucket transfer's or preview's `strategyKey`: the order rule, and a
+ * reserved `copy:` key is refused (a copy account's risk buckets are funded
+ * by its follow only).
+ */
+export declare const StrategyKeySchema: z.ZodString;
 /**
  * Place Limit Order validation schema
  */