@0xmonaco/types 1.0.26 → 1.0.29

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)
@@ -344,12 +355,16 @@ export interface FundingRecord {
     tradingPairId: string;
     fundingRate: string;
     cumulativeFundingPerUnit?: 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 +372,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 +460,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

@@ -10,12 +10,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,6 +50,16 @@ 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;

package/dist/profile/index.d.ts

@@ -237,6 +237,23 @@ export interface GetUserTradesParams {
     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.
+     * - 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
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * In either cursor-walk state (empty or non-empty), `page` is ignored, the
+     * response omits exact totals (`total`/`totalPages`/`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 (pass `""` to
+     * start, then follow `nextPageToken`) rather than `page`.
+     */
+    pageToken?: string;
 }
 /**
  * Response from getting user trades
@@ -252,6 +269,21 @@ export interface GetUserTradesResponse {
     total: number;
     /** Total number of pages */
     totalPages: number;
+    /**
+     * 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
+     * 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 `pageToken`
+     * 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. The
+     * two modes never bridge — page-number pagination is deprecated for deep
+     * history.
+     */
+    nextPageToken: string;
 }
 /**
  * Direction of a funding payment from the user's perspective.
@@ -395,7 +427,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;

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

@@ -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>;
     /**

package/dist/trading/responses.d.ts

@@ -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.
  */
@@ -139,6 +137,23 @@ export interface GetPaginatedOrdersParams {
     page?: number;
     /** Number of orders per page (default: 10, max: 100) */
     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.
+     * - 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
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * In either cursor-walk state (empty or non-empty), `page` is ignored, the
+     * response omits exact totals (`total`/`totalPages`/`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 (pass `""` to
+     * start, then follow `nextPageToken`) rather than `page`.
+     */
+    pageToken?: string;
 }
 /**
  * Response from getting paginated orders
@@ -159,6 +174,21 @@ export interface GetPaginatedOrdersResponse {
     pageSize: number;
     /** Total number of pages */
     totalPages: number;
+    /**
+     * 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
+     * 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 `pageToken`
+     * 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. The
+     * two modes never bridge — page-number pagination is deprecated for deep
+     * history.
+     */
+    nextPageToken: string;
 }
 /**
  * Response from getting a single order by ID

package/dist/validation/profile.d.ts

@@ -66,6 +66,7 @@ export declare const GetUserTradesSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ListFundingPaymentsSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;

package/dist/validation/profile.js

@@ -41,6 +41,7 @@ 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(),
     tradingPairId: UUIDSchema.optional(),
+    pageToken: z.string().optional(),
 });
 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

@@ -261,6 +261,7 @@ export declare const GetPaginatedOrdersSchema: z.ZodObject<{
     marginAccountId: z.ZodOptional<z.ZodUUID>;
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ConditionalOrderConditionTypeSchema: z.ZodEnum<{
     STOP_LOSS: "STOP_LOSS";

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", {
@@ -285,6 +293,7 @@ export const GetPaginatedOrdersSchema = z.object({
     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(),
+    pageToken: z.string().optional(),
 });
 export const ConditionalOrderConditionTypeSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"], {
     message: 'conditionType must be "STOP_LOSS" or "TAKE_PROFIT"',
@@ -343,6 +352,10 @@ export const BatchCreateOrderItemSchema = z
     .refine((data) => data.orderType !== "MARKET" || data.price === undefined, {
     message: "Price must not be provided for MARKET orders",
     path: ["price"],
+})
+    .refine((data) => data.orderType !== "MARKET" || data.timeInForce === undefined, {
+    message: "timeInForce must not be provided for MARKET orders",
+    path: ["timeInForce"],
 })
     .refine((data) => data.riskBucketCollateral === undefined || data.tradingMode === "MARGIN", {
     message: "riskBucketCollateral is only supported for MARGIN orders",

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;
@@ -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;
@@ -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;
@@ -4385,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;
@@ -4547,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;
             /**
@@ -4743,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;
@@ -5101,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;
@@ -5226,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;
             /**
@@ -5259,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;
@@ -5412,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;
         };
@@ -5593,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: {
@@ -7296,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;
@@ -8670,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?: {
@@ -8839,6 +9168,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: {
@@ -9165,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;
@@ -10177,6 +10526,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.26",
+	"version": "1.0.29",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.26",
+		"@0xmonaco/contracts": "1.0.29",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {