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

package/dist/wire/schema.d.ts

@@ -1052,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;
@@ -1854,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;
@@ -2508,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;
@@ -2957,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;
@@ -3176,9 +3223,13 @@ export interface components {
             /** @description On-chain transaction hash; absent when the transaction was submitted but never confirmed */
             txHash?: string | null;
         };
-        /** @description One past faucet request (one endpoint call; all tokens minted together). */
+        /**
+         * @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 (the quota-session granularity) */
+            /** @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;
         };
@@ -3266,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: {
             /**
@@ -3447,19 +3527,39 @@ export interface components {
             /** @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 requests, newest first, regardless of the
-             *      24h window.
+             * @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;
         };
@@ -4110,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;
@@ -4159,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;
             /**
@@ -4192,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;
@@ -4280,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;
@@ -4381,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;
@@ -4543,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;
             /**
@@ -4739,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;
@@ -5097,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;
@@ -5222,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;
             /**
@@ -5255,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;
@@ -5408,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;
         };
@@ -5589,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: {
@@ -6456,6 +6740,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
                 assetId: string;
             };
             cookie?: never;
@@ -7109,6 +7394,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
                 subAccountId: string;
             };
             cookie?: never;
@@ -7159,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;
@@ -7224,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;
@@ -7286,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;
@@ -8019,6 +8327,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000007 */
                 delegatedAgentId: string;
             };
             cookie?: never;
@@ -8325,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;
@@ -8348,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;
@@ -8375,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;
@@ -8408,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;
@@ -8431,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;
@@ -8644,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?: {
@@ -8701,7 +9056,9 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
+                /** @example 1m */
                 interval: string;
             };
             cookie?: never;
@@ -8745,6 +9102,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8781,6 +9139,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8809,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;
@@ -8834,6 +9196,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8856,6 +9219,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8878,6 +9242,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8914,6 +9279,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8950,6 +9316,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -8972,6 +9339,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -9073,6 +9441,7 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -9127,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;
@@ -9309,6 +9696,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -9523,6 +9911,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000004 */
                 conditionalOrderId: string;
             };
             cookie?: never;
@@ -9545,6 +9934,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000004 */
                 conditionalOrderId: string;
             };
             cookie?: never;
@@ -9567,6 +9957,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000003 */
                 orderId: string;
             };
             cookie?: never;
@@ -9624,6 +10015,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000003 */
                 orderId: string;
             };
             cookie?: never;
@@ -9712,6 +10104,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 0x742d35cc6634c0532925a3b8d4060f31e2c3d8b5 */
                 code: string;
             };
             cookie?: never;
@@ -9920,6 +10313,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -9942,6 +10336,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -9968,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;
@@ -9995,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;
@@ -10029,6 +10430,7 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -10079,6 +10481,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -10101,6 +10504,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 2b1a5f9c-0000-4000-8000-000000000002 */
                 positionId: string;
             };
             cookie?: never;
@@ -10122,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;
@@ -10175,6 +10607,7 @@ export interface operations {
             };
             header?: never;
             path: {
+                /** @example 893d2add-2f36-4ee7-b660-893d2add2f36 */
                 tradingPairId: string;
             };
             cookie?: never;
@@ -10375,6 +10808,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @example 0 */
                 withdrawalIndex: string;
             };
             cookie?: never;