@0xmonaco/core 1.0.62 → 1.0.65

package/dist/api/positions/api.d.ts

@@ -1,12 +1,24 @@
 import type { AttachPositionTpSlRequest, AttachPositionTpSlResponse, BatchCloseAllRequest, BatchCloseAllResponse, ClosePositionRequest, ClosePositionResponse, GetPositionPnlHistoryParams, GetPositionPnlHistoryResponse, GetPositionResponse, ListPositionHistoryParams, ListPositionHistoryResponse, ListPositionsParams, ListPositionsResponse, PositionRisk, PositionsAPI } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class PositionsAPIImpl extends BaseAPI implements PositionsAPI {
+    /**
+     * List the caller's positions with page-number pagination. The response
+     * `total` is bounded by the listing's pagination reach: exact up to
+     * `pageSize` x 10,000 rows and saturating there, so a `page` above 10,000 is
+     * rejected rather than served past the last page `total` can report.
+     */
     listPositions(params?: ListPositionsParams): Promise<ListPositionsResponse>;
     getPosition(positionId: string): Promise<GetPositionResponse>;
     closePosition(positionId: string, request: ClosePositionRequest): Promise<ClosePositionResponse>;
     batchCloseAllPositions(request?: BatchCloseAllRequest): Promise<BatchCloseAllResponse>;
     getPositionRisk(positionId: string): Promise<PositionRisk>;
     attachPositionTpSl(positionId: string, request: AttachPositionTpSlRequest): Promise<AttachPositionTpSlResponse>;
+    /**
+     * List the caller's position-history events with page-number pagination. The
+     * response `total` is bounded by the listing's pagination reach: exact up to
+     * `pageSize` x 10,000 rows and saturating there, so a `page` above 10,000 is
+     * rejected rather than served past the last page `total` can report.
+     */
     listPositionHistory(params?: ListPositionHistoryParams): Promise<ListPositionHistoryResponse>;
     getPositionPnlHistory(positionId: string, params: GetPositionPnlHistoryParams): Promise<GetPositionPnlHistoryResponse>;
 }

package/dist/api/positions/api.js

@@ -2,6 +2,12 @@ import { AttachPositionTpSlSchema, BatchCloseAllSchema, ClosePositionSchema, Get
 import { BaseAPI } from "../base";
 import { perpRoutes } from "../perp";
 export class PositionsAPIImpl extends BaseAPI {
+    /**
+     * List the caller's positions with page-number pagination. The response
+     * `total` is bounded by the listing's pagination reach: exact up to
+     * `pageSize` x 10,000 rows and saturating there, so a `page` above 10,000 is
+     * rejected rather than served past the last page `total` can report.
+     */
     async listPositions(params) {
         if (params) {
             validate(ListPositionsSchema, params);
@@ -73,6 +79,12 @@ export class PositionsAPIImpl extends BaseAPI {
             }),
         });
     }
+    /**
+     * List the caller's position-history events with page-number pagination. The
+     * response `total` is bounded by the listing's pagination reach: exact up to
+     * `pageSize` x 10,000 rows and saturating there, so a `page` above 10,000 is
+     * rejected rather than served past the last page `total` can report.
+     */
     async listPositionHistory(params) {
         if (params) {
             validate(ListPositionHistorySchema, params);

package/dist/api/profile/api.d.ts

@@ -176,9 +176,10 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      *
      * @param params - Optional query parameters for pagination and filtering
      * @param params.page - Deprecated: page number for legacy offset pagination (starts
-     * from 1). Passing it selects legacy page-number mode, which only sees recent (hot)
-     * history and populates `total`/`totalPages`. Use cursor pagination (`pageToken`)
-     * instead.
+     * from 1, at most 10,000). Passing it selects legacy page-number mode, which only sees
+     * recent (hot) history and populates `total`/`totalPages` — bounded at the pagination
+     * reach (`total` saturates at `pageSize` × 10,000 rows, `totalPages` at 10,000 pages).
+     * Use cursor pagination (`pageToken`) instead.
      * @param params.pageSize - Number of items per page (default: 20; max 100
      * in page-number mode, up to 1000 when pageToken is present)
      * @param params.tradingPairId - Filter by trading pair ID (UUID)

package/dist/api/profile/api.js

@@ -227,9 +227,10 @@ export class ProfileAPIImpl extends BaseAPI {
      *
      * @param params - Optional query parameters for pagination and filtering
      * @param params.page - Deprecated: page number for legacy offset pagination (starts
-     * from 1). Passing it selects legacy page-number mode, which only sees recent (hot)
-     * history and populates `total`/`totalPages`. Use cursor pagination (`pageToken`)
-     * instead.
+     * from 1, at most 10,000). Passing it selects legacy page-number mode, which only sees
+     * recent (hot) history and populates `total`/`totalPages` — bounded at the pagination
+     * reach (`total` saturates at `pageSize` × 10,000 rows, `totalPages` at 10,000 pages).
+     * Use cursor pagination (`pageToken`) instead.
      * @param params.pageSize - Number of items per page (default: 20; max 100
      * in page-number mode, up to 1000 when pageToken is present)
      * @param params.tradingPairId - Filter by trading pair ID (UUID)

package/dist/api/trading/api.d.ts

@@ -184,6 +184,19 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
     }): Promise<CancelOrderResponse>;
     cancelConditionalOrder(conditionalOrderId: string): Promise<CancelConditionalOrderResponse>;
     getConditionalOrder(conditionalOrderId: string): Promise<ConditionalOrder>;
+    /**
+     * Lists conditional orders for the authenticated user.
+     *
+     * The response `total` is bounded by the listing's pagination reach: exact up
+     * to `pageSize` x 10,000 rows and saturating there, so a caller with more
+     * matching conditional orders than page-number mode can page through reads the
+     * cap, not its lifetime total; `page` is capped at 10,000 and a larger page is
+     * rejected.
+     *
+     * @param params - Optional pagination and margin-account / trading-pair / state filters
+     * @returns Promise resolving to ListConditionalOrdersResponse with orders and pagination info
+     * @throws {APIError} When API communication fails
+     */
     listConditionalOrders(params?: ListConditionalOrdersParams): Promise<ListConditionalOrdersResponse>;
     /**
      * Batch cancels specific orders by their IDs.
@@ -302,16 +315,18 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * working set.
      * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
      * pagination: it starts a cursor walk from the newest (or oldest, for
-     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Cursor
-     * responses carry no exact totals (`total`/`page`/`totalPages` are 0).
+     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Both modes
+     * populate `total`/`totalPages` (bounded by the server count ceiling — see
+     * `totalCapped`); only `page` is 0 in cursor mode.
      *
      * @param params - Query parameters for filtering orders
      * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED"), or by
      * any of several statuses at once by passing an array (e.g., ["SUBMITTED", "PARTIALLY_FILLED"]) (optional)
      * @param params.tradingPairId - Filter by trading pair UUID (optional)
      * @param params.page - Deprecated: page number for legacy offset pagination (must be > 0).
-     * Passing it selects legacy page-number mode, which only sees recent (hot) history and
-     * populates `total`/`totalPages`. Use cursor pagination (`pageToken`) instead.
+     * Passing it selects legacy page-number mode, which only sees recent (hot) history. Both
+     * modes populate `total`/`totalPages` (bounded — see `totalCapped`); use cursor
+     * pagination (`pageToken`) instead for full history.
      * @param params.pageSize - Number of orders per page (defaults to 10, must be > 0; max 100
      * in page-number mode, up to 1000 when pageToken is present)
      * @param params.pageToken - Pagination cursor: pass `""` to start a cursor walk from
@@ -503,6 +518,12 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
     /**
      * Lists TWAP parent orders for the authenticated user.
      *
+     * The response `total` is bounded by the listing's pagination reach: exact up
+     * to `pageSize` x 10,000 rows and saturating there, so a caller with more
+     * matching TWAP orders than page-number mode can page through reads the cap,
+     * not its lifetime total; `page` is capped at 10,000 and a larger page is
+     * rejected.
+     *
      * @param params - Optional pagination and state / trading-pair filters
      * @returns Promise resolving to ListTwapOrdersResponse with orders and pagination info
      * @throws {APIError} When API communication fails

package/dist/api/trading/api.js

@@ -258,6 +258,19 @@ export class TradingAPIImpl extends BaseAPI {
             method: "GET",
         });
     }
+    /**
+     * Lists conditional orders for the authenticated user.
+     *
+     * The response `total` is bounded by the listing's pagination reach: exact up
+     * to `pageSize` x 10,000 rows and saturating there, so a caller with more
+     * matching conditional orders than page-number mode can page through reads the
+     * cap, not its lifetime total; `page` is capped at 10,000 and a larger page is
+     * rejected.
+     *
+     * @param params - Optional pagination and margin-account / trading-pair / state filters
+     * @returns Promise resolving to ListConditionalOrdersResponse with orders and pagination info
+     * @throws {APIError} When API communication fails
+     */
     async listConditionalOrders(params) {
         if (params) {
             validate(ListConditionalOrdersSchema, params);
@@ -468,16 +481,18 @@ export class TradingAPIImpl extends BaseAPI {
      * working set.
      * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
      * pagination: it starts a cursor walk from the newest (or oldest, for
-     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Cursor
-     * responses carry no exact totals (`total`/`page`/`totalPages` are 0).
+     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Both modes
+     * populate `total`/`totalPages` (bounded by the server count ceiling — see
+     * `totalCapped`); only `page` is 0 in cursor mode.
      *
      * @param params - Query parameters for filtering orders
      * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED"), or by
      * any of several statuses at once by passing an array (e.g., ["SUBMITTED", "PARTIALLY_FILLED"]) (optional)
      * @param params.tradingPairId - Filter by trading pair UUID (optional)
      * @param params.page - Deprecated: page number for legacy offset pagination (must be > 0).
-     * Passing it selects legacy page-number mode, which only sees recent (hot) history and
-     * populates `total`/`totalPages`. Use cursor pagination (`pageToken`) instead.
+     * Passing it selects legacy page-number mode, which only sees recent (hot) history. Both
+     * modes populate `total`/`totalPages` (bounded — see `totalCapped`); use cursor
+     * pagination (`pageToken`) instead for full history.
      * @param params.pageSize - Number of orders per page (defaults to 10, must be > 0; max 100
      * in page-number mode, up to 1000 when pageToken is present)
      * @param params.pageToken - Pagination cursor: pass `""` to start a cursor walk from
@@ -791,6 +806,12 @@ export class TradingAPIImpl extends BaseAPI {
     /**
      * Lists TWAP parent orders for the authenticated user.
      *
+     * The response `total` is bounded by the listing's pagination reach: exact up
+     * to `pageSize` x 10,000 rows and saturating there, so a caller with more
+     * matching TWAP orders than page-number mode can page through reads the cap,
+     * not its lifetime total; `page` is capped at 10,000 and a larger page is
+     * rejected.
+     *
      * @param params - Optional pagination and state / trading-pair filters
      * @returns Promise resolving to ListTwapOrdersResponse with orders and pagination info
      * @throws {APIError} When API communication fails

package/dist/api/websocket/websocket.js

@@ -416,6 +416,15 @@ function parseInstrumentEventData(raw) {
         maxOrderSize: readString(data, "maxOrderSize"),
         marketType: readString(data, "marketType"),
         category: readString(data, "category"),
+        // Present-as-null on the wire: the server always sends both keys, carrying an
+        // explicit `null` when an asset has no icon. Read tolerantly — a missing key
+        // maps to `null` rather than dropping the frame — because the instrument
+        // channel must never drop a frame (a dropped frame can hide a market going
+        // inactive, 0XM-2628), and a cosmetic icon is safe to treat as absent. Unlike
+        // `readNullableString`, this does not reject a missing key; a present
+        // non-string value still throws.
+        baseIconUrl: readOptionalString(data, "baseIconUrl") ?? null,
+        quoteIconUrl: readOptionalString(data, "quoteIconUrl") ?? null,
         maxLeverage: readOptionalString(data, "maxLeverage"),
         initialMarginRate: readOptionalString(data, "initialMarginRate"),
         maintenanceMarginRate: readOptionalString(data, "maintenanceMarginRate"),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.62",
+	"version": "1.0.65",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -19,8 +19,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.62",
-		"@0xmonaco/types": "1.0.62",
+		"@0xmonaco/contracts": "1.0.65",
+		"@0xmonaco/types": "1.0.65",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"