@0xmonaco/core 1.0.26 → 1.0.28

package/dist/api/fees/api.d.ts

@@ -36,7 +36,7 @@ export declare class FeesAPIImpl extends BaseAPI implements FeesAPI {
      * @param params.price - The price per unit as string
      * @param params.quantity - The quantity to trade as string
      * @param params.orderType - Order type: "LIMIT" (default) or "MARKET"
-     * @param params.slippageToleranceBps - Slippage tolerance in bps (0–1000, MARKET only, default 500)
+     * @param params.slippageToleranceBps - Slippage tolerance in bps (0–1000, MARKET only, default 1000)
      * @returns Promise resolving to SimulateFeeResponse with fee breakdown
      *
      * @example

package/dist/api/fees/api.js

@@ -36,7 +36,7 @@ export class FeesAPIImpl extends BaseAPI {
      * @param params.price - The price per unit as string
      * @param params.quantity - The quantity to trade as string
      * @param params.orderType - Order type: "LIMIT" (default) or "MARKET"
-     * @param params.slippageToleranceBps - Slippage tolerance in bps (0–1000, MARKET only, default 500)
+     * @param params.slippageToleranceBps - Slippage tolerance in bps (0–1000, MARKET only, default 1000)
      * @returns Promise resolving to SimulateFeeResponse with fee breakdown
      *
      * @example

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

@@ -173,6 +173,11 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * @param params.page - Page number (starts from 1, default: 1)
      * @param params.pageSize - Number of items per page (default: 20, max: 100)
      * @param params.tradingPairId - Filter by trading pair ID (UUID)
+     * @param params.pageToken - Pagination cursor (optional): omit for legacy page-number
+     * pagination; pass `""` to start a cursor walk from the newest row; pass a previous
+     * response's `nextPageToken` to resume. Any cursor-walk value (`""` or non-empty)
+     * ignores `page` and covers full trade history (hot and archived rows merged), unlike
+     * page-number mode.
      * @returns Promise resolving to paginated trades response
      * @throws {ValidationError} When the provided params fail client-side validation
      * @throws {APIError} When the request fails or user is not authenticated

package/dist/api/profile/api.js

@@ -224,6 +224,11 @@ export class ProfileAPIImpl extends BaseAPI {
      * @param params.page - Page number (starts from 1, default: 1)
      * @param params.pageSize - Number of items per page (default: 20, max: 100)
      * @param params.tradingPairId - Filter by trading pair ID (UUID)
+     * @param params.pageToken - Pagination cursor (optional): omit for legacy page-number
+     * pagination; pass `""` to start a cursor walk from the newest row; pass a previous
+     * response's `nextPageToken` to resume. Any cursor-walk value (`""` or non-empty)
+     * ignores `page` and covers full trade history (hot and archived rows merged), unlike
+     * page-number mode.
      * @returns Promise resolving to paginated trades response
      * @throws {ValidationError} When the provided params fail client-side validation
      * @throws {APIError} When the request fails or user is not authenticated
@@ -252,6 +257,9 @@ export class ProfileAPIImpl extends BaseAPI {
         if (params?.tradingPairId !== undefined) {
             searchParams.append("tradingPairId", params.tradingPairId);
         }
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
         const queryString = searchParams.toString();
         const url = queryString ? `/api/v1/accounts/trades?${queryString}` : "/api/v1/accounts/trades";
         return await this.makeAuthenticatedRequest(url);

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

@@ -93,15 +93,17 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
     /**
      * Places a market order for immediate execution.
      *
-     * Market orders execute immediately at the current market price. They provide
-     * immediate execution but may experience slippage.
+     * Market orders execute immediately against available liquidity, inside a
+     * mandatory 1,000 bps server-side protective price band. Fills beyond the band
+     * are cut off, so an order may partially fill and cancel the remainder, or be
+     * rejected when no liquidity sits inside the band.
      *
      * @param tradingPairId - The trading pair UUID
      * @param side - The order side ("BUY" or "SELL")
      * @param quantity - The order quantity as string
      * @param options - Optional parameters for the market order
      * @param options.tradingMode - Trading mode (e.g., "SPOT")
-     * @param options.slippageTolerance - Slippage tolerance as decimal (e.g., 0.01 for 1%, 0 for best price only, undefined for unlimited slippage)
+     * @param options.slippageTolerance - Tightens the mandatory 1,000 bps price band, as a decimal (e.g., 0.01 for 1%; 0 for best price only). It can only tighten the band, never widen it; omitting it applies the full 1,000 bps band.
      * @returns Promise resolving to CreateOrderResponse with order details
      *
      * @example
@@ -122,12 +124,12 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      *   { slippageTolerance: 0 } // Only execute at best ask price
      * );
      *
-     * // Market order with unlimited slippage
+     * // Market order with the default protective band (no client tightening)
      * const order3 = await tradingAPI.placeMarketOrder(
      *   "123e4567-e89b-12d3-a456-426614174000",
      *   "BUY",
      *   "1.0"
-     *   // No slippageTolerance specified = unlimited slippage
+     *   // No slippageTolerance specified = full 1,000 bps band applies
      * );
      * ```
      */
@@ -268,6 +270,11 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * @param params.tradingPairId - Filter by trading pair UUID (optional)
      * @param params.page - Page number for pagination (defaults to 1, must be > 0)
      * @param params.pageSize - Number of orders per page (defaults to 10, max 100, must be > 0)
+     * @param params.pageToken - Pagination cursor (optional): omit for legacy page-number
+     * pagination; pass `""` to start a cursor walk from the newest (or oldest, for
+     * `orderBy: "ASC"`) row; pass a previous response's `nextPageToken` to resume. Any
+     * cursor-walk value (`""` or non-empty) ignores `page` and covers full order history
+     * (hot and archived rows merged), unlike page-number mode.
      * @returns Promise resolving to GetPaginatedOrdersResponse with orders and pagination info
      * @throws {APIError} When API communication fails
      *

package/dist/api/trading/api.js

@@ -125,15 +125,17 @@ export class TradingAPIImpl extends BaseAPI {
     /**
      * Places a market order for immediate execution.
      *
-     * Market orders execute immediately at the current market price. They provide
-     * immediate execution but may experience slippage.
+     * Market orders execute immediately against available liquidity, inside a
+     * mandatory 1,000 bps server-side protective price band. Fills beyond the band
+     * are cut off, so an order may partially fill and cancel the remainder, or be
+     * rejected when no liquidity sits inside the band.
      *
      * @param tradingPairId - The trading pair UUID
      * @param side - The order side ("BUY" or "SELL")
      * @param quantity - The order quantity as string
      * @param options - Optional parameters for the market order
      * @param options.tradingMode - Trading mode (e.g., "SPOT")
-     * @param options.slippageTolerance - Slippage tolerance as decimal (e.g., 0.01 for 1%, 0 for best price only, undefined for unlimited slippage)
+     * @param options.slippageTolerance - Tightens the mandatory 1,000 bps price band, as a decimal (e.g., 0.01 for 1%; 0 for best price only). It can only tighten the band, never widen it; omitting it applies the full 1,000 bps band.
      * @returns Promise resolving to CreateOrderResponse with order details
      *
      * @example
@@ -154,12 +156,12 @@ export class TradingAPIImpl extends BaseAPI {
      *   { slippageTolerance: 0 } // Only execute at best ask price
      * );
      *
-     * // Market order with unlimited slippage
+     * // Market order with the default protective band (no client tightening)
      * const order3 = await tradingAPI.placeMarketOrder(
      *   "123e4567-e89b-12d3-a456-426614174000",
      *   "BUY",
      *   "1.0"
-     *   // No slippageTolerance specified = unlimited slippage
+     *   // No slippageTolerance specified = full 1,000 bps band applies
      * );
      * ```
      */
@@ -417,6 +419,11 @@ export class TradingAPIImpl extends BaseAPI {
      * @param params.tradingPairId - Filter by trading pair UUID (optional)
      * @param params.page - Page number for pagination (defaults to 1, must be > 0)
      * @param params.pageSize - Number of orders per page (defaults to 10, max 100, must be > 0)
+     * @param params.pageToken - Pagination cursor (optional): omit for legacy page-number
+     * pagination; pass `""` to start a cursor walk from the newest (or oldest, for
+     * `orderBy: "ASC"`) row; pass a previous response's `nextPageToken` to resume. Any
+     * cursor-walk value (`""` or non-empty) ignores `page` and covers full order history
+     * (hot and archived rows merged), unlike page-number mode.
      * @returns Promise resolving to GetPaginatedOrdersResponse with orders and pagination info
      * @throws {APIError} When API communication fails
      *
@@ -441,7 +448,7 @@ export class TradingAPIImpl extends BaseAPI {
             validate(GetPaginatedOrdersSchema, params);
         }
         // Set pagination defaults with destructuring and validation
-        const { page = 1, pageSize: requestedPageSize = 10, status, tradingPairId, tradingMode, marginAccountId } = params || {};
+        const { page = 1, pageSize: requestedPageSize = 10, status, tradingPairId, tradingMode, marginAccountId, pageToken } = params || {};
         const validPage = page > 0 ? page : 1;
         const validPageSize = requestedPageSize > 0 ? requestedPageSize : 10;
         const pageSize = Math.min(validPageSize, 100);
@@ -461,6 +468,13 @@ export class TradingAPIImpl extends BaseAPI {
         if (marginAccountId) {
             searchParams.append("marginAccountId", marginAccountId);
         }
+        // `!== undefined` (not a truthy check): an explicitly-provided empty
+        // string is the documented way to start a cursor walk (distinct from
+        // omitting `pageToken` entirely), so it must still be sent rather than
+        // silently dropped like a falsy value would be.
+        if (pageToken !== undefined) {
+            searchParams.append("pageToken", pageToken);
+        }
         const endpoint = `/api/v1/orders?${searchParams.toString()}`;
         return await this.makeAuthenticatedRequest(endpoint, {
             method: "GET",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.26",
+	"version": "1.0.28",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -23,8 +23,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.26",
-		"@0xmonaco/types": "1.0.26",
+		"@0xmonaco/contracts": "1.0.28",
+		"@0xmonaco/types": "1.0.28",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"