@0xmonaco/types 1.0.70 → 1.0.73

package/dist/wire/schema.d.ts

@@ -621,9 +621,11 @@ export interface paths {
          * Refresh session expiry
          * @description Refresh session expiry.
          *
-         *      Extends the expiration of the current session. The request must be signed
+         *      Refreshes the expiration of the current session. The request must be signed
          *      by the session private key (RFC 9421 or legacy X-Monaco-* headers); no body is
-         *      required.
+         *      required. Delegated sessions require an active, unexpired delegation;
+         *      their resulting expiry is capped by the delegation expiry and may move
+         *      earlier if the owner shortened that delegation.
          */
         post: operations["refresh_session"];
         delete?: never;
@@ -704,6 +706,74 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/buildercodes/builder-fee": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Set your builder fee
+         * @description Set this application's builder fee.
+         *
+         *      The builder fee is an additional taker fee, in basis points, that this
+         *      frontend charges its own users on top of Monaco's fee. The application is
+         *      taken from the authenticated session; the caller must be the application's
+         *      BuilderCodes payout wallet, and delegated-agent sessions are refused.
+         *
+         *      `bps` must be between 0 and the current builder-fee cap
+         *      (`builderFeeCapBps` on `GetBuildercodesConfig`) inclusive. The application
+         *      must be enrolled in BuilderCodes with a payout address. At most two changes
+         *      are allowed in any rolling 24 hours; changes Monaco makes on the
+         *      application's behalf do not count. Setting the fee it already has is a
+         *      no-op that succeeds and does not use up a change.
+         *
+         *      The fee can be set while builder fees are switched off
+         *      (`builderFeeEnabled` false): it is stored and nothing is charged until they
+         *      are switched on. Once charged, a new fee applies to orders placed after the
+         *      change within a few seconds; resting orders keep the fee they were placed
+         *      with.
+         *
+         *      A refused change is **HTTP 409** / **FAILED_PRECONDITION** when the
+         *      application is not enrolled with a payout address or has no changes left
+         *      (REST adds `details.nextChangeAllowedAt`), and **HTTP 400** /
+         *      **INVALID_ARGUMENT** when `bps` is above the cap.
+         */
+        put: operations["set_builder_fee"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/buildercodes/builder-fee/changes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List your builder-fee changes
+         * @description List this application's builder-fee changes.
+         *
+         *      Newest first, cursor-paginated. Includes every change to this
+         *      application's builder fee: those its payout wallet made (`BUILDER`) and
+         *      those Monaco made on its behalf (`ADMIN`). The application is taken from
+         *      the authenticated session.
+         */
+        get: operations["list_builder_fee_changes"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/buildercodes/config": {
         parameters: {
             query?: never;
@@ -914,6 +984,36 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/copy-trading/follows/close-positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Close all your copy positions
+         * @description Close all your copy positions.
+         *
+         *      Closes the copy positions of every live follow of yours, as
+         *      CloseFollowPositions does for one: one batch per follow, the follows
+         *      kept, and the same limits (not a flatten guarantee; the follows keep
+         *      mirroring). A follow whose stop is in progress is listed in
+         *      `stoppingFollowIds` and left to its stop. A follow whose close could not
+         *      run is listed in `failedFollows` and the others still close. Never gated
+         *      by copy trading being switched off or by an operations block; only a
+         *      delegated agent session is refused. Shares CloseFollowPositions' rate
+         *      limit.
+         */
+        post: operations["close_all_copy_positions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/copy-trading/follows/preview": {
         parameters: {
             query?: never;
@@ -965,6 +1065,41 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/copy-trading/follows/{followId}/close-positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Close a follow's copy positions
+         * @description Close a follow's copy positions.
+         *
+         *      Closes every position in the follow's copy account at market (reduce-only,
+         *      immediate-or-cancel) and cancels the resting orders and conditional
+         *      orders (TP/SL) on its copy risk buckets (a TWAP cannot run on a copy risk
+         *      bucket), but keeps the follow: it stays ACTIVE (or CLOSE_ONLY) and the
+         *      leader's next trades keep mirroring. StopFollow is the close-and-stop
+         *      path. The proceeds stay in the copy account. Not a flatten guarantee:
+         *      on a thin or halted market part of a position can stay open
+         *      (`positionsNotClosed`), and a leader trade after the close opens copy
+         *      positions again; stop the follow to end the copying. A close is never
+         *      gated by copy trading being switched off or by an operations block, and
+         *      only a delegated agent session is refused. Both close routes share a
+         *      small per-account rate limit (about one close per second, burst 5). The
+         *      response is sent once the batch is durably logged; each close's fills
+         *      arrive on the order, position and copy channels.
+         */
+        post: operations["close_follow_positions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/copy-trading/follows/{followId}/leader-positions": {
         parameters: {
             query?: never;
@@ -989,6 +1124,41 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/copy-trading/follows/{followId}/position-margin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Add margin to a copy position
+         * @description Add margin to a copy position (0XM-2971).
+         *
+         *      Moves collateral from the follow's copy account into the margin of its
+         *      isolated copy position on one trading pair: the position's margin rises
+         *      by exactly `amount`, the copy account's remaining collateral falls by the
+         *      same, and your margin account is never touched. It lowers the position's
+         *      leverage and moves its liquidation price away; it opens no exposure, so
+         *      it works while copy trading is switched off and on a CLOSE_ONLY follow.
+         *      There is no margin reduction: a follow exits by being stopped. Follow
+         *      writes need a master account session (not a delegated agent or a
+         *      sub-account). 404 unless the follow is yours; 409 while it is stopping
+         *      or once it is stopped, and when copy trading is not available on the
+         *      platform at all (the platform then runs copy trading exits only). It
+         *      spends the per-user movement budget withdrawals and collateral transfers
+         *      share. It is not idempotent: a retry after a timeout whose first attempt
+         *      landed adds the amount twice, so read the follow before retrying.
+         */
+        post: operations["add_follow_position_margin"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/copy-trading/follows/{followId}/stop": {
         parameters: {
             query?: never;
@@ -1242,7 +1412,9 @@ export interface paths {
          *      `ListDelegatedAgentOwners`) and a freshly generated session public key.
          *      The new session acts as the owner but records the agent's address for
          *      policy enforcement. Requires an active delegation for the (owner, agent)
-         *      pair.
+         *      pair. Session expiry is bounded by the delegation expiry, if set. Every
+         *      authenticated request and periodic WebSocket session revalidation requires
+         *      the backing delegation to remain active and unexpired.
          */
         post: operations["create_delegated_session"];
         delete?: never;
@@ -1266,8 +1438,9 @@ export interface paths {
          * @description Revoke a delegated agent.
          *
          *      Master accounts only. Revokes the delegation identified by
-         *      `delegated_agent_id`. Existing delegated sessions are not invalidated; only
-         *      future session creation is blocked.
+         *      `delegated_agent_id` and its existing delegated sessions. Subsequent signed
+         *      requests and session refresh fail; connected WebSockets lose access at
+         *      their next periodic session revalidation. Existing orders are not canceled.
          */
         delete: operations["revoke_delegated_agent"];
         options?: never;
@@ -1360,6 +1533,8 @@ export interface paths {
         /**
          * Get my fee tier and pair schedule
          * @description Return the caller's current fee tier, rolling 14-day volumes, and a pair's schedule.
+         *
+         *      Volumes and the tier are wallet-wide: the caller's wallet total across every application.
          */
         get: operations["get_my_fee_tier"];
         put?: never;
@@ -3039,6 +3214,55 @@ export interface components {
              */
             version?: number | null;
         };
+        AddFollowPositionMarginRequest: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * Format: uuid
+             * @description Trading pair UUID of the copy position to add margin to
+             */
+            tradingPairId?: string | null;
+            /**
+             * @description Margin to add, in quote units: a positive decimal, taken from the follow's copy account
+             * @example 25
+             */
+            amount?: string | null;
+        };
+        AddFollowPositionMarginResponse: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * Format: uuid
+             * @description Trading pair UUID of the copy position
+             */
+            tradingPairId?: string | null;
+            /**
+             * Format: uuid
+             * @description The copy position's isolated risk bucket
+             */
+            riskBucketId?: string | null;
+            /**
+             * Format: uuid
+             * @description The copy position's id
+             */
+            positionId?: string | null;
+            /**
+             * @description The copy position's margin after the add, in quote units
+             * @example 125
+             */
+            positionMargin?: string | null;
+            /**
+             * @description What the copy account can still put into this position, in quote units, after the add
+             * @example 875
+             */
+            copyAccountAvailable?: string | null;
+        };
         AppUser: {
             /**
              * Format: uuid
@@ -3667,6 +3891,36 @@ export interface components {
             matchResult?: components["schemas"]["MatchResult"];
             error?: components["schemas"]["BatchReplaceError"];
         };
+        BuilderFeeChange: {
+            /**
+             * @description Who made the change: `BUILDER` (this application's payout wallet) or `ADMIN` (Monaco, on the application's behalf).
+             * @example BUILDER
+             * @enum {string|null}
+             */
+            actorType?: "BUILDER" | "ADMIN" | null;
+            /**
+             * @description The lowercase payout wallet address for a `BUILDER` change, or the Monaco operator's email for an `ADMIN` change.
+             * @example 0x0000000000000000000000000000000000000001
+             */
+            actor?: string | null;
+            /**
+             * Format: uint32
+             * @description Builder fee before the change, in basis points.
+             * @example 0
+             */
+            oldBps?: number | null;
+            /**
+             * Format: uint32
+             * @description Builder fee after the change, in basis points.
+             * @example 10
+             */
+            newBps?: number | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time of the change.
+             */
+            createdAt?: string | null;
+        };
         BuildercodePayout: {
             /**
              * Format: uuid
@@ -3700,7 +3954,7 @@ export interface components {
              */
             createdAt?: string | null;
             /**
-             * @description Payout stream this credit belongs to: `REVENUE_SHARE` (the frontend's share of Monaco's fee) or `BUILDER_FEE` (the frontend's own builder fee, paid by the taker). Both land in the same claimable balance.
+             * @description Payout category for this credit. `REVENUE_SHARE` is active; `BUILDER_FEE` is reserved and is not currently emitted.
              * @example REVENUE_SHARE
              * @enum {string|null}
              */
@@ -3973,6 +4227,37 @@ export interface components {
             /** @description Required when renewing an unexpired lease. Decimal string in JSON. */
             expectedGeneration?: string | null;
         };
+        CloseAllCopyPositionsResponse: {
+            /**
+             * @description Every live follow whose stop is not in progress and whose close ran,
+             *      including one with nothing to close (0 orders placed, 0 positions not
+             *      closed).
+             */
+            follows?: components["schemas"]["CloseFollowPositionsResponse"][] | null;
+            /** @description Follows whose stop is in progress: their stop closes their positions. */
+            stoppingFollowIds?: string[] | null;
+            /** @description Follows whose close could not run; the other follows still closed. */
+            failedFollows?: components["schemas"]["FollowCloseFailure"][] | null;
+        };
+        CloseFollowPositionsResponse: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * Format: uint32
+             * @description Reduce-only, immediate-or-cancel close orders placed; each may fill in part
+             * @example 2
+             */
+            closeOrdersPlaced?: number | null;
+            /**
+             * Format: uint32
+             * @description Copy positions still open after the batch (for example a thin or halted market); 0 when the copy account is flat
+             * @example 0
+             */
+            positionsNotClosed?: number | null;
+        };
         ClosePositionRequest: {
             quantity?: string | null;
             closeType?: string | null;
@@ -4097,7 +4382,7 @@ export interface components {
         };
         CreateDelegatedSessionResponse: {
             /**
-             * @description Session expiry as a Unix timestamp (seconds)
+             * @description Session expiry as a Unix timestamp (seconds), bounded by the delegation expiry when set. Earlier revocation or policy expiry also ends access.
              * @example 1735689599
              */
             expiresAt?: string | null;
@@ -4684,6 +4969,19 @@ export interface components {
             /** @description FOLLOWER, STOP_LOSS, SKIP_LIMIT, ADMIN or LEADER_SUSPENDED */
             stopReason?: string | null;
         };
+        /** @description A follow whose close could not run. */
+        FollowCloseFailure: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * @description Why the close could not run, as a fixed sentence; retry the close
+             * @example The copy positions could not be closed right now; retry shortly
+             */
+            reason?: string | null;
+        };
         Follower: {
             /** @description The follower's wallet address (lowercase hex) */
             walletAddress?: string | null;
@@ -4993,6 +5291,31 @@ export interface components {
              * @example 1000
              */
             buildercodesBudgetBps?: number | null;
+            /** @description Whether builder fees are currently charged. While false, `builderFeeBps` is stored but no builder fee is charged. */
+            builderFeeEnabled?: boolean | null;
+            /**
+             * Format: uint32
+             * @description This application's stored builder fee in basis points: the additional taker fee it charges its users. The fee charged is this value capped at `builderFeeCapBps`, and 0 while `builderFeeEnabled` is false or the application is not enrolled with a payout address.
+             * @example 10
+             */
+            builderFeeBps?: number | null;
+            /**
+             * Format: uint32
+             * @description The highest builder fee, in basis points, that can currently be set or charged.
+             * @example 100
+             */
+            builderFeeCapBps?: number | null;
+            /**
+             * Format: uint32
+             * @description Builder-fee changes this application can still make in the current rolling 24 hours (at most 2).
+             * @example 2
+             */
+            changesRemaining?: number | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time at which the next builder-fee change becomes allowed, or null while `changesRemaining` is above 0.
+             */
+            nextChangeAllowedAt?: string | null;
         };
         /** @description OHLCV candlestick data. */
         GetCandlesResponse: {
@@ -5337,22 +5660,22 @@ export interface components {
         GetMyFeeTierResponse: {
             /**
              * Format: int32
-             * @description Caller's resolved tier (1–6) from stored weighted 14-day volume
+             * @description Caller's resolved tier (1–6) from their wallet's stored weighted 14-day volume
              * @example 2
              */
             currentTierLevel?: number | null;
             /**
-             * @description Caller's weighted 14-day volume (perp + 2.5× spot)
+             * @description Caller's weighted 14-day volume (perp + 2.5× spot), summed across every application the wallet trades through
              * @example 7500000
              */
             weightedVolume14d?: string | null;
             /**
-             * @description Caller's rolling 14-day spot volume
+             * @description Caller's rolling 14-day spot volume, summed across every application the wallet trades through
              * @example 1000000
              */
             spotVolume14d?: string | null;
             /**
-             * @description Caller's rolling 14-day perp volume
+             * @description Caller's rolling 14-day perp volume, summed across every application the wallet trades through
              * @example 5000000
              */
             perpVolume14d?: string | null;
@@ -6071,7 +6394,7 @@ export interface components {
             cumFees?: string | null;
             /**
              * Format: int64
-             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. A live frame is ranked only when it is a faithful projection of the row persisted at that sequence: in practice the fills that leave a position open. Frames that re-read live risk state after sequencing (funding, margin_added/margin_reduced) and terminal frames (which report size 0 and LIQUIDATED, while the stored row keeps its size and records CLOSED) omit the version even though the mutation did advance the persisted one, so an absent version never implies that nothing was persisted. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
+             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills that leave a position open, direct isolated-position margin adds/reductions, and copy-position margin adds; the copy add refreshes its isolated child and copy-cross siblings at the same version. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Funding omits it because it re-reads live state after sequencing; terminal frames omit it because they report size 0 and sometimes LIQUIDATED while the stored row keeps its size and records CLOSED. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
              * @example 918342
              */
             version?: number | null;
@@ -6797,6 +7120,12 @@ export interface components {
              */
             totalPages?: number | null;
         };
+        ListBuilderFeeChangesResponse: {
+            /** @description Builder-fee changes, newest first. */
+            changes?: components["schemas"]["BuilderFeeChange"][] | null;
+            /** @description Cursor for the next page; empty when there are no more. */
+            nextPageToken?: string | null;
+        };
         ListBuildercodePayoutsResponse: {
             /** @description Per-trade credits, newest first. */
             payouts?: components["schemas"]["BuildercodePayout"][] | null;
@@ -7882,7 +8211,7 @@ export interface components {
             cumFees?: string | null;
             /**
              * Format: int64
-             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: it means the row predates this field or came from a producer that does not stamp it, so treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. A live frame is ranked only when it is a faithful projection of the row persisted at that sequence: in practice the fills that leave a position open. Frames that re-read live risk state after sequencing (funding, margin_added/margin_reduced) and terminal frames (which report size 0 and LIQUIDATED, while the stored row keeps its size and records CLOSED) omit the version even though the mutation did advance the persisted one, so an absent version never implies that nothing was persisted. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
+             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: it means the row predates this field or came from a producer that does not stamp it, so treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills that leave a position open, direct isolated-position margin adds/reductions, and copy-position margin adds; the copy add refreshes its isolated child and copy-cross siblings at the same version. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Funding omits it because it re-reads live state after sequencing; terminal frames omit it because they report size 0 and sometimes LIQUIDATED while the stored row keeps its size and records CLOSED. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
              * @example 918342
              */
             version?: number | null;
@@ -8300,7 +8629,7 @@ export interface components {
         RefreshResponse: {
             /**
              * Format: int32
-             * @description Unix timestamp when the session expires after refresh
+             * @description Unix timestamp when the session expires after refresh. For delegated sessions, bounded by the active delegation expiry when set.
              * @example 1699876543
              */
             expiresAt?: number | null;
@@ -8620,6 +8949,39 @@ export interface components {
              */
             isCustom?: boolean | null;
         };
+        SetBuilderFeeRequest: {
+            /**
+             * Format: uint32
+             * @description New builder fee in basis points, from 0 up to the current `builderFeeCapBps` inclusive. 0 stops charging a builder fee.
+             * @example 10
+             */
+            bps: number;
+        };
+        SetBuilderFeeResponse: {
+            /**
+             * Format: uint32
+             * @description The builder fee now stored, in basis points.
+             * @example 10
+             */
+            builderFeeBps?: number | null;
+            /**
+             * Format: uint32
+             * @description The builder fee this change replaced, in basis points. Equal to `builderFeeBps` when the request set the fee it already had, which changes nothing.
+             * @example 0
+             */
+            previousBuilderFeeBps?: number | null;
+            /**
+             * Format: uint32
+             * @description Builder-fee changes this application can still make in the current rolling 24 hours (at most 2).
+             * @example 1
+             */
+            changesRemaining?: number | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time at which the next builder-fee change becomes allowed, or null while `changesRemaining` is above 0.
+             */
+            nextChangeAllowedAt?: string | null;
+        };
         SetSelfTradePreventionDefaultRequest: {
             /**
              * @description The self-trade-prevention mode applied when an order from this wallet would match the wallet family's own resting order and the order names no override: `CANCEL_MAKER` (cancel the resting order — the platform default), `CANCEL_TAKER` (cancel the incoming order), `CANCEL_BOTH`, or `SKIP` (trade around own orders). Input is case-insensitive.
@@ -9763,12 +10125,12 @@ export interface components {
         };
         UpdatedFields: {
             /**
-             * @description New price (if changed)
+             * @description The replacement's limit price: the requested price, or the original order's price when price was omitted.
              * @example 35500.00
              */
             price?: string | null;
             /**
-             * @description New quantity (if changed)
+             * @description The replacement's total quantity: the requested quantity, or the original order's total when quantity was omitted. It is not the resting size: the replacement rests this total minus the already-filled amount, so a 100-lot with 60 filled reports 100 here and rests 40. Read the order's remainingQuantity for the resting size. Margin reduce-only replacements are the exception: this is the close size placed, which is the requested quantity or, when omitted, the original's remaining quantity.
              * @example 0.7
              */
             quantity?: string | null;
@@ -9785,7 +10147,7 @@ export interface components {
              */
             name?: string | null;
             /**
-             * @description Optional delegation expiry timestamp (ISO 8601). Omit for no expiry.
+             * @description Optional delegation expiry timestamp (ISO 8601). Ends delegated reads, trading, and session refresh. Omit for no delegation expiry; session expiry still applies.
              * @example 2026-12-31T23:59:59Z
              */
             expiresAt?: string | null;
@@ -11728,14 +12090,18 @@ export interface operations {
             };
         };
     };
-    get_buildercodes_config: {
+    set_builder_fee: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SetBuilderFeeRequest"];
+            };
+        };
         responses: {
             /** @description OK */
             200: {
@@ -11743,9 +12109,16 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GetBuildercodesConfigResponse"];
+                    "application/json": components["schemas"]["SetBuilderFeeResponse"];
                 };
             };
+            /** @description bps is above the current builder-fee cap (gRPC: INVALID_ARGUMENT) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description Authentication required */
             401: {
                 headers: {
@@ -11767,6 +12140,13 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description The application is not enrolled in BuilderCodes with a payout address, or it has already made two changes in the last 24 hours; the latter carries `details.nextChangeAllowedAt` (gRPC: FAILED_PRECONDITION) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description Internal server error */
             500: {
                 headers: {
@@ -11776,15 +12156,16 @@ export interface operations {
             };
         };
     };
-    list_buildercode_payouts: {
+    list_builder_fee_changes: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
-                page?: number;
                 /** @description Items per page (max 100) */
                 pageSize?: number;
-                /** @description Only return BuilderCodes payouts of this payout kind: REVENUE_SHARE (the frontend's share of Monaco's fee) or BUILDER_FEE (the frontend's own builder fee). Omit for every kind. */
-                kind?: "REVENUE_SHARE" | "BUILDER_FEE";
+                /**
+                 * @description Opaque cursor from a previous response's `nextPageToken`; omit or send an
+                 *      empty string for the first page.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;
@@ -11798,10 +12179,10 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ListBuildercodePayoutsResponse"];
+                    "application/json": components["schemas"]["ListBuilderFeeChangesResponse"];
                 };
             };
-            /** @description Invalid pagination */
+            /** @description Invalid page size or page token */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -11838,7 +12219,7 @@ export interface operations {
             };
         };
     };
-    get_buildercode_payout_summary: {
+    get_buildercodes_config: {
         parameters: {
             query?: never;
             header?: never;
@@ -11853,7 +12234,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GetBuildercodePayoutSummaryResponse"];
+                    "application/json": components["schemas"]["GetBuildercodesConfigResponse"];
                 };
             };
             /** @description Authentication required */
@@ -11886,9 +12267,16 @@ export interface operations {
             };
         };
     };
-    get_buildercode_rewards_balance: {
+    list_buildercode_payouts: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page number (1-indexed) */
+                page?: number;
+                /** @description Items per page (max 100) */
+                pageSize?: number;
+                /** @description Only return BuilderCodes payouts of this payout kind: REVENUE_SHARE (the frontend's share of Monaco's fee) or BUILDER_FEE (reserved and not currently emitted). Omit for every kind. */
+                kind?: "REVENUE_SHARE" | "BUILDER_FEE";
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -11901,12 +12289,115 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GetBuildercodeRewardsBalanceResponse"];
+                    "application/json": components["schemas"]["ListBuildercodePayoutsResponse"];
                 };
             };
-            /** @description Authentication required */
-            401: {
-                headers: {
+            /** @description Invalid pagination */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authenticated application not found (gRPC: NOT_FOUND) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_buildercode_payout_summary: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetBuildercodePayoutSummaryResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authenticated application not found (gRPC: NOT_FOUND) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_buildercode_rewards_balance: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetBuildercodeRewardsBalanceResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
@@ -12122,6 +12613,75 @@ export interface operations {
             };
         };
     };
+    close_all_copy_positions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CloseAllCopyPositionsResponse"];
+                };
+            };
+            /** @description The close was refused */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Delegated agent sessions cannot close copy positions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Copy trading is not available */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Copy position close rate limit exceeded; retry after the interval in details.retryAfter */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The matching engine is unavailable; retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     preview_follow: {
         parameters: {
             query?: never;
@@ -12259,6 +12819,84 @@ export interface operations {
             };
         };
     };
+    close_follow_positions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                followId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CloseFollowPositionsResponse"];
+                };
+            };
+            /** @description Invalid follow id, or the close was refused */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Delegated agent sessions cannot close copy positions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Follow not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The follow is stopped, or its stop is in progress (which closes its positions itself), or copy trading is not available */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Copy position close rate limit exceeded; retry after the interval in details.retryAfter */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The close cannot run right now, or the matching engine is unavailable; retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     list_follow_leader_positions: {
         parameters: {
             query?: never;
@@ -12330,6 +12968,88 @@ export interface operations {
             };
         };
     };
+    add_follow_position_margin: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                followId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddFollowPositionMarginRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AddFollowPositionMarginResponse"];
+                };
+            };
+            /** @description Invalid follow id, trading pair or amount, or refused by the engine with code COPY_TRADING_REJECTED (no copy position on the pair, the position or the margin account is being liquidated, the position has lost more than its margin, more than the copy account holds; the message names the rule) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Only a master account session can add margin (not a delegated agent or a sub-account) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Follow not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The follow is stopping or stopped, or code COPY_TRADING_UNAVAILABLE: copy trading is not available on the platform */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Movement rate limit exceeded — withdrawals and collateral transfers share a per-user budget; retry after the interval in details.retryAfter */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Matching engine unavailable; retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     stop_follow: {
         parameters: {
             query?: never;