@0xmonaco/types 1.0.67 → 1.0.70

package/dist/buildercodes/index.d.ts

@@ -18,9 +18,9 @@ import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, Ge
 export interface BuildercodesAPI extends BaseAPI {
     /** Read this authenticated frontend's enrollment, payout address, and live budget. */
     getConfig(): Promise<GetBuildercodesConfigResponse>;
-    /** List this authenticated frontend's per-trade BuilderCodes credits. */
+    /** 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. */
+    /** Summarize this authenticated frontend's BuilderCodes credits by token, and by token and payout kind. */
     getPayoutSummary(): Promise<GetBuildercodePayoutSummaryResponse>;
     /** Read the authenticated wallet's available reserved reward balances. */
     getRewardsBalance(): Promise<GetBuildercodeRewardsBalanceResponse>;
@@ -67,5 +67,5 @@ export interface BuildercodesAPI extends BaseAPI {
      */
     claimBuildercodeRewards(params: ClaimBuildercodeRewardsParams): Promise<ClaimBuildercodeRewardsResponse>;
 }
-export type { BuildercodePayout, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, } from "./responses";
-export { BuildercodePayoutSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+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";

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 { BuildercodePayoutSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";

package/dist/buildercodes/responses.d.ts

@@ -13,10 +13,23 @@ export declare const GetBuildercodesConfigResponseSchema: z.ZodObject<{
     buildercodesEnabled: z.ZodBoolean;
     buildercodesBudgetBps: z.ZodNumber;
 }, z.core.$strip>;
-/** Pagination accepted by the per-trade payout history endpoint. */
+/**
+ * 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.
+ */
+export declare const BuildercodePayoutKindSchema: z.ZodEnum<{
+    REVENUE_SHARE: "REVENUE_SHARE";
+    BUILDER_FEE: "BUILDER_FEE";
+}>;
+/** Pagination and filter accepted by the per-trade payout history endpoint. */
 export declare const ListBuildercodePayoutsParamsSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>>;
 }, z.core.$strip>;
 /** One per-trade BuilderCodes credit. Amounts are RAW atomic units. */
 export declare const BuildercodePayoutSchema: z.ZodObject<{
@@ -26,6 +39,10 @@ export declare const BuildercodePayoutSchema: z.ZodObject<{
     amount: z.ZodString;
     appliedBps: z.ZodNumber;
     createdAt: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>>;
 }, z.core.$strip>;
 /** Schema for the paginated per-trade payout history. */
 export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
@@ -36,6 +53,10 @@ export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
         amount: z.ZodString;
         appliedBps: z.ZodNumber;
         createdAt: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<{
+            REVENUE_SHARE: "REVENUE_SHARE";
+            BUILDER_FEE: "BUILDER_FEE";
+        }>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
     page: z.ZodNumber;
@@ -49,6 +70,17 @@ export declare const BuildercodePayoutTokenTotalSchema: z.ZodObject<{
     payoutCount: z.ZodNumber;
     lastCreditedAt: z.ZodString;
 }, z.core.$strip>;
+/** One token-denominated BuilderCodes earnings total for one payout kind. */
+export declare const BuildercodePayoutTokenKindTotalSchema: z.ZodObject<{
+    token: z.ZodString;
+    kind: z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>;
+    totalAmount: z.ZodString;
+    payoutCount: z.ZodNumber;
+    lastCreditedAt: z.ZodString;
+}, z.core.$strip>;
 /** Schema for this frontend's payout summary. */
 export declare const GetBuildercodePayoutSummaryResponseSchema: z.ZodObject<{
     totalPayouts: z.ZodNumber;
@@ -59,6 +91,16 @@ export declare const GetBuildercodePayoutSummaryResponseSchema: z.ZodObject<{
         payoutCount: z.ZodNumber;
         lastCreditedAt: z.ZodString;
     }, z.core.$strip>>;
+    byTokenAndKind: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        token: z.ZodString;
+        kind: z.ZodEnum<{
+            REVENUE_SHARE: "REVENUE_SHARE";
+            BUILDER_FEE: "BUILDER_FEE";
+        }>;
+        totalAmount: z.ZodString;
+        payoutCount: z.ZodNumber;
+        lastCreditedAt: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 /** One available balance in the reserved BuilderCodes reward bucket. */
 export declare const BuildercodeRewardsBalanceSchema: z.ZodObject<{
@@ -86,9 +128,11 @@ export type ClaimBuildercodeRewardsParams = z.infer<typeof ClaimBuildercodeRewar
 export type ClaimBuildercodeRewardsResponse = z.infer<typeof ClaimBuildercodeRewardsResponseSchema>;
 export type GetBuildercodesConfigResponse = z.infer<typeof GetBuildercodesConfigResponseSchema>;
 export type ListBuildercodePayoutsParams = z.infer<typeof ListBuildercodePayoutsParamsSchema>;
+export type BuildercodePayoutKind = z.infer<typeof BuildercodePayoutKindSchema>;
 export type BuildercodePayout = z.infer<typeof BuildercodePayoutSchema>;
 export type ListBuildercodePayoutsResponse = z.infer<typeof ListBuildercodePayoutsResponseSchema>;
 export type BuildercodePayoutTokenTotal = z.infer<typeof BuildercodePayoutTokenTotalSchema>;
+export type BuildercodePayoutTokenKindTotal = z.infer<typeof BuildercodePayoutTokenKindTotalSchema>;
 export type GetBuildercodePayoutSummaryResponse = z.infer<typeof GetBuildercodePayoutSummaryResponseSchema>;
 export type BuildercodeRewardsBalance = z.infer<typeof BuildercodeRewardsBalanceSchema>;
 export type GetBuildercodeRewardsBalanceResponse = z.infer<typeof GetBuildercodeRewardsBalanceResponseSchema>;

package/dist/buildercodes/responses.js

@@ -17,10 +17,18 @@ export const GetBuildercodesConfigResponseSchema = z.object({
     buildercodesEnabled: z.boolean(),
     buildercodesBudgetBps: z.number().int().min(0).max(10_000),
 });
-/** Pagination accepted by the per-trade payout history endpoint. */
+/**
+ * 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.
+ */
+export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE"]);
+/** Pagination and filter accepted by the per-trade payout history endpoint. */
 export const ListBuildercodePayoutsParamsSchema = z.object({
     page: z.number().int().min(1).max(10_000).optional(),
     pageSize: z.number().int().min(1).max(100).optional(),
+    /** Only return credits of this kind; `total` counts the filtered rows. Omit for every kind. */
+    kind: BuildercodePayoutKindSchema.optional(),
 });
 /** One per-trade BuilderCodes credit. Amounts are RAW atomic units. */
 export const BuildercodePayoutSchema = z.object({
@@ -30,6 +38,8 @@ export const BuildercodePayoutSchema = z.object({
     amount: z.string(),
     appliedBps: z.number().int(),
     createdAt: z.string(),
+    /** Payout stream of this credit. Absent from servers older than this field, whose credits are all `REVENUE_SHARE`. */
+    kind: BuildercodePayoutKindSchema.optional(),
 });
 /** Schema for the paginated per-trade payout history. */
 export const ListBuildercodePayoutsResponseSchema = z.object({
@@ -46,11 +56,25 @@ export const BuildercodePayoutTokenTotalSchema = z.object({
     payoutCount: z.number().int().nonnegative(),
     lastCreditedAt: z.string(),
 });
+/** One token-denominated BuilderCodes earnings total for one payout kind. */
+export const BuildercodePayoutTokenKindTotalSchema = z.object({
+    token: z.string(),
+    kind: BuildercodePayoutKindSchema,
+    totalAmount: z.string(),
+    payoutCount: z.number().int().nonnegative(),
+    lastCreditedAt: z.string(),
+});
 /** Schema for this frontend's payout summary. */
 export const GetBuildercodePayoutSummaryResponseSchema = z.object({
     totalPayouts: z.number().int().nonnegative(),
     lastCreditedAt: z.string().nullable().optional(),
+    /** Per-token totals, summed across every payout kind. */
     byToken: z.array(BuildercodePayoutTokenTotalSchema),
+    /**
+     * The same totals split by token AND kind; a token's rows sum to its
+     * `byToken` total. Absent from servers older than this field.
+     */
+    byTokenAndKind: z.array(BuildercodePayoutTokenKindTotalSchema).optional(),
 });
 /** One available balance in the reserved BuilderCodes reward bucket. */
 export const BuildercodeRewardsBalanceSchema = z.object({

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

@@ -0,0 +1,95 @@
+/**
+ * Copy Trading Types (0XM-2851)
+ *
+ * Followers allocate collateral to a per-leader copy account (a cross risk
+ * bucket in their margin account) and every fill the leader makes is mirrored
+ * 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";
+/**
+ * Copy trading API.
+ *
+ * Public reads (no session needed): {@link listLeadTraders},
+ * {@link getLeadTrader}, {@link listLeadTraderClosedTrades}. Everything else
+ * is self-scoped to the authenticated caller. Delegated agent and sub-account
+ * sessions cannot register as a leader or follow (403).
+ */
+export interface CopyTradingAPI extends BaseAPI {
+    /**
+     * List lead traders (the public leaderboard), highest first by `sort`
+     * (default `roi`) over `window` (default `30d`). Cursor paged: pass the
+     * previous response's `nextPageToken` with the SAME sort and window; an
+     * empty token means the end.
+     */
+    listLeadTraders(params?: ListLeadTradersParams): Promise<ListLeadTradersResponse>;
+    /**
+     * Get one lead trader by custom TraderCode handle: profile, follow summary
+     * and stats for 7d, 30d, 90d and all. 404 for an unknown or suspended
+     * leader.
+     */
+    getLeadTrader(handle: string): Promise<GetLeadTraderResponse>;
+    /** List a lead trader's closed trades (reducing executions), newest first, cursor paged. */
+    listLeadTraderClosedTrades(handle: string, params?: ListLeadTraderClosedTradesParams): Promise<ListLeadTraderClosedTradesResponse>;
+    /** List a lead trader's open positions. Only current followers of that leader may read them (403 otherwise). */
+    listLeadTraderOpenPositions(handle: string): Promise<ListLeadTraderOpenPositionsResponse>;
+    /**
+     * Register as a lead trader, or edit your profile. A registration is
+     * checked against the platform's eligibility rules (account equity, trading
+     * history, closed positions, and a claimed custom TraderCode handle, which
+     * followers address you by); a refusal is a 400 naming the rule. A follower
+     * with a live follow cannot register.
+     *
+     * The profile is replaced as sent: an omitted `bio` or `minAllocation`
+     * clears it and an omitted `status` means `ACTIVE`; an omitted `shareBps`
+     * keeps the current share (the platform default on a registration).
+     */
+    upsertLeadTrader(params?: UpsertLeadTraderParams): Promise<UpsertLeadTraderResponse>;
+    /** Get your own lead trader profile (404 when you are not a lead trader). */
+    getMyLeadTrader(): Promise<GetLeadTraderResponse>;
+    /** List your followers, as a leader. Cursor paged, up to 1000 per page. */
+    listMyFollowers(params?: ListMyFollowersParams): Promise<ListMyFollowersResponse>;
+    /**
+     * Follow a lead trader (no `followId`), or edit one of your follows
+     * (`followId` set). A create moves `allocation` from your margin account
+     * into a new copy account: a cross risk bucket that holds this follow's
+     * collateral and positions.
+     *
+     * An edit REPLACES the follow's settings: every optional setting you leave
+     * out reverts to its default, so an edit that omits `slPct` removes the
+     * stop-loss. Pass the full desired configuration on every edit. The leader
+     * comes from the stored follow, so `leader` may be omitted on an edit; a
+     * handle naming a different leader is refused.
+     */
+    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).
+     */
+    stopFollow(followId: string): Promise<StopFollowResponse>;
+    /** List your follows, newest first. Cursor paged, up to 1000 per page. */
+    listMyFollows(params?: ListMyFollowsParams): Promise<ListMyFollowsResponse>;
+    /**
+     * Get one of your follows with its most recent skipped mirrors (up to 100)
+     * and the copy account's marked equity. 404 for a follow that is not yours.
+     */
+    getFollow(followId: string): Promise<GetFollowResponse>;
+    /**
+     * List the open positions of the leader one of your follows copies. The
+     * leader comes from the follow, so this works after the leader releases
+     * their handle. 404 for a follow that is not yours; 403 for a stopped one.
+     */
+    listFollowLeaderPositions(followId: string): Promise<ListFollowLeaderPositionsResponse>;
+    /**
+     * Preview what a follow with these terms would open if it set
+     * `copyExisting`, as totals only: the estimated margin and fees, and how
+     * many of the leader's positions would and would not be copied (no pair,
+     * side or reason). Read-only. Delegated agent and sub-account sessions get
+     * 403, as for following.
+     */
+    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";

package/dist/copy-trading/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copy Trading Types (0XM-2851)
+ *
+ * Followers allocate collateral to a per-leader copy account (a cross risk
+ * 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";

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

@@ -0,0 +1,373 @@
+/**
+ * Copy trading response types (0XM-2851).
+ *
+ * Zod schemas for every copy trading REST/gRPC response, with the inferred
+ * TypeScript types. The REST API returns camelCase JSON; an optional field the
+ * server has no value for arrives as `null`, so optional fields are typed
+ * `T | null | undefined` (`.nullish()`).
+ *
+ * Leaders are only ever identified by their public wallet address and custom
+ * TraderCode handle, never by an internal id.
+ *
+ * Label fields (statuses, modes, reasons) are typed `Union | (string & {})`:
+ * the unions name the values the server sends today, and the schemas accept
+ * any string so a value added server-side later does not fail parsing.
+ */
+import { z } from "zod";
+import type { CopyLeverageMode, CopyMarginModePolicy, CopyRelationshipStatus, CopySizingMode, CopySkipReason, CopyStopReason } from "../websocket/events/copy-events";
+/** Lead trader profile status. `SUSPENDED` appears only on your own profile. */
+export type LeadTraderStatus = "ACTIVE" | "PAUSED" | "SUSPENDED";
+/** Leaderboard stats window. */
+export type LeadTraderStatsWindow = "7d" | "30d" | "90d" | "all";
+/** Leaderboard sort metric (highest first). */
+export type LeadTraderSort = "roi" | "pnl" | "followers" | "allocated" | "aum" | "win_rate";
+/** The kind of reducing execution a closed trade records. */
+export type ClosedTradeAction = "DECREASE" | "CLOSE" | "LIQUIDATE" | "ADL";
+/** A lead trader as the public sees them: wallet and handle, never an internal id. */
+export declare const LeadTraderRefSchema: z.ZodObject<{
+    walletAddress: z.ZodString;
+    handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    display: z.ZodString;
+}, z.core.$strip>;
+/** A lead trader's public profile. */
+export declare const LeadTraderProfileSchema: z.ZodObject<{
+    leader: z.ZodObject<{
+        walletAddress: z.ZodString;
+        handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        display: z.ZodString;
+    }, z.core.$strip>;
+    status: z.ZodType<(string & {}) | LeadTraderStatus, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatus, unknown>>;
+    shareBps: z.ZodNumber;
+    bio: z.ZodString;
+    minAllocation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    registeredAt: z.ZodString;
+}, z.core.$strip>;
+/** Live follows of a leader. */
+export declare const LeadTraderFollowSummarySchema: z.ZodObject<{
+    followerCount: z.ZodNumber;
+    allocated: z.ZodString;
+    aumEquity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** A leader's trading stats over one window. */
+export declare const LeadTraderStatsSchema: z.ZodObject<{
+    window: z.ZodType<(string & {}) | LeadTraderStatsWindow, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatsWindow, unknown>>;
+    pnl: z.ZodString;
+    roiPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxDrawdownPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    winRatePct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    closedTrades: z.ZodNumber;
+}, z.core.$strip>;
+/** One lead trader: profile, follow summary and stats for every window (7d, 30d, 90d, all). */
+export declare const GetLeadTraderResponseSchema: z.ZodObject<{
+    profile: z.ZodObject<{
+        leader: z.ZodObject<{
+            walletAddress: z.ZodString;
+            handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            display: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodType<(string & {}) | LeadTraderStatus, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatus, unknown>>;
+        shareBps: z.ZodNumber;
+        bio: z.ZodString;
+        minAllocation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        registeredAt: z.ZodString;
+    }, z.core.$strip>;
+    followSummary: z.ZodObject<{
+        followerCount: z.ZodNumber;
+        allocated: z.ZodString;
+        aumEquity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    stats: z.ZodArray<z.ZodObject<{
+        window: z.ZodType<(string & {}) | LeadTraderStatsWindow, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatsWindow, unknown>>;
+        pnl: z.ZodString;
+        roiPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maxDrawdownPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        winRatePct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        closedTrades: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** One leaderboard row: stats for the requested window only. */
+export declare const LeadTraderListingSchema: z.ZodObject<{
+    profile: z.ZodObject<{
+        leader: z.ZodObject<{
+            walletAddress: z.ZodString;
+            handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            display: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodType<(string & {}) | LeadTraderStatus, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatus, unknown>>;
+        shareBps: z.ZodNumber;
+        bio: z.ZodString;
+        minAllocation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        registeredAt: z.ZodString;
+    }, z.core.$strip>;
+    followSummary: z.ZodObject<{
+        followerCount: z.ZodNumber;
+        allocated: z.ZodString;
+        aumEquity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    stats: z.ZodObject<{
+        window: z.ZodType<(string & {}) | LeadTraderStatsWindow, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatsWindow, unknown>>;
+        pnl: z.ZodString;
+        roiPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        maxDrawdownPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        winRatePct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        closedTrades: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** A page of the public leaderboard. */
+export declare const ListLeadTradersResponseSchema: z.ZodObject<{
+    leaders: z.ZodArray<z.ZodObject<{
+        profile: z.ZodObject<{
+            leader: z.ZodObject<{
+                walletAddress: z.ZodString;
+                handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                display: z.ZodString;
+            }, z.core.$strip>;
+            status: z.ZodType<(string & {}) | LeadTraderStatus, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatus, unknown>>;
+            shareBps: z.ZodNumber;
+            bio: z.ZodString;
+            minAllocation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            registeredAt: z.ZodString;
+        }, z.core.$strip>;
+        followSummary: z.ZodObject<{
+            followerCount: z.ZodNumber;
+            allocated: z.ZodString;
+            aumEquity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        stats: z.ZodObject<{
+            window: z.ZodType<(string & {}) | LeadTraderStatsWindow, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatsWindow, unknown>>;
+            pnl: z.ZodString;
+            roiPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            maxDrawdownPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            winRatePct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            closedTrades: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    nextPageToken: z.ZodString;
+    asOf: z.ZodString;
+}, z.core.$strip>;
+/** Result of registering as, or editing, a lead trader. */
+export declare const UpsertLeadTraderResponseSchema: z.ZodObject<{
+    created: z.ZodBoolean;
+    status: z.ZodType<(string & {}) | LeadTraderStatus, unknown, z.core.$ZodTypeInternals<(string & {}) | LeadTraderStatus, unknown>>;
+    shareBps: z.ZodNumber;
+}, z.core.$strip>;
+/** One of your followers, as a leader sees them. */
+export declare const FollowerSchema: z.ZodObject<{
+    walletAddress: z.ZodString;
+    display: z.ZodString;
+    status: z.ZodType<CopyRelationshipStatus | (string & {}), unknown, z.core.$ZodTypeInternals<CopyRelationshipStatus | (string & {}), unknown>>;
+    allocation: z.ZodString;
+    startedAt: z.ZodString;
+}, z.core.$strip>;
+/** A page of your followers. */
+export declare const ListMyFollowersResponseSchema: z.ZodObject<{
+    followers: z.ZodArray<z.ZodObject<{
+        walletAddress: z.ZodString;
+        display: z.ZodString;
+        status: z.ZodType<CopyRelationshipStatus | (string & {}), unknown, z.core.$ZodTypeInternals<CopyRelationshipStatus | (string & {}), unknown>>;
+        allocation: z.ZodString;
+        startedAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextPageToken: z.ZodString;
+}, z.core.$strip>;
+/** One reducing execution of a leader's position. */
+export declare const ClosedTradeSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    positionSide: z.ZodString;
+    action: z.ZodType<(string & {}) | ClosedTradeAction, unknown, z.core.$ZodTypeInternals<(string & {}) | ClosedTradeAction, unknown>>;
+    size: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    exitPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    entryPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    realizedPnl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    netRealizedPnl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    realizedRoe: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    closedAt: z.ZodString;
+}, z.core.$strip>;
+/** A page of a leader's closed trades. */
+export declare const ListLeadTraderClosedTradesResponseSchema: z.ZodObject<{
+    closedTrades: z.ZodArray<z.ZodObject<{
+        tradingPairId: z.ZodString;
+        positionSide: z.ZodString;
+        action: z.ZodType<(string & {}) | ClosedTradeAction, unknown, z.core.$ZodTypeInternals<(string & {}) | ClosedTradeAction, unknown>>;
+        size: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        exitPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        entryPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        realizedPnl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        netRealizedPnl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        realizedRoe: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        closedAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextPageToken: z.ZodString;
+}, z.core.$strip>;
+/** One open position of a leader you follow. */
+export declare const LeadTraderOpenPositionSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    side: z.ZodString;
+    size: z.ZodString;
+    entryPrice: z.ZodString;
+    markPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unrealizedPnl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    leverage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    marginMode: z.ZodString;
+}, z.core.$strip>;
+/** A followed leader's open positions (current followers only). */
+export declare const ListLeadTraderOpenPositionsResponseSchema: z.ZodObject<{
+    positions: z.ZodArray<z.ZodObject<{
+        tradingPairId: z.ZodString;
+        side: z.ZodString;
+        size: z.ZodString;
+        entryPrice: z.ZodString;
+        markPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unrealizedPnl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        leverage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        marginMode: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** One of your follows. */
+export declare const FollowSchema: z.ZodObject<{
+    followId: z.ZodString;
+    leader: z.ZodObject<{
+        walletAddress: z.ZodString;
+        handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        display: z.ZodString;
+    }, z.core.$strip>;
+    status: z.ZodType<CopyRelationshipStatus | (string & {}), unknown, z.core.$ZodTypeInternals<CopyRelationshipStatus | (string & {}), unknown>>;
+    marginModePolicy: z.ZodType<CopyMarginModePolicy | (string & {}), unknown, z.core.$ZodTypeInternals<CopyMarginModePolicy | (string & {}), unknown>>;
+    sizingMode: z.ZodType<CopySizingMode | (string & {}), unknown, z.core.$ZodTypeInternals<CopySizingMode | (string & {}), unknown>>;
+    sizingParam: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    leverageMode: z.ZodType<CopyLeverageMode | (string & {}), unknown, z.core.$ZodTypeInternals<CopyLeverageMode | (string & {}), unknown>>;
+    fixedLeverage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    allocation: z.ZodString;
+    slPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    copyExisting: z.ZodBoolean;
+    tradingPairIds: z.ZodArray<z.ZodString>;
+    consecutiveSkips: z.ZodNumber;
+    copyRiskBucketId: z.ZodString;
+    startedAt: z.ZodString;
+    stoppedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stopReason: z.ZodOptional<z.ZodNullable<z.ZodType<CopyStopReason | (string & {}), unknown, z.core.$ZodTypeInternals<CopyStopReason | (string & {}), unknown>>>>;
+}, z.core.$strip>;
+/** A page of your follows. */
+export declare const ListMyFollowsResponseSchema: z.ZodObject<{
+    follows: z.ZodArray<z.ZodObject<{
+        followId: z.ZodString;
+        leader: z.ZodObject<{
+            walletAddress: z.ZodString;
+            handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            display: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodType<CopyRelationshipStatus | (string & {}), unknown, z.core.$ZodTypeInternals<CopyRelationshipStatus | (string & {}), unknown>>;
+        marginModePolicy: z.ZodType<CopyMarginModePolicy | (string & {}), unknown, z.core.$ZodTypeInternals<CopyMarginModePolicy | (string & {}), unknown>>;
+        sizingMode: z.ZodType<CopySizingMode | (string & {}), unknown, z.core.$ZodTypeInternals<CopySizingMode | (string & {}), unknown>>;
+        sizingParam: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        leverageMode: z.ZodType<CopyLeverageMode | (string & {}), unknown, z.core.$ZodTypeInternals<CopyLeverageMode | (string & {}), unknown>>;
+        fixedLeverage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        allocation: z.ZodString;
+        slPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        copyExisting: z.ZodBoolean;
+        tradingPairIds: z.ZodArray<z.ZodString>;
+        consecutiveSkips: z.ZodNumber;
+        copyRiskBucketId: z.ZodString;
+        startedAt: z.ZodString;
+        stoppedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        stopReason: z.ZodOptional<z.ZodNullable<z.ZodType<CopyStopReason | (string & {}), unknown, z.core.$ZodTypeInternals<CopyStopReason | (string & {}), unknown>>>>;
+    }, z.core.$strip>>;
+    nextPageToken: z.ZodString;
+}, z.core.$strip>;
+/** A leader fill one of your follows did not mirror. */
+export declare const CopySkipSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    reason: z.ZodType<CopySkipReason | (string & {}), unknown, z.core.$ZodTypeInternals<CopySkipReason | (string & {}), unknown>>;
+    requestedQuantity: z.ZodString;
+    skippedAt: z.ZodString;
+}, z.core.$strip>;
+/** One of your follows with its most recent skips (up to 100). */
+export declare const GetFollowResponseSchema: z.ZodObject<{
+    follow: z.ZodObject<{
+        followId: z.ZodString;
+        leader: z.ZodObject<{
+            walletAddress: z.ZodString;
+            handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            display: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodType<CopyRelationshipStatus | (string & {}), unknown, z.core.$ZodTypeInternals<CopyRelationshipStatus | (string & {}), unknown>>;
+        marginModePolicy: z.ZodType<CopyMarginModePolicy | (string & {}), unknown, z.core.$ZodTypeInternals<CopyMarginModePolicy | (string & {}), unknown>>;
+        sizingMode: z.ZodType<CopySizingMode | (string & {}), unknown, z.core.$ZodTypeInternals<CopySizingMode | (string & {}), unknown>>;
+        sizingParam: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        leverageMode: z.ZodType<CopyLeverageMode | (string & {}), unknown, z.core.$ZodTypeInternals<CopyLeverageMode | (string & {}), unknown>>;
+        fixedLeverage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        allocation: z.ZodString;
+        slPct: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        copyExisting: z.ZodBoolean;
+        tradingPairIds: z.ZodArray<z.ZodString>;
+        consecutiveSkips: z.ZodNumber;
+        copyRiskBucketId: z.ZodString;
+        startedAt: z.ZodString;
+        stoppedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        stopReason: z.ZodOptional<z.ZodNullable<z.ZodType<CopyStopReason | (string & {}), unknown, z.core.$ZodTypeInternals<CopyStopReason | (string & {}), unknown>>>>;
+    }, z.core.$strip>;
+    recentSkips: z.ZodArray<z.ZodObject<{
+        tradingPairId: z.ZodString;
+        reason: z.ZodType<CopySkipReason | (string & {}), unknown, z.core.$ZodTypeInternals<CopySkipReason | (string & {}), unknown>>;
+        requestedQuantity: z.ZodString;
+        skippedAt: z.ZodString;
+    }, z.core.$strip>>;
+    copyAccountEquity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** The open positions of the leader one of your follows copies. */
+export declare const ListFollowLeaderPositionsResponseSchema: z.ZodObject<{
+    positions: z.ZodArray<z.ZodObject<{
+        tradingPairId: z.ZodString;
+        side: z.ZodString;
+        size: z.ZodString;
+        entryPrice: z.ZodString;
+        markPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unrealizedPnl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        leverage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        marginMode: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Result of following a leader or editing a follow. */
+export declare const UpsertFollowResponseSchema: z.ZodObject<{
+    followId: z.ZodString;
+    copyRiskBucketId: z.ZodString;
+    created: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * What following with `copyExisting` would open, as totals only. The caller
+ * is never a follower of the leader, so the preview names no pair, side,
+ * size, mark or skip reason. Totals are rounded up to cents.
+ */
+export declare const PreviewFollowResponseSchema: z.ZodObject<{
+    estimatedMargin: z.ZodString;
+    estimatedFee: z.ZodString;
+    copiedPositions: z.ZodNumber;
+    skippedPositions: z.ZodNumber;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+/** Result of stopping a follow. */
+export declare const StopFollowResponseSchema: z.ZodObject<{
+    followId: 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>;
+export type LeadTraderStats = z.infer<typeof LeadTraderStatsSchema>;
+export type GetLeadTraderResponse = z.infer<typeof GetLeadTraderResponseSchema>;
+export type LeadTraderListing = z.infer<typeof LeadTraderListingSchema>;
+export type ListLeadTradersResponse = z.infer<typeof ListLeadTradersResponseSchema>;
+export type UpsertLeadTraderResponse = z.infer<typeof UpsertLeadTraderResponseSchema>;
+export type Follower = z.infer<typeof FollowerSchema>;
+export type ListMyFollowersResponse = z.infer<typeof ListMyFollowersResponseSchema>;
+export type ClosedTrade = z.infer<typeof ClosedTradeSchema>;
+export type ListLeadTraderClosedTradesResponse = z.infer<typeof ListLeadTraderClosedTradesResponseSchema>;
+export type LeadTraderOpenPosition = z.infer<typeof LeadTraderOpenPositionSchema>;
+export type ListLeadTraderOpenPositionsResponse = z.infer<typeof ListLeadTraderOpenPositionsResponseSchema>;
+export type Follow = z.infer<typeof FollowSchema>;
+export type ListMyFollowsResponse = z.infer<typeof ListMyFollowsResponseSchema>;
+export type CopySkip = z.infer<typeof CopySkipSchema>;
+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 PreviewFollowResponse = z.infer<typeof PreviewFollowResponseSchema>;