@0xmonaco/types 1.0.70 → 1.0.73-develop.af0f5d0

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,61 @@ 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.
+ * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` records
+ * Monaco revenue share; `BUILDER_FEE` records builder fees charged to takers.
  */
 export declare const BuildercodePayoutKindSchema: z.ZodEnum<{
     REVENUE_SHARE: "REVENUE_SHARE";
@@ -127,6 +177,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,46 @@ 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.
+ * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` records
+ * Monaco revenue share; `BUILDER_FEE` records builder fees charged to takers.
  */
 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.
  *
@@ -65,10 +65,58 @@ export interface CopyTradingAPI extends BaseAPI {
     upsertFollow(params: UpsertFollowParams): Promise<UpsertFollowResponse>;
     /**
      * Stop one of your follows: the leader's fills stop being mirrored. An exit
-     * is never gated beyond ownership, except that a delegated agent session
-     * cannot stop a follow (403).
+     * is never refused for the state of the account or the platform. Only
+     * ownership applies, a delegated agent session cannot stop a follow (403),
+     * and stops have a rate limit of their own (429 past it).
      */
     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; 400 `COPY_TRADING_REJECTED` when the add
+     * is refused (no isolated copy position on the pair, the copy position is
+     * being liquidated or is in bad debt, 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

@@ -1,15 +1,22 @@
 import type { Address } from "viem";
 import type { BaseAPI } from "../api";
-export type DelegatedAgentAction = "CREATE_ORDER" | "CANCEL_ORDER" | "REPLACE_ORDER" | "create_order" | "cancel_order" | "replace_order";
+export type DelegatedAgentAction = "CREATE_ORDER" | "CANCEL_ORDER" | "REPLACE_ORDER" | "READ" | "MANAGE_RISK_BUCKETS" | "create_order" | "cancel_order" | "replace_order" | "read" | "manage_risk_buckets";
 export interface UpsertDelegatedAgentRequest {
     agentAddress: string;
     name?: string;
+    /** Delegation expiry (ISO 8601); ends reads, trading, and session refresh. Omit for the default of 14 days from now; at most 180 days ahead. */
     expiresAt?: string;
-    /** Required. An empty list permits no actions. */
+    /**
+     * Required. An empty list permits no order actions. Every delegated session may read the owner's
+     * data, so a list of only `READ` (or none) is a read-only key.
+     */
     allowedActions: DelegatedAgentAction[];
-    /** Required. A matching market OR account permits an order; both scopes empty deny all orders. */
+    /** Required. Each listed scope must match: a listed market AND a listed account. Both empty deny all orders. */
     allowedTradingPairIds: string[];
-    /** Additional account scope. Omit or send [] for market-only scope, not access to every account. */
+    /**
+     * The margin accounts the agent is bound to (a sub-account's own key). Omit or send [] to leave the
+     * account unrestricted.
+     */
     allowedMarginAccountIds?: string[];
     /** Omit or send [] for unrestricted order types. */
     allowedOrderTypes?: Array<"LIMIT" | "MARKET">;
@@ -19,6 +26,8 @@ export interface UpsertDelegatedAgentRequest {
     maxOrderNotional?: string;
     /** @deprecated Unsupported: setting this field causes the server to reject the request. */
     maxOpenOrders?: number;
+    /** Up to 20 IP addresses or CIDR ranges the agent may create its delegated session from. Omit for any. */
+    ipAllowlist?: string[];
 }
 export interface DelegatedAgent {
     id: string;
@@ -37,6 +46,8 @@ export interface DelegatedAgent {
     maxOrderNotional?: string;
     /** @deprecated Legacy data only; no concurrent open-order cap is enforced. */
     maxOpenOrders?: number;
+    /** Normalized IP addresses and CIDR ranges; empty allows any address. */
+    ipAllowlist?: string[];
 }
 export interface ListDelegatedAgentsResponse {
     agents: DelegatedAgent[];
@@ -61,6 +72,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(),