@0xmonaco/types 0.8.11 → 0.8.14

package/dist/wire/schema.d.ts

@@ -816,7 +816,71 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/margin/collateral/transfer-in": {
+    "/api/v1/margin/parent-margin-account": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["get_parent_margin_account_summary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/margin/parent-margin-account/collateral/transfer-in": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["transfer_collateral_to_parent_margin_account"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/margin/parent-margin-account/collateral/transfer-out": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["transfer_collateral_from_parent_margin_account"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/margin/parent-margin-account/movements": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["get_parent_margin_account_movements"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/margin/parent-margin-account/simulate-order-risk": {
         parameters: {
             query?: never;
             header?: never;
@@ -825,14 +889,14 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post: operations["transfer_collateral_to_auto_margin_account"];
+        post: operations["simulate_parent_margin_order_risk"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/api/v1/margin/simulate-order-risk": {
+    "/api/v1/margin/risk-buckets/collateral/transfer-in": {
         parameters: {
             query?: never;
             header?: never;
@@ -841,7 +905,23 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post: operations["simulate_auto_margin_order_risk"];
+        post: operations["transfer_collateral_to_risk_bucket"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/margin/risk-buckets/simulate-order-risk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["simulate_risk_bucket_order_risk"];
         delete?: never;
         options?: never;
         head?: never;
@@ -1385,6 +1465,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/positions/batch-close-all": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * @description Close all open positions in a single batch ("panic close").
+         *
+         *      Submits a MARKET reduce-only close for every open position owned by the
+         *      caller, optionally filtered to a single trading pair. Best-effort and
+         *      partial: each position closes independently and per-position failures are
+         *      reported in `results` rather than aborting the batch.
+         */
+        post: operations["batch_close_all_positions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/positions/history": {
         parameters: {
             query?: never;
@@ -1579,9 +1683,10 @@ export interface paths {
          *
          *      Master accounts with the withdraw permission only. Routes through the
          *      matching engine to debit the balance and allocate a `withdrawal_index`,
-         *      then returns the target vault address and the signed
-         *      `executeSignedWithdrawal` calldata the caller submits on-chain. No further
-         *      server-side signing is required.
+         *      then returns it plus the target vault address. The `calldata` field is
+         *      empty: `executeWithdrawal` requires the merkle proof, which only exists
+         *      after the withdrawal's root is confirmed on-chain. Poll GetWithdrawal to
+         *      obtain the calldata once it is ready.
          */
         post: operations["initiate_withdrawal"];
         delete?: never;
@@ -1599,13 +1704,15 @@ export interface paths {
         };
         /**
          * Get withdrawal
-         * @description Re-fetch a withdrawal's signed calldata.
+         * @description Fetch a withdrawal's executable calldata by index.
          *
-         *      Public lookup — no auth. Returns the same response shape as
-         *      InitiateWithdrawal for a previously-initiated `withdrawal_index`. The
-         *      calldata is signed against a fixed (index, metadata, destination, token,
-         *      amount) tuple, so re-fetching it cannot redirect funds: resubmitting it
-         *      on-chain always pays the original destination.
+         *      Public lookup — no auth. Returns the vault address and ABI-encoded
+         *      `executeWithdrawal(...)` calldata for a previously-initiated
+         *      `withdrawal_index`. The calldata is bound to the fixed
+         *      (index, metadata, owner, destination, token, amount) tuple persisted for
+         *      the withdrawal, so re-fetching it cannot redirect funds. Returns 409 while
+         *      the withdrawal's root has not been confirmed on-chain yet (proof not
+         *      available) — clients poll this endpoint until it succeeds.
          */
         get: operations["get_withdrawal"];
         put?: never;
@@ -1688,6 +1795,11 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             asset_id?: string | null;
+            /**
+             * @description Raw total balance (available + locked) in smallest token unit
+             * @example 1050750000
+             */
+            total_balance_raw?: string | null;
         };
         AddPositionMarginRequest: {
             /** @description Collateral asset to move into the isolated bucket. USDC is the current v1 path. */
@@ -2031,6 +2143,60 @@ export interface components {
             cancelled_at?: string | null;
             error?: components["schemas"]["BatchCancelError"];
         };
+        BatchCloseAllRequest: {
+            /**
+             * Format: uuid
+             * @description Optional trading-pair filter. When set, only open positions on this
+             *      trading pair are closed; otherwise every open position is closed.
+             */
+            trading_pair_id?: string | null;
+            /**
+             * Format: int32
+             * @description Optional slippage tolerance (basis points) applied to each MARKET close.
+             */
+            slippage_tolerance_bps?: number | null;
+        };
+        BatchCloseAllResponse: {
+            /**
+             * Format: int32
+             * @description Number of open positions the batch attempted to close.
+             */
+            total_requested?: number | null;
+            /**
+             * Format: int32
+             * @description Number of positions whose close order was accepted by the matching engine
+             *      (SUCCESS, PARTIAL, or PENDING).
+             */
+            total_closed?: number | null;
+            /**
+             * Format: int32
+             * @description Number of positions whose close failed (validation, lookup, or a rejected
+             *      close order).
+             */
+            total_failed?: number | null;
+            results?: components["schemas"]["BatchCloseResult"][] | null;
+        };
+        BatchCloseError: {
+            /**
+             * @description Machine-readable error code (e.g. POSITION_NOT_FOUND, INVALID_REQUEST,
+             *      MATCHING_ENGINE_ERROR).
+             */
+            code?: string | null;
+            /** @description Human-readable error message. */
+            message?: string | null;
+        };
+        BatchCloseResult: {
+            /** @description Position UUID this result is for. */
+            position_id?: string | null;
+            /** @description Close order UUID. Present when the close order was accepted. */
+            close_order_id?: string | null;
+            /** @description Close outcome: SUCCESS, PARTIAL, or PENDING. Present when accepted. */
+            status?: string | null;
+            /** @description Quantity submitted on the close order. Present when accepted. */
+            submitted_quantity?: string | null;
+            /** @description Failure detail. Present when this position could not be closed. */
+            error?: components["schemas"]["BatchCloseError"] | null;
+        };
         BatchCreateError: {
             /**
              * @description Machine-readable error code
@@ -2104,15 +2270,15 @@ export interface components {
             margin_account_id?: string | null;
             /**
              * Format: uuid
-             * @description Existing isolated margin bucket UUID for bucket-scoped margin orders
+             * @description Existing isolated risk bucket UUID for risk-bucket-scoped margin orders
              * @example 123e4567-e89b-12d3-a456-426614174001
              */
-            margin_bucket_id?: string | null;
+            risk_bucket_id?: string | null;
             /**
-             * @description Decimal collateral to allocate into a new isolated margin bucket. When provided, the API creates the bucket ID and matching-engine persists the bucket through the durable log.
+             * @description Decimal collateral to allocate into a new isolated risk bucket. When provided, the API creates the bucket ID and matching-engine persists the bucket through the durable log.
              * @example 1000
              */
-            margin_bucket_collateral?: string | null;
+            risk_bucket_collateral?: string | null;
             /**
              * @description Position side for margin orders: LONG, SHORT, or NONE
              * @example LONG
@@ -2130,7 +2296,7 @@ export interface components {
              */
             reduce_only?: boolean | null;
             /**
-             * @description Strategy key used to group auto-margin buckets for delegated/margin orders
+             * @description Strategy key used to group risk buckets for delegated/margin orders
              * @example my-strategy
              */
             strategy_key?: string | null;
@@ -2531,15 +2697,15 @@ export interface components {
             margin_account_id?: string | null;
             /**
              * Format: uuid
-             * @description Existing isolated margin bucket UUID for bucket-scoped margin orders
+             * @description Existing isolated risk bucket UUID for risk-bucket-scoped margin orders
              * @example 123e4567-e89b-12d3-a456-426614174001
              */
-            margin_bucket_id?: string | null;
+            risk_bucket_id?: string | null;
             /**
-             * @description Decimal collateral to allocate into a new isolated margin bucket. When provided, the API creates the bucket ID and matching-engine persists the bucket through the durable log.
+             * @description Decimal collateral to allocate into a new isolated risk bucket. When provided, the API creates the bucket ID and matching-engine persists the bucket through the durable log.
              * @example 1000
              */
-            margin_bucket_collateral?: string | null;
+            risk_bucket_collateral?: string | null;
             /**
              * @description Position side for margin orders: LONG, SHORT, or NONE
              * @example LONG
@@ -2559,7 +2725,7 @@ export interface components {
             take_profit?: components["schemas"]["ParentTpSlLeg"];
             stop_loss?: components["schemas"]["ParentTpSlLeg"];
             /**
-             * @description Strategy key used to group auto-margin buckets for delegated/margin orders
+             * @description Strategy key used to group risk buckets for delegated/margin orders
              * @example my-strategy
              */
             strategy_key?: string | null;
@@ -2599,9 +2765,9 @@ export interface components {
             margin_account_id?: string | null;
             /**
              * Format: uuid
-             * @description Resolved isolated margin bucket UUID for bucket-scoped margin orders
+             * @description Resolved isolated risk bucket UUID for risk-bucket-scoped margin orders
              */
-            margin_bucket_id?: string | null;
+            risk_bucket_id?: string | null;
             /** @description Client strategy key carried for compatibility */
             strategy_key?: string | null;
             /**
@@ -2865,6 +3031,11 @@ export interface components {
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             asset_id?: string | null;
+            /**
+             * @description Raw total balance (available + locked) in smallest token unit
+             * @example 1050750000
+             */
+            total_balance_raw?: string | null;
         };
         GetBalancesResponse: {
             balances?: components["schemas"]["AccountBalance"][] | null;
@@ -2966,7 +3137,7 @@ export interface components {
             /** Format: uuid */
             trading_pair_id?: string | null;
             strategy_key?: string | null;
-            margin_bucket_id?: string | null;
+            risk_bucket_id?: string | null;
             margin_mode?: string | null;
         };
         GetMarkPriceResponse: {
@@ -3521,7 +3692,7 @@ export interface components {
             liquidation_price?: string | null;
             status?: string | null;
             updated_at?: string | null;
-            margin_bucket_id?: string | null;
+            risk_bucket_id?: string | null;
         };
         GetPositionRiskResponse: {
             position_id?: string | null;
@@ -3687,6 +3858,11 @@ export interface components {
             amount?: string | null;
             /** @description On-chain address that will receive the withdrawal (EVM, 42 chars including 0x) */
             destination?: string | null;
+            /**
+             * @description Source ledger to withdraw from: "spot" (default) debits spot balance; "margin" directly debits withdrawable collateral from the parent margin account
+             * @example spot
+             */
+            source?: string | null;
         };
         LedgerMovement: {
             /**
@@ -4089,7 +4265,7 @@ export interface components {
             trading_pair_id?: string | null;
             strategy_key?: string | null;
             /** @description Present only for risk-bucket summary rows. */
-            margin_bucket_id?: string | null;
+            risk_bucket_id?: string | null;
             /** @description Present only for risk-bucket summary rows. Values: ISOLATED, CROSS. */
             margin_mode?: string | null;
         };
@@ -4243,7 +4419,7 @@ export interface components {
             liquidation_price?: string | null;
             status?: string | null;
             updated_at?: string | null;
-            margin_bucket_id?: string | null;
+            risk_bucket_id?: string | null;
         };
         PositionHistoryEvent: {
             id?: string | null;
@@ -4488,7 +4664,7 @@ export interface components {
             /** @description Up to 7 UTC-day buckets (oldest first); empty when <1 day of history */
             snapshot_7d?: components["schemas"]["ScreenerSnapshotPoint"][] | null;
             /**
-             * @description Asset-class category: crypto, equities, or commodities
+             * @description Asset-class category: crypto, equities, commodities, or fx
              * @example crypto
              */
             category?: string | null;
@@ -4521,18 +4697,6 @@ export interface components {
              */
             price_change_percent?: string | null;
         };
-        SimulateAutoMarginOrderRiskRequest: {
-            /** Format: uuid */
-            trading_pair_id?: string | null;
-            strategy_key?: string | null;
-            side?: string | null;
-            position_side?: string | null;
-            order_type?: string | null;
-            price?: string | null;
-            quantity?: string | null;
-            leverage?: string | null;
-            reduce_only?: boolean | null;
-        };
         SimulateFeesResponse: {
             /**
              * @description Notional value (price x quantity)
@@ -4644,6 +4808,29 @@ export interface components {
             /** @description Populated when the simulated account is an auto-resolved bucket. */
             strategy_key?: string | null;
         };
+        SimulateParentMarginOrderRiskRequest: {
+            /** Format: uuid */
+            trading_pair_id?: string | null;
+            side?: string | null;
+            position_side?: string | null;
+            order_type?: string | null;
+            price?: string | null;
+            quantity?: string | null;
+            leverage?: string | null;
+            reduce_only?: boolean | null;
+        };
+        SimulateRiskBucketOrderRiskRequest: {
+            /** Format: uuid */
+            trading_pair_id?: string | null;
+            strategy_key?: string | null;
+            side?: string | null;
+            position_side?: string | null;
+            order_type?: string | null;
+            price?: string | null;
+            quantity?: string | null;
+            leverage?: string | null;
+            reduce_only?: boolean | null;
+        };
         SubAccount: {
             /**
              * Format: uuid
@@ -4913,24 +5100,24 @@ export interface components {
              */
             max_leverage?: string | null;
             /**
-             * @description Asset-class category: crypto, equities, or commodities
+             * @description Asset-class category: crypto, equities, commodities, or fx
              * @example crypto
              */
             category?: string | null;
         };
         TransferCollateralFromMarginAccountRequest: {
-            /** @description Margin account UUID whose current isolated bucket releases collateral. */
+            /** @description Parent margin account UUID that releases collateral. */
             margin_account_id?: string | null;
             asset?: string | null;
             amount?: string | null;
             /**
              * Format: uuid
-             * @description Optional trading pair UUID used to scope the transfer to an isolated bucket
-             *      under the parent margin account. If omitted, the transfer applies to the
-             *      parent account or active cross-margin bucket.
+             * @description Optional trading pair UUID used to release collateral from an isolated risk
+             *      bucket under the parent margin account. If omitted, the transfer applies to
+             *      the parent margin account only.
              */
             trading_pair_id?: string | null;
-            /** @description Optional strategy key echoed in responses when callers scope an auto bucket. */
+            /** @description Optional strategy key echoed in responses when callers scope a risk bucket. */
             strategy_key?: string | null;
         };
         TransferCollateralFromMarginAccountResponse: {
@@ -4944,26 +5131,23 @@ export interface components {
             new_withdrawable_collateral?: string | null;
             strategy_key?: string | null;
         };
-        TransferCollateralToAutoMarginAccountRequest: {
+        TransferCollateralFromParentMarginAccountRequest: {
             asset?: string | null;
             amount?: string | null;
-            /** Format: uuid */
-            trading_pair_id?: string | null;
-            strategy_key?: string | null;
         };
         TransferCollateralToMarginAccountRequest: {
-            /** @description Margin account UUID whose current isolated bucket receives collateral. */
+            /** @description Parent margin account UUID that receives collateral. */
             margin_account_id?: string | null;
             asset?: string | null;
             amount?: string | null;
             /**
              * Format: uuid
-             * @description Optional trading pair UUID used to scope the transfer to an isolated bucket
-             *      under the parent margin account. If omitted, the transfer applies to the
-             *      parent account or active cross-margin bucket.
+             * @description Optional trading pair UUID used to allocate collateral to an isolated risk
+             *      bucket under the parent margin account. If omitted, the transfer applies to
+             *      the parent margin account only.
              */
             trading_pair_id?: string | null;
-            /** @description Optional strategy key echoed in responses when callers scope an auto bucket. */
+            /** @description Optional strategy key echoed in responses when callers scope a risk bucket. */
             strategy_key?: string | null;
         };
         TransferCollateralToMarginAccountResponse: {
@@ -4977,6 +5161,20 @@ export interface components {
             new_withdrawable_collateral?: string | null;
             strategy_key?: string | null;
         };
+        TransferCollateralToParentMarginAccountRequest: {
+            asset?: string | null;
+            amount?: string | null;
+        };
+        TransferCollateralToRiskBucketRequest: {
+            asset?: string | null;
+            amount?: string | null;
+            /**
+             * Format: uuid
+             * @description Trading pair UUID whose risk bucket receives collateral.
+             */
+            trading_pair_id?: string | null;
+            strategy_key?: string | null;
+        };
         UpdateLimitRequest: {
             /**
              * Format: uuid
@@ -5140,11 +5338,11 @@ export interface components {
             user?: components["schemas"]["UserInfo"];
         };
         Withdrawal: {
-            /** @description Allocated withdrawal index — matches executeSignedWithdrawal.index on-chain */
+            /** @description Allocated withdrawal index — matches executeWithdrawal.index on-chain */
             withdrawal_index?: string | null;
             /** @description 0x-prefixed lowercase address of the vault contract the calldata is submitted to */
             vault_address?: string | null;
-            /** @description 0x-prefixed ABI-encoded, signed executeSignedWithdrawal(...) calldata; submit as tx.data to the vault */
+            /** @description 0x-prefixed ABI-encoded executeWithdrawal(...) calldata; submit as tx.data to the vault. Empty on InitiateWithdrawal (the merkle proof is not available until the withdrawal root is confirmed on-chain) — fetch it from GetWithdrawal once ready */
             calldata?: string | null;
         };
     };
@@ -6800,7 +6998,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Margin account UUID whose current isolated bucket receives collateral. */
+                /** @description Parent margin account UUID that receives collateral. */
                 margin_account_id: string;
             };
             cookie?: never;
@@ -6827,7 +7025,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Margin account UUID whose current isolated bucket releases collateral. */
+                /** @description Parent margin account UUID that releases collateral. */
                 margin_account_id: string;
             };
             cookie?: never;
@@ -6927,7 +7125,30 @@ export interface operations {
             };
         };
     };
-    transfer_collateral_to_auto_margin_account: {
+    get_parent_margin_account_summary: {
+        parameters: {
+            query?: {
+                /** @description Trading pair identifier (UUID) */
+                trading_pair_id?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetMarginAccountSummaryResponse"];
+                };
+            };
+        };
+    };
+    transfer_collateral_to_parent_margin_account: {
         parameters: {
             query?: never;
             header?: never;
@@ -6936,7 +7157,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["TransferCollateralToAutoMarginAccountRequest"];
+                "application/json": components["schemas"]["TransferCollateralToParentMarginAccountRequest"];
             };
         };
         responses: {
@@ -6951,7 +7172,7 @@ export interface operations {
             };
         };
     };
-    simulate_auto_margin_order_risk: {
+    transfer_collateral_from_parent_margin_account: {
         parameters: {
             query?: never;
             header?: never;
@@ -6960,7 +7181,105 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["SimulateAutoMarginOrderRiskRequest"];
+                "application/json": components["schemas"]["TransferCollateralFromParentMarginAccountRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransferCollateralFromMarginAccountResponse"];
+                };
+            };
+        };
+    };
+    get_parent_margin_account_movements: {
+        parameters: {
+            query?: {
+                movement_type?: string;
+                /** @description Page number (1-indexed) */
+                page?: number;
+                /** @description Items per page (max 100) */
+                page_size?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetMarginAccountMovementsResponse"];
+                };
+            };
+        };
+    };
+    simulate_parent_margin_order_risk: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SimulateParentMarginOrderRiskRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SimulateOrderRiskResponse"];
+                };
+            };
+        };
+    };
+    transfer_collateral_to_risk_bucket: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TransferCollateralToRiskBucketRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TransferCollateralToMarginAccountResponse"];
+                };
+            };
+        };
+    };
+    simulate_risk_bucket_order_risk: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SimulateRiskBucketOrderRiskRequest"];
             };
         };
         responses: {
@@ -8013,6 +8332,30 @@ export interface operations {
             };
         };
     };
+    batch_close_all_positions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchCloseAllRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BatchCloseAllResponse"];
+                };
+            };
+        };
+    };
     list_position_history: {
         parameters: {
             query?: {
@@ -8414,13 +8757,20 @@ export interface operations {
                     "application/json": components["schemas"]["Withdrawal"];
                 };
             };
-            /** @description Withdrawal not found */
+            /** @description Withdrawal not found (may not be persisted yet) */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
+            /** @description Withdrawal not confirmed on-chain yet; retry shortly */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description Internal server error */
             500: {
                 headers: {