@0xmonaco/types 1.0.98 → 1.1.0

package/dist/fees/index.d.ts

@@ -4,7 +4,7 @@
  * Types for fees operations including fee simulation.
  */
 import type { BaseAPI } from "../api/index";
-import type { GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse } from "./responses";
+import type { GetFeeScheduleResponse, GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse } from "./responses";
 /**
  * Fees API interface.
  * Provides methods for simulating and calculating trading fees.
@@ -59,6 +59,26 @@ export interface FeesAPI extends BaseAPI {
      * ```
      */
     getMyFeeTier(params: GetMyFeeTierParams): Promise<GetMyFeeTierResponse>;
+    /**
+     * Get a trading pair's fee tier schedule. Public: needs no authentication.
+     *
+     * Returns the pair's Monaco fee schedule ordered by tier level: each row's
+     * weighted 14-day volume threshold and its maker/taker fee in basis points
+     * (a negative maker fee is a rebate). Your own tier and rate come from
+     * {@link FeesAPI.getMyFeeTier}.
+     *
+     * @param tradingPairId - Trading pair whose fee schedule to return
+     * @returns Promise resolving to the pair's fee tier schedule
+     *
+     * @example
+     * ```typescript
+     * const { feeSchedule } = await feesAPI.getFeeSchedule("123e4567-e89b-12d3-a456-426614174000");
+     * for (const row of feeSchedule) {
+     *   console.log(`Tier ${row.tierLevel}: maker ${row.makerFeeBps} bps, taker ${row.takerFeeBps} bps`);
+     * }
+     * ```
+     */
+    getFeeSchedule(tradingPairId: string): Promise<GetFeeScheduleResponse>;
 }
-export type { FeeTierScheduleRow, GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse, } from "./responses";
-export { FeeTierScheduleRowSchema, GetMyFeeTierParamsSchema, GetMyFeeTierResponseSchema, SimulateFeeParamsSchema, SimulateFeeResponseSchema, } from "./responses";
+export type { FeeTierScheduleRow, GetFeeScheduleParams, GetFeeScheduleResponse, GetMyFeeTierParams, GetMyFeeTierResponse, SimulateFeeParams, SimulateFeeResponse, } from "./responses";
+export { FeeTierScheduleRowSchema, GetFeeScheduleParamsSchema, GetFeeScheduleResponseSchema, GetMyFeeTierParamsSchema, GetMyFeeTierResponseSchema, SimulateFeeParamsSchema, SimulateFeeResponseSchema, } from "./responses";

package/dist/fees/index.js

@@ -3,4 +3,4 @@
  *
  * Types for fees operations including fee simulation.
  */
-export { FeeTierScheduleRowSchema, GetMyFeeTierParamsSchema, GetMyFeeTierResponseSchema, SimulateFeeParamsSchema, SimulateFeeResponseSchema, } from "./responses";
+export { FeeTierScheduleRowSchema, GetFeeScheduleParamsSchema, GetFeeScheduleResponseSchema, GetMyFeeTierParamsSchema, GetMyFeeTierResponseSchema, SimulateFeeParamsSchema, SimulateFeeResponseSchema, } from "./responses";

package/dist/fees/responses.d.ts

@@ -86,6 +86,24 @@ export declare const GetMyFeeTierResponseSchema: z.ZodObject<{
         takerFeeBps: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * Zod schema for the parameters of a public fee schedule lookup
+ */
+export declare const GetFeeScheduleParamsSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Zod schema for the public fee schedule response
+ */
+export declare const GetFeeScheduleResponseSchema: z.ZodObject<{
+    tradingPairId: z.ZodString;
+    feeSchedule: z.ZodArray<z.ZodObject<{
+        tierLevel: z.ZodNumber;
+        minVolumeThreshold: z.ZodString;
+        makerFeeBps: z.ZodString;
+        takerFeeBps: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Parameters for a "my fee tier" lookup
  * @remarks Type is inferred from GetMyFeeTierParamsSchema
@@ -101,3 +119,13 @@ export type FeeTierScheduleRow = z.infer<typeof FeeTierScheduleRowSchema>;
  * @remarks Type is inferred from GetMyFeeTierResponseSchema
  */
 export type GetMyFeeTierResponse = z.infer<typeof GetMyFeeTierResponseSchema>;
+/**
+ * Parameters for a public fee schedule lookup
+ * @remarks Type is inferred from GetFeeScheduleParamsSchema
+ */
+export type GetFeeScheduleParams = z.infer<typeof GetFeeScheduleParamsSchema>;
+/**
+ * A trading pair's public fee tier schedule
+ * @remarks Type is inferred from GetFeeScheduleResponseSchema
+ */
+export type GetFeeScheduleResponse = z.infer<typeof GetFeeScheduleResponseSchema>;

package/dist/fees/responses.js

@@ -133,3 +133,19 @@ export const GetMyFeeTierResponseSchema = z.object({
     /** Six-row fee schedule for the requested pair, ascending by tier */
     feeSchedule: z.array(FeeTierScheduleRowSchema),
 });
+/**
+ * Zod schema for the parameters of a public fee schedule lookup
+ */
+export const GetFeeScheduleParamsSchema = z.object({
+    /** Trading pair ID whose fee tier schedule to return */
+    tradingPairId: z.string().trim().min(1, "Trading pair ID is required and cannot be empty"),
+});
+/**
+ * Zod schema for the public fee schedule response
+ */
+export const GetFeeScheduleResponseSchema = z.object({
+    /** Trading pair the schedule belongs to (UUID) */
+    tradingPairId: z.string(),
+    /** The pair's fee tier schedule, ascending by tier level */
+    feeSchedule: z.array(FeeTierScheduleRowSchema),
+});

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

@@ -87,9 +87,12 @@ export interface MarginAccountSummary {
      * reducing, reduce-only, or opposite-side order sheltered by a larger
      * resting ladder needs less or none of it (and can be admitted even when
      * this field is zero), while an order crossing a losing position can need
-     * more than its own margin-plus-fee. Divide by a market's initial margin
-     * rate for indicative notional capacity; the authoritative per-order answer
-     * remains `simulateRiskBucketOrderRisk`.
+     * more than its own margin-plus-fee. A bucket below its initial margin pays
+     * that gap out of the parent headroom first: its next order that opens,
+     * adds to or flips a position draws the gap with its own requirement, so
+     * the figure there is the headroom less the gap. Divide by a market's
+     * initial margin rate for indicative notional capacity; the authoritative
+     * per-order answer remains `simulateRiskBucketOrderRisk`.
      *
      * Present only on risk-bucket rows served from a live risk engine snapshot;
      * absent (the key is omitted, never null) on parent rows and on

package/dist/trading/orders.d.ts

@@ -46,7 +46,7 @@ export interface Order {
     /** Trading mode (SPOT or MARGIN) */
     tradingMode: TradingMode;
     /**
-     * Time in force - GTC, IOC, or FOK (GTD is deprecated and rejected).
+     * Time in force - GTC, IOC, or FOK.
      * Absent on a MARKET order, which has none.
      */
     timeInForce?: TimeInForce;
@@ -137,6 +137,33 @@ export interface Order {
      * SDK version does not know still reaches you. Wire: `origin`.
      */
     origin?: OrderOrigin | (string & {});
+    /**
+     * Monaco taker fee rate fixed when this order was placed (re-fixed on
+     * replace), in basis points, as a decimal string such as `"4.5"`. A rate,
+     * not an amount: the amounts charged are `monacoTakerFee` and
+     * `monacoMakerRebate`.
+     *
+     * The fee actually charged on a fill can be lower for a maker rebate: a
+     * rebate never exceeds the taker fee of the same fill.
+     *
+     * Absent (never `"0"`) for orders placed before rates were stored. The same
+     * value the order WebSocket events and `orders` snapshot rows carry.
+     * Wire: `placementTakerFeeBps`.
+     */
+    placementTakerFeeBps?: string;
+    /**
+     * Monaco maker fee rate fixed when this order was placed (re-fixed on
+     * replace), in basis points, as a decimal string such as `"-0.1"`. Negative
+     * means rebate. A rate, not an amount: the amount is `monacoMakerRebate`.
+     *
+     * The rebate actually paid on a fill can be smaller: a rebate never exceeds
+     * the taker fee of the same fill.
+     *
+     * Absent (never `"0"`) for orders placed before rates were stored. The same
+     * value the order WebSocket events and `orders` snapshot rows carry.
+     * Wire: `placementMakerFeeBps`.
+     */
+    placementMakerFeeBps?: string;
     /**
      * Opaque, compare-only revision counter for this order's state: a strictly
      * higher value is strictly newer state for that order, and equal values
@@ -242,12 +269,11 @@ export type TradingMode = "SPOT" | "MARGIN";
  * - GTC: Good Till Cancel - remains active until filled or canceled
  * - IOC: Immediate or Cancel - execute immediately and cancel unfilled portion
  * - FOK: Fill or Kill - execute completely or cancel entirely
- * - GTD: **deprecated, never implemented** - the server rejects it with HTTP
- *   400 (`Time in force must be GTC, IOC, or FOK`). The variant is retained so
- *   existing code keeps compiling. For an order that expires at a set time, use
- *   `GTC` together with `expirationDate`.
+ *
+ * For an order that expires at a set time, use `GTC` together with
+ * `expirationDate`.
  */
-export type TimeInForce = "GTC" | "IOC" | "FOK" | "GTD";
+export type TimeInForce = "GTC" | "IOC" | "FOK";
 /**
  * Per-order self-trade-prevention override: how the engine resolves the order
  * matching against one of your own resting orders (whole wallet family,

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

@@ -8,24 +8,20 @@ import type { Address } from "viem";
 /**
  * Reason for the balance update.
  *
- * `fee` and `rebate` accompany a fill: `fee` when a taker/application fee is
- * charged, `rebate` when a maker rebate is credited (including perp/margin
- * makers). `funding` accompanies a funding settlement against margin collateral
- * (also surfaced on the movements channel with `transactionType: "funding"`).
- * `liquidation` and `adl` accompany a forced-close on the liquidation-worker
- * path: `liquidation` on the liquidated victim's collateral, `adl` on an
- * account impacted by auto-deleveraging.
+ * Every `balance_update` carries one spot `user_balances` row. Its
+ * producer-owned `version`, when present, is scoped to the authenticated
+ * user/application and token: higher is newer, equal is idempotent. `fee` and `rebate` accompany a
+ * spot fill: `fee` when a taker/application fee is charged, `rebate` when a
+ * maker rebate is credited. A collateral transfer that moves the spot wallet
+ * row (`margin_transfer_in` / `margin_transfer_out`) sends a versioned spot
+ * frame for that leg.
  *
- * A genuine spot frame carries the resulting `user_balances` row and its
- * producer-owned `version`, scoped to the authenticated user/application and
- * token. Higher is newer; equal is idempotent. A collateral transfer that
- * moves the spot wallet row emits a genuine versioned spot frame for that leg.
- * Margin collateral frames — a parent to risk-bucket allocation, which moves
- * no wallet balance — and margin-routed deposit notifications omit `version`:
- * they are not spot rows, and a deposit notification can carry a delta rather
- * than whole-row state.
- * They cannot be reconciled against a spot snapshot or summed as separate
- * credits; refresh authoritative margin-account state instead.
+ * Margin collateral is not a spot row and is not sent on this channel: a
+ * margin-routed deposit, a perp fill, a funding settlement, a liquidation and
+ * an auto-deleveraging close send no `balance_update`. Read margin collateral
+ * from the `account` channel. `margin_deposit`, `funding`, `liquidation` and
+ * `adl` stay in this union so existing code that names them still compiles;
+ * the server does not send them.
  */
 export type BalanceUpdateReason = "lock" | "unlock" | "deposit" | "margin_deposit" | "withdrawal" | "trade" | "fee" | "rebate" | "funding" | "liquidation" | "adl" | "margin_transfer_in" | "margin_transfer_out";
 /**
@@ -36,7 +32,7 @@ export interface UserBalanceEventData {
     tokenAddress: Address;
     /** Token symbol */
     tokenSymbol: string | null;
-    /** Available balance for trading (normalized) */
+    /** Available spot balance (normalized) */
     available: string;
     /** Available balance in raw format (wei) */
     availableRaw: string;
@@ -49,8 +45,8 @@ export interface UserBalanceEventData {
     /** Total balance in raw format (wei) */
     totalRaw: string;
     /**
-     * Opaque durable spot-row version. Present only for genuine `user_balances`
-     * state; absent on legacy frames and margin collateral notifications.
+     * Opaque durable spot-row version. Absent on frames from a producer that
+     * does not stamp versions yet.
      *
      * Only a POSITIVE version is rankable. `0` is the legacy sentinel and means
      * exactly what an absent field means — unranked — so normalize the two

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

@@ -201,6 +201,28 @@ export interface CommonOrderEventData {
      * servers predating the field. Wire: `position_id`.
      */
     positionId?: string;
+    /**
+     * Monaco taker fee rate fixed when this order was placed (re-fixed on
+     * replace), in basis points, as a decimal string such as `"4.5"`. The same
+     * value REST `getOrder` returns as `placementTakerFeeBps`. The fee actually
+     * charged on a fill can be lower for a maker rebate: a rebate never exceeds
+     * the taker fee of the same fill. Carried on every order event; a maker fill
+     * reports the MAKER order's own rate. Omitted, never `"0"`, for an order
+     * placed before rates were stored and by servers predating the field.
+     * Wire: `placement_taker_fee_bps`.
+     */
+    placementTakerFeeBps?: string;
+    /**
+     * Monaco maker fee rate fixed when this order was placed (re-fixed on
+     * replace), in basis points, as a decimal string such as `"-0.1"`. Negative
+     * means rebate. The same value REST `getOrder` returns as
+     * `placementMakerFeeBps`. The rebate actually paid on a fill can be smaller:
+     * a rebate never exceeds the taker fee of the same fill. Carried on every
+     * order event; a maker fill reports the MAKER order's own rate. Omitted,
+     * never `"0"`, for an order placed before rates were stored and by servers
+     * predating the field. Wire: `placement_maker_fee_bps`.
+     */
+    placementMakerFeeBps?: string;
 }
 /**
  * What placed an order, as carried on order events' `origin` (0XM-2848).

package/dist/websocket/snapshots.d.ts

@@ -86,8 +86,9 @@ export type OHLCVSnapshotCandle = Omit<Candlestick, "s">;
  * `Option` serialized WITHOUT `skip_serializing_if`, so the key is always
  * present and carries `null` when unset — hence `| null` rather than `?`.
  * `clientOrderId`, `selfTradePreventionMode`, `parentOrderId`, `postOnly`,
- * `expirationDate`, `triggerPrice`, `positionSide`, `version` and `origin` are
- * the fields the server omits outright, so they are the `?`s.
+ * `expirationDate`, `triggerPrice`, `positionSide`, `version`, `origin`,
+ * `placementTakerFeeBps` and `placementMakerFeeBps` are the fields the server
+ * omits outright, so they are the `?`s.
  *
  * The value unions are widened (`Union | (string & {})`) for the same reason
  * the order event's are: the parser hands an unrecognized value through rather
@@ -207,4 +208,19 @@ export interface OrderSnapshotItem {
      * Wire: `origin`.
      */
     origin?: OrderOrigin | (string & {});
+    /**
+     * Monaco taker fee rate fixed when this order was placed (re-fixed on
+     * replace), in basis points (decimal string), as REST `getOrder` and the
+     * live order events report it. Omitted — not `null`, never `"0"` — for an
+     * order placed before rates were stored. Wire: `placement_taker_fee_bps`.
+     */
+    placementTakerFeeBps?: string;
+    /**
+     * Monaco maker fee rate fixed when this order was placed (re-fixed on
+     * replace), in basis points (decimal string); negative means rebate. As
+     * REST `getOrder` and the live order events report it. Omitted — not
+     * `null`, never `"0"` — for an order placed before rates were stored.
+     * Wire: `placement_maker_fee_bps`.
+     */
+    placementMakerFeeBps?: string;
 }

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

@@ -46,6 +46,7 @@ export const OPERATION_IDS = [
     "get_candles",
     "get_conditional_order",
     "get_faucet_info",
+    "get_fee_schedule",
     "get_follow",
     "get_funding_state",
     "get_index_price",

package/dist/wire/schema.d.ts

@@ -1562,6 +1562,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/fees/schedule": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a trading pair's fee tier schedule
+         * @description Public. The tier schedule a pair charges, ordered by tier level. Your own tier and rate: GET /api/v1/fees/tier.
+         */
+        get: operations["get_fee_schedule"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/fees/simulate": {
         parameters: {
             query?: never;
@@ -5947,6 +5967,16 @@ export interface components {
              */
             recentRequests?: components["schemas"]["FaucetRequestRecord"][] | null;
         };
+        GetFeeScheduleResponse: {
+            /**
+             * Format: uuid
+             * @description Trading pair UUID the schedule belongs to
+             * @example 123e4567-e89b-12d3-a456-426614174000
+             */
+            tradingPairId?: string | null;
+            /** @description The pair's fee tier schedule, ascending by tier level */
+            feeSchedule?: components["schemas"]["FeeTierScheduleRow"][] | null;
+        };
         GetFollowResponse: {
             /** @description The follow. */
             follow?: components["schemas"]["Follow"] | null;
@@ -6650,6 +6680,16 @@ export interface components {
              * @example LIQUIDATION
              */
             origin?: string | null;
+            /**
+             * @description Monaco taker fee rate fixed when this order was placed (re-fixed on replace), in basis points. The fee actually charged on a fill can be lower for a maker rebate: a rebate never exceeds the taker fee of the same fill. Absent for orders placed before rates were stored.
+             * @example 4.5
+             */
+            placementTakerFeeBps?: string | null;
+            /**
+             * @description Monaco maker fee rate fixed when this order was placed (re-fixed on replace), in basis points. Negative means rebate. The rebate actually paid on a fill can be smaller: a rebate never exceeds the taker fee of the same fill. Absent for orders placed before rates were stored.
+             * @example -0.1
+             */
+            placementMakerFeeBps?: string | null;
         };
         /** @description Orderbook snapshot with token metadata and sequence number. */
         GetOrderbookResponse: {
@@ -8599,9 +8639,12 @@ export interface components {
              *      reducing, reduce-only, or opposite-side order sheltered by a larger
              *      resting ladder needs less or none of it (and can be admitted even when
              *      this field is zero), while an order crossing a losing position can need
-             *      more than its own margin-plus-fee. Divide by a market's initial margin
-             *      rate for indicative notional capacity; the authoritative per-order answer
-             *      remains `simulate_risk_bucket_order_risk`.
+             *      more than its own margin-plus-fee. A bucket below its initial margin pays
+             *      that gap out of the parent headroom first: its next order that opens,
+             *      adds to or flips a position draws the gap with its own requirement, so
+             *      the figure there is the headroom less the gap. Divide by a market's
+             *      initial margin rate for indicative notional capacity; the authoritative
+             *      per-order answer remains `simulate_risk_bucket_order_risk`.
              *
              *      Present only on risk-bucket summary rows served from a live risk engine
              *      snapshot; absent on parent rows and on persisted-fallback reads, where
@@ -15678,6 +15721,50 @@ export interface operations {
             };
         };
     };
+    get_fee_schedule: {
+        parameters: {
+            query?: {
+                /** @description Trading pair identifier (UUID) */
+                tradingPairId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetFeeScheduleResponse"];
+                };
+            };
+            /** @description Invalid trading pair ID format */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Trading pair or fee tier schedule not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     simulate_fees: {
         parameters: {
             query: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.98",
+	"version": "1.1.0",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.98",
+		"@0xmonaco/contracts": "1.1.0",
 		"zod": "^4.6.7"
 	},
 	"peerDependencies": {