@0xmonaco/types 1.0.32 → 1.0.33-develop.c485f61

package/dist/pitpass/index.d.ts

@@ -4,7 +4,7 @@
  * Types for PitPass TraderCode API: code lookup, rewards balance, and transfer.
  */
 import type { BaseAPI } from "../api";
-import type { GetRewardsBalanceResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "./responses";
+import type { GetRewardsBalanceResponse, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "./responses";
 /**
  * PitPass TraderCode API interface.
  *
@@ -14,14 +14,50 @@ import type { GetRewardsBalanceResponse, TraderCodeInfoResponse, TraderCodeRespo
  */
 export interface PitpassAPI extends BaseAPI {
     /**
-     * Return the authenticated caller's TraderCode (their normalized wallet address).
+     * Return the authenticated caller's TraderCode.
      *
      * Never 404s — every signed-in wallet has a derivable code. Ensures the
      * backing row so referrals attributed to this wallet have a code to link.
+     * The response carries both the permanent wallet-derived `code` and the
+     * custom-handle fields (`customCode`, `isCustom`, `display`).
      *
-     * @returns Promise resolving to the caller's TraderCode and its creation timestamp
+     * @returns Promise resolving to the caller's TraderCode identity and its creation timestamp
      */
     getMyTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Claim or edit the authenticated caller's custom (vanity) TraderCode handle.
+     *
+     * The handle is stored exactly as entered (case preserved); uniqueness is
+     * enforced case-insensitively by the server. The client validates the handle
+     * (letter-first `[A-Za-z0-9_]`, length 5–20) before sending. The server is
+     * the authoritative gate: it returns 409 when the handle is taken, 422 with a
+     * reason on validation failure, 429 when the per-hour edit limit is hit, and
+     * 403 when the feature is disabled.
+     *
+     * @param code - The custom handle to claim or edit to, exactly as entered
+     * @returns Promise resolving to the caller's updated TraderCode identity
+     */
+    setTraderCode(code: string): Promise<TraderCodeResponse>;
+    /**
+     * Clear the caller's custom TraderCode handle, reverting to the
+     * wallet-derived default. The freed handle enters a cooldown before anyone
+     * else can claim it.
+     *
+     * @returns Promise resolving to the caller's TraderCode identity after the revert
+     */
+    clearTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Public, unauthenticated advisory check of whether a custom TraderCode
+     * handle is available (as-you-type UX).
+     *
+     * Advisory only — the authoritative gate is the atomic claim in
+     * {@link setTraderCode}, so a positive result here is not a reservation.
+     * Returns `available` plus, when unavailable, a `reason` code.
+     *
+     * @param code - The custom handle to check
+     * @returns Promise resolving to availability and, when unavailable, the reason
+     */
+    checkTraderCodeAvailability(code: string): Promise<TraderCodeAvailabilityResponse>;
     /**
      * Public, unauthenticated lookup of a TraderCode.
      *
@@ -56,5 +92,5 @@ export interface PitpassAPI extends BaseAPI {
      */
     transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
 }
-export type { GetRewardsBalanceResponse, RewardsBalanceEntry, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse, } from "./responses";
-export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";
+export type { GetRewardsBalanceResponse, RewardsBalanceEntry, SetTraderCodeParams, TraderCodeAvailabilityReason, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse, } from "./responses";
+export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, SetTraderCodeParamsSchema, TraderCodeAvailabilityReasonSchema, TraderCodeAvailabilityResponseSchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/pitpass/index.js

@@ -3,4 +3,4 @@
  *
  * Types for PitPass TraderCode API: code lookup, rewards balance, and transfer.
  */
-export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";
+export { GetRewardsBalanceResponseSchema, RewardsBalanceEntrySchema, SetTraderCodeParamsSchema, TraderCodeAvailabilityReasonSchema, TraderCodeAvailabilityResponseSchema, TraderCodeInfoResponseSchema, TraderCodeResponseSchema, TransferRewardsParamsSchema, TransferRewardsResponseSchema, } from "./responses";

package/dist/pitpass/responses.d.ts

@@ -21,6 +21,37 @@ export declare const GetRewardsBalanceResponseSchema: z.ZodObject<{
 export declare const TraderCodeResponseSchema: z.ZodObject<{
     code: z.ZodString;
     createdAt: z.ZodString;
+    customCode: z.ZodString;
+    isCustom: z.ZodBoolean;
+    display: z.ZodString;
+}, z.core.$strip>;
+/**
+ * The reason a custom TraderCode handle is unavailable, as reported by the
+ * advisory availability check. Empty/absent when the handle is available.
+ */
+export declare const TraderCodeAvailabilityReasonSchema: z.ZodEnum<{
+    taken: "taken";
+    too_short: "too_short";
+    too_long: "too_long";
+    reserved: "reserved";
+    invalid_char: "invalid_char";
+    looks_like_address: "looks_like_address";
+}>;
+/** Schema for the custom TraderCode availability check response. */
+export declare const TraderCodeAvailabilityResponseSchema: z.ZodObject<{
+    available: z.ZodBoolean;
+    reason: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
+        taken: "taken";
+        too_short: "too_short";
+        too_long: "too_long";
+        reserved: "reserved";
+        invalid_char: "invalid_char";
+        looks_like_address: "looks_like_address";
+    }>>>;
+}, z.core.$strip>;
+/** Schema for the set-custom-TraderCode request params (claim or edit). */
+export declare const SetTraderCodeParamsSchema: z.ZodObject<{
+    code: z.ZodString;
 }, z.core.$strip>;
 /** Schema for the public TraderCode info response. */
 export declare const TraderCodeInfoResponseSchema: z.ZodObject<{
@@ -39,6 +70,9 @@ export declare const TransferRewardsResponseSchema: z.ZodObject<{
 export type RewardsBalanceEntry = z.infer<typeof RewardsBalanceEntrySchema>;
 export type GetRewardsBalanceResponse = z.infer<typeof GetRewardsBalanceResponseSchema>;
 export type TraderCodeResponse = z.infer<typeof TraderCodeResponseSchema>;
+export type TraderCodeAvailabilityReason = z.infer<typeof TraderCodeAvailabilityReasonSchema>;
+export type TraderCodeAvailabilityResponse = z.infer<typeof TraderCodeAvailabilityResponseSchema>;
+export type SetTraderCodeParams = z.infer<typeof SetTraderCodeParamsSchema>;
 export type TraderCodeInfoResponse = z.infer<typeof TraderCodeInfoResponseSchema>;
 export type TransferRewardsParams = z.infer<typeof TransferRewardsParamsSchema>;
 export type TransferRewardsResponse = z.infer<typeof TransferRewardsResponseSchema>;

package/dist/pitpass/responses.js

@@ -19,10 +19,60 @@ export const GetRewardsBalanceResponseSchema = z.object({
 });
 /** Schema for a TraderCode response. */
 export const TraderCodeResponseSchema = z.object({
-    /** The caller's TraderCode — their normalized wallet address. */
+    /**
+     * The caller's TraderCode — their normalized wallet address. Always present;
+     * the permanent reward identity and a public alias even when a custom handle
+     * is set.
+     */
     code: z.string(),
     /** RFC 3339 timestamp when the code row was first derived. */
     createdAt: z.string(),
+    /**
+     * The caller's custom vanity handle, exactly as entered (case preserved), or
+     * an empty string when the wallet-derived default is kept. Use {@link isCustom}
+     * to disambiguate.
+     */
+    customCode: z.string(),
+    /** True when a custom handle is set; false when the wallet-derived default is in effect. */
+    isCustom: z.boolean(),
+    /**
+     * The single human-facing string to render: the custom handle when set,
+     * otherwise the `Monaco - <address>` default form.
+     */
+    display: z.string(),
+});
+/**
+ * The reason a custom TraderCode handle is unavailable, as reported by the
+ * advisory availability check. Empty/absent when the handle is available.
+ */
+export const TraderCodeAvailabilityReasonSchema = z.enum(["taken", "too_short", "too_long", "reserved", "invalid_char", "looks_like_address"]);
+/** Schema for the custom TraderCode availability check response. */
+export const TraderCodeAvailabilityResponseSchema = z.object({
+    /** True when the handle passes validation and is neither live nor cooling down. */
+    available: z.boolean(),
+    /**
+     * When unavailable, the reason code; omitted when the handle is available.
+     *
+     * The API always serializes `reason`, sending the empty string `""` (proto3
+     * string default) when the handle is available. Normalize that sentinel (and
+     * `null`) to `undefined` so an available response parses cleanly and consumers
+     * can treat `reason` as absent.
+     */
+    reason: z.preprocess((value) => (value === "" || value === null ? undefined : value), TraderCodeAvailabilityReasonSchema.optional()),
+});
+/** Schema for the set-custom-TraderCode request params (claim or edit). */
+export const SetTraderCodeParamsSchema = z.object({
+    /**
+     * The custom handle to claim or edit to. Case is preserved on store;
+     * uniqueness is enforced case-insensitively by the server. Client-side
+     * validation is case-preserving: a letter-first `[A-Za-z0-9_]` handle of
+     * length 5–20.
+     */
+    code: z
+        .string()
+        .trim()
+        .min(1, "code is required")
+        .regex(/^[A-Za-z][A-Za-z0-9_]{4,19}$/, "code must start with a letter and be 5–20 chars of letters, digits, or underscores"),
 });
 /** Schema for the public TraderCode info response. */
 export const TraderCodeInfoResponseSchema = z.object({

package/dist/positions/index.d.ts

@@ -70,6 +70,25 @@ export interface Position {
      * percentage. Terminal rows only; absent when unavailable.
      */
     realizedRoe?: string;
+    /**
+     * Volume-weighted average price across the position's reducing executions.
+     * Positions closed in several fills exit at this price, not at the final
+     * fill or the mark at close. Terminal rows only; absent when the position's
+     * reducing executions do not account for its whole lifetime.
+     */
+    exitPrice?: string;
+    /**
+     * Lifetime funding paid (signed; negative means received), summed over the
+     * position's reducing executions. Terminal rows only; absent when
+     * unavailable.
+     */
+    fundingPaid?: string;
+    /**
+     * Trading fees paid on the position's reducing executions (signed; negative
+     * means rebated). Closing-side fees only — fees on opening fills are not
+     * included. Terminal rows only; absent when unavailable.
+     */
+    feesPaid?: string;
 }
 export interface ListPositionsParams {
     marginAccountId?: string;

package/dist/websocket/events/balance-events.d.ts

@@ -2,7 +2,7 @@
  * User Balance WebSocket Event Types
  *
  * Types for real-time user balance update events.
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */
 import type { Address } from "viem";
 /**

package/dist/websocket/events/balance-events.js

@@ -2,5 +2,5 @@
  * User Balance WebSocket Event Types
  *
  * Types for real-time user balance update events.
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */

package/dist/websocket/events/movement-events.d.ts

@@ -2,7 +2,7 @@
  * User Movement WebSocket Event Types
  *
  * Types for real-time user ledger movement events (deposits, withdrawals, transfers).
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */
 import type { Address } from "viem";
 /**

package/dist/websocket/events/movement-events.js

@@ -2,5 +2,5 @@
  * User Movement WebSocket Event Types
  *
  * Types for real-time user ledger movement events (deposits, withdrawals, transfers).
- * This is an authenticated channel - requires JWT token.
+ * This is an authenticated channel - requires the signed session-key handshake.
  */

package/dist/wire/operations.d.ts

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

package/dist/wire/operations.js

@@ -21,6 +21,8 @@ export const OPERATION_IDS = [
     "batch_replace_orders",
     "cancel_conditional_order",
     "cancel_order",
+    "check_trader_code_availability",
+    "clear_trader_code",
     "close_position",
     "create_challenge",
     "create_delegated_session",
@@ -98,6 +100,7 @@ export const OPERATION_IDS = [
     "replace_order",
     "revoke_delegated_agent",
     "revoke_session",
+    "set_trader_code",
     "simulate_fees",
     "simulate_order_risk",
     "simulate_parent_margin_order_risk",

package/dist/wire/schema.d.ts

@@ -1496,8 +1496,17 @@ export interface paths {
          * Batch replace orders
          * @description Batch replace orders.
          *
-         *      Replace multiple orders in a single batch. Each order is processed
-         *      sequentially through the matching engine.
+         *      Replace multiple orders in one engine step with per-item results: every
+         *      original is cancelled first, then each replacement is placed in request
+         *      order. A
+         *      two-sided quote can therefore shift across its own resting prices in one
+         *      call, and a replacement may use funds freed by any original in the batch.
+         *
+         *      Failure semantics: an item that fails validation, or whose original
+         *      cannot be found, leaves the original resting. An item whose replacement
+         *      fails to PLACE (for example insufficient balance or self-trade
+         *      prevention) reports the error with its original already cancelled — the
+         *      original is never silently left resting after a failed replacement.
          */
         post: operations["batch_replace_orders"];
         delete?: never;
@@ -1594,6 +1603,31 @@ 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
+         * @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["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;
@@ -1621,6 +1655,44 @@ export interface paths {
         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
+         * @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["set_trader_code"];
+        post?: never;
+        /**
+         * Clear your custom TraderCode
+         * @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["clear_trader_code"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/pitpass/codes/{code}": {
         parameters: {
             query?: never;
@@ -2855,6 +2927,18 @@ export interface components {
              */
             value?: string | null;
         };
+        CheckTraderCodeAvailabilityResponse: {
+            /**
+             * @description True when the handle passes validation and is neither live nor cooling down.
+             * @example false
+             */
+            available?: boolean | null;
+            /**
+             * @description When unavailable, the snake_case reason: one of `taken`, `too_short`, `too_long`, `reserved`, `invalid_char`, `looks_like_address`. Empty when available.
+             * @example taken
+             */
+            reason?: string | null;
+        };
         ClosePositionRequest: {
             quantity?: string | null;
             closeType?: string | null;
@@ -4317,6 +4401,26 @@ export interface components {
              *      executions do not account for its whole lifetime.
              */
             realizedRoe?: string | null;
+            /**
+             * @description Volume-weighted average price across the position's reducing executions.
+             *      Positions closed in several fills exit at this price, not at the final
+             *      fill or the mark at close. Terminal rows only; absent when the position's
+             *      reducing executions do not account for its whole lifetime.
+             */
+            exitPrice?: string | null;
+            /**
+             * @description Lifetime funding paid (signed; negative means received), summed over the
+             *      position's reducing executions. Terminal rows only; absent when the
+             *      position's reducing executions do not account for its whole lifetime.
+             */
+            fundingPaid?: string | null;
+            /**
+             * @description Trading fees paid on the position's reducing executions (signed; negative
+             *      means rebated). Closing-side fees only — fees on opening fills are not
+             *      included. Terminal rows only; absent when the position's reducing
+             *      executions do not account for its whole lifetime.
+             */
+            feesPaid?: string | null;
         };
         GetPositionRiskResponse: {
             positionId?: string | null;
@@ -5483,6 +5587,26 @@ export interface components {
              *      executions do not account for its whole lifetime.
              */
             realizedRoe?: string | null;
+            /**
+             * @description Volume-weighted average price across the position's reducing executions.
+             *      Positions closed in several fills exit at this price, not at the final
+             *      fill or the mark at close. Terminal rows only; absent when the position's
+             *      reducing executions do not account for its whole lifetime.
+             */
+            exitPrice?: string | null;
+            /**
+             * @description Lifetime funding paid (signed; negative means received), summed over the
+             *      position's reducing executions. Terminal rows only; absent when the
+             *      position's reducing executions do not account for its whole lifetime.
+             */
+            fundingPaid?: string | null;
+            /**
+             * @description Trading fees paid on the position's reducing executions (signed; negative
+             *      means rebated). Closing-side fees only — fees on opening fills are not
+             *      included. Terminal rows only; absent when the position's reducing
+             *      executions do not account for its whole lifetime.
+             */
+            feesPaid?: string | null;
         };
         PositionHistoryEvent: {
             id?: string | null;
@@ -5898,6 +6022,13 @@ export interface components {
              */
             priceChangePercent?: string | null;
         };
+        SetTraderCodeRequest: {
+            /**
+             * @description The custom handle to claim or edit to: `[A-Za-z0-9_]`, must start with a letter, 5–20 characters. Case is preserved on store; uniqueness is case-insensitive.
+             * @example CryptoKing
+             */
+            code: string;
+        };
         SimulateFeesResponse: {
             /**
              * @description Notional value (price x quantity)
@@ -6248,7 +6379,7 @@ export interface components {
         };
         TraderCodeResponse: {
             /**
-             * @description Your TraderCode — your normalized wallet address (clients render it `Monaco - <address>`).
+             * @description Your TraderCode — your normalized wallet address (clients render it `Monaco - <address>`). Always present; the permanent reward identity and a public alias even when a custom handle is set.
              * @example 0x0000000000000000000000000000000000000002
              */
             code?: string | null;
@@ -6257,6 +6388,21 @@ export interface components {
              * @example 2026-07-07T18:00:00Z
              */
             createdAt?: string | null;
+            /**
+             * @description Your custom vanity handle, exactly as entered (case preserved), or an empty string when the wallet-derived default is kept. Use `is_custom` to disambiguate.
+             * @example CryptoKing
+             */
+            customCode?: string | null;
+            /**
+             * @description True when a custom handle is set; false when the wallet-derived default is in effect.
+             * @example true
+             */
+            isCustom?: boolean | null;
+            /**
+             * @description The single human-facing string to render: the custom handle when set, otherwise the `Monaco - <address>` default form.
+             * @example CryptoKing
+             */
+            display?: string | null;
         };
         /** @description Trading pair configuration including tokens, fees, and order limits. */
         TradingPairData: {
@@ -10077,6 +10223,42 @@ export interface operations {
             };
         };
     };
+    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;
+            };
+        };
+    };
     get_my_trader_code: {
         parameters: {
             query?: never;
@@ -10111,6 +10293,120 @@ export interface operations {
             };
         };
     };
+    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;
+            };
+        };
+    };
+    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;
+            };
+        };
+    };
     get_trader_code_info: {
         parameters: {
             query?: never;

package/package.json

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