@0xmonaco/types 1.0.70 → 1.0.73

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/buildercodes/index.d.ts

@@ -5,7 +5,7 @@
  * per-trade revenue share.
  */
 import type { BaseAPI } from "../api";
-import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse } from "./responses";
+import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, ListBuilderFeeChangesParams, ListBuilderFeeChangesResponse, SetBuilderFeeParams, SetBuilderFeeResponse } from "./responses";
 /**
  * BuilderCodes payout API interface.
  *
@@ -18,6 +18,10 @@ import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, Ge
 export interface BuildercodesAPI extends BaseAPI {
     /** Read this authenticated frontend's enrollment, payout address, and live budget. */
     getConfig(): Promise<GetBuildercodesConfigResponse>;
+    /** Set this frontend's stored builder fee in basis points. */
+    setBuilderFee(params: SetBuilderFeeParams): Promise<SetBuilderFeeResponse>;
+    /** List this frontend's builder-fee audit log, newest first. */
+    listBuilderFeeChanges(params?: ListBuilderFeeChangesParams): Promise<ListBuilderFeeChangesResponse>;
     /** List this authenticated frontend's per-trade BuilderCodes credits, optionally of one payout `kind`. */
     listPayouts(params?: ListBuildercodePayoutsParams): Promise<ListBuildercodePayoutsResponse>;
     /** Summarize this authenticated frontend's BuilderCodes credits by token, and by token and payout kind. */
@@ -67,5 +71,5 @@ export interface BuildercodesAPI extends BaseAPI {
      */
     claimBuildercodeRewards(params: ClaimBuildercodeRewardsParams): Promise<ClaimBuildercodeRewardsResponse>;
 }
-export type { BuildercodePayout, BuildercodePayoutKind, BuildercodePayoutTokenKindTotal, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, } from "./responses";
-export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export type { BuildercodePayout, BuildercodePayoutKind, BuildercodePayoutTokenKindTotal, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, BuilderFeeActorType, BuilderFeeChange, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, ListBuilderFeeChangesParams, ListBuilderFeeChangesResponse, SetBuilderFeeParams, SetBuilderFeeResponse, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, BuilderFeeActorTypeSchema, BuilderFeeChangeSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, ListBuilderFeeChangesParamsSchema, ListBuilderFeeChangesResponseSchema, SetBuilderFeeParamsSchema, SetBuilderFeeResponseSchema, } from "./responses";

package/dist/buildercodes/index.js

@@ -4,4 +4,4 @@
  * Types for the BuilderCodes API: reading and claiming an enrolled frontend's
  * per-trade revenue share.
  */
-export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, BuilderFeeActorTypeSchema, BuilderFeeChangeSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, ListBuilderFeeChangesParamsSchema, ListBuilderFeeChangesResponseSchema, SetBuilderFeeParamsSchema, SetBuilderFeeResponseSchema, } from "./responses";

package/dist/buildercodes/responses.d.ts

@@ -12,11 +12,62 @@ export declare const GetBuildercodesConfigResponseSchema: z.ZodObject<{
     payoutAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     buildercodesEnabled: z.ZodBoolean;
     buildercodesBudgetBps: z.ZodNumber;
+    builderFeeEnabled: z.ZodBoolean;
+    builderFeeBps: z.ZodNumber;
+    builderFeeCapBps: z.ZodNumber;
+    changesRemaining: z.ZodNumber;
+    nextChangeAllowedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** Schema for changing this frontend's builder fee. */
+export declare const SetBuilderFeeParamsSchema: z.ZodObject<{
+    bps: z.ZodNumber;
+}, z.core.$strip>;
+/** Schema returned after setting this frontend's builder fee. */
+export declare const SetBuilderFeeResponseSchema: z.ZodObject<{
+    builderFeeBps: z.ZodNumber;
+    previousBuilderFeeBps: z.ZodNumber;
+    changesRemaining: z.ZodNumber;
+    nextChangeAllowedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** Builder-fee change actor exposed by the audit log. */
+export declare const BuilderFeeActorTypeSchema: z.ZodEnum<{
+    BUILDER: "BUILDER";
+    ADMIN: "ADMIN";
+}>;
+/** One builder-fee audit-log entry. */
+export declare const BuilderFeeChangeSchema: z.ZodObject<{
+    actorType: z.ZodEnum<{
+        BUILDER: "BUILDER";
+        ADMIN: "ADMIN";
+    }>;
+    actor: z.ZodString;
+    oldBps: z.ZodNumber;
+    newBps: z.ZodNumber;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/** Cursor pagination accepted by the builder-fee change log. */
+export declare const ListBuilderFeeChangesParamsSchema: z.ZodObject<{
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Schema for one page of builder-fee changes, newest first. */
+export declare const ListBuilderFeeChangesResponseSchema: z.ZodObject<{
+    changes: z.ZodArray<z.ZodObject<{
+        actorType: z.ZodEnum<{
+            BUILDER: "BUILDER";
+            ADMIN: "ADMIN";
+        }>;
+        actor: z.ZodString;
+        oldBps: z.ZodNumber;
+        newBps: z.ZodNumber;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextPageToken: z.ZodString;
 }, z.core.$strip>;
 /**
  * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` is the
- * frontend's share of Monaco's fee; `BUILDER_FEE` is the frontend's own builder
- * fee, paid by the taker. Both land in the same claimable balance.
+ * active frontend-revenue-share category; `BUILDER_FEE` is reserved and is not
+ * currently emitted.
  */
 export declare const BuildercodePayoutKindSchema: z.ZodEnum<{
     REVENUE_SHARE: "REVENUE_SHARE";
@@ -127,6 +178,12 @@ export declare const ClaimBuildercodeRewardsResponseSchema: z.ZodObject<{
 export type ClaimBuildercodeRewardsParams = z.infer<typeof ClaimBuildercodeRewardsParamsSchema>;
 export type ClaimBuildercodeRewardsResponse = z.infer<typeof ClaimBuildercodeRewardsResponseSchema>;
 export type GetBuildercodesConfigResponse = z.infer<typeof GetBuildercodesConfigResponseSchema>;
+export type SetBuilderFeeParams = z.infer<typeof SetBuilderFeeParamsSchema>;
+export type SetBuilderFeeResponse = z.infer<typeof SetBuilderFeeResponseSchema>;
+export type BuilderFeeActorType = z.infer<typeof BuilderFeeActorTypeSchema>;
+export type BuilderFeeChange = z.infer<typeof BuilderFeeChangeSchema>;
+export type ListBuilderFeeChangesParams = z.infer<typeof ListBuilderFeeChangesParamsSchema>;
+export type ListBuilderFeeChangesResponse = z.infer<typeof ListBuilderFeeChangesResponseSchema>;
 export type ListBuildercodePayoutsParams = z.infer<typeof ListBuildercodePayoutsParamsSchema>;
 export type BuildercodePayoutKind = z.infer<typeof BuildercodePayoutKindSchema>;
 export type BuildercodePayout = z.infer<typeof BuildercodePayoutSchema>;

package/dist/buildercodes/responses.js

@@ -16,11 +16,47 @@ export const GetBuildercodesConfigResponseSchema = z.object({
     payoutAddress: z.string().nullable().optional(),
     buildercodesEnabled: z.boolean(),
     buildercodesBudgetBps: z.number().int().min(0).max(10_000),
+    builderFeeEnabled: z.boolean(),
+    builderFeeBps: z.number().int().min(0).max(100),
+    builderFeeCapBps: z.number().int().min(0).max(100),
+    changesRemaining: z.number().int().min(0).max(2),
+    nextChangeAllowedAt: z.string().nullable().optional(),
+});
+/** Schema for changing this frontend's builder fee. */
+export const SetBuilderFeeParamsSchema = z.object({
+    bps: z.number().int().min(0).max(100),
+});
+/** Schema returned after setting this frontend's builder fee. */
+export const SetBuilderFeeResponseSchema = z.object({
+    builderFeeBps: z.number().int().min(0).max(100),
+    previousBuilderFeeBps: z.number().int().min(0).max(100),
+    changesRemaining: z.number().int().min(0).max(2),
+    nextChangeAllowedAt: z.string().nullable().optional(),
+});
+/** Builder-fee change actor exposed by the audit log. */
+export const BuilderFeeActorTypeSchema = z.enum(["BUILDER", "ADMIN"]);
+/** One builder-fee audit-log entry. */
+export const BuilderFeeChangeSchema = z.object({
+    actorType: BuilderFeeActorTypeSchema,
+    actor: z.string(),
+    oldBps: z.number().int().min(0).max(100),
+    newBps: z.number().int().min(0).max(100),
+    createdAt: z.string(),
+});
+/** Cursor pagination accepted by the builder-fee change log. */
+export const ListBuilderFeeChangesParamsSchema = z.object({
+    pageSize: z.number().int().min(1).max(100).optional(),
+    pageToken: z.string().optional(),
+});
+/** Schema for one page of builder-fee changes, newest first. */
+export const ListBuilderFeeChangesResponseSchema = z.object({
+    changes: z.array(BuilderFeeChangeSchema),
+    nextPageToken: z.string(),
 });
 /**
  * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` is the
- * frontend's share of Monaco's fee; `BUILDER_FEE` is the frontend's own builder
- * fee, paid by the taker. Both land in the same claimable balance.
+ * active frontend-revenue-share category; `BUILDER_FEE` is reserved and is not
+ * currently emitted.
  */
 export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE"]);
 /** Pagination and filter accepted by the per-trade payout history endpoint. */

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/trading/responses.d.ts

@@ -159,7 +159,7 @@ export interface ReplaceOrderResponse {
     status: "SUCCESS" | "FAILED";
     /** Operation message */
     message: string;
-    /** Fields that were updated */
+    /** The replacement's price and total quantity (see {@link UpdatedFields}) */
     updatedFields: UpdatedFields;
     /** Original order identifier that was replaced */
     originalOrderId?: string;
@@ -167,12 +167,19 @@ export interface ReplaceOrderResponse {
     matchResult?: MatchResult;
 }
 /**
- * Fields that were updated in the replace operation
+ * The replacement's price and quantity, as the replace operation placed them
  */
 export interface UpdatedFields {
-    /** Updated price (if changed) */
+    /** The replacement's price: the requested price, or the original order's when omitted */
     price?: string;
-    /** Updated quantity (if changed) */
+    /**
+     * The replacement's TOTAL quantity, not its resting size: the requested
+     * quantity, or the original order's total when omitted. A 100-lot with 60
+     * filled reports "100" and rests 40; read the order's `remainingQuantity`
+     * for the resting size. For a margin reduce-only replacement it is the close
+     * size placed (the requested quantity, or the original's remaining quantity
+     * when omitted).
+     */
     quantity?: string;
 }
 /**
@@ -336,7 +343,7 @@ export interface BatchReplaceResult {
     originalOrderId: string;
     /** New order identifier (if successful) */
     newOrderId?: string;
-    /** Fields that were updated (if successful) */
+    /** The replacement's price and total quantity, if successful (see {@link UpdatedFields}) */
     updatedFields?: UpdatedFields;
     /** Match result information if the new order was processed */
     matchResult?: MatchResult;
@@ -435,7 +442,12 @@ export interface BatchReplaceOrderParams {
     orderId: string;
     /** New order price (optional) */
     price?: string;
-    /** New order quantity (optional) */
+    /**
+     * New TOTAL order quantity (optional): the replacement rests this total
+     * minus the already-filled amount, so it must exceed the filled amount.
+     * Omitted, the order keeps its total. A margin reduce-only quantity is a
+     * close size, placed as given.
+     */
     quantity?: string;
     /** For sub-accounts: use master's balance (optional) */
     useMasterBalance?: boolean;

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_builder_fee_changes", "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_builder_fee", "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];