@0xmonaco/types 1.0.80 → 1.0.82

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

@@ -45,8 +45,9 @@ export interface MarketStatsData {
     /** Best ask price (decimal string) */
     bestAskPrice?: string;
     /**
-     * Open interest (decimal string). Perp-only; omitted for spot, and omitted
-     * (never zero) until the market's open interest is known.
+     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * Perp-only; omitted for spot, and omitted (never zero) until the market's
+     * open interest is known.
      */
     openInterest?: string;
     /**
@@ -57,9 +58,10 @@ export interface MarketStatsData {
     openInterestLimit?: string;
     /**
      * What is left of `openInterestLimit` at the mark, in quote (USD) notional,
-     * never below zero (decimal string). 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.
+     * never below zero (decimal string): the cap minus the gross `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.
      */
     openInterestHeadroom?: string;
     /** Last trade price (decimal string) */
@@ -145,8 +147,9 @@ export interface MarketStatsSummary {
     /** 24h low price (decimal string) */
     dailyPriceLow?: string;
     /**
-     * Open interest (decimal string). Perp-only; omitted for spot, and omitted
-     * (never zero) until the market's open interest is known.
+     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * Perp-only; omitted for spot, and omitted (never zero) until the market's
+     * open interest is known.
      */
     openInterest?: string;
     /** Current (last settled) funding rate (decimal string). Perp-only; omitted for spot. */
@@ -166,8 +169,9 @@ export interface MarketStatsSummary {
     /** Funding premium (decimal string). Perp-only; omitted for spot. */
     premium?: string;
     /**
-     * Open interest in quote notional (decimal string): `openInterest` priced at
-     * the mark, falling back to the last trade price. Perp-only; omitted for spot,
+     * Gross open interest (longs plus shorts) 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.
      */
     openInterestNotional?: string;

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

@@ -205,6 +205,20 @@ export interface PositionEventData {
      * released only after durable acknowledgement.
      */
     version?: number;
+    /**
+     * Lifetime funding since the position opened (decimal string; positive
+     * means paid, negative means received): the funding accrued on the size
+     * still open plus the funding its partial closes settled. A terminal frame
+     * carries the closed position's whole-life total, the same `fundingPaid` a
+     * REST read of the closed position returns. The subscribe-time snapshot
+     * carries the REST value for the same row.
+     *
+     * Absent means UNKNOWN, never zero: the server cannot account for every
+     * earlier reduction yet (a value would understate it), or a deployment
+     * older than this field sent the frame. Keep the last known value rather
+     * than clearing it.
+     */
+    fundingPaid?: string;
 }
 /**
  * Position event emitted when a user's position state changes.

package/dist/websocket/snapshots.d.ts

@@ -5,9 +5,11 @@
  * `Subscribed` ack and before that subscription's first live diff. Its `data`
  * is the channel's COMPLETE current state as a flat array — a consumer that
  * applies it wholesale needs no REST baseline read for that channel. `trades`
- * is the exception: its array is the pair's newest trades, a recent-history
- * baseline rather than complete state, which can overlap the first live trades
- * or miss one executed just before the subscribe — dedupe on `tradeId`.
+ * and `ohlcv` are the exceptions: their arrays are recent history rather than
+ * complete state. `trades` is the pair's newest trades, which can overlap the
+ * first live trades or miss one executed just before the subscribe — dedupe on
+ * `tradeId`. `ohlcv` is the subscribed series' newest candles, whose newest
+ * candle can be partial or missing — upsert live candles by `T`.
  *
  * Two rules hold across every channel:
  *
@@ -27,6 +29,7 @@
  * frame, so its callback is never invoked. That is a silent no-op, never an
  * error.
  */
+import type { Candlestick } from "../market";
 import type { OrderSide, OrderType, SelfTradePreventionMode, TimeInForce, TradingMode } from "../trading";
 /**
  * Receives one channel's complete subscribe-time state.
@@ -45,6 +48,21 @@ import type { OrderSide, OrderType, SelfTradePreventionMode, TimeInForce, Tradin
  * see `MonacoWebSocket` for the full rule.
  */
 export type SnapshotHandler<T> = (items: T[]) => void;
+/**
+ * One candle in an `ohlcv` channel snapshot: the live frame's candlestick
+ * without `s`.
+ *
+ * The channel fixes the pair, interval and price series, so a row carries no
+ * envelope and no symbol; `i` is the subscription's interval. `T` is the
+ * period start and `t` the period end (start plus the interval), as on a live
+ * candle.
+ *
+ * The snapshot is the series' newest candles, oldest first: recent history,
+ * not a gap-free replay. The newest candle can be partial or missing, so a
+ * consumer upserts live candles by `T` — a live candle replaces the snapshot
+ * candle with the same `T`, or appends a newer one.
+ */
+export type OHLCVSnapshotCandle = Omit<Candlestick, "s">;
 /**
  * One resting order in an `orders` channel snapshot.
  *

package/dist/websocket/snapshots.js

@@ -5,9 +5,11 @@
  * `Subscribed` ack and before that subscription's first live diff. Its `data`
  * is the channel's COMPLETE current state as a flat array — a consumer that
  * applies it wholesale needs no REST baseline read for that channel. `trades`
- * is the exception: its array is the pair's newest trades, a recent-history
- * baseline rather than complete state, which can overlap the first live trades
- * or miss one executed just before the subscribe — dedupe on `tradeId`.
+ * and `ohlcv` are the exceptions: their arrays are recent history rather than
+ * complete state. `trades` is the pair's newest trades, which can overlap the
+ * first live trades or miss one executed just before the subscribe — dedupe on
+ * `tradeId`. `ohlcv` is the subscribed series' newest candles, whose newest
+ * candle can be partial or missing — upsert live candles by `T`.
  *
  * Two rules hold across every channel:
  *

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_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_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_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", "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

@@ -125,8 +125,19 @@ export const OPERATION_IDS = [
     "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",