@0xmonaco/types 1.0.85 → 1.0.87

package/dist/applications/responses.d.ts

@@ -228,8 +228,10 @@ export interface ListAppBalancesResponse {
 /**
  * Aggregate volume and fee stats for an application.
  *
- * Stats are scoped to trades where the application's users were the taker.
- * All monetary values are normalized (human-readable quote token units).
+ * Stats are scoped to trades where the application's users were the taker,
+ * except `applicationMakerFee` (and its share of `builderFeeTotal`), which
+ * counts trades where they were the maker. All monetary values are normalized
+ * (human-readable quote token units).
  */
 export interface GetAppStatsResponse {
     /** Total quote volume for trades where this application's users were the taker */
@@ -238,8 +240,12 @@ export interface GetAppStatsResponse {
     makerFee: string;
     /** Total taker fees collected */
     takerFee: string;
-    /** Application revenue share from taker fees */
+    /** Builder fees this application charged its users as takers. Taker side only */
     applicationTakerFee: string;
     /** Total number of trades */
     tradeCount: number;
+    /** Maker add-ons this application charged its users as makers. Absent from servers older than this field */
+    applicationMakerFee?: string;
+    /** `applicationTakerFee` plus `applicationMakerFee`. Absent from servers older than this field */
+    builderFeeTotal?: string;
 }

package/dist/auth/index.d.ts

@@ -108,7 +108,7 @@ export interface AuthAPI extends BaseAPI {
      */
     setWalletClient(walletClient: unknown): void;
 }
-export type { ApplicationInfo, AuthState, ChallengeResponse, SessionCredentials, SessionRefreshResponse, User, } from "./responses";
+export type { ApplicationInfo, AuthState, ChallengeResponse, ReferralNotAppliedReason, SessionCredentials, SessionRefreshResponse, User, } from "./responses";
 export interface InviteCodeRequestSummary {
     mainnetVolumeUsd: string;
     eligibleMilestones: number;

package/dist/auth/responses.d.ts

@@ -23,6 +23,19 @@ export interface User {
     /** Username of the user */
     username?: string;
 }
+/**
+ * Why a TraderCode presented on a first sign-in did not record a referral.
+ * Sign-in succeeds either way.
+ *
+ * - `REFERRAL_NOT_APPLIED_REASON_ALREADY_REFERRED`: the wallet already has a
+ *   different referrer, from signing up with that referrer's code on this or
+ *   another application. A wallet keeps its first referrer.
+ * - `REFERRAL_NOT_APPLIED_REASON_UNKNOWN_CODE`: the code matches no wallet and
+ *   no custom handle.
+ * - `REFERRAL_NOT_APPLIED_REASON_SELF_REFERRAL`: the code is the signing
+ *   wallet's own.
+ */
+export type ReferralNotAppliedReason = "REFERRAL_NOT_APPLIED_REASON_UNSPECIFIED" | "REFERRAL_NOT_APPLIED_REASON_ALREADY_REFERRED" | "REFERRAL_NOT_APPLIED_REASON_UNKNOWN_CODE" | "REFERRAL_NOT_APPLIED_REASON_SELF_REFERRAL";
 /**
  * Authentication state for the noncustodial session-key scheme.
  *
@@ -58,6 +71,14 @@ export interface AuthState {
      * the field.
      */
     referralApplied?: boolean;
+    /**
+     * Why the TraderCode presented on this sign-up did not apply, to show the
+     * user (e.g. "you already have a referrer"). Absent when it applied, when no
+     * code was presented, for a returning user of this application, and on
+     * responses from a server that predates the field. Treat an unrecognised
+     * value as a newer reason.
+     */
+    referralNotAppliedReason?: ReferralNotAppliedReason | (string & {});
 }
 export interface ApplicationInfo {
     /** Unique identifier for the application */

package/dist/buildercodes/index.d.ts

@@ -18,7 +18,7 @@ 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. */
+    /** Set this frontend's stored builder fee and, optionally, its maker add-on, in basis points, as one change. */
     setBuilderFee(params: SetBuilderFeeParams): Promise<SetBuilderFeeResponse>;
     /** List this frontend's builder-fee audit log, newest first. */
     listBuilderFeeChanges(params?: ListBuilderFeeChangesParams): Promise<ListBuilderFeeChangesResponse>;

package/dist/buildercodes/responses.d.ts

@@ -17,17 +17,21 @@ export declare const GetBuildercodesConfigResponseSchema: z.ZodObject<{
     builderFeeCapBps: z.ZodNumber;
     changesRemaining: z.ZodNumber;
     nextChangeAllowedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    builderMakerFeeBps: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-/** Schema for changing this frontend's builder fee. */
+/** Schema for changing this frontend's builder fees. */
 export declare const SetBuilderFeeParamsSchema: z.ZodObject<{
     bps: z.ZodNumber;
+    makerBps: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-/** Schema returned after setting this frontend's builder fee. */
+/** Schema returned after setting this frontend's builder fees. */
 export declare const SetBuilderFeeResponseSchema: z.ZodObject<{
     builderFeeBps: z.ZodNumber;
     previousBuilderFeeBps: z.ZodNumber;
     changesRemaining: z.ZodNumber;
     nextChangeAllowedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    builderMakerFeeBps: z.ZodOptional<z.ZodNumber>;
+    previousBuilderMakerFeeBps: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** Builder-fee change actor exposed by the audit log. */
 export declare const BuilderFeeActorTypeSchema: z.ZodEnum<{
@@ -44,6 +48,8 @@ export declare const BuilderFeeChangeSchema: z.ZodObject<{
     oldBps: z.ZodNumber;
     newBps: z.ZodNumber;
     createdAt: z.ZodString;
+    oldMakerBps: z.ZodOptional<z.ZodNumber>;
+    newMakerBps: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** Cursor pagination accepted by the builder-fee change log. */
 export declare const ListBuilderFeeChangesParamsSchema: z.ZodObject<{
@@ -61,16 +67,20 @@ export declare const ListBuilderFeeChangesResponseSchema: z.ZodObject<{
         oldBps: z.ZodNumber;
         newBps: z.ZodNumber;
         createdAt: z.ZodString;
+        oldMakerBps: z.ZodOptional<z.ZodNumber>;
+        newMakerBps: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     nextPageToken: z.ZodString;
 }, z.core.$strip>;
 /**
  * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` records
- * Monaco revenue share; `BUILDER_FEE` records builder fees charged to takers.
+ * Monaco revenue share; `BUILDER_FEE` records builder fees charged to takers;
+ * `BUILDER_MAKER_FEE` records maker add-ons charged to makers.
  */
 export declare const BuildercodePayoutKindSchema: z.ZodEnum<{
     REVENUE_SHARE: "REVENUE_SHARE";
     BUILDER_FEE: "BUILDER_FEE";
+    BUILDER_MAKER_FEE: "BUILDER_MAKER_FEE";
 }>;
 /**
  * Pagination and filter accepted by the per-trade payout history endpoint.
@@ -86,6 +96,7 @@ export declare const ListBuildercodePayoutsParamsSchema: z.ZodObject<{
     kind: z.ZodOptional<z.ZodEnum<{
         REVENUE_SHARE: "REVENUE_SHARE";
         BUILDER_FEE: "BUILDER_FEE";
+        BUILDER_MAKER_FEE: "BUILDER_MAKER_FEE";
     }>>;
 }, z.core.$strip>;
 /** One per-trade BuilderCodes credit. Amounts are RAW atomic units. */
@@ -99,6 +110,7 @@ export declare const BuildercodePayoutSchema: z.ZodObject<{
     kind: z.ZodOptional<z.ZodEnum<{
         REVENUE_SHARE: "REVENUE_SHARE";
         BUILDER_FEE: "BUILDER_FEE";
+        BUILDER_MAKER_FEE: "BUILDER_MAKER_FEE";
     }>>;
 }, z.core.$strip>;
 /** Schema for the paginated per-trade payout history. */
@@ -113,6 +125,7 @@ export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
         kind: z.ZodOptional<z.ZodEnum<{
             REVENUE_SHARE: "REVENUE_SHARE";
             BUILDER_FEE: "BUILDER_FEE";
+            BUILDER_MAKER_FEE: "BUILDER_MAKER_FEE";
         }>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
@@ -133,6 +146,7 @@ export declare const BuildercodePayoutTokenKindTotalSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         REVENUE_SHARE: "REVENUE_SHARE";
         BUILDER_FEE: "BUILDER_FEE";
+        BUILDER_MAKER_FEE: "BUILDER_MAKER_FEE";
     }>;
     totalAmount: z.ZodString;
     payoutCount: z.ZodNumber;
@@ -153,11 +167,18 @@ export declare const GetBuildercodePayoutSummaryResponseSchema: z.ZodObject<{
         kind: z.ZodEnum<{
             REVENUE_SHARE: "REVENUE_SHARE";
             BUILDER_FEE: "BUILDER_FEE";
+            BUILDER_MAKER_FEE: "BUILDER_MAKER_FEE";
         }>;
         totalAmount: z.ZodString;
         payoutCount: z.ZodNumber;
         lastCreditedAt: z.ZodString;
     }, z.core.$strip>>>;
+    builderFeeByToken: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        token: z.ZodString;
+        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<{

package/dist/buildercodes/responses.js

@@ -21,17 +21,35 @@ export const GetBuildercodesConfigResponseSchema = z.object({
     builderFeeCapBps: z.number().int().min(0).max(100),
     changesRemaining: z.number().int().min(0).max(2),
     nextChangeAllowedAt: z.string().nullable().optional(),
+    /**
+     * The stored maker add-on in basis points: the additional fee this frontend
+     * charges its users when their order fills as the maker. Shares
+     * `builderFeeCapBps` and the switches with the taker fee. Absent from servers
+     * older than this field.
+     */
+    builderMakerFeeBps: z.number().int().min(0).max(100).optional(),
 });
-/** Schema for changing this frontend's builder fee. */
+/** Schema for changing this frontend's builder fees. */
 export const SetBuilderFeeParamsSchema = z.object({
+    /** The taker builder fee in basis points. Required; `0` stops charging one. */
     bps: z.number().int().min(0).max(100),
+    /**
+     * The maker add-on in basis points. Omit to leave it unchanged; `0` stops
+     * charging one. Applies to orders placed shortly after it is saved, never to
+     * an order already resting. One call that sets both sides is one change.
+     */
+    makerBps: z.number().int().min(0).max(100).optional(),
 });
-/** Schema returned after setting this frontend's builder fee. */
+/** Schema returned after setting this frontend's builder fees. */
 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(),
+    /** The maker add-on now stored. Absent from servers older than this field. */
+    builderMakerFeeBps: z.number().int().min(0).max(100).optional(),
+    /** The maker add-on this change replaced. Absent from servers older than this field. */
+    previousBuilderMakerFeeBps: z.number().int().min(0).max(100).optional(),
 });
 /** Builder-fee change actor exposed by the audit log. */
 export const BuilderFeeActorTypeSchema = z.enum(["BUILDER", "ADMIN"]);
@@ -42,6 +60,10 @@ export const BuilderFeeChangeSchema = z.object({
     oldBps: z.number().int().min(0).max(100),
     newBps: z.number().int().min(0).max(100),
     createdAt: z.string(),
+    /** The maker add-on before the change. Absent from servers older than this field. */
+    oldMakerBps: z.number().int().min(0).max(100).optional(),
+    /** The maker add-on after the change. Absent from servers older than this field. */
+    newMakerBps: z.number().int().min(0).max(100).optional(),
 });
 /** Cursor pagination accepted by the builder-fee change log. */
 export const ListBuilderFeeChangesParamsSchema = z.object({
@@ -55,9 +77,10 @@ export const ListBuilderFeeChangesResponseSchema = z.object({
 });
 /**
  * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` records
- * Monaco revenue share; `BUILDER_FEE` records builder fees charged to takers.
+ * Monaco revenue share; `BUILDER_FEE` records builder fees charged to takers;
+ * `BUILDER_MAKER_FEE` records maker add-ons charged to makers.
  */
-export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE"]);
+export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE", "BUILDER_MAKER_FEE"]);
 /**
  * Pagination and filter accepted by the per-trade payout history endpoint.
  *
@@ -130,6 +153,11 @@ export const GetBuildercodePayoutSummaryResponseSchema = z.object({
      * `byToken` total. Absent from servers older than this field.
      */
     byTokenAndKind: z.array(BuildercodePayoutTokenKindTotalSchema).optional(),
+    /**
+     * Per-token builder-fee totals: `BUILDER_FEE` plus `BUILDER_MAKER_FEE`,
+     * without the revenue share. Absent from servers older than this field.
+     */
+    builderFeeByToken: z.array(BuildercodePayoutTokenTotalSchema).optional(),
 });
 /** One available balance in the reserved BuilderCodes reward bucket. */
 export const BuildercodeRewardsBalanceSchema = z.object({

package/dist/fees/responses.d.ts

@@ -31,6 +31,8 @@ export declare const SimulateFeeResponseSchema: z.ZodObject<{
     applicationTakerFeeBps: z.ZodNumber;
     buyOrderLockAmount: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     makerTotalReceipt: z.ZodString;
+    applicationMakerFee: z.ZodOptional<z.ZodString>;
+    applicationMakerFeeBps: z.ZodOptional<z.ZodNumber>;
     monacoMakerRebate: z.ZodString;
     monacoMakerRebateBps: z.ZodNumber;
     monacoMakerRebateBpsExact: z.ZodString;

package/dist/fees/responses.js

@@ -61,8 +61,12 @@ export const SimulateFeeResponseSchema = z.object({
     applicationTakerFeeBps: z.number(),
     /** Amount to lock for BUY orders (null for `SELL`) */
     buyOrderLockAmount: z.string().nullable().optional(),
-    /** Total amount maker receives */
+    /** Total amount received if the order fills as the maker: notional minus the maker fee (a rebate adds) minus `applicationMakerFee` */
     makerTotalReceipt: z.string(),
+    /** Frontend maker add-on if the order fills as the maker. Absent from servers older than this field */
+    applicationMakerFee: z.string().optional(),
+    /** Maker add-on rate in basis points an order placed now would store. Absent from servers older than this field */
+    applicationMakerFeeBps: z.number().optional(),
     /** Monaco protocol maker rebate (negative = rebate) */
     monacoMakerRebate: z.string(),
     /**

package/dist/index.d.ts

@@ -16,7 +16,6 @@ export * from "./fees";
 export * from "./managed-markets";
 export * from "./margin-accounts";
 export * from "./market";
-export * from "./pitpass";
 export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";

package/dist/index.js

@@ -17,7 +17,6 @@ export * from "./fees";
 export * from "./managed-markets";
 export * from "./margin-accounts";
 export * from "./market";
-export * from "./pitpass";
 export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";

package/dist/market/index.d.ts

@@ -201,7 +201,7 @@ export interface ScreenerSnapshotPoint {
     quoteVolume: string;
     /** Percent price change (close - open) / open * 100 for the day */
     priceChangePercent: string;
-    /** Daily average of the valued completed-UTC-minute gross open-interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
+    /** Daily average of the valued completed-UTC-minute one-sided LONG open-interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
     openInterestNotionalAvg: string | null;
 }
 /**
@@ -252,22 +252,24 @@ export interface ScreenerItem {
      */
     lastFundingTime: string | null;
     /**
-     * Gross open interest (longs plus shorts) in base-asset units (e.g. BTC);
-     * null for spot pairs, "0" for a margin pair with no open positions
+     * One-sided LONG open interest (each contract counted once) in base-asset units
+     * (e.g. BTC), from the latest completed-minute sample; null for spot pairs or
+     * when no sample was recorded in the last five minutes, "0" for a margin pair with no
+     * open positions
      */
     openInterestBase: string | null;
     /**
-     * Gross open-interest notional (longs plus shorts) in quote units
+     * One-sided LONG open-interest notional in quote units
      * (openInterestBase × latest trade price); null for spot pairs. Valued at the pair's latest trade price (a
      * snapshot); the mark-accurate notional lives on getPerpMarketSummary /
      * getOpenInterest
      */
     openInterestNotional: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
     openInterestNotionalAvg1h: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
     openInterestNotionalAvg24h: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
     openInterestNotionalAvg7d: string | null;
     /**
      * Estimated rate for the in-progress funding window (decimal fraction per
@@ -436,11 +438,11 @@ export interface PerpMarketSummary {
     quoteVolume24h?: string;
     priceChange24h?: string;
     priceChangePercent24h?: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (legacy alias of openInterestBase) */
     openInterest: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (e.g. BTC) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (e.g. BTC) */
     openInterestBase?: string;
-    /** Gross open-interest notional (longs plus shorts) in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
+    /** One-sided LONG open-interest notional in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
     openInterestNotional?: string;
     currentFundingRate?: string;
     estimatedNextFundingRate?: string;
@@ -595,11 +597,11 @@ export interface ListAllFundingHistoryResponse {
 }
 export interface OpenInterest {
     tradingPairId: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (legacy alias of openInterestBase) */
     openInterest?: string;
-    /** Gross open interest (longs plus shorts) in base-asset units */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units */
     openInterestBase: string;
-    /** Gross open-interest notional (longs plus shorts) in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
+    /** One-sided LONG open-interest notional in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
     openInterestNotional: string;
     updatedAt: string;
 }

package/dist/profile/index.d.ts

@@ -287,16 +287,16 @@ export interface UserTrade {
     /**
      * Total fee paid for this trade (as string to preserve precision). For a
      * taker this is Monaco's taker fee plus the frontend's builder fee; for a
-     * maker it is the maker fee (negative for a rebate). Equals
-     * `monacoFee + builderFee`.
+     * maker it is the maker fee (negative for a rebate) plus the frontend's
+     * maker add-on. Equals `monacoFee + builderFee`.
      */
     fee: string;
     /** Monaco's component of `fee`. Absent from servers older than this field. */
     monacoFee?: string;
     /**
-     * The frontend's builder fee component of `fee`. Always `"0"` for a maker:
-     * builder fees are charged to takers only. Absent from servers older than
-     * this field.
+     * The frontend's builder fee component of `fee`: the builder fee for a
+     * taker, the maker add-on for a maker. Absent from servers older than this
+     * field.
      */
     builderFee?: string;
     /** Timestamp when the trade was executed (ISO string) */

package/dist/sdk/index.d.ts

@@ -9,7 +9,6 @@ import type { FeesAPI } from "../fees";
 import type { ManagedMarketsAPI } from "../managed-markets";
 import type { MarginAccountsAPI } from "../margin-accounts";
 import type { MarketAPI } from "../market";
-import type { PitpassAPI } from "../pitpass";
 import type { PortfolioAPI } from "../portfolio";
 import type { PositionsAPI } from "../positions";
 import type { ProfileAPI } from "../profile";
@@ -115,13 +114,6 @@ export interface MonacoSDK {
     subAccounts: SubAccountsAPI;
     /** TraderCodes referral and rewards API */
     tradercodes: TraderCodesAPI;
-    /**
-     * TraderCodes referral and rewards API under its original name: the same
-     * instance as {@link tradercodes}.
-     *
-     * @deprecated Use `tradercodes`. Removed after at least two SDK releases.
-     */
-    pitpass: PitpassAPI;
     /** BuilderCodes frontend revenue-share payout API */
     buildercodes: BuildercodesAPI;
     /** Copy trading API: lead trader profiles and the leaderboard, and your follows */

package/dist/trading/index.d.ts

@@ -71,7 +71,7 @@ export interface TradingAPI extends BaseAPI {
          * replacement re-states it and inherits nothing from the original order.
          */
         clientOrderId?: string;
-        /** The SDK generates a key once per call when omitted. Supply the same key to retry a logical order within 24 hours. */
+        /** The SDK generates a key once per call when omitted. Supply the same key to retry a logical order within 15 minutes. */
         idempotencyKey?: string;
         takeProfit?: ParentTpSlLegParams;
         stopLoss?: ParentTpSlLegParams;
@@ -126,7 +126,7 @@ export interface TradingAPI extends BaseAPI {
          * replacement re-states it and inherits nothing from the original order.
          */
         clientOrderId?: string;
-        /** The SDK generates a key once per call when omitted. Supply the same key to retry a logical order within 24 hours. */
+        /** The SDK generates a key once per call when omitted. Supply the same key to retry a logical order within 15 minutes. */
         idempotencyKey?: string;
         takeProfit?: ParentTpSlLegParams;
         stopLoss?: ParentTpSlLegParams;

package/dist/trading/responses.d.ts

@@ -425,7 +425,7 @@ export interface BatchCreateOrderParams {
      * execute a second time.
      */
     clientOrderId?: string;
-    /** The SDK generates a key once per item when omitted. Supply the same key for batch or single-create retries within 24 hours. */
+    /** The SDK generates a key once per item when omitted. Supply the same key for batch or single-create retries within 15 minutes. */
     idempotencyKey?: string;
 }
 /**

package/dist/websocket/events/market-stats-events.d.ts

@@ -45,7 +45,8 @@ export interface MarketStatsData {
     /** Best ask price (decimal string) */
     bestAskPrice?: string;
     /**
-     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * One-sided LONG open interest (each contract counted once) in base
+     * units (decimal string).
      * Perp-only; omitted for spot, and omitted (never zero) until the market's
      * open interest is known.
      */
@@ -58,8 +59,8 @@ export interface MarketStatsData {
     openInterestLimit?: string;
     /**
      * What is left of `openInterestLimit` at the mark, in quote (USD) notional,
-     * never below zero (decimal string): the cap minus the gross `openInterest`
-     * × `markPrice`. At zero, orders that open exposure are refused until open
+     * never below zero (decimal string): the cap minus the gross open interest
+     * (longs plus shorts, not derivable from `openInterest`) × `markPrice`. At zero, orders that open exposure are refused until open
      * interest or the mark falls. Perp-only; omitted for spot, when there is no
      * mark, and until open interest is known.
      */
@@ -147,7 +148,8 @@ export interface MarketStatsSummary {
     /** 24h low price (decimal string) */
     dailyPriceLow?: string;
     /**
-     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * One-sided LONG open interest (each contract counted once) in base
+     * units (decimal string).
      * Perp-only; omitted for spot, and omitted (never zero) until the market's
      * open interest is known.
      */
@@ -169,8 +171,7 @@ export interface MarketStatsSummary {
     /** Funding premium (decimal string). Perp-only; omitted for spot. */
     premium?: string;
     /**
-     * Gross open interest (longs plus shorts) in quote notional (decimal
-     * string): `openInterest` priced at the mark, falling back to the last trade
+     * One-sided LONG open interest in quote notional (decimal string): `openInterest` priced at the mark, falling back to the last trade
      * price. Perp-only; omitted for spot,
      * and omitted (never zero) until both open interest and a price are known.
      */

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

@@ -288,7 +288,7 @@ export interface OrderMatchedEvent extends OrderEvent {
          * units (negative = maker rebate): `monacoFee + builderFee`. For a taker
          * this is Monaco's taker fee plus the frontend's builder fee, the same
          * total as the order echo's `totalTakerFees`; for a maker it is the maker
-         * fee. Wire: `fee`.
+         * fee plus the frontend's maker add-on. Wire: `fee`.
          */
         fee: string;
         /**
@@ -307,8 +307,8 @@ export interface OrderMatchedEvent extends OrderEvent {
         monacoFeeRaw?: string;
         /**
          * The frontend's builder fee component of `fee`, in normalized decimal
-         * QUOTE units. Always `"0"` for a maker: builder fees are charged to
-         * takers only. Optional because a server older than this field omits it.
+         * QUOTE units: the builder fee for a taker, the maker add-on for a maker.
+         * Optional because a server older than this field omits it.
          * Wire: `builder_fee`.
          */
         builderFee?: string;
@@ -409,7 +409,7 @@ export interface OrderPartiallyFilledEvent extends OrderEvent {
          *
          * For a taker this is Monaco's taker fee plus the frontend's builder fee,
          * the same total as the order echo's `totalTakerFees`; for a maker it is
-         * the maker fee. It previously held the raw integer value now exposed as
+         * the maker fee plus the frontend's maker add-on. It previously held the raw integer value now exposed as
          * `feeRaw`, and before that Monaco's fee alone.
          */
         fee?: string;
@@ -426,8 +426,9 @@ export interface OrderPartiallyFilledEvent extends OrderEvent {
         monacoFeeRaw?: string;
         /**
          * The frontend's builder fee component of `fee`, in normalized decimal
-         * QUOTE units. Always `"0"` for a maker: builder fees are charged to
-         * takers only. Wire: `builder_fee`.
+         * QUOTE units: the builder fee for a taker, the maker add-on (charged at
+         * the rate the order stored when it was placed) for a maker. Wire:
+         * `builder_fee`.
          */
         builderFee?: string;
         /** `builderFee` in RAW quote-unit precision. Wire: `builder_fee_raw`. */
@@ -507,7 +508,7 @@ export interface OrderFilledEvent extends OrderEvent {
          *
          * For a taker this is Monaco's taker fee plus the frontend's builder fee,
          * the same total as the order echo's `totalTakerFees`; for a maker it is
-         * the maker fee. It previously held the raw integer value now exposed as
+         * the maker fee plus the frontend's maker add-on. It previously held the raw integer value now exposed as
          * `feeRaw`, and before that Monaco's fee alone.
          */
         fee?: string;
@@ -524,8 +525,9 @@ export interface OrderFilledEvent extends OrderEvent {
         monacoFeeRaw?: string;
         /**
          * The frontend's builder fee component of `fee`, in normalized decimal
-         * QUOTE units. Always `"0"` for a maker: builder fees are charged to
-         * takers only. Wire: `builder_fee`.
+         * QUOTE units: the builder fee for a taker, the maker add-on (charged at
+         * the rate the order stored when it was placed) for a maker. Wire:
+         * `builder_fee`.
          */
         builderFee?: string;
         /** `builderFee` in RAW quote-unit precision. Wire: `builder_fee_raw`. */

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_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", "close_sub_account", "create_challenge", "create_delegated_session", "create_order", "create_sub_account", "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_pnl", "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_referral_tree", "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_invite_codes", "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_order_slices", "list_twap_orders", "mint_tokens", "pitpass_check_trader_code_availability", "pitpass_clear_trader_code", "pitpass_get_my_referral_downline", "pitpass_get_my_referral_position", "pitpass_get_my_referral_tree", "pitpass_get_my_trader_code", "pitpass_get_rewards_balance", "pitpass_get_trader_code_info", "pitpass_set_trader_code", "pitpass_transfer_rewards", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "request_invite_codes", "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", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_from_sub_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_collateral_to_sub_account", "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", "close_sub_account", "create_challenge", "create_delegated_session", "create_order", "create_sub_account", "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_pnl", "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_referral_tree", "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_invite_codes", "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_order_slices", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "request_invite_codes", "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", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_from_sub_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_collateral_to_sub_account", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -129,16 +129,6 @@ export const OPERATION_IDS = [
     "list_twap_order_slices",
     "list_twap_orders",
     "mint_tokens",
-    "pitpass_check_trader_code_availability",
-    "pitpass_clear_trader_code",
-    "pitpass_get_my_referral_downline",
-    "pitpass_get_my_referral_position",
-    "pitpass_get_my_referral_tree",
-    "pitpass_get_my_trader_code",
-    "pitpass_get_rewards_balance",
-    "pitpass_get_trader_code_info",
-    "pitpass_set_trader_code",
-    "pitpass_transfer_rewards",
     "preview_follow",
     "refresh_managed_market_quotes",
     "refresh_session",