@0xmonaco/types 1.0.86 → 1.0.88

package/dist/wire/schema.d.ts

@@ -717,33 +717,42 @@ export interface paths {
         };
         get?: never;
         /**
-         * Set your builder fee
-         * @description Set this application's builder fee.
+         * Set your builder fees
+         * @description Set this application's builder fees.
          *
          *      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.
+         *      frontend charges its own users on top of Monaco's fee when their order
+         *      fills as the taker. The maker add-on is the same for a user's order that
+         *      fills as the maker: it is paid by the maker on top of Monaco's maker fee or
+         *      rebate. 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.
+         *      `bps` (taker) is required. `makerBps` is optional; omitting it leaves the
+         *      maker add-on unchanged. Each must be between 0 and the current builder-fee
+         *      cap (`builderFeeCapBps` on `GetBuildercodesConfig`) inclusive; the cap and
+         *      the switches are shared by both sides. The application must be enrolled in
+         *      BuilderCodes with a payout address. At most two changes are allowed in any
+         *      rolling 24 hours, and one call that sets both sides is one change; changes
+         *      Monaco makes on the application's behalf do not count. Setting the values
+         *      it already has is a no-op that succeeds and does not use up a change.
          *
-         *      The fee can be set while the revenue share or builder fees are switched
-         *      on, and is refused (**HTTP 403** / **PERMISSION_DENIED**) while both are
-         *      off. With builder fees off (`builderFeeEnabled` false) it is stored and
-         *      nothing is charged until they are switched on. A newly stored fee reaches order requests within a few
-         *      seconds. Sequencer ordering is authoritative for matching-engine policy and
-         *      enrollment state: an order processed before one of those sequenced changes
-         *      uses the earlier state, and a later order uses the new state.
+         *      The fees can be set while the revenue share or builder fees are switched
+         *      on, and are refused (**HTTP 403** / **PERMISSION_DENIED**) while both are
+         *      off. With builder fees off (`builderFeeEnabled` false) they are stored and
+         *      nothing is charged until they are switched on. A newly stored taker fee
+         *      reaches order requests within a few seconds. A newly stored maker add-on
+         *      applies to orders placed after the matching engine's next BuilderCodes
+         *      enrollment refresh, shortly after it is saved; an order resting on the book
+         *      keeps the maker add-on in force when it was placed. Sequencer ordering is
+         *      authoritative for matching-engine policy and enrollment state: an order
+         *      processed before one of those sequenced changes uses the earlier state, and
+         *      a later order uses the new state.
          *
          *      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.
+         *      **INVALID_ARGUMENT** when `bps` or `makerBps` is above the cap.
          */
         put: operations["set_builder_fee"];
         post?: never;
@@ -765,7 +774,8 @@ export interface paths {
          * @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
+         *      application's builder fees (taker and maker add-on, one row per change):
+         *      those its payout wallet made (`BUILDER`) and
          *      those Monaco made on its behalf (`ADMIN`). The application is taken from
          *      the authenticated session.
          */
@@ -2749,277 +2759,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/pitpass/codes/available": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Check custom TraderCode availability (deprecated PitPass path)
-         * @deprecated
-         * @description Check custom-handle availability (public, advisory).
-         *
-         *      Unauthenticated as-you-type check for a custom handle: returns `available`
-         *      plus, when unavailable, a snake_case `reason` code. Advisory only — the
-         *      authoritative gate is the atomic claim in SetTraderCode — so a positive
-         *      result never reserves the handle.
-         */
-        get: operations["pitpass_check_trader_code_availability"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/codes/me": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get your TraderCode (deprecated PitPass path)
-         * @deprecated
-         * @description Claim your TraderCode.
-         *
-         *      Get your TraderCode.
-         *
-         *      Return the authenticated caller's TraderCode, which is derived from their
-         *      wallet address (rendered `Monaco - <address>` by clients). Never 404s — the
-         *      code always exists for a signed-in wallet — and ensures the backing row so
-         *      referrals attributed to this wallet have a code to link.
-         */
-        get: operations["pitpass_get_my_trader_code"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/codes/me/custom": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        /**
-         * Claim or edit your custom TraderCode (deprecated PitPass path)
-         * @deprecated
-         * @description Claim or edit your custom TraderCode handle.
-         *
-         *      Single claim-or-edit entry point: set the authenticated caller's custom
-         *      vanity handle (a `[A-Za-z0-9_]`, letter-first, 5–20-char name), keeping the
-         *      permanent wallet-derived code as the reward identity. The first claim is
-         *      free; subsequent changes are rate-limited and release the freed handle into
-         *      a cooldown before anyone else can reclaim it. Case is preserved on store;
-         *      uniqueness is case-insensitive. Gated by the `custom_trader_codes_enabled`
-         *      feature flag. Returns the caller's updated TraderCode identity.
-         */
-        put: operations["pitpass_set_trader_code"];
-        post?: never;
-        /**
-         * Clear your custom TraderCode (deprecated PitPass path)
-         * @deprecated
-         * @description Clear your custom TraderCode handle.
-         *
-         *      Revert the authenticated caller to their wallet-derived default, releasing
-         *      the freed handle into cooldown. A no-op (returns the current default) when
-         *      no custom handle is set. Like an edit, a clear counts against the
-         *      rolling-hour rate-limit. Gated by the `custom_trader_codes_enabled` feature
-         *      flag.
-         */
-        delete: operations["pitpass_clear_trader_code"];
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/codes/{code}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Look up a TraderCode (deprecated PitPass path)
-         * @deprecated
-         * @description Look up a TraderCode (public).
-         *
-         *      Public, unauthenticated lookup used to validate a referral code at signup.
-         *      The code is a wallet address; returns the normalized code when it resolves
-         *      to a known wallet. Returns 404 when the code does not resolve to a user.
-         */
-        get: operations["pitpass_get_trader_code_info"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/referrals/me": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get your referral position (deprecated PitPass path)
-         * @deprecated
-         * @description Read your own referral position (self-scoped).
-         *
-         *      Return the authenticated caller's referral position: their referral chain
-         *      upward (L1, L2 and onward — who referred them, who referred that wallet, and
-         *      so on, as many levels as their trades on this client application pay), the
-         *      total rewards they have earned, and their most recent reward rows.
-         *      Self-scoped — identity comes only from the session, never a path id,
-         *      so a caller can only ever read their own chain. Every other user is
-         *      identified by their public wallet address, never an internal id. An empty
-         *      `referrer` means the caller was not referred.
-         */
-        get: operations["pitpass_get_my_referral_position"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/referrals/me/downline": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get your referral downline and earnings (deprecated PitPass path)
-         * @deprecated
-         * @description Read your own downline earnings (self-scoped).
-         *
-         *      Return who the authenticated caller earns from and how much: one page of
-         *      the earnings-by-source breakdown across every reward level, their L1
-         *      direct-referee roster (including referees who have not traded yet), and a
-         *      per-level earnings summary that always covers every level and source,
-         *      whatever page is requested. `earnings_by_source` is paged (`page_size`,
-         *      `page_token`); a request without them gets the first page, not every row.
-         *      Self-scoped — identity comes only from the session, never a path id. Every
-         *      source and referee is identified by their public wallet address, never an
-         *      internal id.
-         */
-        get: operations["pitpass_get_my_referral_downline"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/referrals/me/tree": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get one level of your referral tree (deprecated PitPass path)
-         * @deprecated
-         * @description Read one level of your own referral tree (self-scoped).
-         *
-         *      Return the wallets directly referred by `parent` — the authenticated caller
-         *      when `parent` is omitted, otherwise one of the caller's own referees above
-         *      the deepest rewarded level — one page at a time, newest first. Each node carries its level
-         *      relative to the caller, its parent, how many wallets it has referred (so the
-         *      client knows whether it can be expanded), and what the caller has earned
-         *      from that wallet's own trades. Expanding a node is another call with
-         *      `parent` set to that node's wallet; the tree always lists the caller's
-         *      direct referees (L1) and goes as deep as any client application rewards,
-         *      at most 10 levels.
-         *
-         *      Self-scoped — identity comes only from the session. A `parent` that is not
-         *      the caller or a referee the caller can expand returns 404, the same
-         *      as a wallet that does not exist, so the endpoint cannot be used to read
-         *      anyone else's tree. Every node is identified by its public wallet address,
-         *      never an internal id.
-         */
-        get: operations["pitpass_get_my_referral_tree"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/rewards/balance": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get your rewards balance (deprecated PitPass path)
-         * @deprecated
-         * @description Read accrued TraderCodes rewards balance.
-         *
-         *      Return the caller's current rewards-bucket balances across all reward tokens.
-         *      Rewards accumulate here as referred users trade; call TransferRewards to move
-         *      them into a tradeable balance. Returns an empty list when no rewards have
-         *      been earned yet.
-         */
-        get: operations["pitpass_get_rewards_balance"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/pitpass/rewards/transfer": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Transfer rewards into a trading balance (deprecated PitPass path)
-         * @deprecated
-         * @description Transfer earned rewards into a trading balance.
-         *
-         *      Move spendable TraderCodes reward balance from your rewards bucket into a
-         *      trading balance under the authenticated application, making it tradeable
-         *      immediately. Ledger-only (one shared vault + one backend ledger) — no
-         *      on-chain transaction and no gas. Fails with 409 when the rewards balance is
-         *      insufficient. It spends the per-user movement budget withdrawals and
-         *      collateral transfers share.
-         */
-        post: operations["pitpass_transfer_rewards"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/v1/positions": {
         parameters: {
             query?: never;
@@ -4193,7 +3932,7 @@ export interface components {
         };
         BatchCreateError: {
             /**
-             * @description Machine-readable error code. ORDER_SUBMISSION_CAPACITY_EXCEEDED refuses a new keyed submission when response-cache capacity is protected by pending durability or persistence. ORDER_SUBMISSION_UNAVAILABLE means the original response is temporarily unavailable or keyed admission is busy; it never authorizes duplicate execution. Retry the same key and payload; the 24-hour limit applies only to previously accepted keys.
+             * @description Machine-readable error code. ORDER_SUBMISSION_CAPACITY_EXCEEDED refuses a new keyed submission when response-cache capacity is protected by pending durability or persistence. ORDER_SUBMISSION_UNAVAILABLE means the original response is temporarily unavailable or keyed admission is busy; it never authorizes duplicate execution. Retry the same key and payload; the 15-minute limit applies only to previously accepted keys.
              * @example INSUFFICIENT_BALANCE
              */
             code?: string | null;
@@ -4311,7 +4050,7 @@ export interface components {
              * @example quote-btc-1130-a
              */
             clientOrderId?: string | null;
-            /** @description Optional submission identity, distinct from clientOrderId. Use 1-64 characters from [A-Za-z0-9._:-], without whitespace. Scoped to your authenticated user/subaccount and application, shared by create and batch-create items. Retrying the same key and normalized order payload within 24 hours of the original acceptance returns the original committed submission result, even after a fill or cancellation, without executing again. A full response cache does not prevent new keyed submissions: durable responses may be evicted while exact key history remains retained. If response capacity is protected by pending durability or persistence, a new key is refused with ORDER_SUBMISSION_CAPACITY_EXCEEDED. A retry whose original response cannot currently be retrieved returns ORDER_SUBMISSION_UNAVAILABLE and never executes again. Both are HTTP 503 / gRPC UNAVAILABLE, or per-item errors in batches. Retry the same key and payload; for previously accepted keys, stay within 24 hours of the original acceptance. A capacity refusal does not accept or reserve a new key. Different payload returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS; per-item error in batches). Validation failures before acceptance do not reserve the key. The window does not extend on retries; after it expires the key may execute a new order, so never retry an unresolved submission after 24 hours. Generate a fresh key for each intended new order and retain it across transport retries. Without a key, a timeout or 5xx leaves the outcome unknown and must not be blindly retried. */
+            /** @description Optional submission identity, distinct from clientOrderId. Use 1-64 characters from [A-Za-z0-9._:-], without whitespace. Scoped to your authenticated user/subaccount and application, shared by create and batch-create items. Retrying the same key and normalized order payload within 15 minutes of the original acceptance returns the original committed submission result, even after a fill or cancellation, without executing again. A full response cache does not prevent new keyed submissions: durable responses may be evicted while exact key history remains retained. If response capacity is protected by pending durability or persistence, a new key is refused with ORDER_SUBMISSION_CAPACITY_EXCEEDED. A retry whose original response cannot currently be retrieved returns ORDER_SUBMISSION_UNAVAILABLE and never executes again. Both are HTTP 503 / gRPC UNAVAILABLE, or per-item errors in batches. Retry the same key and payload; for previously accepted keys, stay within 15 minutes of the original acceptance. A capacity refusal does not accept or reserve a new key. Different payload returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS; per-item error in batches). Validation failures before acceptance do not reserve the key. The window does not extend on retries; after it expires the key may execute a new order, so never retry an unresolved submission after 15 minutes. Generate a fresh key for each intended new order and retain it across transport retries. Without a key, a timeout or 5xx leaves the outcome unknown and must not be blindly retried. */
             idempotencyKey?: string | null;
             /**
              * @description Per-order self-trade-prevention override: how the engine resolves this order matching against one of your own resting orders (your whole wallet family, subaccounts included; the incoming order's mode governs the step and resting orders' modes are never consulted). CANCEL_MAKER cancels each of your resting orders encountered and keeps matching. CANCEL_TAKER fills third-party liquidity up to the first self-touch, then cancels the incoming order's remainder — a zero-fill CANCELLED outcome is possible. CANCEL_BOTH additionally cancels the encountered resting orders. SKIP trades around your resting orders; a remainder that would rest crossing one of your surviving orders is cancelled instead of resting. Omitted, your wallet's configured default applies, else the platform default CANCEL_MAKER. STP cancellations carry terminalReason SELF_TRADE_PREVENTION and stpCounterpartyOrderId on reads and WebSocket events. With time_in_force FOK: CANCEL_MAKER cancels your makers first and then fills or kills; CANCEL_TAKER and SKIP cancel the whole order when self is in the fill path; CANCEL_BOTH fails only this item with a per-item SELF_TRADE_NOT_ALLOWED error — the batch itself still returns 2xx / OK. An unknown value likewise fails only this item, with error.code INVALID_SELF_TRADE_PREVENTION_MODE. The requested value is echoed back as selfTradePreventionMode on order reads, absent when omitted here.
@@ -4475,6 +4214,18 @@ export interface components {
              * @description RFC 3339 time of the change.
              */
             createdAt?: string | null;
+            /**
+             * Format: uint32
+             * @description Maker add-on before the change, in basis points. Equal to `newMakerBps` when the change left it unchanged.
+             * @example 0
+             */
+            oldMakerBps?: number | null;
+            /**
+             * Format: uint32
+             * @description Maker add-on after the change, in basis points.
+             * @example 5
+             */
+            newMakerBps?: number | null;
         };
         BuildercodePayout: {
             /**
@@ -4499,7 +4250,7 @@ export interface components {
             amount?: string | null;
             /**
              * Format: int32
-             * @description Basis-point rate applied to this credit. For `BUILDER_FEE`, this is the normalized builder-fee rate charged to the taker. For `REVENUE_SHARE`, it is the realized whole-basis-point rate for that fill and can be lower than the configured BuilderCodes budget.
+             * @description Basis-point rate applied to this credit. For `BUILDER_FEE`, this is the normalized builder-fee rate charged to the taker. For `BUILDER_MAKER_FEE`, it is the maker add-on rate the maker order stored when it was placed. For `REVENUE_SHARE`, it is the realized whole-basis-point rate for that fill and can be lower than the configured BuilderCodes budget.
              * @example 1000
              */
             appliedBps?: number | null;
@@ -4509,11 +4260,11 @@ export interface components {
              */
             createdAt?: string | null;
             /**
-             * @description Payout category for this credit: `REVENUE_SHARE` for Monaco revenue sharing or `BUILDER_FEE` for an ordinary builder fee charged to the taker.
+             * @description Payout category for this credit: `REVENUE_SHARE` for Monaco revenue sharing, `BUILDER_FEE` for a builder fee charged to the taker, or `BUILDER_MAKER_FEE` for a maker add-on charged to the maker.
              * @example REVENUE_SHARE
              * @enum {string|null}
              */
-            kind?: "REVENUE_SHARE" | "BUILDER_FEE" | null;
+            kind?: "REVENUE_SHARE" | "BUILDER_FEE" | "BUILDER_MAKER_FEE" | null;
         };
         BuildercodePayoutTokenKindTotal: {
             /**
@@ -4522,11 +4273,11 @@ export interface components {
              */
             token?: string | null;
             /**
-             * @description Payout stream these totals cover: `REVENUE_SHARE` or `BUILDER_FEE`.
+             * @description Payout stream these totals cover: `REVENUE_SHARE`, `BUILDER_FEE` or `BUILDER_MAKER_FEE`.
              * @example REVENUE_SHARE
              * @enum {string|null}
              */
-            kind?: "REVENUE_SHARE" | "BUILDER_FEE" | null;
+            kind?: "REVENUE_SHARE" | "BUILDER_FEE" | "BUILDER_MAKER_FEE" | null;
             /**
              * @description Summed credits of this kind in RAW atomic units of this token.
              * @example 5000000
@@ -5122,7 +4873,7 @@ export interface components {
              * @example quote-btc-1130-a
              */
             clientOrderId?: string | null;
-            /** @description Optional submission identity, distinct from clientOrderId. Use 1-64 characters from [A-Za-z0-9._:-], without whitespace. Scoped to your authenticated user/subaccount and application, shared by create and batch-create items. Retrying the same key and normalized order payload within 24 hours of the original acceptance returns the original committed submission result, even after a fill or cancellation, without executing again. A full response cache does not prevent new keyed submissions: durable responses may be evicted while exact key history remains retained. If response capacity is protected by pending durability or persistence, a new key is refused with ORDER_SUBMISSION_CAPACITY_EXCEEDED. A retry whose original response cannot currently be retrieved returns ORDER_SUBMISSION_UNAVAILABLE and never executes again. Both are HTTP 503 / gRPC UNAVAILABLE, or per-item errors in batches. Retry the same key and payload; for previously accepted keys, stay within 24 hours of the original acceptance. A capacity refusal does not accept or reserve a new key. Different payload returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS; per-item error in batches). Validation failures before acceptance do not reserve the key. The window does not extend on retries; after it expires the key may execute a new order, so never retry an unresolved submission after 24 hours. Generate a fresh key for each intended new order and retain it across transport retries. Without a key, a timeout or 5xx leaves the outcome unknown and must not be blindly retried. */
+            /** @description Optional submission identity, distinct from clientOrderId. Use 1-64 characters from [A-Za-z0-9._:-], without whitespace. Scoped to your authenticated user/subaccount and application, shared by create and batch-create items. Retrying the same key and normalized order payload within 15 minutes of the original acceptance returns the original committed submission result, even after a fill or cancellation, without executing again. A full response cache does not prevent new keyed submissions: durable responses may be evicted while exact key history remains retained. If response capacity is protected by pending durability or persistence, a new key is refused with ORDER_SUBMISSION_CAPACITY_EXCEEDED. A retry whose original response cannot currently be retrieved returns ORDER_SUBMISSION_UNAVAILABLE and never executes again. Both are HTTP 503 / gRPC UNAVAILABLE, or per-item errors in batches. Retry the same key and payload; for previously accepted keys, stay within 15 minutes of the original acceptance. A capacity refusal does not accept or reserve a new key. Different payload returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS; per-item error in batches). Validation failures before acceptance do not reserve the key. The window does not extend on retries; after it expires the key may execute a new order, so never retry an unresolved submission after 15 minutes. Generate a fresh key for each intended new order and retain it across transport retries. Without a key, a timeout or 5xx leaves the outcome unknown and must not be blindly retried. */
             idempotencyKey?: string | null;
             /**
              * @description Per-order self-trade-prevention override: how the engine resolves this order matching against one of your own resting orders (your whole wallet family, subaccounts included; the incoming order's mode governs the step and resting orders' modes are never consulted). CANCEL_MAKER cancels each of your resting orders encountered and keeps matching. CANCEL_TAKER fills third-party liquidity up to the first self-touch, then cancels the incoming order's remainder — a zero-fill CANCELLED outcome is possible. CANCEL_BOTH additionally cancels the encountered resting orders. SKIP trades around your resting orders; a remainder that would rest crossing one of your surviving orders is cancelled instead of resting. Omitted, your wallet's configured default applies, else the platform default CANCEL_MAKER. STP cancellations carry terminalReason SELF_TRADE_PREVENTION and stpCounterpartyOrderId on reads and WebSocket events. With time_in_force FOK: CANCEL_MAKER cancels your makers first and then fills or kills; CANCEL_TAKER and SKIP cancel the whole order when self is in the fill path; CANCEL_BOTH rejects the placement with SELF_TRADE_NOT_ALLOWED. The requested value is echoed back as selfTradePreventionMode on order reads, absent when omitted here.
@@ -5726,7 +5477,7 @@ export interface components {
              */
             takerFee?: string | null;
             /**
-             * @description Application revenue share from taker fees (normalized, in human-readable quote token units)
+             * @description Builder fees this application charged its users as takers (normalized, in human-readable quote token units). Taker side only; see `applicationMakerFee` and `builderFeeTotal`
              * @example 5.67
              */
             applicationTakerFee?: string | null;
@@ -5735,6 +5486,16 @@ export interface components {
              * @example 42
              */
             tradeCount?: string | null;
+            /**
+             * @description Maker add-ons this application charged its users as makers, on trades where its user's order was the maker (normalized, in human-readable quote token units)
+             * @example 1.23
+             */
+            applicationMakerFee?: string | null;
+            /**
+             * @description This application's total builder-fee revenue: `applicationTakerFee` plus `applicationMakerFee` (normalized, in human-readable quote token units)
+             * @example 6.90
+             */
+            builderFeeTotal?: string | null;
         };
         GetAvailableCollateralResponse: {
             asset?: string | null;
@@ -5871,6 +5632,8 @@ export interface components {
             byToken?: components["schemas"]["BuildercodePayoutTokenTotal"][] | null;
             /** @description The same totals split by token AND payout kind. One row per (token, kind) pair with at least one credit; a token's rows sum to its `byToken` total. Empty when this application has no payouts. */
             byTokenAndKind?: components["schemas"]["BuildercodePayoutTokenKindTotal"][] | null;
+            /** @description Per-token builder-fee totals: the `BUILDER_FEE` and `BUILDER_MAKER_FEE` rows of `byTokenAndKind` summed per token, without the revenue share. One row per token with at least one builder-fee credit. Empty when this application has none. */
+            builderFeeByToken?: components["schemas"]["BuildercodePayoutTokenTotal"][] | null;
         };
         GetBuildercodeRewardsBalanceResponse: {
             /** @description One entry per reward token with a non-zero available balance. */
@@ -5922,8 +5685,14 @@ export interface components {
              * @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. */
+            /**
+             * Format: uint32
+             * @description This application's stored maker add-on in basis points: the additional fee it charges its users when their order fills as the maker, on top of Monaco's maker fee or rebate. Charged under the same cap and switches as `builderFeeBps`; an order stores the rate in force when it was placed and is charged that rate when it fills.
+             * @example 0
+             */
+            builderMakerFeeBps?: number | null;
+        };
+        /** @description OHLCV candlestick data. */
         GetCandlesResponse: {
             candles?: components["schemas"]["Candle"][] | null;
         };
@@ -10068,6 +9837,12 @@ export interface components {
              * @example 10
              */
             bps: number;
+            /**
+             * Format: uint32
+             * @description New maker add-on in basis points, from 0 up to the current `builderFeeCapBps` inclusive. Omit to leave the maker add-on unchanged; 0 stops charging one. It applies to orders placed after the matching engine's next BuilderCodes enrollment refresh, shortly after it is saved, and never to an order already resting.
+             * @example 5
+             */
+            makerBps?: number | null;
         };
         SetBuilderFeeResponse: {
             /**
@@ -10093,6 +9868,18 @@ export interface components {
              * @description RFC 3339 time at which the next builder-fee change becomes allowed, or null while `changesRemaining` is above 0.
              */
             nextChangeAllowedAt?: string | null;
+            /**
+             * Format: uint32
+             * @description The maker add-on now stored, in basis points. It applies to orders placed after the matching engine's next BuilderCodes enrollment refresh, shortly after it is saved; orders already resting keep the rate they were placed with.
+             * @example 5
+             */
+            builderMakerFeeBps?: number | null;
+            /**
+             * Format: uint32
+             * @description The maker add-on this change replaced, in basis points. Equal to `builderMakerFeeBps` when the request left it unchanged.
+             * @example 0
+             */
+            previousBuilderMakerFeeBps?: number | null;
         };
         SetSelfTradePreventionDefaultRequest: {
             /**
@@ -10140,7 +9927,7 @@ export interface components {
              */
             takerTotalPayment?: string | null;
             /**
-             * @description Total amount received by maker (notional - rebate)
+             * @description Total amount received if this order fills as the maker: notional minus the Monaco maker fee (so a rebate adds) minus `applicationMakerFee`
              * @example 19995.00
              */
             makerTotalReceipt?: string | null;
@@ -10200,6 +9987,17 @@ export interface components {
              * @example -1
              */
             monacoMakerRebateBpsExact?: string | null;
+            /**
+             * @description Application maker add-on in quote token if this order fills as the maker: the frontend's own fee, paid by the maker on top of the Monaco maker fee or rebate. 0 when the application charges none
+             * @example 1.00
+             */
+            applicationMakerFee?: string | null;
+            /**
+             * Format: int32
+             * @description Application maker add-on rate in basis points: the rate an order placed now would store, under the same cap and switches as `applicationTakerFeeBps`
+             * @example 0
+             */
+            applicationMakerFeeBps?: number | null;
         };
         SimulateOrderRiskRequest: {
             /** @description Margin account UUID for the isolated bucket being simulated. */
@@ -11495,7 +11293,8 @@ export interface components {
             /**
              * @description Total fee this user paid on the trade, in raw quote units: for a taker,
              *      Monaco's taker fee plus the frontend's builder fee; for a maker, the maker
-             *      fee (negative for a rebate). Equals `monaco_fee + builder_fee`.
+             *      fee (negative for a rebate) plus the frontend's maker add-on. Equals
+             *      `monaco_fee + builder_fee`.
              */
             fee?: string | null;
             realizedPnl?: string | null;
@@ -11503,8 +11302,9 @@ export interface components {
             /** @description Monaco's component of `fee`, in raw quote units. */
             monacoFee?: string | null;
             /**
-             * @description The frontend's builder fee component of `fee`, in raw quote units. Always
-             *      "0" for a maker: builder fees are charged to takers only.
+             * @description The frontend's builder fee component of `fee`, in raw quote units: for a
+             *      taker, the builder fee; for a maker, the maker add-on, charged at the rate
+             *      the order stored when it was placed. "0" when the frontend charges none.
              */
             builderFee?: string | null;
         };
@@ -11540,7 +11340,7 @@ export interface components {
              */
             sessionPublicKey: string;
             /**
-             * @description Optional TraderCode captured at signup (e.g. from a `?ref=CODE` link). When a user verifies for the very first time with a valid code, a referral relationship is recorded atomically. Ignored for users who already exist, and silently ignored if the code is unknown — a bad code never blocks sign-in.
+             * @description Optional TraderCode captured at signup (e.g. from a `?ref=CODE` link). When a user verifies for the very first time with a valid code, a referral relationship is recorded atomically. Ignored for users who already exist. A code that does not apply (unknown, the wallet's own, or a different referrer than the one the wallet already has) never blocks sign-in; `VerifyResponse.referral_not_applied_reason` says why.
              * @example 0x1234567890abcdef1234567890abcdef12345678
              */
             referralCode?: string | null;
@@ -11564,10 +11364,18 @@ export interface components {
              */
             isNewUser?: boolean | null;
             /**
-             * @description True when a TraderCodes referral relationship was recorded on this verify: a valid, non-self TraderCode presented on the wallet's first sign-in to THIS application resolved to a known referrer. Scoped like `is_new_user` (per `(wallet, application)`), so a wallet already registered on another application can still see this on its first sign-in to a new one. False for a returning user of this application, an absent or unknown code, or a self-referral. Confirms the referral landed for the signup success screen.
+             * @description True when a TraderCodes referral relationship was recorded on this verify: a valid, non-self TraderCode presented on the wallet's first sign-in to THIS application resolved to a known referrer. Scoped like `is_new_user` (per `(wallet, application)`), so a wallet already registered on another application can still see this on its first sign-in to a new one. False for a returning user of this application, an absent or unknown code, a self-referral, or a wallet that already has a different referrer (see `referral_not_applied_reason`). Confirms the referral landed for the signup success screen.
              * @example true
              */
             referralApplied?: boolean | null;
+            /**
+             * Format: enum
+             * @description Why the TraderCode presented on this sign-up did not apply. Absent when it
+             *      applied, when no code was presented, and for a returning user of this
+             *      application.
+             * @enum {string|null}
+             */
+            referralNotAppliedReason?: "REFERRAL_NOT_APPLIED_REASON_UNSPECIFIED" | "REFERRAL_NOT_APPLIED_REASON_ALREADY_REFERRED" | "REFERRAL_NOT_APPLIED_REASON_UNKNOWN_CODE" | "REFERRAL_NOT_APPLIED_REASON_SELF_REFERRAL" | null;
         };
         Withdrawal: {
             /**
@@ -13463,7 +13271,7 @@ export interface operations {
                     "application/json": components["schemas"]["SetBuilderFeeResponse"];
                 };
             };
-            /** @description bps is above the current builder-fee cap (gRPC: INVALID_ARGUMENT) */
+            /** @description bps or makerBps is above the current builder-fee cap (gRPC: INVALID_ARGUMENT) */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -13663,8 +13471,8 @@ export interface operations {
                  *      token, or the request is rejected 400.
                  */
                 pageToken?: string;
-                /** @description Only return BuilderCodes payouts of this payout kind: REVENUE_SHARE (the frontend's share of Monaco's fee) or BUILDER_FEE (ordinary builder fees charged to takers and credited to enrolled applications). Omit for every kind. */
-                kind?: "REVENUE_SHARE" | "BUILDER_FEE";
+                /** @description Only return BuilderCodes payouts of this payout kind: REVENUE_SHARE (the frontend's share of Monaco's fee), BUILDER_FEE (builder fees charged to takers) or BUILDER_MAKER_FEE (maker add-ons charged to makers). Both builder-fee kinds are credited to the enrolled application whose order paid them. Omit for every kind. */
+                kind?: "REVENUE_SHARE" | "BUILDER_FEE" | "BUILDER_MAKER_FEE";
             };
             header?: never;
             path?: never;
@@ -17015,7 +16823,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Keyed order submission temporarily unavailable; retry the same key and payload. For previously accepted keys, retry only within 24 hours of the original acceptance. A capacity refusal does not accept or reserve a new key. */
+            /** @description Keyed order submission temporarily unavailable; retry the same key and payload. For previously accepted keys, retry only within 15 minutes of the original acceptance. A capacity refusal does not accept or reserve a new key. */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -17938,488 +17746,6 @@ export interface operations {
             };
         };
     };
-    pitpass_check_trader_code_availability: {
-        parameters: {
-            query?: {
-                code?: string;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["CheckTraderCodeAvailabilityResponse"];
-                };
-            };
-            /** @description Availability check rate-limit exceeded */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Internal server error */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-        };
-    };
-    pitpass_get_my_trader_code: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TraderCodeResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read 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;
-            };
-        };
-    };
-    pitpass_set_trader_code: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["SetTraderCodeRequest"];
-            };
-        };
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TraderCodeResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Custom trader codes are not enabled */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Handle is taken (case-insensitive) or cooling down */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Validation failed; body carries a reason code */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Edit rate-limit exceeded */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Internal server error */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-        };
-    };
-    pitpass_clear_trader_code: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TraderCodeResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Custom trader codes are not enabled */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Edit rate-limit exceeded */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Internal server error */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-        };
-    };
-    pitpass_get_trader_code_info: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /** @example 0x742d35cc6634c0532925a3b8d4060f31e2c3d8b5 */
-                code: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["GetTraderCodeInfoResponse"];
-                };
-            };
-            /** @description Code not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Internal server error */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-        };
-    };
-    pitpass_get_my_referral_position: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["GetMyReferralPositionResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read 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;
-            };
-        };
-    };
-    pitpass_get_my_referral_downline: {
-        parameters: {
-            query?: {
-                /** @description `earningsBySource` rows per page (max 500) */
-                pageSize?: number;
-                /**
-                 * @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;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["GetMyReferralDownlineResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read 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;
-            };
-        };
-    };
-    pitpass_get_my_referral_tree: {
-        parameters: {
-            query?: {
-                parent?: string;
-                /** @description Nodes per page (max 200) */
-                pageSize?: number;
-                /**
-                 * @description Opaque cursor from a previous response's `nextPageToken`; omit or send an
-                 *      empty string for the first page. Only valid with the same `parent`.
-                 */
-                pageToken?: string;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["GetMyReferralTreeResponse"];
-                };
-            };
-            /** @description Invalid `parent` wallet address, `pageSize`, or `pageToken` */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description `parent` is not the caller or one of the caller's own expandable referees */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read 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;
-            };
-        };
-    };
-    pitpass_get_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"]["GetRewardsBalanceResponse"];
-                };
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read 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;
-            };
-        };
-    };
-    pitpass_transfer_rewards: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["TransferRewardsRequest"];
-            };
-        };
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TransferRewardsResponse"];
-                };
-            };
-            /** @description Invalid token or amount */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Authentication required */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Insufficient rewards balance */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Movement rate limit exceeded — withdrawals, collateral transfers and reward 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;
-            };
-        };
-    };
     list_positions: {
         parameters: {
             query?: {