@0xmonaco/types 1.0.25 → 1.0.26-develop.aeb6d5b

package/dist/wire/schema.d.ts

@@ -734,6 +734,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/faucet/info": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get faucet quota and recent requests
+         * @description Get faucet quota and recent requests.
+         *
+         *      Returns the authenticated wallet's remaining faucet requests in the
+         *      rolling 24h window, when the next request becomes available, and the
+         *      5 most recent faucet requests. Quota is wallet-scoped: it aggregates
+         *      across all user rows sharing the wallet address, matching mint
+         *      enforcement.
+         */
+        get: operations["get_faucet_info"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/faucet/mint": {
         parameters: {
             query?: never;
@@ -1026,6 +1052,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/market/funding/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description Historical funding settlements across all perp markets in one call, so
+         *      clients don't have to fan out one request per trading pair.
+         */
+        get: operations["list_all_funding_history"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/market/pairs": {
         parameters: {
             query?: never;
@@ -1828,6 +1874,33 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/pulse": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the market pulse news feed
+         * @description Get the market pulse news feed.
+         *
+         *      Returns the latest cached snapshot of AI-synthesized, per-asset news
+         *      headlines with sentiment tags, refreshed hourly from the upstream
+         *      pipeline by a background poller. The request path never calls the
+         *      upstream. Public endpoint — no authentication required. Responses carry
+         *      an ETag (the snapshot's generatedAt); clients may send If-None-Match to
+         *      receive 304 when unchanged.
+         */
+        get: operations["get_pulse"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/trades/by-id/{tradeId}": {
         parameters: {
             query?: never;
@@ -2280,8 +2353,13 @@ export interface components {
             updatedAt?: string | null;
         };
         AttachPositionTpSlRequest: {
-            stopLoss?: components["schemas"]["TpSlLeg"];
+            /**
+             * @description One-cancels-the-other. Defaults to false. When true, both take_profit and
+             *      stop_loss are required and the sibling is cancelled after either triggers.
+             */
+            oco?: boolean | null;
             takeProfit?: components["schemas"]["TpSlLeg"];
+            stopLoss?: components["schemas"]["TpSlLeg"];
         };
         AttachPositionTpSlResponse: {
             positionId?: string | null;
@@ -2477,7 +2555,7 @@ export interface components {
              */
             expirationDate?: string | null;
             /**
-             * @description Time in force: GTC, IOC, or FOK
+             * @description Time in force: GTC, IOC, or FOK. LIMIT orders only; rejected on MARKET orders.
              * @example GTC
              */
             timeInForce?: string | null;
@@ -2499,13 +2577,14 @@ export interface components {
              */
             riskBucketCollateral?: string | null;
             /**
-             * @description Position side for margin orders: LONG, SHORT, or NONE
+             * @deprecated
+             * @description DEPRECATED compatibility field. Order side is authoritative. When supplied, BUY requires LONG and SELL requires SHORT; NONE is rejected.
              * @example LONG
              * @enum {string|null}
              */
-            positionSide?: "LONG" | "SHORT" | "NONE" | null;
+            positionSide?: "LONG" | "SHORT" | null;
             /**
-             * @description Leverage multiplier as decimal string for margin orders
+             * @description Leverage multiplier as a decimal string. Required for normal margin orders; optional and ignored for reduce-only orders.
              * @example 5
              */
             leverage?: string | null;
@@ -2925,7 +3004,7 @@ export interface components {
              */
             expirationDate?: string | null;
             /**
-             * @description Time in force: GTC, IOC, or FOK
+             * @description Time in force: GTC, IOC, or FOK. LIMIT orders only; rejected on MARKET orders.
              * @example GTC
              */
             timeInForce?: string | null;
@@ -2947,13 +3026,14 @@ export interface components {
              */
             riskBucketCollateral?: string | null;
             /**
-             * @description Position side for margin orders: LONG, SHORT, or NONE
+             * @deprecated
+             * @description DEPRECATED compatibility field. Order side is authoritative. When supplied, BUY requires LONG and SELL requires SHORT; NONE is rejected.
              * @example LONG
              * @enum {string|null}
              */
-            positionSide?: "LONG" | "SHORT" | "NONE" | null;
+            positionSide?: "LONG" | "SHORT" | null;
             /**
-             * @description Leverage multiplier as decimal string for margin orders
+             * @description Leverage multiplier as a decimal string. Required for normal margin orders; optional and ignored for reduce-only orders.
              * @example 5
              */
             leverage?: string | null;
@@ -3123,6 +3203,36 @@ export interface components {
              */
             error?: string | null;
         };
+        /** @description One token minted by a past faucet request. */
+        FaucetMintRecord: {
+            /**
+             * Format: uuid
+             * @description Asset UUID
+             */
+            assetId?: string | null;
+            /**
+             * @description Token symbol
+             * @example USDC
+             */
+            symbol?: string | null;
+            /**
+             * @description Amount minted in token units
+             * @example 1000
+             */
+            amount?: string | null;
+            /** @description On-chain transaction hash; absent when the transaction was submitted but never confirmed */
+            txHash?: string | null;
+        };
+        /**
+         * @description Past faucet mints grouped by clock minute for display. A group can span
+         *      several endpoint calls made in the same minute; the daily quota counts
+         *      each call individually.
+         */
+        FaucetRequestRecord: {
+            /** @description Timestamp (ISO 8601) of the request, truncated to the minute (display grouping; the daily quota counts every call) */
+            requestedAt?: string | null;
+            minted?: components["schemas"]["FaucetMintRecord"][] | null;
+        };
         FeeTierScheduleRow: {
             /**
              * Format: int32
@@ -3207,19 +3317,48 @@ export interface components {
              */
             createdAt?: string | null;
         };
+        /**
+         * @description One settled funding window. Windows are fixed and epoch-aligned (hourly);
+         *      a boundary the engine was down for is skipped, never settled retroactively,
+         *      so consecutive records can legitimately be more than one interval apart.
+         */
         FundingRecord: {
             /** Format: uuid */
             tradingPairId?: string | null;
             epoch?: string | null;
+            /**
+             * @description Final settled rate for the window as a decimal-string fraction per
+             *      funding interval (e.g. "0.0001" = 0.01%). The ±max-rate cap is applied
+             *      once to the window average at settlement; this is the capped value that
+             *      payments used.
+             */
             fundingRate?: string | null;
+            /**
+             * @description Quote currency charged per unit of base position for this window:
+             *      funding_rate x reference_price. Positive means longs paid shorts.
+             */
             fundingDeltaPerUnit?: string | null;
+            /**
+             * @description Running sum of funding_delta_per_unit across all settled windows;
+             *      position payments settle against deltas of this value.
+             */
             cumulativeFundingPerUnit?: string | null;
+            /**
+             * @description Mark price at the window boundary — the payment basis for every
+             *      position settled in this window.
+             */
             referencePrice?: string | null;
             /** Format: uint32 */
             sampleCount?: number | null;
             windowStartedAt?: string | null;
             windowClosedAt?: string | null;
             settledAt?: string | null;
+            /**
+             * @description True when the window held fewer than the minimum accepted samples and
+             *      settled at the carried last settled rate (zero if no rate was ever
+             *      settled) instead of a freshly computed average.
+             */
+            carried?: boolean | null;
         };
         GetAppStatsResponse: {
             /**
@@ -3372,14 +3511,55 @@ export interface components {
              */
             clientId?: string | null;
         };
+        GetFaucetInfoResponse: {
+            /**
+             * Format: uint32
+             * @description Remaining faucet requests in the rolling 24h window
+             * @example 2
+             */
+            remainingRequests24h?: number | null;
+            /**
+             * Format: uint32
+             * @description Maximum faucet requests per rolling 24h window
+             * @example 3
+             */
+            dailyLimit?: number | null;
+            /** @description Timestamp (ISO 8601) safe to retry at or after: when the wallet's next faucet slot frees under the current daily limit, with a small safety margin. When remaining_requests_24h is 0 this is when the next mint becomes possible. Absent when no requests are in the rolling 24h window or when the daily limit is 0. Not a calendar-day reset. */
+            nextAvailableAt?: string | null;
+            /**
+             * @description Up to 5 most recent faucet request groups, newest first, regardless of
+             *      the 24h window.
+             */
+            recentRequests?: components["schemas"]["FaucetRequestRecord"][] | null;
+        };
         GetFundingStateResponse: {
             /** Format: uuid */
             tradingPairId?: string | null;
+            /**
+             * @description Most recently SETTLED funding rate as a decimal-string fraction per funding interval; "0" when nothing has settled yet
+             * @example 0.0001
+             */
             currentFundingRate?: string | null;
+            /**
+             * @description Implied rate for the in-progress window. An estimate refreshed on each accepted premium sample (roughly every sample interval plus persistence lag), not a real-time stream; absent when the window has no samples
+             * @example 0.00012
+             */
             estimatedNextFundingRate?: string | null;
+            /**
+             * @description Scheduled end of the current funding window (ms epoch string). An estimate, not a guarantee: settlement lands at or shortly after this boundary when the market is alive, and boundaries that pass while the engine is down are skipped, never settled retroactively
+             * @example 1754006400000
+             */
             nextFundingTime?: string | null;
-            /** Format: uint32 */
+            /**
+             * Format: uint32
+             * @description Length of a funding window in seconds, inferred from settlement history and market configuration
+             * @example 3600
+             */
             fundingIntervalSeconds?: number | null;
+            /**
+             * @description Close of the most recently settled window (ms epoch string); absent before the first settlement
+             * @example 1754002800000
+             */
             lastFundingTime?: string | null;
             updatedAt?: string | null;
         };
@@ -3739,7 +3919,8 @@ export interface components {
              */
             marginAccountId?: string | null;
             /**
-             * @description Position side for margin orders
+             * @deprecated
+             * @description DEPRECATED derived compatibility value. Order side is authoritative.
              * @example LONG
              */
             positionSide?: string | null;
@@ -3831,6 +4012,11 @@ export interface components {
              * @description Batch UUID for batch orders
              */
             batchId?: string | null;
+            /**
+             * @description Stable terminal cause for a cancelled order: USER_REQUESTED, REPLACED, LIQUIDATION, INSUFFICIENT_MARGIN, REDUCE_ONLY_EXHAUSTED, POSITION_CLOSED, OCO_SIBLING_TRIGGERED, or SYSTEM
+             * @example REDUCE_ONLY_EXHAUSTED
+             */
+            terminalReason?: string | null;
         };
         /** @description Orderbook snapshot with token metadata and sequence number. */
         GetOrderbookResponse: {
@@ -4024,7 +4210,7 @@ export interface components {
             perpsEquity?: string | null;
             /**
              * Format: double
-             * @description Ratio of profitable trades to total trades
+             * @description Position-level win rate: winning positions over winning + losing positions (break-even excluded). Each position (one flat->open->flat round-trip) is classified once by its net realized PnL after all fees, not per fill. Null when the period has no closed positions.
              * @example 0.65
              */
             winLossRatio?: number | null;
@@ -4073,13 +4259,23 @@ export interface components {
             /** Format: uuid */
             tradingPairId?: string | null;
             side?: string | null;
+            /**
+             * @description Open rows: current absolute position quantity. Terminal rows
+             *      (CLOSED/LIQUIDATED/EXPIRED): total quantity closed over the position's
+             *      life, summed from its reducing executions when available.
+             */
             size?: string | null;
             entryPrice?: string | null;
             markPrice?: string | null;
             indexPrice?: string | null;
             unrealizedPnl?: string | null;
             realizedPnl?: string | null;
-            /** @description Current isolated collateral for this position's margin-account bucket. */
+            /**
+             * @description Open rows: current isolated collateral for this position's risk bucket.
+             *      Terminal rows: total initial margin allocated across the position's
+             *      reducing executions when available — the margin basis for lifetime
+             *      realized return.
+             */
             isolatedMargin?: string | null;
             leverage?: string | null;
             /**
@@ -4106,6 +4302,21 @@ export interface components {
             updatedAt?: string | null;
             riskBucketId?: string | null;
             marginMode?: string | null;
+            /**
+             * @description Lifetime realized PnL net of trading fees and funding. Terminal rows
+             *      only; absent when the position's reducing executions are unavailable.
+             */
+            netRealizedPnl?: string | null;
+            /**
+             * @description Lifetime realized return on the total allocated initial margin, as a
+             *      percentage, computed from NET realized PnL (after trading fees and
+             *      funding). The denominator is initial margin only: fees and funding are
+             *      costs rather than posted collateral, and funding is signed, so folding it
+             *      into the denominator could drive it to zero or negative. Terminal rows
+             *      only; absent when unavailable, including when the position's reducing
+             *      executions do not account for its whole lifetime.
+             */
+            realizedRoe?: string | null;
         };
         GetPositionRiskResponse: {
             positionId?: string | null;
@@ -4194,6 +4405,26 @@ export interface components {
              */
             applicationMakerFeeBps?: number | null;
         };
+        GetPulseResponse: {
+            /**
+             * @description When this snapshot was produced upstream, ISO-8601 UTC; also serves as the response ETag value
+             * @example 2026-07-22T15:17:14Z
+             */
+            generatedAt?: string | null;
+            /**
+             * @description Asset universe this snapshot was synthesized against
+             * @example [
+             *       "BTC",
+             *       "ETH",
+             *       "SOL",
+             *       "SEI",
+             *       "HYPE"
+             *     ]
+             */
+            watchlist?: string[] | null;
+            /** @description Pulse items, pre-sorted: watchlist order first, MARKET last, most-recent-first within each asset. Items with unverified figures are removed server-side. */
+            items?: components["schemas"]["PulseItem"][] | null;
+        };
         GetRewardsBalanceResponse: {
             /** @description One entry per reward token that has a non-zero available balance. */
             balances?: components["schemas"]["RewardsBalanceEntry"][] | null;
@@ -4295,6 +4526,22 @@ export interface components {
              * @example 8
              */
             totalPages?: string | null;
+            /**
+             * @description Cursor for the next page. Empty on every page-number (legacy) response —
+             *      page-number mode never mints a token, full page or not, since resuming
+             *      a client from a legacy-minted position could silently strand archived
+             *      history newer than wherever that page happened to end. To walk full
+             *      history, start a cursor-mode request with `page_token` present but
+             *      empty (`""`); from then on the token is present whenever that page
+             *      returned any rows (AIP-158 "maybe more" semantics), not only when the
+             *      page is exactly full. Empty only when a cursor-mode page returned zero
+             *      rows, which is the sole proof the walk is exhausted; a non-empty token
+             *      does not guarantee further results, so keep following it until a
+             *      response returns zero rows and an empty token. The two modes never
+             *      bridge: a page-number response's empty token is not "done," it simply
+             *      means page-number mode does not participate in cursor continuation.
+             */
+            nextPageToken?: string | null;
         };
         IndexComponent: {
             provider?: string | null;
@@ -4457,6 +4704,15 @@ export interface components {
              */
             balanceId?: string | null;
         };
+        ListAllFundingHistoryResponse: {
+            records?: components["schemas"]["FundingRecord"][] | null;
+            /** Format: uint32 */
+            total?: number | null;
+            /** Format: uint32 */
+            page?: number | null;
+            /** Format: uint32 */
+            pageSize?: number | null;
+        };
         ListAppBalancesResponse: {
             balances?: components["schemas"]["ApplicationBalance"][] | null;
             /**
@@ -4653,6 +4909,22 @@ export interface components {
              * @example 8
              */
             totalPages?: number | null;
+            /**
+             * @description Cursor for the next page. Empty on every page-number (legacy) response —
+             *      page-number mode never mints a token, full page or not, since resuming
+             *      a client from a legacy-minted position could silently strand archived
+             *      history newer than wherever that page happened to end. To walk full
+             *      history, start a cursor-mode request with `page_token` present but
+             *      empty (`""`); from then on the token is present whenever that page
+             *      returned any rows (AIP-158 "maybe more" semantics), not only when the
+             *      page is exactly full. Empty only when a cursor-mode page returned zero
+             *      rows, which is the sole proof the walk is exhausted; a non-empty token
+             *      does not guarantee further results, so keep following it until a
+             *      response returns zero rows and an empty token. The two modes never
+             *      bridge: a page-number response's empty token is not "done," it simply
+             *      means page-number mode does not participate in cursor continuation.
+             */
+            nextPageToken?: string | null;
         };
         ListPendingWithdrawalsResponse: {
             withdrawals?: components["schemas"]["PendingWithdrawal"][] | null;
@@ -5011,12 +5283,23 @@ export interface components {
             date?: string | null;
             netRealizedPnl?: string | null;
         };
+        /**
+         * @description Win rate is position-level: winners/losers/break_even and win_rate_pct count
+         *      each position (one flat -> open -> flat round-trip) once, classified by its
+         *      net realized PnL after all fees. `count` stays fill-based (each partial
+         *      closing fill is counted).
+         */
         PortfolioClosedTradeStats: {
             count?: string | null;
             winners?: string | null;
             losers?: string | null;
             breakEven?: string | null;
             winRatePct?: string | null;
+            /**
+             * @description Total classified positions (= winners + losers + break_even): the
+             *      position-level denominator, distinct from the fill-based `count`.
+             */
+            positions?: string | null;
         };
         PortfolioMarginPositionCounts: {
             total?: string | null;
@@ -5136,13 +5419,23 @@ export interface components {
             /** Format: uuid */
             tradingPairId?: string | null;
             side?: string | null;
+            /**
+             * @description Open rows: current absolute position quantity. Terminal rows
+             *      (CLOSED/LIQUIDATED/EXPIRED): total quantity closed over the position's
+             *      life, summed from its reducing executions when available.
+             */
             size?: string | null;
             entryPrice?: string | null;
             markPrice?: string | null;
             indexPrice?: string | null;
             unrealizedPnl?: string | null;
             realizedPnl?: string | null;
-            /** @description Current isolated collateral for this position's margin-account bucket. */
+            /**
+             * @description Open rows: current isolated collateral for this position's risk bucket.
+             *      Terminal rows: total initial margin allocated across the position's
+             *      reducing executions when available — the margin basis for lifetime
+             *      realized return.
+             */
             isolatedMargin?: string | null;
             leverage?: string | null;
             /**
@@ -5169,6 +5462,21 @@ export interface components {
             updatedAt?: string | null;
             riskBucketId?: string | null;
             marginMode?: string | null;
+            /**
+             * @description Lifetime realized PnL net of trading fees and funding. Terminal rows
+             *      only; absent when the position's reducing executions are unavailable.
+             */
+            netRealizedPnl?: string | null;
+            /**
+             * @description Lifetime realized return on the total allocated initial margin, as a
+             *      percentage, computed from NET realized PnL (after trading fees and
+             *      funding). The denominator is initial margin only: fees and funding are
+             *      costs rather than posted collateral, and funding is signed, so folding it
+             *      into the denominator could drive it to zero or negative. Terminal rows
+             *      only; absent when unavailable, including when the position's reducing
+             *      executions do not account for its whole lifetime.
+             */
+            realizedRoe?: string | null;
         };
         PositionHistoryEvent: {
             id?: string | null;
@@ -5322,6 +5630,58 @@ export interface components {
              */
             tradingMode?: string | null;
         };
+        PulseItem: {
+            /**
+             * @description Watchlist ticker (e.g. "BTC") or "MARKET" for a cross-asset story
+             * @example SEI
+             */
+            asset?: string | null;
+            /**
+             * @description Sentiment tag: "Bullish", "Neutral", or "Bearish"
+             * @example Bullish
+             */
+            sentiment?: string | null;
+            /**
+             * @description Synthesized 1-2 sentence summary, at most 240 characters
+             * @example SEI gained 4% amid ecosystem growth.
+             */
+            summary?: string | null;
+            /**
+             * @description Timestamp of the most recent source in the cluster, ISO-8601; render relative time client-side
+             * @example 2026-07-21T02:15:19
+             */
+            updatedAt?: string | null;
+            /** @description Provenance for the item, for attribution links */
+            sources?: components["schemas"]["PulseSource"][] | null;
+        };
+        PulseSource: {
+            /**
+             * @description Source article or post URL
+             * @example https://coinmarketcap.com/top-stories/6a5f0c340787ae5558351f0f/
+             */
+            url?: string | null;
+            /**
+             * @description Source author or publication name
+             * @example CoinMarketCap
+             */
+            author?: string | null;
+            /**
+             * @description Source channel: "twitter" or "news"
+             * @example news
+             */
+            source?: string | null;
+            /**
+             * @description Source publication time, ISO-8601
+             * @example 2026-07-21T02:15:19
+             */
+            createdAt?: string | null;
+            /**
+             * Format: uint32
+             * @description Relevance score, 1 (low) to 5 (high)
+             * @example 4
+             */
+            relevance?: number | null;
+        };
         ReducePositionMarginRequest: {
             amount?: string | null;
         };
@@ -5415,7 +5775,13 @@ export interface components {
         RiskTier: {
             initialMarginRatio?: string | null;
             maintenanceMarginRatio?: string | null;
+            /**
+             * @deprecated
+             * @description DEPRECATED compatibility alias. This value is a maximum absolute base-asset quantity, not a notional. Use maxPositionSize.
+             */
             maxPositionNotional?: string | null;
+            /** @description Maximum authoritative absolute position size in base-asset quantity. */
+            maxPositionSize?: string | null;
         };
         /** @description Per-pair screener row. Window fields null when insufficient history. */
         ScreenerItem: {
@@ -5497,6 +5863,16 @@ export interface components {
              * @example 482931
              */
             totalTradeCountLtd?: string | null;
+            /**
+             * @description Latest settled funding rate as a decimal fraction per funding window (the capped settled value); null for spot pairs and margin pairs with no settled funding window yet
+             * @example 0.000125
+             */
+            latestFundingRate?: string | null;
+            /**
+             * @description Close time of the latest settled funding window (ms since epoch); null for spot pairs and margin pairs with no settled funding window yet
+             * @example 1745308800000
+             */
+            lastFundingTime?: string | null;
         };
         /** @description One UTC-day bucket in a pair's 7-day snapshot. */
         ScreenerSnapshotPoint: {
@@ -5615,10 +5991,15 @@ export interface components {
             /** Format: uuid */
             tradingPairId?: string | null;
             side?: string | null;
+            /**
+             * @description Deprecated compatibility value. `side` is authoritative; when present,
+             *      BUY must carry LONG and SELL must carry SHORT.
+             */
             positionSide?: string | null;
             orderType?: string | null;
             price?: string | null;
             quantity?: string | null;
+            /** @description Required for normal orders; optional and ignored for reduce-only. */
             leverage?: string | null;
             reduceOnly?: boolean | null;
         };
@@ -5657,10 +6038,12 @@ export interface components {
             /** Format: uuid */
             tradingPairId?: string | null;
             side?: string | null;
+            /** @description Deprecated compatibility value; `side` is authoritative. */
             positionSide?: string | null;
             orderType?: string | null;
             price?: string | null;
             quantity?: string | null;
+            /** @description Required for normal orders; optional and ignored for reduce-only. */
             leverage?: string | null;
             reduceOnly?: boolean | null;
         };
@@ -5669,10 +6052,12 @@ export interface components {
             tradingPairId?: string | null;
             strategyKey?: string | null;
             side?: string | null;
+            /** @description Deprecated compatibility value; `side` is authoritative. */
             positionSide?: string | null;
             orderType?: string | null;
             price?: string | null;
             quantity?: string | null;
+            /** @description Required for normal orders; optional and ignored for reduce-only. */
             leverage?: string | null;
             reduceOnly?: boolean | null;
             /** @description Risk bucket mode. Defaults to ISOLATED. Values: ISOLATED, CROSS. */
@@ -5814,6 +6199,12 @@ export interface components {
             /** Format: int32 */
             slippageToleranceBps?: number | null;
             expiresAt?: string | null;
+            /**
+             * @description Resolve the full live position size when triggered. Mutually exclusive
+             *      with quantity. For compatibility, omitting both quantity and this field
+             *      also means full-position close.
+             */
+            closePosition?: boolean | null;
         };
         /** @description Core fields of a single executed trade, nested under `data` in the public trade event envelope. */
         TradeData: {
@@ -6349,6 +6740,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
                 assetId: string;
             };
             cookie?: never;
@@ -7002,6 +7394,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
                 subAccountId: string;
             };
             cookie?: never;
@@ -7052,7 +7445,9 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
                 subAccountId: string;
+                /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
                 assetId: string;
             };
             cookie?: never;
@@ -7117,7 +7512,9 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
                 subAccountId: string;
+                /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
                 assetId: string;
             };
             cookie?: never;
@@ -7179,6 +7576,24 @@ export interface operations {
                 pageSize?: number;
                 /** @description Trading pair identifier (UUID) */
                 tradingPairId?: string;
+                /**
+                 * @description Pagination cursor with three distinct states:
+                 *       - Omitted: legacy page-number pagination via `page`, limited to recent
+                 *         history once the archive window is enabled.
+                 *       - Empty string (""): start a cursor walk with no prior position, from
+                 *         the newest row (this endpoint always sorts newest-first).
+                 *       - Non-empty: an opaque cursor from a previous response's
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      In either cursor-walk state (empty or non-empty), `page` is ignored, the
+                 *      response omits exact totals (total/total_pages/page are 0), and results
+                 *      cover full trade history — hot and archived rows merged — unlike
+                 *      page-number mode, which only ever sees recent history. Clients that need
+                 *      complete trade history must use the cursor form (start with an empty
+                 *      string, then follow next_page_token) rather than `page`. Filters must
+                 *      match the request that produced the token.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;
@@ -7912,6 +8327,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000007 */
                 delegatedAgentId: string;
             };
             cookie?: never;
@@ -7964,6 +8380,47 @@ export interface operations {
             };
         };
     };
+    get_faucet_info: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetFaucetInfoResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Faucet quota configuration unavailable; safe to retry */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     mint_tokens: {
         parameters: {
             query?: never;
@@ -8177,7 +8634,10 @@ export interface operations {
             };
             header?: never;
             path: {
-                /** @description Margin account UUID for the current isolated bucket. */
+                /**
+                 * @description Margin account UUID for the current isolated bucket.
+                 * @example 2b1a5f9c-0000-4000-8000-000000000001
+                 */
                 marginAccountId: string;
             };
             cookie?: never;
@@ -8200,7 +8660,10 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Parent margin account UUID that receives collateral. */
+                /**
+                 * @description Parent margin account UUID that receives collateral.
+                 * @example 2b1a5f9c-0000-4000-8000-000000000001
+                 */
                 marginAccountId: string;
             };
             cookie?: never;
@@ -8227,7 +8690,10 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Parent margin account UUID that releases collateral. */
+                /**
+                 * @description Parent margin account UUID that releases collateral.
+                 * @example 2b1a5f9c-0000-4000-8000-000000000001
+                 */
                 marginAccountId: string;
             };
             cookie?: never;
@@ -8260,7 +8726,10 @@ export interface operations {
             };
             header?: never;
             path: {
-                /** @description Margin account UUID for the current isolated bucket. */
+                /**
+                 * @description Margin account UUID for the current isolated bucket.
+                 * @example 2b1a5f9c-0000-4000-8000-000000000001
+                 */
                 marginAccountId: string;
             };
             cookie?: never;
@@ -8283,7 +8752,10 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Margin account UUID for the isolated bucket being simulated. */
+                /**
+                 * @description Margin account UUID for the isolated bucket being simulated.
+                 * @example 2b1a5f9c-0000-4000-8000-000000000001
+                 */
                 marginAccountId: string;
             };
             cookie?: never;
@@ -8496,6 +8968,37 @@ export interface operations {
             };
         };
     };
+    list_all_funding_history: {
+        parameters: {
+            query?: {
+                /** @description Start time as Unix timestamp (milliseconds) */
+                startTime?: number;
+                /** @description End time as Unix timestamp (milliseconds) */
+                endTime?: number;
+                /** @description Page number (1-indexed) */
+                page?: number;
+                /** @description Items per page (max 100) */
+                pageSize?: number;
+                /** @description Sort direction for settledAt */
+                orderBy?: "ASC" | "DESC";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListAllFundingHistoryResponse"];
+                };
+            };
+        };
+    };
     list_trading_pairs: {
         parameters: {
             query?: {
@@ -8553,7 +9056,9 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
+                /** @example 1m */
                 interval: string;
             };
             cookie?: never;
@@ -8597,6 +9102,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8633,6 +9139,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8661,9 +9168,12 @@ export interface operations {
                 page?: number;
                 /** @description Items per page (max 100) */
                 pageSize?: number;
+                /** @description Sort direction for createdAt */
+                orderBy?: "ASC" | "DESC";
             };
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8686,6 +9196,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8708,6 +9219,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8730,6 +9242,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8766,6 +9279,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8802,6 +9316,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8824,6 +9339,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8925,6 +9441,7 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8979,6 +9496,24 @@ export interface operations {
                 marginAccountId?: string;
                 /** @description Sort direction for createdAt */
                 orderBy?: "ASC" | "DESC";
+                /**
+                 * @description Pagination cursor with three distinct states:
+                 *       - Omitted: legacy page-number pagination via `page`, limited to recent
+                 *         history once the archive window is enabled.
+                 *       - Empty string (""): start a cursor walk with no prior position, from
+                 *         the newest row (or the oldest, when `orderBy` is ASC).
+                 *       - Non-empty: an opaque cursor from a previous response's
+                 *         `next_page_token`; results resume immediately after that position.
+                 *
+                 *      In either cursor-walk state (empty or non-empty), `page` is ignored, the
+                 *      response omits exact totals (total/total_pages/page are 0), and results
+                 *      cover full order history — hot and archived rows merged — unlike
+                 *      page-number mode, which only ever sees recent history. Clients that need
+                 *      complete order history must use the cursor form (start with an empty
+                 *      string, then follow next_page_token) rather than `page`. Filters and
+                 *      orderBy must match the request that produced the token.
+                 */
+                pageToken?: string;
             };
             header?: never;
             path?: never;
@@ -9161,6 +9696,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -9375,6 +9911,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000004 */
                 conditionalOrderId: string;
             };
             cookie?: never;
@@ -9397,6 +9934,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000004 */
                 conditionalOrderId: string;
             };
             cookie?: never;
@@ -9419,6 +9957,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000003 */
                 orderId: string;
             };
             cookie?: never;
@@ -9476,6 +10015,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000003 */
                 orderId: string;
             };
             cookie?: never;
@@ -9564,6 +10104,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 0x742d35cc6634c0532925a3b8d4060f31e2c3d8b5 */
                 code: string;
             };
             cookie?: never;
@@ -9772,6 +10313,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -9794,6 +10336,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -9820,7 +10363,10 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Position UUID for the isolated bucket being adjusted. */
+                /**
+                 * @description Position UUID for the isolated bucket being adjusted.
+                 * @example 2b1a5f9c-0000-4000-8000-000000000002
+                 */
                 positionId: string;
             };
             cookie?: never;
@@ -9847,7 +10393,10 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Position UUID for the isolated bucket being adjusted. */
+                /**
+                 * @description Position UUID for the isolated bucket being adjusted.
+                 * @example 2b1a5f9c-0000-4000-8000-000000000002
+                 */
                 positionId: string;
             };
             cookie?: never;
@@ -9881,6 +10430,7 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -9931,6 +10481,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -9953,6 +10504,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -9974,11 +10526,39 @@ export interface operations {
             };
         };
     };
+    get_pulse: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPulseResponse"];
+                };
+            };
+            /** @description Pulse feed not yet available */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_trade_by_id: {
         parameters: {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000006 */
                 tradeId: string;
             };
             cookie?: never;
@@ -10027,6 +10607,7 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -10227,6 +10808,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 0 */
                 withdrawalIndex: string;
             };
             cookie?: never;