@0xmonaco/types 1.0.64 → 1.0.65

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

@@ -230,6 +230,12 @@ export interface MarginAccountMovement {
 }
 export interface GetMarginAccountMovementsResponse {
     movements: MarginAccountMovement[];
+    /**
+     * Matching movements. Exact up to 10,000 pages of the requested page size
+     * (`pageSize` x 10,000 rows) and saturates there, so a caller with more
+     * movements than the listing can page through reads the cap, not its
+     * lifetime total. `page` is capped at 10,000.
+     */
     total: number;
     page: number;
     pageSize: number;

package/dist/positions/index.d.ts

@@ -149,6 +149,12 @@ export interface ListPositionsParams {
 }
 export interface ListPositionsResponse {
     positions: Position[];
+    /**
+     * Matching positions. Exact up to 10,000 pages of the requested page size
+     * (`pageSize` x 10,000 rows) and saturates there, so a caller with more
+     * matching positions than the listing can page through reads the cap, not
+     * its lifetime total. `page` is capped at 10,000.
+     */
     total: number;
     page: number;
     pageSize: number;
@@ -304,6 +310,12 @@ export interface PositionHistoryEvent {
 }
 export interface ListPositionHistoryResponse {
     events: PositionHistoryEvent[];
+    /**
+     * Matching position-history events. Exact up to 10,000 pages of the
+     * requested page size (`pageSize` x 10,000 rows) and saturates there, so a
+     * caller with more history than the listing can page through reads the cap,
+     * not its lifetime total. `page` is capped at 10,000.
+     */
     total: number;
     page: number;
     pageSize: number;

package/dist/profile/index.d.ts

@@ -292,14 +292,17 @@ export interface GetUserTradesResponse {
     /** Items per page */
     pageSize: number;
     /**
-     * Total number of trades.
+     * Total matching trades. In page-number mode it is exact up to
+     * `pageSize` × 10,000 rows and saturates there, so a wallet with more history
+     * than legacy mode can page through reads the cap, not its lifetime total.
      *
      * @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 pages at this `pageSize`. Exact up to 10,000 in page-number mode and
+     * saturates there, the last page legacy mode can reach.
      *
      * @deprecated Only populated by legacy page-number (offset) responses; 0 in
      * cursor mode, which has no exact total. Walk `nextPageToken` instead.

package/dist/trading/responses.d.ts

@@ -556,6 +556,12 @@ export interface ConditionalOrder {
 }
 export interface ListConditionalOrdersResponse {
     orders: ConditionalOrder[];
+    /**
+     * Matching conditional orders. Exact up to 10,000 pages of the requested
+     * page size (`pageSize` x 10,000 rows) and saturates there, so a caller with
+     * more matching conditional orders than the listing can page through reads
+     * the cap, not its lifetime total. `page` is capped at 10,000.
+     */
     total: number;
     page: number;
     pageSize: number;
@@ -824,7 +830,12 @@ export interface ListTwapOrdersParams {
  */
 export interface ListTwapOrdersResponse {
     orders: TwapOrder[];
-    /** Total number of TWAP orders matching the filter */
+    /**
+     * Matching TWAP orders. Exact up to 10,000 pages of the requested page size
+     * (`pageSize` x 10,000 rows) and saturates there, so a caller with more
+     * matching TWAP orders than the listing can page through reads the cap, not
+     * its lifetime total. `page` is capped at 10,000.
+     */
     total: number;
     /** Current page number */
     page: number;

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

@@ -18,6 +18,10 @@
  * Perp-only fields (`maxLeverage`, `initialMarginRate`, `maintenanceMarginRate`)
  * are optional and omitted on the wire for spot markets, which have no leverage
  * or margin parameters. All numeric quantities are decimal strings.
+ *
+ * Every frame (snapshot and live) carries `baseIconUrl` and `quoteIconUrl` for
+ * the market's two assets, each `null` when that asset has no icon configured,
+ * so a client can render a position's asset icons from the instrument row alone.
  */
 /**
  * The kind of instrument change a frame reports.
@@ -65,6 +69,20 @@ export interface InstrumentEventData {
     marketType: string;
     /** Asset-class category, e.g. "crypto", "equities", "commodities" */
     category: string;
+    /**
+     * Base asset icon URL, or `null` when the asset has no icon configured.
+     * The server sends this on every market (spot and perp) as an explicit `null`
+     * when absent, unlike the perp-only fields that are omitted — but the property
+     * is declared **optional** so that adding it stays a non-breaking change for
+     * code that constructs or mocks this shape. Never a synthesized URL. Join a
+     * position's `tradingPairId` to this row to render the icon without a REST call.
+     */
+    baseIconUrl?: string | null;
+    /**
+     * Quote asset icon URL, or `null` when the asset has no icon configured. See
+     * {@link InstrumentEventData.baseIconUrl}.
+     */
+    quoteIconUrl?: string | null;
     /** Maximum leverage (decimal string). Perp-only; omitted for spot. */
     maxLeverage?: string;
     /** Initial margin rate (decimal string). Perp-only; omitted for spot. */

package/dist/websocket/events/instrument-events.js

@@ -18,4 +18,8 @@
  * Perp-only fields (`maxLeverage`, `initialMarginRate`, `maintenanceMarginRate`)
  * are optional and omitted on the wire for spot markets, which have no leverage
  * or margin parameters. All numeric quantities are decimal strings.
+ *
+ * Every frame (snapshot and live) carries `baseIconUrl` and `quoteIconUrl` for
+ * the market's two assets, each `null` when that asset has no icon configured,
+ * so a client can render a position's asset icons from the instrument row alone.
  */

package/dist/wire/schema.d.ts

@@ -4624,7 +4624,11 @@ export interface components {
         };
         GetMarginAccountMovementsResponse: {
             movements?: components["schemas"]["MarginAccountMovement"][] | null;
-            /** Format: uint32 */
+            /**
+             * Format: uint32
+             * @description Matching movements. Exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more movements than the listing can page through reads the cap, not its lifetime total.
+             * @example 150
+             */
             total?: number | null;
             /** Format: uint32 */
             page?: number | null;
@@ -5882,13 +5886,13 @@ export interface components {
             pageSize?: string | null;
             /**
              * @deprecated
-             * @description Deprecated: total number of trades (legacy offset mode only; 0 in cursor mode)
+             * @description Deprecated: total matching trades (legacy page-number mode only; 0 in cursor mode). Exact up to pageSize x 10,000 rows and saturates there. Use pageToken cursor pagination instead.
              * @example 150
              */
             total?: string | null;
             /**
              * @deprecated
-             * @description Deprecated: total number of pages (legacy offset mode only; 0 in cursor mode)
+             * @description Deprecated: total pages at this pageSize (legacy page-number mode only; 0 in cursor mode). Exact up to 10,000 and saturates there. Use pageToken cursor pagination instead.
              * @example 8
              */
             totalPages?: string | null;
@@ -6213,7 +6217,11 @@ export interface components {
         };
         ListConditionalOrdersResponse: {
             orders?: components["schemas"]["ConditionalOrder"][] | null;
-            /** Format: uint32 */
+            /**
+             * Format: uint32
+             * @description Matching conditional orders. Exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more matching conditional orders than the listing can page through reads the cap, not its lifetime total.
+             * @example 3
+             */
             total?: number | null;
             /** Format: uint32 */
             page?: number | null;
@@ -6362,7 +6370,11 @@ export interface components {
         };
         ListPositionHistoryResponse: {
             events?: components["schemas"]["PositionHistoryEvent"][] | null;
-            /** Format: uint32 */
+            /**
+             * Format: uint32
+             * @description Matching position-history events. Exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more history than the listing can page through reads the cap, not its lifetime total.
+             * @example 150
+             */
             total?: number | null;
             /** Format: uint32 */
             page?: number | null;
@@ -6371,7 +6383,11 @@ export interface components {
         };
         ListPositionsResponse: {
             positions?: components["schemas"]["Position"][] | null;
-            /** Format: uint32 */
+            /**
+             * Format: uint32
+             * @description Matching positions. Exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more matching positions than the listing can page through reads the cap, not its lifetime total.
+             * @example 150
+             */
             total?: number | null;
             /** Format: uint32 */
             page?: number | null;
@@ -6419,7 +6435,7 @@ export interface components {
             orders?: components["schemas"]["TwapOrder"][] | null;
             /**
              * Format: uint32
-             * @description Total number of TWAP orders matching the filter
+             * @description Matching TWAP orders. Exact up to 10,000 pages of the requested page size (page_size x 10,000 rows) and saturates there, so a caller with more matching TWAP orders than the listing can page through reads the cap, not its lifetime total.
              * @example 3
              */
             total?: number | null;

package/package.json

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