@0xmonaco/types 1.0.73 → 1.0.74

package/dist/validation/margin-accounts.d.ts

@@ -50,12 +50,14 @@ export declare const TransferCollateralToRiskBucketSchema: z.ZodObject<{
         tradingPairId: z.ZodUUID;
         strategyKey: z.ZodOptional<z.ZodString>;
         marginMode: z.ZodOptional<z.ZodLiteral<"ISOLATED">>;
+        marginAccountId: z.ZodOptional<z.ZodUUID>;
         selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
         applyToPositionMargin: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>, z.ZodObject<{
         asset: z.ZodString;
         amount: z.ZodString;
         marginMode: z.ZodLiteral<"CROSS">;
+        marginAccountId: z.ZodOptional<z.ZodUUID>;
         selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
         strategyKey: z.ZodOptional<z.ZodNever>;
         tradingPairId: z.ZodOptional<z.ZodNever>;
@@ -154,6 +156,7 @@ export declare const SimulateRiskBucketOrderRiskSchema: z.ZodObject<{
         tradingPairId: z.ZodUUID;
         strategyKey: z.ZodOptional<z.ZodString>;
         marginMode: z.ZodOptional<z.ZodLiteral<"ISOLATED">>;
+        marginAccountId: z.ZodOptional<z.ZodUUID>;
         selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
         applyToPositionMargin: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>, z.ZodObject<{
@@ -177,7 +180,38 @@ export declare const SimulateRiskBucketOrderRiskSchema: z.ZodObject<{
         reduceOnly: z.ZodOptional<z.ZodBoolean>;
         slippageToleranceBps: z.ZodOptional<z.ZodNumber>;
         marginMode: z.ZodLiteral<"CROSS">;
+        marginAccountId: z.ZodOptional<z.ZodUUID>;
         selectedTradingPairIds: z.ZodOptional<z.ZodNever>;
         strategyKey: z.ZodOptional<z.ZodNever>;
     }, z.core.$strict>]>>;
 }, z.core.$strip>;
+export declare const CreateMarginSubAccountSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        subaccountKey: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export declare const CloseMarginSubAccountSchema: z.ZodObject<{
+    marginAccountId: z.ZodUUID;
+}, z.core.$strip>;
+export declare const GetMarginAccountPnlSchema: z.ZodObject<{
+    marginAccountId: z.ZodUUID;
+}, z.core.$strip>;
+export declare const TransferMarginCollateralSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        asset: z.ZodString;
+        amount: z.ZodString;
+        from: z.ZodUnion<readonly [z.ZodObject<{
+            wallet: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            marginAccountId: z.ZodUUID;
+            riskBucketId: z.ZodOptional<z.ZodUUID>;
+        }, z.core.$strict>]>;
+        to: z.ZodUnion<readonly [z.ZodObject<{
+            wallet: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            marginAccountId: z.ZodUUID;
+            riskBucketId: z.ZodOptional<z.ZodUUID>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>;
+}, z.core.$strip>;

package/dist/validation/margin-accounts.js

@@ -49,6 +49,9 @@ const RiskBucketRequestSchema = z.object({
 });
 const IsolatedRiskBucketRequestSchema = RiskBucketRequestSchema.extend({
     marginMode: z.literal("ISOLATED").optional(),
+    // A sub-account funds and previews its own risk buckets; omitted means the
+    // default margin account.
+    marginAccountId: UUIDSchema.optional(),
     selectedTradingPairIds: z.never().optional(),
     // Omitted defaults server-side to true (the Adjust Margin gesture); false
     // is the plain allocation programmatic funding loops need. The CROSS form
@@ -64,6 +67,7 @@ const IsolatedRiskBucketRequestSchema = RiskBucketRequestSchema.extend({
 // the pair being previewed, not a scope declaration.
 const CrossRiskBucketSimulateRequestSchema = z.object({
     marginMode: z.literal("CROSS"),
+    marginAccountId: UUIDSchema.optional(),
     selectedTradingPairIds: z.never().optional(),
     strategyKey: z.never().optional(),
 });
@@ -74,6 +78,7 @@ const CrossRiskBucketSimulateRequestSchema = z.object({
 // it does nothing rather than believing it took effect.
 const CrossRiskBucketRequestSchema = z.object({
     marginMode: z.literal("CROSS"),
+    marginAccountId: UUIDSchema.optional(),
     selectedTradingPairIds: z.never().optional(),
     strategyKey: z.never().optional(),
     tradingPairId: z.never().optional(),
@@ -223,3 +228,38 @@ export const SimulateRiskBucketOrderRiskSchema = z
     message: "price is required for LIMIT risk simulations",
     path: ["request", "price"],
 });
+export const CreateMarginSubAccountSchema = z.object({
+    request: z
+        .object({
+        subaccountKey: z
+            .string()
+            .trim()
+            .min(1, "subaccountKey is required")
+            .max(64, "subaccountKey must be at most 64 characters")
+            .regex(/^[A-Za-z0-9_.:-]+$/, "subaccountKey may contain only letters, digits, '_', '-', '.' and ':'")
+            .refine((key) => !key.toLowerCase().startsWith("copy:"), "sub-account keys starting with copy: are reserved")
+            .refine((key) => key !== "default", "default names the default margin account"),
+        label: z.string().optional(),
+    })
+        .strict(),
+});
+export const CloseMarginSubAccountSchema = z.object({
+    marginAccountId: UUIDSchema,
+});
+export const GetMarginAccountPnlSchema = z.object({
+    marginAccountId: UUIDSchema,
+});
+const CollateralTransferEndpointSchema = z.union([
+    z.object({ wallet: z.literal(true) }).strict(),
+    z.object({ marginAccountId: UUIDSchema, riskBucketId: UUIDSchema.optional() }).strict(),
+]);
+export const TransferMarginCollateralSchema = z.object({
+    request: z
+        .object({
+        asset: z.string().trim().min(1, "Asset is required"),
+        amount: PositiveDecimalStringSchema,
+        from: CollateralTransferEndpointSchema,
+        to: CollateralTransferEndpointSchema,
+    })
+        .strict(),
+});

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

@@ -12,7 +12,7 @@
 /**
  * Liquidation alert event data.
  *
- * `status` and `accountState` are free-form strings on the wire (they mirror
+ * `status` and `riskBucketState` are free-form strings on the wire (they mirror
  * server-side enums that carry no wire-level rename), so they are typed as
  * `string` rather than a closed union to avoid dropping a risk-critical alert
  * on an unexpected value.
@@ -28,8 +28,8 @@ export interface LiquidationEventData {
     tradingPairId?: string;
     /** Liquidation record status (e.g. "UNRESOLVED", free-form) */
     status: string;
-    /** Margin-account risk state at alert time (e.g. "PENDING", free-form) */
-    accountState: string;
+    /** The liquidated risk bucket's state at alert time (e.g. "PENDING_LIQUIDATION", free-form) */
+    riskBucketState: string;
     /** Position liquidation price, when known (decimal string) */
     liquidationPrice?: string;
     /** Mark price at alert time, when known (decimal string) */

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

@@ -179,6 +179,12 @@ export interface CommonOrderEventData {
      * Wire: `parent_order_id`.
      */
     parentOrderId?: string;
+    /**
+     * The margin account the order trades on: the default margin account or one
+     * of your sub-accounts, so an owner can route events per account. Omitted for
+     * a spot order and by servers predating the field. Wire: `margin_account_id`.
+     */
+    marginAccountId?: string;
     /**
      * The margin position this order is bound to: the same id REST `getOrder`
      * returns as `positionId`. A margin order placed while its margin account

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

@@ -42,7 +42,14 @@ export interface PositionEventData {
     side: PositionEventSide | (string & {});
     /** Position lifecycle status (SCREAMING_SNAKE_CASE on the wire, e.g. "OPEN") */
     status: PositionEventStatus | (string & {});
-    /** Absolute position size (decimal string) */
+    /**
+     * Absolute position size (decimal string). Open frames carry current size;
+     * terminal frames normally carry lifetime reduced quantity — the sum of
+     * every reducing execution, not only the exposure before the final close.
+     * After restart, incomplete legacy size history carries the known partial
+     * quantity and leaves the frame unranked. Detect closure from `status`,
+     * never from `size === "0"`.
+     */
     size: string;
     /** Average entry price (decimal string) */
     entryPrice: string;
@@ -144,14 +151,10 @@ export interface PositionEventData {
      * an unranked frame is not comparable with a snapshot row even when their
      * state matches.
      * Absent means UNRANKED, never "oldest", and it does NOT tell you whether
-     * anything was persisted. Four cases reach it: the frame came from a
-     * producer that predates this field; the emit path wrote no row;
-     * the path DID write the row but re-reads live risk state after sequencing
-     * (`funding`), so the mutation did advance the persisted version; or the
-     * frame is a different projection of the row
-     * than persistence stores (terminal frames report `size` 0 and
-     * `LIQUIDATED`, while the stored row keeps its size and records `CLOSED`).
-     * In the last two, a REST read or a fresh snapshot ranks the mutation.
+     * anything was persisted. Current cases are a producer predating this field,
+     * an emit path whose command wrote no position row, or a terminal frame
+     * rebuilt after restart from legacy reduction history that lacks the size or
+     * margin fields needed to reconstruct complete lifetime values.
      * Fall back to a full field comparison rather than ranking it lowest.
      *
      * The merge rule is PER FIELD GROUP, never per frame. On a higher version
@@ -172,15 +175,15 @@ export interface PositionEventData {
      * mutation — up to the one-hour funding interval.
      *
      * A frame is ranked only when it is a faithful projection of the row
-     * persisted at that sequence: fills that leave a position OPEN, direct
-     * isolated-position margin adds/reductions, and copy-position margin adds.
+     * persisted at that sequence: fills, non-zero funding settlements, terminal
+     * closes/liquidations/ADL, direct isolated-position margin adds/reductions,
+     * and copy-position margin adds. Funding carries state captured inside its
+     * sequencer command; terminal frames retain lifetime reduced quantity and
+     * exact CLOSED/LIQUIDATED classification.
      * The copy add refreshes the isolated child and its copy-cross siblings at
      * the same version. Cross-risk-bucket ALLOCATE/RELEASE and copy follow/stop
      * refreshes use `margin_added`/`margin_reduced` but are UNRANKED because
-     * those commands write no position rows. Funding re-reads live state after
-     * sequencing and is also unranked. TERMINAL frames are unranked because
-     * they report `size` 0 and `LIQUIDATED` while the stored row keeps its size
-     * and records `CLOSED`. Wallet IN/OUT and plain isolated allocation emit no
+     * those commands write no position rows. Wallet IN/OUT and plain isolated allocation emit no
      * position frame. Transfer frames use captured post-command state and are
      * released only after durable acknowledgement.
      */

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", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_builder_fee_changes", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_builder_fee", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
+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_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_builder_fee", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -29,9 +29,11 @@ export const OPERATION_IDS = [
     "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",
@@ -49,6 +51,7 @@ export const OPERATION_IDS = [
     "get_index_price",
     "get_lead_trader",
     "get_margin_account_movements",
+    "get_margin_account_pnl",
     "get_margin_account_summary",
     "get_mark_price",
     "get_market_metadata",
@@ -57,6 +60,7 @@ export const OPERATION_IDS = [
     "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",
@@ -139,6 +143,7 @@ export const OPERATION_IDS = [
     "simulate_risk_bucket_order_risk",
     "stop_follow",
     "submit_whitelist",
+    "transfer_collateral",
     "transfer_collateral_from_margin_account",
     "transfer_collateral_from_parent_margin_account",
     "transfer_collateral_to_margin_account",