@0xmonaco/types 1.0.28 → 1.0.31

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from "./pitpass";
 export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";
+export * from "./pulse";
 export * from "./sdk";
 export * from "./sub-accounts";
 export * from "./trading";

package/dist/index.js

@@ -18,6 +18,7 @@ export * from "./pitpass";
 export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";
+export * from "./pulse";
 export * from "./sdk";
 export * from "./sub-accounts";
 export * from "./trading";

package/dist/market/index.d.ts

@@ -213,6 +213,17 @@ export interface ScreenerItem {
     totalQuoteVolumeLtd: string;
     /** Life-to-date cumulative number of trades since inception (0 if no trades yet) */
     totalTradeCountLtd: number;
+    /**
+     * 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
+     */
+    latestFundingRate: string | null;
+    /**
+     * Close time of the latest settled funding window (ms since epoch, as string);
+     * null for spot pairs and margin pairs with no settled funding window yet
+     */
+    lastFundingTime: string | null;
 }
 /**
  * Paginated screener response, sorted by quoteVolume24h desc (nulls last)
@@ -342,14 +353,34 @@ export interface FundingState {
 }
 export interface FundingRecord {
     tradingPairId: string;
+    /** Sequential settlement-window index (serialized as a JSON number). */
+    epoch: number;
+    /** Capped settled rate for the window, as a decimal-string fraction per funding interval (e.g. "0.0001" = 0.01%). */
     fundingRate: string;
+    /** Quote charged per unit of base position for this window (fundingRate × referencePrice; positive means longs paid shorts). */
+    fundingDeltaPerUnit: string;
+    /** Running sum of fundingDeltaPerUnit across settled windows; position payments settle against deltas of this value. */
     cumulativeFundingPerUnit?: string;
+    /** Mark price at the window boundary — the payment basis for every position settled in the window. */
+    referencePrice: string;
+    /** Number of premium samples that fed the window's settled rate. */
+    sampleCount: number;
+    /** Window open time (ISO 8601). */
+    windowStartedAt: string;
+    /** Window close time (ISO 8601). */
+    windowClosedAt: string;
+    /** Settlement time (ISO 8601); the sort key for `listAllFundingHistory`. */
+    settledAt: string;
+    /** True when the window settled at the carried last rate (sparse-sample rule). */
+    carried?: boolean;
 }
 export interface ListFundingHistoryParams {
     startTime?: string;
     endTime?: string;
     page?: number;
     pageSize?: number;
+    /** Sort direction for epoch: "ASC" or "DESC" (default DESC). */
+    orderBy?: "ASC" | "DESC";
 }
 export interface ListFundingHistoryResponse {
     records: FundingRecord[];
@@ -357,6 +388,20 @@ export interface ListFundingHistoryResponse {
     page: number;
     pageSize: number;
 }
+export interface ListAllFundingHistoryParams {
+    startTime?: string;
+    endTime?: string;
+    page?: number;
+    pageSize?: number;
+    /** Sort direction for settledAt (default DESC). */
+    orderBy?: "ASC" | "DESC";
+}
+export interface ListAllFundingHistoryResponse {
+    records: FundingRecord[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
 export interface OpenInterest {
     tradingPairId: string;
     openInterest?: string;
@@ -431,5 +476,14 @@ export interface MarketAPI extends BaseAPI {
     getIndexPrice(tradingPairId: string): Promise<IndexPrice>;
     getFundingState(tradingPairId: string): Promise<FundingState>;
     listFundingHistory(tradingPairId: string, params?: ListFundingHistoryParams): Promise<ListFundingHistoryResponse>;
+    /**
+     * Fetch settled funding history across every market in one call, so clients
+     * don't have to fan out one listFundingHistory request per trading pair.
+     * Each record carries its tradingPairId; sorted by settledAt (default DESC).
+     * @param params - Optional time bounds (ms-epoch strings, inclusive on
+     *   settledAt), pagination, and orderBy (ASC or DESC)
+     * @returns Promise resolving to the paginated all-markets funding history
+     */
+    listAllFundingHistory(params?: ListAllFundingHistoryParams): Promise<ListAllFundingHistoryResponse>;
     getOpenInterest(tradingPairId: string): Promise<OpenInterest>;
 }

package/dist/portfolio/index.d.ts

@@ -77,10 +77,17 @@ export interface PortfolioRealizedTotals {
     netRealizedPnl: string;
 }
 export interface PortfolioClosedTradeStats {
+    /** Fill-based: closing fills in the window (partial fills each counted). */
     count: number;
+    /**
+     * Position-level: each position (one flat -> open -> flat round-trip) is
+     * classified once by its net realized PnL after all fees.
+     */
     winners: number;
     losers: number;
     breakEven: number;
+    /** Total classified positions (= winners + losers + breakEven). */
+    positions: number;
     winRatePct?: string;
 }
 export interface PortfolioBestDay {

package/dist/positions/index.d.ts

@@ -1,7 +1,17 @@
 import type { BaseAPI } from "../api";
 import type { MarginMode } from "../margin-accounts";
 import type { OrderType, PositionSide, TimeInForce } from "../trading";
-export type PositionStatus = "OPEN" | "CLOSED" | "LIQUIDATING";
+/**
+ * Position lifecycle statuses the API returns. `CLOSED`, `LIQUIDATED`, and
+ * `EXPIRED` are terminal; `LIQUIDATING` is transient.
+ */
+export type PositionStatus = "OPEN" | "CLOSED" | "LIQUIDATING" | "LIQUIDATED" | "EXPIRED";
+/**
+ * Accepted `status` filter values for {@link ListPositionsParams}. Narrower than
+ * {@link PositionStatus}: the backend folds `EXPIRED` positions under a `CLOSED`
+ * filter, so `EXPIRED` is not an accepted filter value.
+ */
+export type PositionStatusFilter = "OPEN" | "CLOSED" | "LIQUIDATING" | "LIQUIDATED";
 export type ClosePositionType = "MARKET" | "LIMIT" | "IOC";
 export interface Position {
     positionId: string;
@@ -10,12 +20,23 @@ export interface Position {
     marginMode?: MarginMode;
     tradingPairId: string;
     side: PositionSide;
+    /**
+     * 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;
     entryPrice: string;
     markPrice: string;
     indexPrice?: string;
     unrealizedPnl: string;
     realizedPnl: string;
+    /**
+     * 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;
     leverage?: string;
     /**
@@ -39,11 +60,21 @@ export interface Position {
     liquidationPrice: string;
     status: PositionStatus;
     updatedAt: string;
+    /**
+     * Lifetime realized PnL net of trading fees and funding. Terminal rows
+     * only; absent when the position's reducing executions are unavailable.
+     */
+    netRealizedPnl?: string;
+    /**
+     * Lifetime realized return on the total allocated initial margin, as a
+     * percentage. Terminal rows only; absent when unavailable.
+     */
+    realizedRoe?: string;
 }
 export interface ListPositionsParams {
     marginAccountId?: string;
     tradingPairId?: string;
-    status?: PositionStatus;
+    status?: PositionStatusFilter;
     page?: number;
     pageSize?: number;
 }

package/dist/profile/index.d.ts

@@ -231,16 +231,24 @@ export interface UserTrade {
  * Query parameters for getting user trades
  */
 export interface GetUserTradesParams {
-    /** Page number (starts from 1) */
+    /**
+     * Page number for legacy offset pagination (starts from 1).
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode, which only ever sees recent (hot)
+     * history; omitting both `page` and `pageToken` now drives cursor mode.
+     */
     page?: number;
-    /** Number of items per page (max 100) */
+    /** Number of items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     pageSize?: number;
     /** Filter by trading pair ID (UUID) */
     tradingPairId?: string;
     /**
      * Pagination cursor with three distinct states:
-     * - Omitted (`undefined`): legacy page-number pagination via `page`,
-     *   limited to recent history once the archive window is enabled.
+     * - Omitted (`undefined`): the SDK starts a cursor walk (it sends
+     *   `pageToken=""`) unless the deprecated `page` param was passed, in
+     *   which case the request uses legacy page-number pagination, 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
@@ -261,13 +269,28 @@ export interface GetUserTradesParams {
 export interface GetUserTradesResponse {
     /** List of user trades */
     trades: UserTrade[];
-    /** Current page number */
+    /**
+     * Current page number.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode. Use `pageToken`/`nextPageToken` pagination instead.
+     */
     page: number;
     /** Items per page */
     pageSize: number;
-    /** Total number of trades */
+    /**
+     * Total number of trades.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     total: number;
-    /** Total number of pages */
+    /**
+     * Total number of pages.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     totalPages: number;
     /**
      * Cursor for the next page. Empty on every page-number (legacy) response —
@@ -427,7 +450,12 @@ export interface PortfolioStats {
     totalTrades: number;
     /** Total fees paid */
     feesPaid: string;
-    /** Ratio of profitable trades to total trades. Null when there are no closed trades in the period. */
+    /**
+     * 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.
+     */
     winLossRatio: number | null;
     /** Total equity in USDC terms (spot balances plus perps account equity) */
     totalEquity: string;
@@ -541,12 +569,20 @@ export interface ProfileAPI extends BaseAPI {
      *
      * @param params - Optional query parameters for pagination and filtering
      * @param params.page - Page number (starts from 1)
-     * @param params.limit - Number of items per page (max 100)
+     * @param params.limit - Number of items per page (max 100 in page-number mode, up to 1000 when `pageToken` is present)
      * @param params.tradingPairId - Filter by trading pair ID (UUID)
      * @returns Promise resolving to paginated trades response
      * @throws ValidationError If pagination params (page/limit) are invalid or tradingPairId is not a valid UUID; this may occur before any network request.
      */
     getUserTrades(params?: GetUserTradesParams): Promise<GetUserTradesResponse>;
+    /**
+     * Walks the user's full trade history with cursor pagination, yielding one
+     * trade at a time. Follows each response's `nextPageToken` until the walk
+     * is exhausted; covers hot and archived history.
+     * @param params - Optional filters and page size; the cursor is managed internally
+     * @returns Async generator yielding trades
+     */
+    iterateUserTrades(params?: Omit<GetUserTradesParams, "page" | "pageToken">): AsyncGenerator<UserTrade, void, undefined>;
     /**
      * List the current user's funding payment history with pagination and filters.
      *

package/dist/pulse/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Pulse Types
+ *
+ * Types for the public market-pulse news feed: AI-synthesized, per-asset
+ * headlines served from the backend's hourly-refreshed cache.
+ *
+ * NOTE: This endpoint is **public (unauthenticated)** and ETag-cacheable.
+ * It returns 503 while the backend cache is cold.
+ */
+import type { BaseAPI } from "../api";
+/** Provenance for one pulse item, for attribution links. */
+export interface PulseSource {
+    /** Source article or post URL. */
+    url: string;
+    /** Source author or publication name. */
+    author: string;
+    /** Source channel: "twitter" or "news". */
+    source: string;
+    /** Source publication time, ISO-8601. */
+    createdAt: string;
+    /** Relevance score, 1 (low) to 5 (high). */
+    relevance: number;
+}
+/** One synthesized market-pulse headline. */
+export interface PulseItem {
+    /** Watchlist ticker (e.g. "BTC") or "MARKET" for a cross-asset story. */
+    asset: string;
+    /** Sentiment tag: "Bullish", "Neutral", or "Bearish". */
+    sentiment: string;
+    /** Synthesized 1-2 sentence summary (at most 240 characters). */
+    summary: string;
+    /** Timestamp of the most recent source; render relative time client-side. */
+    updatedAt: string;
+    /** Provenance for the item. */
+    sources: PulseSource[];
+}
+/** The latest pulse snapshot. */
+export interface GetPulseResponse {
+    /** When this snapshot was produced upstream (ISO-8601 UTC); also the ETag value. */
+    generatedAt: string;
+    /** Asset universe the snapshot was synthesized against. */
+    watchlist: string[];
+    /** Pulse items, pre-sorted (watchlist order, MARKET last, newest first per asset). */
+    items: PulseItem[];
+}
+/**
+ * Pulse API interface. The endpoint is public (no auth required).
+ */
+export interface PulseAPI extends BaseAPI {
+    /**
+     * Get the latest market pulse news feed snapshot.
+     *
+     * Public/unauthenticated; served from the backend cache (refreshed hourly).
+     * Items whose figures could not be verified upstream are removed
+     * server-side before caching.
+     *
+     * @returns Promise resolving to the latest snapshot
+     * @throws 503 while the backend cache is cold
+     */
+    getPulse(): Promise<GetPulseResponse>;
+}

package/dist/pulse/index.js

@@ -0,0 +1,9 @@
+/**
+ * Pulse Types
+ *
+ * Types for the public market-pulse news feed: AI-synthesized, per-asset
+ * headlines served from the backend's hourly-refreshed cache.
+ *
+ * NOTE: This endpoint is **public (unauthenticated)** and ETag-cacheable.
+ * It returns 503 while the backend cache is cold.
+ */

package/dist/sdk/index.d.ts

@@ -10,6 +10,7 @@ import type { PitpassAPI } from "../pitpass";
 import type { PortfolioAPI } from "../portfolio";
 import type { PositionsAPI } from "../positions";
 import type { ProfileAPI } from "../profile";
+import type { PulseAPI } from "../pulse";
 import type { SubAccountsAPI } from "../sub-accounts";
 import type { TradingAPI, TradingMode } from "../trading";
 import type { VaultAPI } from "../vault";
@@ -101,6 +102,8 @@ export interface MonacoSDK {
     whitelist: WhitelistAPI;
     /** Profile operations API */
     profile: ProfileAPI;
+    /** Public market-pulse news feed API (cached, hourly-refreshed) */
+    pulse: PulseAPI;
     /** Orderbook REST API for fetching orderbook snapshots */
     orderbook: {
         getOrderbook: (tradingPairId: string, options?: {

package/dist/trading/index.d.ts

@@ -5,7 +5,7 @@
  */
 import type { BaseAPI } from "../api/index";
 import type { MarginMode } from "../margin-accounts";
-import type { OrderSide, PositionSide, TimeInForce, TradingMode } from "./orders";
+import type { Order, OrderSide, PositionSide, TimeInForce, TradingMode } from "./orders";
 import type { BatchCancelOrdersResponse, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchReplaceOrderParams, BatchReplaceOrdersResponse, CancelConditionalOrderResponse, CancelOrderResponse, ConditionalOrder, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, ParentTpSlLegParams, ReplaceOrderResponse } from "./responses";
 /**
  * Trading API interface.
@@ -38,9 +38,7 @@ export interface TradingAPI extends BaseAPI {
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
-        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         takeProfit?: ParentTpSlLegParams;
-        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
     /**
@@ -65,9 +63,7 @@ export interface TradingAPI extends BaseAPI {
         positionSide?: PositionSide;
         leverage?: string;
         reduceOnly?: boolean;
-        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         takeProfit?: ParentTpSlLegParams;
-        /** @deprecated Entry-attached TP/SL is rejected; use position TP/SL. */
         stopLoss?: ParentTpSlLegParams;
     }): Promise<CreateOrderResponse>;
     /**
@@ -139,6 +135,14 @@ export interface TradingAPI extends BaseAPI {
      * @returns Promise resolving to the paginated orders result
      */
     getPaginatedOrders(params?: GetPaginatedOrdersParams): Promise<GetPaginatedOrdersResponse>;
+    /**
+     * Walks the user's full order history with cursor pagination, yielding one
+     * order at a time. Follows each response's `nextPageToken` until the walk
+     * is exhausted; covers hot and archived history.
+     * @param params - Optional filters and page size; the cursor is managed internally
+     * @returns Async generator yielding orders
+     */
+    iterateOrders(params?: Omit<GetPaginatedOrdersParams, "page" | "pageToken">): AsyncGenerator<Order, void, undefined>;
     /**
      * Gets a single order by its ID.
      * @param orderId - ID of the order to retrieve
@@ -146,6 +150,6 @@ export interface TradingAPI extends BaseAPI {
      */
     getOrder(orderId: string): Promise<GetOrderResponse>;
 }
-export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderTerminalReason, OrderType, PositionSide, TimeInForce, TradingMode, } from "./orders";
+export type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderRole, OrderSide, OrderStatus, OrderStatusFilter, OrderTerminalReason, OrderType, PositionSide, TimeInForce, TradingMode, } from "./orders";
 export { ORDER_STATUS_VALUES } from "./orders";
 export type { BatchCancelError, BatchCancelOrdersResponse, BatchCancelResult, BatchCreateOrderParams, BatchCreateOrdersResponse, BatchCreateResult, BatchError, BatchReplaceOrderParams, BatchReplaceOrdersResponse, BatchReplaceResult, CancelConditionalOrderResponse, CancelOrderResponse, ConditionalOrder, CreateOrderResponse, GetOrderResponse, GetPaginatedOrdersParams, GetPaginatedOrdersResponse, ListConditionalOrdersParams, ListConditionalOrdersResponse, MatchResult, ParentTpSlLegParams, ReplaceOrderResponse, UpdatedFields, } from "./responses";

package/dist/trading/orders.d.ts

@@ -115,6 +115,14 @@ export declare const ORDER_STATUS_VALUES: readonly ["SUBMITTED", "PARTIALLY_FILL
  * - EXPIRED: Order expired based on time constraints
  */
 export type OrderStatus = (typeof ORDER_STATUS_VALUES)[number];
+/**
+ * Order status filter accepted by the order listing endpoints.
+ *
+ * A single status matches only that status; an array matches any of the listed
+ * statuses (sent to the API as a comma-separated `status` query parameter), so
+ * several statuses can be fetched in one request instead of one per status.
+ */
+export type OrderStatusFilter = OrderStatus | readonly OrderStatus[];
 /**
  * Trading mode
  */

package/dist/trading/responses.d.ts

@@ -4,7 +4,7 @@
  * Response types for trading operations.
  */
 import type { MarginMode } from "../margin-accounts";
-import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderSide, OrderStatus, OrderType, PositionSide, TimeInForce, TradingMode } from "./orders";
+import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalOrderTriggerSource, Order, OrderSide, OrderStatus, OrderStatusFilter, OrderType, PositionSide, TimeInForce, TradingMode } from "./orders";
 /**
  * Match result information for order execution.
  * Contains detailed information about trades, fills, and execution quality.
@@ -38,8 +38,6 @@ export interface MatchResult {
     } | null;
 }
 /**
- * @deprecated Entry-attached TP/SL is rejected. Use position-associated TP/SL.
- *
  * Parent TP/SL follows the parent order quantity and becomes active once the
  * parent order creates or extends a position.
  */
@@ -127,22 +125,30 @@ export interface UpdatedFields {
  * Query parameters for getting paginated orders
  */
 export interface GetPaginatedOrdersParams {
-    /** Filter by order status */
-    status?: OrderStatus;
+    /** Filter by order status, or by any of several statuses when given an array */
+    status?: OrderStatusFilter;
     /** Filter by trading pair UUID */
     tradingPairId?: string;
     /** Filter by trading mode */
     tradingMode?: TradingMode;
     /** Filter by margin account UUID */
     marginAccountId?: string;
-    /** Page number for pagination (default: 1) */
+    /**
+     * Page number for legacy offset pagination.
+     *
+     * @deprecated Use cursor pagination (`pageToken`) instead. Passing `page`
+     * selects legacy page-number mode, which only ever sees recent (hot)
+     * history; omitting both `page` and `pageToken` now drives cursor mode.
+     */
     page?: number;
-    /** Number of orders per page (default: 10, max: 100) */
+    /** Number of orders per page (default: 10; max 100 in page-number mode, up to 1000 when `pageToken` is present) */
     pageSize?: number;
     /**
      * Pagination cursor with three distinct states:
-     * - Omitted (`undefined`): legacy page-number pagination via `page`,
-     *   limited to recent history once the archive window is enabled.
+     * - Omitted (`undefined`): the SDK starts a cursor walk (it sends
+     *   `pageToken=""`) unless the deprecated `page` param was passed, in
+     *   which case the request uses legacy page-number pagination, 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
@@ -168,13 +174,28 @@ export interface GetPaginatedOrdersResponse {
     latest_orders?: Order[];
     /** Array of historical orders from PostgreSQL (paginated) */
     orders: Order[];
-    /** Total number of orders matching the query */
+    /**
+     * Total number of orders matching the query.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     total: number;
-    /** Current page number */
+    /**
+     * Current page number.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode. Use `pageToken`/`nextPageToken` pagination instead.
+     */
     page: number;
     /** Number of orders per page */
     pageSize: number;
-    /** Total number of pages */
+    /**
+     * Total number of pages.
+     *
+     * @deprecated Only populated by legacy page-number (offset) responses; 0 in
+     * cursor mode, which has no exact total. Walk `nextPageToken` instead.
+     */
     totalPages: number;
     /**
      * Cursor for the next page. Empty on every page-number (legacy) response —

package/dist/validation/positions.d.ts

@@ -11,6 +11,7 @@ export declare const ListPositionsSchema: z.ZodObject<{
         OPEN: "OPEN";
         CLOSED: "CLOSED";
         LIQUIDATING: "LIQUIDATING";
+        LIQUIDATED: "LIQUIDATED";
     }>>;
 }, z.core.$strip>;
 export declare const GetPositionSchema: z.ZodObject<{

package/dist/validation/positions.js

@@ -7,8 +7,11 @@ const PaginationSchema = z.object({
     page: z.number().int().min(1, "Page must be at least 1").optional(),
     pageSize: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
 });
-const PositionStatusSchema = z.enum(["OPEN", "CLOSED", "LIQUIDATING"], {
-    message: 'Position status must be "OPEN", "CLOSED", or "LIQUIDATING"',
+// Filter values accepted by the list-positions endpoint. Narrower than the
+// returned PositionStatus: the backend folds EXPIRED positions under CLOSED, so
+// EXPIRED is not an accepted filter value.
+const PositionStatusSchema = z.enum(["OPEN", "CLOSED", "LIQUIDATING", "LIQUIDATED"], {
+    message: 'Position status must be "OPEN", "CLOSED", "LIQUIDATING", or "LIQUIDATED"',
 });
 const ClosePositionTypeSchema = z.enum(["MARKET", "LIMIT", "IOC"], {
     message: 'Close type must be "MARKET", "LIMIT", or "IOC"',

package/dist/validation/profile.js

@@ -37,11 +37,25 @@ export const GetUserMovementsSchema = z.object({
  * Validates parameters for fetching paginated user trades.
  * All fields are optional — an empty object or undefined is valid.
  */
-export const GetUserTradesSchema = z.object({
+export const GetUserTradesSchema = z
+    .object({
     page: z.number().int("Page must be an integer").min(1, "Page must be at least 1").optional(),
-    pageSize: z.number().int("Page size must be an integer").min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    pageSize: z.number().int("Page size must be an integer").min(1, "Page size must be at least 1").max(1000, "Page size cannot exceed 1000").optional(),
     tradingPairId: UUIDSchema.optional(),
     pageToken: z.string().optional(),
+})
+    .superRefine((params, ctx) => {
+    // The higher 1000 cap only applies to cursor (pageToken) requests; the
+    // server keeps the 100 cap for page-number requests (offset scans).
+    // Legacy page-number mode is selected only by passing `page` without
+    // `pageToken` — omitting both starts a cursor walk.
+    if (params.page !== undefined && params.pageToken === undefined && params.pageSize !== undefined && params.pageSize > 100) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Page size cannot exceed 100 in page-number mode (page without pageToken)",
+            path: ["pageSize"],
+        });
+    }
 });
 export const ListFundingPaymentsSchema = z.object({
     page: z.number().int("Page must be an integer").min(1, "Page must be at least 1").optional(),

package/dist/validation/trading.d.ts

@@ -237,13 +237,13 @@ export declare const ReplaceOrderSchema: z.ZodObject<{
  *
  * Validates parameters for fetching paginated orders.
  * Matches the getPaginatedOrders method signature which accepts:
- * - status: OrderStatus (optional filter)
+ * - status: OrderStatus, or a non-empty array of them (optional filter)
  * - tradingPairId: trading pair UUID (optional filter)
  * - page: number (default: 1)
- * - pageSize: number (default: 10, max: 100)
+ * - pageSize: number (default: 10, max: 100 in page-number mode, 1000 when pageToken is present)
  */
 export declare const GetPaginatedOrdersSchema: z.ZodObject<{
-    status: z.ZodOptional<z.ZodEnum<{
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
         SUBMITTED: "SUBMITTED";
         PARTIALLY_FILLED: "PARTIALLY_FILLED";
         FILLED: "FILLED";
@@ -252,7 +252,16 @@ export declare const GetPaginatedOrdersSchema: z.ZodObject<{
         CANCELLED: "CANCELLED";
         REJECTED: "REJECTED";
         EXPIRED: "EXPIRED";
-    }>>;
+    }>, z.ZodArray<z.ZodEnum<{
+        SUBMITTED: "SUBMITTED";
+        PARTIALLY_FILLED: "PARTIALLY_FILLED";
+        FILLED: "FILLED";
+        SETTLED_ON_CHAIN: "SETTLED_ON_CHAIN";
+        SETTLED: "SETTLED";
+        CANCELLED: "CANCELLED";
+        REJECTED: "REJECTED";
+        EXPIRED: "EXPIRED";
+    }>>]>>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
     tradingMode: z.ZodOptional<z.ZodEnum<{
         SPOT: "SPOT";

package/dist/validation/trading.js

@@ -141,8 +141,12 @@ export const PlaceLimitOrderSchema = z
     message: "leverage is required for normal MARGIN orders",
     path: ["options", "leverage"],
 })
-    .refine((data) => !hasParentTpSl(data.options), {
-    message: "Entry-attached TP/SL are no longer supported; create position TP/SL after the position opens",
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
+    message: "takeProfit/stopLoss are only supported for MARGIN orders",
+    path: ["options"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
+    message: "takeProfit/stopLoss cannot be attached to reduce-only orders",
     path: ["options"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
@@ -210,8 +214,12 @@ export const PlaceMarketOrderSchema = z
     message: "leverage is required for normal MARGIN orders",
     path: ["options", "leverage"],
 })
-    .refine((data) => !hasParentTpSl(data.options), {
-    message: "Entry-attached TP/SL are no longer supported; create position TP/SL after the position opens",
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.tradingMode === "MARGIN", {
+    message: "takeProfit/stopLoss are only supported for MARGIN orders",
+    path: ["options"],
+})
+    .refine((data) => !hasParentTpSl(data.options) || data.options?.reduceOnly !== true, {
+    message: "takeProfit/stopLoss cannot be attached to reduce-only orders",
     path: ["options"],
 })
     .refine((data) => data.options?.riskBucketCollateral === undefined || data.options?.tradingMode === "MARGIN", {
@@ -273,19 +281,33 @@ export const ReplaceOrderSchema = z.object({
  *
  * Validates parameters for fetching paginated orders.
  * Matches the getPaginatedOrders method signature which accepts:
- * - status: OrderStatus (optional filter)
+ * - status: OrderStatus, or a non-empty array of them (optional filter)
  * - tradingPairId: trading pair UUID (optional filter)
  * - page: number (default: 1)
- * - pageSize: number (default: 10, max: 100)
+ * - pageSize: number (default: 10, max: 100 in page-number mode, 1000 when pageToken is present)
  */
-export const GetPaginatedOrdersSchema = z.object({
-    status: z.enum(ORDER_STATUS_VALUES).optional(),
+export const GetPaginatedOrdersSchema = z
+    .object({
+    status: z.union([z.enum(ORDER_STATUS_VALUES), z.array(z.enum(ORDER_STATUS_VALUES)).min(1, "Status filter must list at least one status")]).optional(),
     tradingPairId: UUIDSchema.optional(),
     tradingMode: TradingModeSchema.optional(),
     marginAccountId: UUIDSchema.optional(),
     page: z.number().int().min(1, "Page must be at least 1").optional(),
-    pageSize: z.number().int().min(1, "Page size must be at least 1").max(100, "Page size cannot exceed 100").optional(),
+    pageSize: z.number().int().min(1, "Page size must be at least 1").max(1000, "Page size cannot exceed 1000").optional(),
     pageToken: z.string().optional(),
+})
+    .superRefine((params, ctx) => {
+    // The higher 1000 cap only applies to cursor (pageToken) requests; the
+    // server keeps the 100 cap for page-number requests (offset scans).
+    // Legacy page-number mode is selected only by passing `page` without
+    // `pageToken` — omitting both starts a cursor walk.
+    if (params.page !== undefined && params.pageToken === undefined && params.pageSize !== undefined && params.pageSize > 100) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Page size cannot exceed 100 in page-number mode (page without pageToken)",
+            path: ["pageSize"],
+        });
+    }
 });
 export const ConditionalOrderConditionTypeSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"], {
     message: 'conditionType must be "STOP_LOSS" or "TAKE_PROFIT"',

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_faucet_info", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_faucet_info", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -60,6 +60,7 @@ export const OPERATION_IDS = [
     "get_position",
     "get_position_pnl_history",
     "get_position_risk",
+    "get_pulse",
     "get_rewards_balance",
     "get_screener",
     "get_sub_account_limits",
@@ -75,6 +76,7 @@ export const OPERATION_IDS = [
     "get_withdrawal",
     "health_check",
     "initiate_withdrawal",
+    "list_all_funding_history",
     "list_application_balances",
     "list_application_movements",
     "list_application_orders",

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;
@@ -3270,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: {
             /**
@@ -3459,11 +3535,31 @@ export interface components {
         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;
         };
@@ -4114,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;
@@ -4163,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;
             /**
@@ -4196,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;
@@ -4284,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;
@@ -4366,7 +4507,8 @@ export interface components {
         GetUserTradesResponse: {
             trades?: components["schemas"]["UserTrade"][] | null;
             /**
-             * @description Current page number
+             * @deprecated
+             * @description Deprecated: current page number (legacy offset mode only; 0 in cursor mode)
              * @example 1
              */
             page?: string | null;
@@ -4376,12 +4518,14 @@ export interface components {
              */
             pageSize?: string | null;
             /**
-             * @description Total number of trades
+             * @deprecated
+             * @description Deprecated: total number of trades (legacy offset mode only; 0 in cursor mode)
              * @example 150
              */
             total?: string | null;
             /**
-             * @description Total number of pages
+             * @deprecated
+             * @description Deprecated: total number of pages (legacy offset mode only; 0 in cursor mode)
              * @example 8
              */
             totalPages?: string | null;
@@ -4563,6 +4707,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;
             /**
@@ -4737,13 +4890,15 @@ export interface components {
             orders?: components["schemas"]["GetOrderResponse"][] | null;
             /**
              * Format: uint32
-             * @description Total number of orders matching the filter
+             * @deprecated
+             * @description Deprecated: total number of orders matching the filter (legacy offset mode only; 0 in cursor mode)
              * @example 150
              */
             total?: number | null;
             /**
              * Format: uint32
-             * @description Current page number
+             * @deprecated
+             * @description Deprecated: current page number (legacy offset mode only; 0 in cursor mode)
              * @example 1
              */
             page?: number | null;
@@ -4755,7 +4910,8 @@ export interface components {
             pageSize?: number | null;
             /**
              * Format: uint32
-             * @description Total number of pages
+             * @deprecated
+             * @description Deprecated: total number of pages (legacy offset mode only; 0 in cursor mode)
              * @example 8
              */
             totalPages?: number | null;
@@ -5133,12 +5289,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;
@@ -5258,13 +5425,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;
             /**
@@ -5291,6 +5468,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;
@@ -5444,6 +5636,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;
         };
@@ -5625,6 +5869,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: {
@@ -7322,9 +7576,12 @@ export interface operations {
     get_user_trades: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
+                /**
+                 * @deprecated
+                 * @description Deprecated: page number for legacy offset pagination (1-indexed). Use pageToken cursor pagination instead.
+                 */
                 page?: number;
-                /** @description Items per page (max 100) */
+                /** @description Items per page (max: 100 in page-number mode; up to 1000 when pageToken is present) */
                 pageSize?: number;
                 /** @description Trading pair identifier (UUID) */
                 tradingPairId?: string;
@@ -8720,6 +8977,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?: {
@@ -8889,6 +9177,8 @@ export interface operations {
                 page?: number;
                 /** @description Items per page (max 100) */
                 pageSize?: number;
+                /** @description Sort direction for createdAt */
+                orderBy?: "ASC" | "DESC";
             };
             header?: never;
             path: {
@@ -9202,9 +9492,12 @@ export interface operations {
     get_orders: {
         parameters: {
             query?: {
-                /** @description Page number (1-indexed) */
+                /**
+                 * @deprecated
+                 * @description Deprecated: page number for legacy offset pagination (1-indexed). Use pageToken cursor pagination instead.
+                 */
                 page?: number;
-                /** @description Items per page (max 100) */
+                /** @description Items per page (max 100 in page-number mode; up to 1000 when pageToken is present) */
                 pageSize?: number;
                 /** @description Order status (single value or comma-separated list) */
                 status?: string;
@@ -10245,6 +10538,33 @@ 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;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.28",
+	"version": "1.0.31",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.28",
+		"@0xmonaco/contracts": "1.0.31",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {