@0xmonaco/types 1.1.5 → 1.1.7

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

@@ -101,8 +101,9 @@ export interface PositionEventData {
     /**
      * Initial margin this position requires at `markPrice` (decimal string),
      * honoring both its effective leverage and the market initial-margin floor —
-     * the same `initialMarginRequired` REST returns (0XM-2668). `"0"` when the
-     * position has no open exposure.
+     * the same `initialMarginRequired` REST returns (0XM-2668). Each unit keeps
+     * the leverage of the order that opened it. `"0"` when the position has no
+     * open exposure.
      *
      * UNVERSIONED, for the same reason as `maintenanceMarginRequired`.
      */

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

@@ -42,9 +42,33 @@ export interface RfqRequestedEvent {
 }
 /** One side of the taker's view: the allocation that would fill the quantity. */
 export interface RfqSideViewEventData {
-    /** All-in volume-weighted price, the taker's fee included. */
+    /** All-in volume-weighted price, the taker's Monaco and builder fees included. */
     vwap: string;
     availableQuantity: string;
+    /** The volume-weighted price before fees. */
+    grossVwap?: string;
+    /** Estimated Monaco taker fee on `availableQuantity`, in the quote asset. */
+    estimatedMonacoFee?: string;
+    /** Estimated builder fee on `availableQuantity`, in the quote asset. */
+    estimatedBuilderFee?: string;
+    /** Estimated total taker fee on `availableQuantity`, in the quote asset. */
+    estimatedTotalFee?: string;
+    /**
+     * The requested size on the public order book, for comparison. Display
+     * only; absent when a fresh book snapshot cannot fill the whole size.
+     */
+    book?: RfqBookComparisonEventData;
+}
+/** The taker's requested size priced against the public order book, with the view's fee rates. */
+export interface RfqBookComparisonEventData {
+    /** All-in book VWAP: the cost per unit when buying, the net proceeds per unit when selling. */
+    vwap: string;
+    /** The book VWAP before fees. */
+    grossVwap: string;
+    /** When the book snapshot was read, Unix milliseconds. */
+    asOfMs: number;
+    /** Price levels the size walked. */
+    levels: number;
 }
 /** The taker's view of the quotes. No maker identity or individual quote. */
 export interface RfqViewEventData {
@@ -57,6 +81,10 @@ export interface RfqViewEventData {
     asOfMs: number;
     /** Pushes can arrive out of order: keep the view with the highest `sequence`. */
     sequence: number;
+    /** Your Monaco taker fee rate in this view, in centi-bps. */
+    monacoFeeCbps?: number;
+    /** Your frontend's builder fee rate in this view, in centi-bps; frozen when you accept. */
+    builderFeeCbps?: number;
 }
 /** To the taker: its view moved. */
 export interface RfqViewEvent {
@@ -82,6 +110,18 @@ export interface RfqSelectionEventData {
     makerFeeCbps: number;
     /** Reject or improve before this time; silence executes. */
     lastLookDeadlineAtMs: number;
+    /**
+     * The MOST your frontend's builder add-on charges on this fill, in centi-bps:
+     * the rate stored on your quote order. A fill charges it or nothing, never
+     * more; the receipt shows what was charged. Absent when it could not be read.
+     */
+    maxBuilderFeeCbps?: number;
+    /**
+     * Estimated net at `quantity` and `price`, in the quote asset, at
+     * `makerFeeCbps` plus `maxBuilderFeeCbps`: the least you receive when
+     * selling, the most you pay when buying. Absent with `maxBuilderFeeCbps`.
+     */
+    estimatedNet?: string;
 }
 /** To one selected maker: its last-look prompt. */
 export interface RfqSelectedEvent {
@@ -94,7 +134,12 @@ export interface RfqFillEventData {
     executionId: string;
     price: string;
     quantity: string;
+    /** Your whole taker fee on this fill: `monacoFee` plus `builderFee`. */
     fee: string;
+    /** The Monaco part of `fee`. */
+    monacoFee?: string;
+    /** The builder part of `fee`. */
+    builderFee?: string;
 }
 /** How an RFQ ended, for its taker. */
 export interface RfqOutcomeEventData {
@@ -103,6 +148,11 @@ export interface RfqOutcomeEventData {
     /** Gross VWAP of the fills; absent when nothing filled. */
     vwap?: string;
     fills: RfqFillEventData[];
+    /**
+     * Your all-in VWAP: notional plus your whole fee for a buy, minus it for a
+     * sell, over the executed quantity. Absent when nothing filled.
+     */
+    allInVwap?: string;
 }
 /** To the taker and every maker that quoted: the RFQ ended. */
 export interface RfqOutcomeEvent {

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

@@ -40,6 +40,12 @@ export interface TradeEventData {
     quoteVolumeRaw?: string;
     /** Application (frontend) that placed the taker order; trade volume and fees are attributed to it. REST trade reads only. */
     takerApplicationId?: string;
+    /**
+     * The taker's builder fee: the add-on the taker's application charged, in
+     * raw quote-asset units, on top of `takerFeeRaw`; `"0"` when it charged
+     * none. REST trade reads only.
+     */
+    builderFeeRaw?: string;
 }
 /**
  * Trade event emitted when a trade is executed
@@ -53,4 +59,35 @@ export interface TradeEvent {
     tradingMode: TradingMode | (string & {});
     /** Trade execution data */
     data: TradeEventData;
+    /**
+     * The trade's position in its pair's chain: the durable-log sequence of the
+     * step that executed it. Present only when the server sources trades from
+     * market-data (`WS_TRADES_SOURCE=market_data`); absent otherwise.
+     */
+    seq?: number;
+    /** The trade's index among its step's fills; with `seq`, the trade's key. Same presence as `seq`. */
+    matchIndex?: number;
+    /** `seq` of the previous trade on the pair; 0 when the publisher knows none. Same presence as `seq`. */
+    prevSeq?: number;
+    /** `matchIndex` of the previous trade on the pair; `null` when the publisher knows none. Same presence as `seq`. */
+    prevMatchIndex?: number | null;
+}
+/**
+ * A sequenced trade `ws.trades` received that did not link to the last trade
+ * it delivered (or the snapshot cursor). The server forwards only linking
+ * trades, so this means a frame was lost or unreadable on the client; the
+ * trade is still delivered and the chain continues from it.
+ */
+export interface TradeGap {
+    tradingPairId: string;
+    /** The key of the last trade delivered, or the snapshot cursor. */
+    expected: {
+        seq: number;
+        matchIndex: number;
+    };
+    /** The received trade's link as sent; `null` where the frame carried none. */
+    received: {
+        prevSeq: number | null;
+        prevMatchIndex: number | null;
+    };
 }

package/dist/websocket/index.d.ts

@@ -6,5 +6,6 @@
 export * from "./base";
 export * from "./client";
 export * from "./clients/orderbook-client";
+export * from "./depth";
 export * from "./events";
 export * from "./snapshots";

package/dist/websocket/index.js

@@ -6,5 +6,6 @@
 export * from "./base";
 export * from "./client";
 export * from "./clients/orderbook-client";
+export * from "./depth";
 export * from "./events";
 export * from "./snapshots";

package/dist/websocket/snapshots.d.ts

@@ -51,7 +51,29 @@ import type { OrderOrigin } from "./events/orders-events";
  * already holds a second subscriber's callback waits for the next reconnect;
  * see `MonacoWebSocket` for the full rule.
  */
-export type SnapshotHandler<T> = (items: T[]) => void;
+export type SnapshotHandler<T> = (items: T[], meta?: SnapshotMeta) => void;
+/**
+ * The trade a `trades:<pair>` snapshot is current as of: trades at or below
+ * this key, compared as `(seq, matchIndex)`, are already reflected, and the
+ * next live trade links to it exactly.
+ */
+export interface TradeSnapshotCursor {
+    seq: number;
+    matchIndex: number;
+}
+/**
+ * What a `Snapshot` frame carries beside its rows. Today only the
+ * `trades:<pair>` snapshot uses it, and only when the server sources trades
+ * from market-data.
+ */
+export interface SnapshotMeta {
+    /**
+     * `trades:<pair>` only: the trade the live frames continue from, or `null`
+     * when nothing was applied since the server seeded the pair (the first live
+     * trade is then the base). Absent under the default engine source.
+     */
+    cursor?: TradeSnapshotCursor | null;
+}
 /**
  * One candle in an `ohlcv` channel snapshot: the live frame's candlestick
  * without `s`.

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 ["accept_rfq", "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_all_after", "cancel_conditional_order", "cancel_order", "cancel_rfq", "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_rfq", "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_fee_schedule", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_liquidation_metrics", "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_region_status", "get_rewards_balance", "get_rfq", "get_rfq_capabilities", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_sweeper_deposit_status", "get_trade_by_id", "get_trade_flow", "get_trader_code_info", "get_trader_metrics", "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_all_liquidation_events", "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_insurance_funds", "list_invite_codes", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_liquidation_events", "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_sweeper_deposits", "list_trades", "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", "respond_rfq_last_look", "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", "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", "upsert_rfq_quote", "verify_signature", "withdraw_rfq_quote"];
+export declare const OPERATION_IDS: readonly ["accept_rfq", "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_all_after", "cancel_conditional_order", "cancel_order", "cancel_rfq", "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_rfq", "create_sub_account", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_builder", "get_builder_series", "get_builder_totals", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_fee_schedule", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_liquidation_metrics", "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_protocol_series", "get_protocol_totals", "get_pulse", "get_region_status", "get_rewards_balance", "get_rfq", "get_rfq_capabilities", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_sweeper_deposit_status", "get_token_custody", "get_trade_by_id", "get_trade_flow", "get_trader_code_info", "get_trader_metrics", "get_trades", "get_trading_pair_by_id", "get_treasury_net_fees", "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_wallet_summary", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_all_liquidation_events", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_builder_fee_changes", "list_builder_leaderboard", "list_buildercode_payouts", "list_builders", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_insurance_funds", "list_invite_codes", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_liquidation_events", "list_managed_market_assignments", "list_margin_accounts", "list_market_volumes", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_sweeper_deposits", "list_token_custody", "list_trades", "list_trading_pairs", "list_twap_order_slices", "list_twap_orders", "list_vault_deposits", "list_vault_withdrawals", "list_wallet_leaderboard", "list_wallet_liquidations", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "request_invite_codes", "respond_rfq_last_look", "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", "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", "upsert_rfq_quote", "verify_signature", "withdraw_rfq_quote"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -44,6 +44,9 @@ export const OPERATION_IDS = [
     "get_application_config",
     "get_application_stats",
     "get_available_collateral",
+    "get_builder",
+    "get_builder_series",
+    "get_builder_totals",
     "get_buildercode_payout_summary",
     "get_buildercode_rewards_balance",
     "get_buildercodes_config",
@@ -86,6 +89,8 @@ export const OPERATION_IDS = [
     "get_position",
     "get_position_pnl_history",
     "get_position_risk",
+    "get_protocol_series",
+    "get_protocol_totals",
     "get_pulse",
     "get_region_status",
     "get_rewards_balance",
@@ -96,12 +101,14 @@ export const OPERATION_IDS = [
     "get_sub_account_limits",
     "get_sweeper_chains",
     "get_sweeper_deposit_status",
+    "get_token_custody",
     "get_trade_by_id",
     "get_trade_flow",
     "get_trader_code_info",
     "get_trader_metrics",
     "get_trades",
     "get_trading_pair_by_id",
+    "get_treasury_net_fees",
     "get_twap_order",
     "get_twap_order_tca",
     "get_user_balance_by_asset",
@@ -109,6 +116,7 @@ export const OPERATION_IDS = [
     "get_user_movements",
     "get_user_profile",
     "get_user_trades",
+    "get_wallet_summary",
     "get_withdrawal",
     "health_check",
     "initiate_withdrawal",
@@ -119,7 +127,9 @@ export const OPERATION_IDS = [
     "list_application_orders",
     "list_application_users",
     "list_builder_fee_changes",
+    "list_builder_leaderboard",
     "list_buildercode_payouts",
+    "list_builders",
     "list_conditional_orders",
     "list_delegated_agent_owners",
     "list_delegated_agents",
@@ -134,6 +144,7 @@ export const OPERATION_IDS = [
     "list_liquidation_events",
     "list_managed_market_assignments",
     "list_margin_accounts",
+    "list_market_volumes",
     "list_my_followers",
     "list_my_follows",
     "list_pending_withdrawals",
@@ -141,10 +152,15 @@ export const OPERATION_IDS = [
     "list_positions",
     "list_sub_accounts_with_balances",
     "list_sweeper_deposits",
+    "list_token_custody",
     "list_trades",
     "list_trading_pairs",
     "list_twap_order_slices",
     "list_twap_orders",
+    "list_vault_deposits",
+    "list_vault_withdrawals",
+    "list_wallet_leaderboard",
+    "list_wallet_liquidations",
     "mint_tokens",
     "preview_follow",
     "refresh_managed_market_quotes",