@0xmonaco/types 1.0.70 → 1.0.72

package/dist/auth/index.d.ts

@@ -77,8 +77,10 @@ export interface AuthAPI extends BaseAPI {
      */
     verifySignature(address: string, signature: string, nonce: string, clientId: string, session: SessionCredentials, referralCode?: string): Promise<AuthState>;
     /**
-     * Extends the current session's expiry. The request is signed with the
-     * active session key (set via {@link setSessionKeypair}).
+     * Refreshes the current session's expiry. The request is signed with the
+     * active session key (set via {@link setSessionKeypair}). For a delegated
+     * session, the returned expiry is capped by the active delegation and may
+     * move earlier if the owner shortened that delegation.
      * @returns Promise resolving to the new expiry
      */
     refreshSession(): Promise<SessionRefreshResponse>;

package/dist/auth/responses.d.ts

@@ -78,7 +78,9 @@ export interface SessionCredentials {
     privateKey: string;
 }
 /**
- * Response to a session refresh request — extends the session's expiry.
+ * Response to a session refresh request with the resulting expiry. For a
+ * delegated session, this remains capped by the active delegation and may move earlier
+ * if the owner shortened that delegation.
  */
 export interface SessionRefreshResponse {
     /** Unix timestamp when the session expires after refresh */

package/dist/copy-trading/index.d.ts

@@ -6,8 +6,8 @@
  * into it. Leaders are addressed by their custom TraderCode handle.
  */
 import type { BaseAPI } from "../api";
-import type { ListLeadTraderClosedTradesParams, ListLeadTradersParams, ListMyFollowersParams, ListMyFollowsParams, PreviewFollowParams, UpsertFollowParams, UpsertLeadTraderParams } from "../validation/copy-trading";
-import type { GetFollowResponse, GetLeadTraderResponse, ListFollowLeaderPositionsResponse, ListLeadTraderClosedTradesResponse, ListLeadTraderOpenPositionsResponse, ListLeadTradersResponse, ListMyFollowersResponse, ListMyFollowsResponse, PreviewFollowResponse, StopFollowResponse, UpsertFollowResponse, UpsertLeadTraderResponse } from "./responses";
+import type { AddFollowPositionMarginParams, ListLeadTraderClosedTradesParams, ListLeadTradersParams, ListMyFollowersParams, ListMyFollowsParams, PreviewFollowParams, UpsertFollowParams, UpsertLeadTraderParams } from "../validation/copy-trading";
+import type { AddFollowPositionMarginResponse, CloseAllCopyPositionsResponse, CloseFollowPositionsResponse, GetFollowResponse, GetLeadTraderResponse, ListFollowLeaderPositionsResponse, ListLeadTraderClosedTradesResponse, ListLeadTraderOpenPositionsResponse, ListLeadTradersResponse, ListMyFollowersResponse, ListMyFollowsResponse, PreviewFollowResponse, StopFollowResponse, UpsertFollowResponse, UpsertLeadTraderResponse } from "./responses";
 /**
  * Copy trading API.
  *
@@ -69,6 +69,54 @@ export interface CopyTradingAPI extends BaseAPI {
      * cannot stop a follow (403).
      */
     stopFollow(followId: string): Promise<StopFollowResponse>;
+    /**
+     * Close every position in one of your follows' copy accounts at market
+     * (reduce-only, immediate-or-cancel) and cancel the resting orders and
+     * conditional orders (TP/SL) on its copy risk buckets, keeping the follow:
+     * the leader's next trades keep mirroring. `stopFollow` is the
+     * close-and-stop path. Proceeds stay in the copy account. Not a flatten
+     * guarantee: a thin or halted market can leave part of a position open
+     * (`positionsNotClosed`), and a leader trade after the close opens copies
+     * again. Never gated by copy trading being off or an operations block; only
+     * a delegated agent session is refused (403). Both close methods share a
+     * small per-account rate limit (about one per second, burst 5; 429 with
+     * Retry-After). 404 for a follow that is not yours; 409 for a stopped
+     * follow or one whose stop is in progress; 400 when the close was refused;
+     * 503 when it cannot run right now. The response is sent once the batch is
+     * durably logged; fills arrive on the order, position and copy channels.
+     */
+    closeFollowPositions(followId: string): Promise<CloseFollowPositionsResponse>;
+    /**
+     * Close the copy positions of every live follow of yours, as
+     * `closeFollowPositions` does for one, keeping the follows. Follows whose
+     * stop is in progress are listed in `stoppingFollowIds`; a follow whose
+     * close could not run is listed in `failedFollows` with a fixed reason
+     * while the others still close.
+     */
+    closeAllCopyPositions(): Promise<CloseAllCopyPositionsResponse>;
+    /**
+     * Add margin to one of your copy positions: moves `amount` (quote units)
+     * from the follow's copy account into the margin of its isolated copy
+     * position on `tradingPairId`. The position's margin rises by exactly
+     * `amount` and the copy account's remaining collateral falls by the same;
+     * your margin account is never touched. It lowers the position's leverage
+     * and moves its liquidation price away, and opens no exposure, so it works
+     * while copy trading is switched off and on a `CLOSE_ONLY` follow. There
+     * is no margin reduction: a follow exits by being stopped.
+     *
+     * Master account sessions only (a delegated agent or a sub-account gets
+     * 403); 404 for a follow that is not yours; 409 while the follow is
+     * stopping or once it is stopped, or `COPY_TRADING_UNAVAILABLE` when copy
+     * trading is not available on the platform; 400 `COPY_TRADING_REJECTED`
+     * when the engine refuses (no isolated copy position on the pair, the
+     * position or the margin account is being liquidated, the position has
+     * lost more than its margin, more than the copy account can put in); 429
+     * over the movement budget withdrawals and collateral transfers share.
+     *
+     * Not idempotent: a retry after a timeout whose first attempt landed adds
+     * the amount twice, so read the follow before retrying.
+     */
+    addFollowPositionMargin(params: AddFollowPositionMarginParams): Promise<AddFollowPositionMarginResponse>;
     /** List your follows, newest first. Cursor paged, up to 1000 per page. */
     listMyFollows(params?: ListMyFollowsParams): Promise<ListMyFollowsResponse>;
     /**
@@ -91,5 +139,5 @@ export interface CopyTradingAPI extends BaseAPI {
      */
     previewFollow(params: PreviewFollowParams): Promise<PreviewFollowResponse>;
 }
-export type { ClosedTrade, ClosedTradeAction, CopySkip, Follow, Follower, GetFollowResponse, GetLeadTraderResponse, LeadTraderFollowSummary, LeadTraderListing, LeadTraderOpenPosition, LeadTraderProfile, LeadTraderRef, LeadTraderSort, LeadTraderStats, LeadTraderStatsWindow, LeadTraderStatus, ListFollowLeaderPositionsResponse, ListLeadTraderClosedTradesResponse, ListLeadTraderOpenPositionsResponse, ListLeadTradersResponse, ListMyFollowersResponse, ListMyFollowsResponse, PreviewFollowResponse, StopFollowResponse, UpsertFollowResponse, UpsertLeadTraderResponse, } from "./responses";
-export { ClosedTradeSchema, CopySkipSchema, FollowerSchema, FollowSchema, GetFollowResponseSchema, GetLeadTraderResponseSchema, LeadTraderFollowSummarySchema, LeadTraderListingSchema, LeadTraderOpenPositionSchema, LeadTraderProfileSchema, LeadTraderRefSchema, LeadTraderStatsSchema, ListFollowLeaderPositionsResponseSchema, ListLeadTraderClosedTradesResponseSchema, ListLeadTraderOpenPositionsResponseSchema, ListLeadTradersResponseSchema, ListMyFollowersResponseSchema, ListMyFollowsResponseSchema, PreviewFollowResponseSchema, StopFollowResponseSchema, UpsertFollowResponseSchema, UpsertLeadTraderResponseSchema, } from "./responses";
+export type { AddFollowPositionMarginResponse, CloseAllCopyPositionsResponse, ClosedTrade, ClosedTradeAction, CloseFollowPositionsResponse, CopySkip, Follow, FollowCloseFailure, Follower, GetFollowResponse, GetLeadTraderResponse, LeadTraderFollowSummary, LeadTraderListing, LeadTraderOpenPosition, LeadTraderProfile, LeadTraderRef, LeadTraderSort, LeadTraderStats, LeadTraderStatsWindow, LeadTraderStatus, ListFollowLeaderPositionsResponse, ListLeadTraderClosedTradesResponse, ListLeadTraderOpenPositionsResponse, ListLeadTradersResponse, ListMyFollowersResponse, ListMyFollowsResponse, PreviewFollowResponse, StopFollowResponse, UpsertFollowResponse, UpsertLeadTraderResponse, } from "./responses";
+export { AddFollowPositionMarginResponseSchema, CloseAllCopyPositionsResponseSchema, ClosedTradeSchema, CloseFollowPositionsResponseSchema, CopySkipSchema, FollowCloseFailureSchema, FollowerSchema, FollowSchema, GetFollowResponseSchema, GetLeadTraderResponseSchema, LeadTraderFollowSummarySchema, LeadTraderListingSchema, LeadTraderOpenPositionSchema, LeadTraderProfileSchema, LeadTraderRefSchema, LeadTraderStatsSchema, ListFollowLeaderPositionsResponseSchema, ListLeadTraderClosedTradesResponseSchema, ListLeadTraderOpenPositionsResponseSchema, ListLeadTradersResponseSchema, ListMyFollowersResponseSchema, ListMyFollowsResponseSchema, PreviewFollowResponseSchema, StopFollowResponseSchema, UpsertFollowResponseSchema, UpsertLeadTraderResponseSchema, } from "./responses";

package/dist/copy-trading/index.js

@@ -5,4 +5,4 @@
  * bucket in their margin account) and every fill the leader makes is mirrored
  * into it. Leaders are addressed by their custom TraderCode handle.
  */
-export { ClosedTradeSchema, CopySkipSchema, FollowerSchema, FollowSchema, GetFollowResponseSchema, GetLeadTraderResponseSchema, LeadTraderFollowSummarySchema, LeadTraderListingSchema, LeadTraderOpenPositionSchema, LeadTraderProfileSchema, LeadTraderRefSchema, LeadTraderStatsSchema, ListFollowLeaderPositionsResponseSchema, ListLeadTraderClosedTradesResponseSchema, ListLeadTraderOpenPositionsResponseSchema, ListLeadTradersResponseSchema, ListMyFollowersResponseSchema, ListMyFollowsResponseSchema, PreviewFollowResponseSchema, StopFollowResponseSchema, UpsertFollowResponseSchema, UpsertLeadTraderResponseSchema, } from "./responses";
+export { AddFollowPositionMarginResponseSchema, CloseAllCopyPositionsResponseSchema, ClosedTradeSchema, CloseFollowPositionsResponseSchema, CopySkipSchema, FollowCloseFailureSchema, FollowerSchema, FollowSchema, GetFollowResponseSchema, GetLeadTraderResponseSchema, LeadTraderFollowSummarySchema, LeadTraderListingSchema, LeadTraderOpenPositionSchema, LeadTraderProfileSchema, LeadTraderRefSchema, LeadTraderStatsSchema, ListFollowLeaderPositionsResponseSchema, ListLeadTraderClosedTradesResponseSchema, ListLeadTraderOpenPositionsResponseSchema, ListLeadTradersResponseSchema, ListMyFollowersResponseSchema, ListMyFollowsResponseSchema, PreviewFollowResponseSchema, StopFollowResponseSchema, UpsertFollowResponseSchema, UpsertLeadTraderResponseSchema, } from "./responses";

package/dist/copy-trading/responses.d.ts

@@ -349,6 +349,45 @@ export declare const PreviewFollowResponseSchema: z.ZodObject<{
 export declare const StopFollowResponseSchema: z.ZodObject<{
     followId: z.ZodString;
 }, z.core.$strip>;
+/**
+ * One follow's copy positions closing: a batch acknowledgement, sent once the
+ * batch is durably logged. The closes are reduce-only and immediate-or-cancel;
+ * each one's fills arrive on the order, position and copy channels. Not a
+ * flatten guarantee: `positionsNotClosed` counts what a thin or halted market
+ * left open.
+ */
+export declare const CloseFollowPositionsResponseSchema: z.ZodObject<{
+    followId: z.ZodString;
+    closeOrdersPlaced: z.ZodNumber;
+    positionsNotClosed: z.ZodNumber;
+}, z.core.$strip>;
+/** A follow whose close could not run. */
+export declare const FollowCloseFailureSchema: z.ZodObject<{
+    followId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+/** Result of closing all your copy positions. */
+export declare const CloseAllCopyPositionsResponseSchema: z.ZodObject<{
+    follows: z.ZodArray<z.ZodObject<{
+        followId: z.ZodString;
+        closeOrdersPlaced: z.ZodNumber;
+        positionsNotClosed: z.ZodNumber;
+    }, z.core.$strip>>;
+    stoppingFollowIds: z.ZodArray<z.ZodString>;
+    failedFollows: z.ZodArray<z.ZodObject<{
+        followId: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Result of adding margin to one of your copy positions. */
+export declare const AddFollowPositionMarginResponseSchema: z.ZodObject<{
+    followId: z.ZodString;
+    tradingPairId: z.ZodString;
+    riskBucketId: z.ZodString;
+    positionId: z.ZodString;
+    positionMargin: z.ZodString;
+    copyAccountAvailable: z.ZodString;
+}, z.core.$strip>;
 export type LeadTraderRef = z.infer<typeof LeadTraderRefSchema>;
 export type LeadTraderProfile = z.infer<typeof LeadTraderProfileSchema>;
 export type LeadTraderFollowSummary = z.infer<typeof LeadTraderFollowSummarySchema>;
@@ -370,4 +409,8 @@ export type GetFollowResponse = z.infer<typeof GetFollowResponseSchema>;
 export type ListFollowLeaderPositionsResponse = z.infer<typeof ListFollowLeaderPositionsResponseSchema>;
 export type UpsertFollowResponse = z.infer<typeof UpsertFollowResponseSchema>;
 export type StopFollowResponse = z.infer<typeof StopFollowResponseSchema>;
+export type CloseFollowPositionsResponse = z.infer<typeof CloseFollowPositionsResponseSchema>;
+export type FollowCloseFailure = z.infer<typeof FollowCloseFailureSchema>;
+export type CloseAllCopyPositionsResponse = z.infer<typeof CloseAllCopyPositionsResponseSchema>;
 export type PreviewFollowResponse = z.infer<typeof PreviewFollowResponseSchema>;
+export type AddFollowPositionMarginResponse = z.infer<typeof AddFollowPositionMarginResponseSchema>;

package/dist/copy-trading/responses.js

@@ -266,3 +266,52 @@ export const StopFollowResponseSchema = z.object({
     /** The stopped follow's id. */
     followId: z.string(),
 });
+/**
+ * One follow's copy positions closing: a batch acknowledgement, sent once the
+ * batch is durably logged. The closes are reduce-only and immediate-or-cancel;
+ * each one's fills arrive on the order, position and copy channels. Not a
+ * flatten guarantee: `positionsNotClosed` counts what a thin or halted market
+ * left open.
+ */
+export const CloseFollowPositionsResponseSchema = z.object({
+    /** The follow's id. */
+    followId: z.string(),
+    /** Close orders placed (each may fill in part). */
+    closeOrdersPlaced: z.number(),
+    /** Copy positions still open after the batch (for example a thin or halted market). */
+    positionsNotClosed: z.number(),
+});
+/** A follow whose close could not run. */
+export const FollowCloseFailureSchema = z.object({
+    /** The follow's id. */
+    followId: z.string(),
+    /** Why the close could not run, as a fixed sentence; retry the close. */
+    reason: z.string(),
+});
+/** Result of closing all your copy positions. */
+export const CloseAllCopyPositionsResponseSchema = z.object({
+    /**
+     * Every live follow whose stop is not in progress and whose close ran,
+     * including one with nothing to close (0 orders placed, 0 positions not closed).
+     */
+    follows: z.array(CloseFollowPositionsResponseSchema),
+    /** Follows whose stop is in progress: their stop closes their positions. */
+    stoppingFollowIds: z.array(z.string()),
+    /** Follows whose close could not run; the other follows still closed. */
+    failedFollows: z.array(FollowCloseFailureSchema),
+});
+/** Result of adding margin to one of your copy positions. */
+export const AddFollowPositionMarginResponseSchema = z.object({
+    /** The follow's id. */
+    followId: z.string(),
+    /** Trading pair of the copy position. */
+    tradingPairId: z.string(),
+    /** The copy position's isolated risk bucket. */
+    riskBucketId: z.string(),
+    /** The copy position's id. */
+    positionId: z.string(),
+    /** The copy position's margin after the add, in quote units. */
+    positionMargin: z.string(),
+    /** What the copy account can still put into this position after the add, in quote units. */
+    copyAccountAvailable: z.string(),
+});

package/dist/delegated-agents/index.d.ts

@@ -4,6 +4,7 @@ export type DelegatedAgentAction = "CREATE_ORDER" | "CANCEL_ORDER" | "REPLACE_OR
 export interface UpsertDelegatedAgentRequest {
     agentAddress: string;
     name?: string;
+    /** Delegation expiry (ISO 8601); ends reads, trading, and session refresh. */
     expiresAt?: string;
     /** Required. An empty list permits no actions. */
     allowedActions: DelegatedAgentAction[];
@@ -61,6 +62,7 @@ export interface CreateDelegatedSessionRequest {
     sessionPublicKey: string;
 }
 export interface CreateDelegatedSessionResponse {
+    /** Unix seconds; bounded by delegation expiry. Revocation may end access sooner. */
     expiresAt: number;
     delegationId: string;
     ownerUserId: string;

package/dist/fees/index.d.ts

@@ -41,6 +41,9 @@ export interface FeesAPI extends BaseAPI {
      * spot/perp breakdown), the volume still needed to reach the next tier, and the
      * requested pair's six-row fee schedule (threshold plus maker/taker bps).
      *
+     * The tier and volumes are wallet-wide: the caller's wallet total across every
+     * application it trades through, so they read the same from any application.
+     *
      * @param params - Parameters for the lookup
      * @param params.tradingPairId - Trading pair whose fee schedule to return
      * @returns Promise resolving to the caller's tier and the pair's schedule

package/dist/fees/responses.js

@@ -126,13 +126,13 @@ export const FeeTierScheduleRowSchema = z.object({
  * Zod schema for the "my fee tier" response
  */
 export const GetMyFeeTierResponseSchema = z.object({
-    /** Caller's resolved tier (1–6) from stored weighted 14-day volume */
+    /** Caller's resolved tier (1–6) from their wallet's stored weighted 14-day volume */
     currentTierLevel: z.number().int(),
-    /** Caller's weighted 14-day volume (perp + 2.5× spot) */
+    /** Caller's weighted 14-day volume (perp + 2.5× spot), summed across every application the wallet trades through */
     weightedVolume14d: z.string(),
-    /** Caller's rolling 14-day spot volume */
+    /** Caller's rolling 14-day spot volume, summed across every application the wallet trades through */
     spotVolume14d: z.string(),
-    /** Caller's rolling 14-day perp volume */
+    /** Caller's rolling 14-day perp volume, summed across every application the wallet trades through */
     perpVolume14d: z.string(),
     /** Additional weighted volume needed to reach the next tier; absent at tier 6 */
     volumeToNextTier: z.string().nullable().optional(),

package/dist/validation/copy-trading.d.ts

@@ -70,6 +70,16 @@ export declare const PreviewFollowSchema: z.ZodObject<{
     allocation: z.ZodString;
     tradingPairIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
 }, z.core.$strict>;
+/**
+ * Params for adding margin to one of your copy positions: `amount` moves from
+ * the follow's copy account into the margin of its isolated copy position on
+ * `tradingPairId`. The follow id is sent in the path, the rest in the body.
+ */
+export declare const AddFollowPositionMarginSchema: z.ZodObject<{
+    followId: z.ZodUUID;
+    tradingPairId: z.ZodUUID;
+    amount: z.ZodString;
+}, z.core.$strict>;
 /** Params for the public leaderboard. */
 export declare const ListLeadTradersSchema: z.ZodObject<{
     pageSize: z.ZodOptional<z.ZodNumber>;
@@ -107,6 +117,7 @@ export declare const ListMyFollowersSchema: z.ZodObject<{
 export type UpsertLeadTraderParams = z.input<typeof UpsertLeadTraderSchema>;
 export type UpsertFollowParams = z.input<typeof UpsertFollowSchema>;
 export type PreviewFollowParams = z.input<typeof PreviewFollowSchema>;
+export type AddFollowPositionMarginParams = z.input<typeof AddFollowPositionMarginSchema>;
 export type ListLeadTradersParams = z.input<typeof ListLeadTradersSchema>;
 export type ListLeadTraderClosedTradesParams = z.input<typeof ListLeadTraderClosedTradesSchema>;
 export type ListMyFollowsParams = z.input<typeof ListMyFollowsSchema>;

package/dist/validation/copy-trading.js

@@ -123,6 +123,21 @@ export const PreviewFollowSchema = z
 })
     .strict()
     .superRefine((params, ctx) => termRules(params, ctx));
+/**
+ * Params for adding margin to one of your copy positions: `amount` moves from
+ * the follow's copy account into the margin of its isolated copy position on
+ * `tradingPairId`. The follow id is sent in the path, the rest in the body.
+ */
+export const AddFollowPositionMarginSchema = z
+    .object({
+    /** The follow's id. */
+    followId: UUIDSchema,
+    /** Trading pair of the copy position to add margin to. */
+    tradingPairId: UUIDSchema,
+    /** Margin to add, in quote units, taken from the follow's copy account. */
+    amount: PositiveDecimalStringSchema,
+})
+    .strict();
 /** Params for the public leaderboard. */
 export const ListLeadTradersSchema = z
     .object({

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

@@ -107,7 +107,7 @@ export interface PositionEventData {
     /**
      * What triggered the update. Free-form, but the server uses a canonical set:
      * `trade`, `close`, `liquidation`, `adl`, `funding`, `margin_added`,
-     * `margin_reduced`, `margin_collateral_transfer`.
+     * `margin_reduced`.
      */
     reason: string;
     /**
@@ -147,8 +147,8 @@ export interface PositionEventData {
      * anything was persisted. Four cases reach it: the frame came from a
      * producer that predates this field; the emit path wrote no row;
      * the path DID write the row but re-reads live risk state after sequencing
-     * (funding, `margin_added`/`margin_reduced`), so the mutation did advance
-     * the persisted version; or the frame is a different projection of the row
+     * (`funding`), so the mutation did advance the persisted version; or the
+     * frame is a different projection of the row
      * than persistence stores (terminal frames report `size` 0 and
      * `LIQUIDATED`, while the stored row keeps its size and records `CLOSED`).
      * In the last two, a REST read or a fresh snapshot ranks the mutation.
@@ -172,13 +172,17 @@ export interface PositionEventData {
      * mutation — up to the one-hour funding interval.
      *
      * A frame is ranked only when it is a faithful projection of the row
-     * persisted at that sequence: in practice the FILLS THAT LEAVE A POSITION
-     * OPEN. Unranked are (a) frames that re-read live risk state after their
-     * command was sequenced, since a later command can overtake that read —
-     * the `funding` and `margin_added`/`margin_reduced` frames — and (b)
-     * TERMINAL frames, which report `size` 0 and `LIQUIDATED` while the stored
-     * row keeps its size and records `CLOSED`. Those mutations still advance
-     * the persisted version, so REST and a fresh snapshot rank them.
+     * persisted at that sequence: fills that leave a position OPEN, direct
+     * isolated-position margin adds/reductions, and copy-position margin adds.
+     * The copy add refreshes the isolated child and its copy-cross siblings at
+     * the same version. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop
+     * refreshes use `margin_added`/`margin_reduced` but are UNRANKED because
+     * those commands write no position rows. Funding re-reads live state after
+     * sequencing and is also unranked. TERMINAL frames are unranked because
+     * they report `size` 0 and `LIQUIDATED` while the stored row keeps its size
+     * and records `CLOSED`. Wallet IN/OUT and plain isolated allocation emit no
+     * position frame. Transfer frames use captured post-command state and are
+     * released only after durable acknowledgement.
      */
     version?: number;
 }

package/dist/websocket/events/twap-order-events.d.ts

@@ -29,6 +29,13 @@ export type TwapOrderEventReason = "created" | "slice_placed" | "slice_skipped"
  */
 export interface TwapOrderEventData {
     twapOrderId: string;
+    /**
+     * Opaque same-parent reconciliation revision. Compare only updates for this
+     * `twapOrderId`: accept an update when its version is greater than or equal
+     * to the stored version, ignore lower versions, and expect gaps. A snapshot
+     * wins ties. Absent on legacy updates whose revision is unknown.
+     */
+    version?: number;
     tradingPairId: string;
     side: OrderSide | (string & {});
     tradingMode: TradingMode | (string & {});

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 ["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", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "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_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "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_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "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", "upsert_follow", "upsert_lead_trader", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_follow_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", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_all_copy_positions", "close_follow_positions", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "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_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "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_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "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", "upsert_follow", "upsert_lead_trader", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -11,6 +11,7 @@
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
 export const OPERATION_IDS = [
+    "add_follow_position_margin",
     "attach_position_tp_sl",
     "batch_cancel_all",
     "batch_cancel_all_by_pair",
@@ -25,6 +26,8 @@ export const OPERATION_IDS = [
     "claim_buildercode_rewards",
     "claim_managed_market_lease",
     "clear_trader_code",
+    "close_all_copy_positions",
+    "close_follow_positions",
     "close_position",
     "create_challenge",
     "create_delegated_session",

package/dist/wire/schema.d.ts

@@ -621,9 +621,11 @@ export interface paths {
          * Refresh session expiry
          * @description Refresh session expiry.
          *
-         *      Extends the expiration of the current session. The request must be signed
+         *      Refreshes the expiration of the current session. The request must be signed
          *      by the session private key (RFC 9421 or legacy X-Monaco-* headers); no body is
-         *      required.
+         *      required. Delegated sessions require an active, unexpired delegation;
+         *      their resulting expiry is capped by the delegation expiry and may move
+         *      earlier if the owner shortened that delegation.
          */
         post: operations["refresh_session"];
         delete?: never;
@@ -914,6 +916,36 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/copy-trading/follows/close-positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Close all your copy positions
+         * @description Close all your copy positions.
+         *
+         *      Closes the copy positions of every live follow of yours, as
+         *      CloseFollowPositions does for one: one batch per follow, the follows
+         *      kept, and the same limits (not a flatten guarantee; the follows keep
+         *      mirroring). A follow whose stop is in progress is listed in
+         *      `stoppingFollowIds` and left to its stop. A follow whose close could not
+         *      run is listed in `failedFollows` and the others still close. Never gated
+         *      by copy trading being switched off or by an operations block; only a
+         *      delegated agent session is refused. Shares CloseFollowPositions' rate
+         *      limit.
+         */
+        post: operations["close_all_copy_positions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/copy-trading/follows/preview": {
         parameters: {
             query?: never;
@@ -965,6 +997,41 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/copy-trading/follows/{followId}/close-positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Close a follow's copy positions
+         * @description Close a follow's copy positions.
+         *
+         *      Closes every position in the follow's copy account at market (reduce-only,
+         *      immediate-or-cancel) and cancels the resting orders and conditional
+         *      orders (TP/SL) on its copy risk buckets (a TWAP cannot run on a copy risk
+         *      bucket), but keeps the follow: it stays ACTIVE (or CLOSE_ONLY) and the
+         *      leader's next trades keep mirroring. StopFollow is the close-and-stop
+         *      path. The proceeds stay in the copy account. Not a flatten guarantee:
+         *      on a thin or halted market part of a position can stay open
+         *      (`positionsNotClosed`), and a leader trade after the close opens copy
+         *      positions again; stop the follow to end the copying. A close is never
+         *      gated by copy trading being switched off or by an operations block, and
+         *      only a delegated agent session is refused. Both close routes share a
+         *      small per-account rate limit (about one close per second, burst 5). The
+         *      response is sent once the batch is durably logged; each close's fills
+         *      arrive on the order, position and copy channels.
+         */
+        post: operations["close_follow_positions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/copy-trading/follows/{followId}/leader-positions": {
         parameters: {
             query?: never;
@@ -989,6 +1056,41 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/copy-trading/follows/{followId}/position-margin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Add margin to a copy position
+         * @description Add margin to a copy position (0XM-2971).
+         *
+         *      Moves collateral from the follow's copy account into the margin of its
+         *      isolated copy position on one trading pair: the position's margin rises
+         *      by exactly `amount`, the copy account's remaining collateral falls by the
+         *      same, and your margin account is never touched. It lowers the position's
+         *      leverage and moves its liquidation price away; it opens no exposure, so
+         *      it works while copy trading is switched off and on a CLOSE_ONLY follow.
+         *      There is no margin reduction: a follow exits by being stopped. Follow
+         *      writes need a master account session (not a delegated agent or a
+         *      sub-account). 404 unless the follow is yours; 409 while it is stopping
+         *      or once it is stopped, and when copy trading is not available on the
+         *      platform at all (the platform then runs copy trading exits only). It
+         *      spends the per-user movement budget withdrawals and collateral transfers
+         *      share. It is not idempotent: a retry after a timeout whose first attempt
+         *      landed adds the amount twice, so read the follow before retrying.
+         */
+        post: operations["add_follow_position_margin"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/copy-trading/follows/{followId}/stop": {
         parameters: {
             query?: never;
@@ -1242,7 +1344,9 @@ export interface paths {
          *      `ListDelegatedAgentOwners`) and a freshly generated session public key.
          *      The new session acts as the owner but records the agent's address for
          *      policy enforcement. Requires an active delegation for the (owner, agent)
-         *      pair.
+         *      pair. Session expiry is bounded by the delegation expiry, if set. Every
+         *      authenticated request and periodic WebSocket session revalidation requires
+         *      the backing delegation to remain active and unexpired.
          */
         post: operations["create_delegated_session"];
         delete?: never;
@@ -1266,8 +1370,9 @@ export interface paths {
          * @description Revoke a delegated agent.
          *
          *      Master accounts only. Revokes the delegation identified by
-         *      `delegated_agent_id`. Existing delegated sessions are not invalidated; only
-         *      future session creation is blocked.
+         *      `delegated_agent_id` and its existing delegated sessions. Subsequent signed
+         *      requests and session refresh fail; connected WebSockets lose access at
+         *      their next periodic session revalidation. Existing orders are not canceled.
          */
         delete: operations["revoke_delegated_agent"];
         options?: never;
@@ -1360,6 +1465,8 @@ export interface paths {
         /**
          * Get my fee tier and pair schedule
          * @description Return the caller's current fee tier, rolling 14-day volumes, and a pair's schedule.
+         *
+         *      Volumes and the tier are wallet-wide: the caller's wallet total across every application.
          */
         get: operations["get_my_fee_tier"];
         put?: never;
@@ -3039,6 +3146,55 @@ export interface components {
              */
             version?: number | null;
         };
+        AddFollowPositionMarginRequest: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * Format: uuid
+             * @description Trading pair UUID of the copy position to add margin to
+             */
+            tradingPairId?: string | null;
+            /**
+             * @description Margin to add, in quote units: a positive decimal, taken from the follow's copy account
+             * @example 25
+             */
+            amount?: string | null;
+        };
+        AddFollowPositionMarginResponse: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * Format: uuid
+             * @description Trading pair UUID of the copy position
+             */
+            tradingPairId?: string | null;
+            /**
+             * Format: uuid
+             * @description The copy position's isolated risk bucket
+             */
+            riskBucketId?: string | null;
+            /**
+             * Format: uuid
+             * @description The copy position's id
+             */
+            positionId?: string | null;
+            /**
+             * @description The copy position's margin after the add, in quote units
+             * @example 125
+             */
+            positionMargin?: string | null;
+            /**
+             * @description What the copy account can still put into this position, in quote units, after the add
+             * @example 875
+             */
+            copyAccountAvailable?: string | null;
+        };
         AppUser: {
             /**
              * Format: uuid
@@ -3973,6 +4129,37 @@ export interface components {
             /** @description Required when renewing an unexpired lease. Decimal string in JSON. */
             expectedGeneration?: string | null;
         };
+        CloseAllCopyPositionsResponse: {
+            /**
+             * @description Every live follow whose stop is not in progress and whose close ran,
+             *      including one with nothing to close (0 orders placed, 0 positions not
+             *      closed).
+             */
+            follows?: components["schemas"]["CloseFollowPositionsResponse"][] | null;
+            /** @description Follows whose stop is in progress: their stop closes their positions. */
+            stoppingFollowIds?: string[] | null;
+            /** @description Follows whose close could not run; the other follows still closed. */
+            failedFollows?: components["schemas"]["FollowCloseFailure"][] | null;
+        };
+        CloseFollowPositionsResponse: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * Format: uint32
+             * @description Reduce-only, immediate-or-cancel close orders placed; each may fill in part
+             * @example 2
+             */
+            closeOrdersPlaced?: number | null;
+            /**
+             * Format: uint32
+             * @description Copy positions still open after the batch (for example a thin or halted market); 0 when the copy account is flat
+             * @example 0
+             */
+            positionsNotClosed?: number | null;
+        };
         ClosePositionRequest: {
             quantity?: string | null;
             closeType?: string | null;
@@ -4097,7 +4284,7 @@ export interface components {
         };
         CreateDelegatedSessionResponse: {
             /**
-             * @description Session expiry as a Unix timestamp (seconds)
+             * @description Session expiry as a Unix timestamp (seconds), bounded by the delegation expiry when set. Earlier revocation or policy expiry also ends access.
              * @example 1735689599
              */
             expiresAt?: string | null;
@@ -4684,6 +4871,19 @@ export interface components {
             /** @description FOLLOWER, STOP_LOSS, SKIP_LIMIT, ADMIN or LEADER_SUSPENDED */
             stopReason?: string | null;
         };
+        /** @description A follow whose close could not run. */
+        FollowCloseFailure: {
+            /**
+             * Format: uuid
+             * @description The follow's id
+             */
+            followId?: string | null;
+            /**
+             * @description Why the close could not run, as a fixed sentence; retry the close
+             * @example The copy positions could not be closed right now; retry shortly
+             */
+            reason?: string | null;
+        };
         Follower: {
             /** @description The follower's wallet address (lowercase hex) */
             walletAddress?: string | null;
@@ -5337,22 +5537,22 @@ export interface components {
         GetMyFeeTierResponse: {
             /**
              * Format: int32
-             * @description Caller's resolved tier (1–6) from stored weighted 14-day volume
+             * @description Caller's resolved tier (1–6) from their wallet's stored weighted 14-day volume
              * @example 2
              */
             currentTierLevel?: number | null;
             /**
-             * @description Caller's weighted 14-day volume (perp + 2.5× spot)
+             * @description Caller's weighted 14-day volume (perp + 2.5× spot), summed across every application the wallet trades through
              * @example 7500000
              */
             weightedVolume14d?: string | null;
             /**
-             * @description Caller's rolling 14-day spot volume
+             * @description Caller's rolling 14-day spot volume, summed across every application the wallet trades through
              * @example 1000000
              */
             spotVolume14d?: string | null;
             /**
-             * @description Caller's rolling 14-day perp volume
+             * @description Caller's rolling 14-day perp volume, summed across every application the wallet trades through
              * @example 5000000
              */
             perpVolume14d?: string | null;
@@ -6071,7 +6271,7 @@ export interface components {
             cumFees?: string | null;
             /**
              * Format: int64
-             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. A live frame is ranked only when it is a faithful projection of the row persisted at that sequence: in practice the fills that leave a position open. Frames that re-read live risk state after sequencing (funding, margin_added/margin_reduced) and terminal frames (which report size 0 and LIQUIDATED, while the stored row keeps its size and records CLOSED) omit the version even though the mutation did advance the persisted one, so an absent version never implies that nothing was persisted. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
+             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills that leave a position open, direct isolated-position margin adds/reductions, and copy-position margin adds; the copy add refreshes its isolated child and copy-cross siblings at the same version. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Funding omits it because it re-reads live state after sequencing; terminal frames omit it because they report size 0 and sometimes LIQUIDATED while the stored row keeps its size and records CLOSED. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
              * @example 918342
              */
             version?: number | null;
@@ -7882,7 +8082,7 @@ export interface components {
             cumFees?: string | null;
             /**
              * Format: int64
-             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: it means the row predates this field or came from a producer that does not stamp it, so treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. A live frame is ranked only when it is a faithful projection of the row persisted at that sequence: in practice the fills that leave a position open. Frames that re-read live risk state after sequencing (funding, margin_added/margin_reduced) and terminal frames (which report size 0 and LIQUIDATED, while the stored row keeps its size and records CLOSED) omit the version even though the mutation did advance the persisted one, so an absent version never implies that nothing was persisted. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
+             * @description Opaque, non-negative producer-owned version for this position row. Compare only within the same position; higher is newer. 0 is the unranked legacy sentinel and never participates in ordering: it means the row predates this field or came from a producer that does not stamp it, so treat it exactly as an absent version and fall back to a full field comparison rather than ranking it as oldest. It advances on sequenced position mutations (open, add, reduce, close, funding, margin transfer, liquidation, ADL) and is shared by the persisted read, the WebSocket positions snapshot and a RANKED live position_update frame. Ranked live frames include fills that leave a position open, direct isolated-position margin adds/reductions, and copy-position margin adds; the copy add refreshes its isolated child and copy-cross siblings at the same version. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop refreshes use margin_added/margin_reduced but omit the version because those commands write no position rows. Funding omits it because it re-reads live state after sequencing; terminal frames omit it because they report size 0 and sometimes LIQUIDATED while the stored row keeps its size and records CLOSED. Wallet IN/OUT and plain isolated allocation send no position frame. Transfer frames use captured post-command state and are released only after durable acknowledgement. mark_price, unrealized_pnl, liquidation_price, leverage, maintenance_margin_required and initial_margin_required are UNVERSIONED valuation fields, re-derived per payload rather than served from the versioned row: the version does not advance for them (five move with the oracle mark; leverage does not, being opening notional over posted margin, but the live surfaces derive it while the persisted row serves its stored column, so it can still disagree at an unchanged version) (a valuation-only oracle tick persists nothing; a state-transitioning one, a breach or recovery, persists the account's snapshot and restamps the positions it changed), so the merge rule is per field group — on an equal version skip the versioned fields but still take all six from the newer payload, because discarding a whole payload on an equal version freezes displayed PnL and can leave a stale margin requirement on screen. isolated_margin is the one exception among the versioned fields: the WebSocket positions snapshot overlays it from an independent live matching-engine read rather than the versioned row, so take it from the newest payload on an equal version too or a consumer can retain stale backing. The version advances exactly when the row's versioned content changed at that sequence, a change undone within one persistence batch included; a position a command left unchanged keeps its version, so a RANKED live frame for an untouched sibling of a filled position can carry a higher version than the persisted row while describing identical content — rank it as newer, and nothing changes. A response served from live matching-engine state reports 0 (unranked): the engine holds the state but not the version.
              * @example 918342
              */
             version?: number | null;
@@ -8300,7 +8500,7 @@ export interface components {
         RefreshResponse: {
             /**
              * Format: int32
-             * @description Unix timestamp when the session expires after refresh
+             * @description Unix timestamp when the session expires after refresh. For delegated sessions, bounded by the active delegation expiry when set.
              * @example 1699876543
              */
             expiresAt?: number | null;
@@ -9785,7 +9985,7 @@ export interface components {
              */
             name?: string | null;
             /**
-             * @description Optional delegation expiry timestamp (ISO 8601). Omit for no expiry.
+             * @description Optional delegation expiry timestamp (ISO 8601). Ends delegated reads, trading, and session refresh. Omit for no delegation expiry; session expiry still applies.
              * @example 2026-12-31T23:59:59Z
              */
             expiresAt?: string | null;
@@ -12122,6 +12322,75 @@ export interface operations {
             };
         };
     };
+    close_all_copy_positions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CloseAllCopyPositionsResponse"];
+                };
+            };
+            /** @description The close was refused */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Delegated agent sessions cannot close copy positions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Copy trading is not available */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Copy position close rate limit exceeded; retry after the interval in details.retryAfter */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The matching engine is unavailable; retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     preview_follow: {
         parameters: {
             query?: never;
@@ -12259,6 +12528,84 @@ export interface operations {
             };
         };
     };
+    close_follow_positions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                followId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CloseFollowPositionsResponse"];
+                };
+            };
+            /** @description Invalid follow id, or the close was refused */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Delegated agent sessions cannot close copy positions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Follow not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The follow is stopped, or its stop is in progress (which closes its positions itself), or copy trading is not available */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Copy position close rate limit exceeded; retry after the interval in details.retryAfter */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The close cannot run right now, or the matching engine is unavailable; retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     list_follow_leader_positions: {
         parameters: {
             query?: never;
@@ -12330,6 +12677,88 @@ export interface operations {
             };
         };
     };
+    add_follow_position_margin: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                followId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddFollowPositionMarginRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AddFollowPositionMarginResponse"];
+                };
+            };
+            /** @description Invalid follow id, trading pair or amount, or refused by the engine with code COPY_TRADING_REJECTED (no copy position on the pair, the position or the margin account is being liquidated, the position has lost more than its margin, more than the copy account holds; the message names the rule) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Only a master account session can add margin (not a delegated agent or a sub-account) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Follow not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The follow is stopping or stopped, or code COPY_TRADING_UNAVAILABLE: copy trading is not available on the platform */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Movement rate limit exceeded — withdrawals and collateral transfers share a per-user budget; retry after the interval in details.retryAfter */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Matching engine unavailable; retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     stop_follow: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.70",
+	"version": "1.0.72",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.70",
+		"@0xmonaco/contracts": "1.0.72",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {