@0xmonaco/core 1.0.28 → 1.0.31

package/dist/api/index.d.ts

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

package/dist/api/index.js

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

package/dist/api/market/api.d.ts

@@ -1,4 +1,4 @@
-import type { Candlestick, FundingState, GetCandlesticksParams, GetScreenerParams, GetScreenerResponse, GetTradingPairsParams, GetTradingPairsResponse, IndexPrice, Interval, ListFundingHistoryParams, ListFundingHistoryResponse, MarketAPI, MarketMetadata, MarketStats, MarkPrice, OpenInterest, PerpMarketConfig, PerpMarketSummary, TradingMode, TradingPair } from "@0xmonaco/types";
+import type { Candlestick, FundingState, GetCandlesticksParams, GetScreenerParams, GetScreenerResponse, GetTradingPairsParams, GetTradingPairsResponse, IndexPrice, Interval, ListAllFundingHistoryParams, ListAllFundingHistoryResponse, ListFundingHistoryParams, ListFundingHistoryResponse, MarketAPI, MarketMetadata, MarketStats, MarkPrice, OpenInterest, PerpMarketConfig, PerpMarketSummary, TradingMode, TradingPair } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 /**
  * Market API Implementation
@@ -17,6 +17,7 @@ export declare class MarketAPIImpl extends BaseAPI implements MarketAPI {
     getIndexPrice(tradingPairId: string): Promise<IndexPrice>;
     getFundingState(tradingPairId: string): Promise<FundingState>;
     listFundingHistory(tradingPairId: string, params?: ListFundingHistoryParams): Promise<ListFundingHistoryResponse>;
+    listAllFundingHistory(params?: ListAllFundingHistoryParams): Promise<ListAllFundingHistoryResponse>;
     getOpenInterest(tradingPairId: string): Promise<OpenInterest>;
     getScreener(params?: GetScreenerParams): Promise<GetScreenerResponse>;
     getMarketStats(): Promise<MarketStats>;

package/dist/api/market/api.js

@@ -100,6 +100,9 @@ export class MarketAPIImpl extends BaseAPI {
         validate(GetMarketMetadataSchema, { tradingPairId });
         return await this.makePublicRequest(perpRoutes.market.listFundingHistory(tradingPairId, params));
     }
+    async listAllFundingHistory(params) {
+        return await this.makePublicRequest(perpRoutes.market.listAllFundingHistory(params));
+    }
     async getOpenInterest(tradingPairId) {
         validate(GetMarketMetadataSchema, { tradingPairId });
         return await this.makePublicRequest(perpRoutes.market.getOpenInterest(tradingPairId));

package/dist/api/perp/routes.d.ts

@@ -67,6 +67,14 @@ export declare const perpRoutes: {
             endTime?: string;
             page?: number;
             pageSize?: number;
+            orderBy?: string;
+        }) => string;
+        readonly listAllFundingHistory: (params?: {
+            startTime?: string;
+            endTime?: string;
+            page?: number;
+            pageSize?: number;
+            orderBy?: string;
         }) => string;
         readonly getOpenInterest: (tradingPairId: string) => string;
         readonly getScreener: (params?: {

package/dist/api/perp/routes.js

@@ -52,6 +52,7 @@ export const perpRoutes = {
         getIndexPrice: (tradingPairId) => `${API_V1}/market/pairs/${encodeSegment(tradingPairId)}/index-price`,
         getFundingState: (tradingPairId) => `${API_V1}/market/pairs/${encodeSegment(tradingPairId)}/funding`,
         listFundingHistory: (tradingPairId, params) => withQuery(`${API_V1}/market/pairs/${encodeSegment(tradingPairId)}/funding/history`, params),
+        listAllFundingHistory: (params) => withQuery(`${API_V1}/market/funding/history`, params),
         getOpenInterest: (tradingPairId) => `${API_V1}/market/pairs/${encodeSegment(tradingPairId)}/open-interest`,
         getScreener: (params) => withQuery(`${API_V1}/market/screener`, params),
         getMarketStats: () => `${API_V1}/market/stats`,

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

@@ -169,30 +169,65 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * Fetches the user's executed trades from the /api/v1/accounts/trades endpoint.
      * Requires a valid access token to be set.
      *
+     * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
+     * pagination: it starts a cursor walk from the newest row and the response's
+     * `nextPageToken` resumes it. Cursor responses carry no exact totals
+     * (`total`/`page`/`totalPages` are 0).
+     *
      * @param params - Optional query parameters for pagination and filtering
-     * @param params.page - Page number (starts from 1, default: 1)
-     * @param params.pageSize - Number of items per page (default: 20, max: 100)
+     * @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.
+     * @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)
-     * @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.
+     * @param params.pageToken - Pagination cursor: 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. Omitting both `page` and
+     * `pageToken` starts a cursor walk (`pageToken=""`).
      * @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
      *
      * @example
      * ```typescript
-     * // Get first page of trades
-     * const trades = await profileAPI.getUserTrades();
-     * console.log(`Total trades: ${trades.total}`);
+     * // Walk full trade history with cursor pagination (the default mode)
+     * let pageToken: string | undefined;
+     * do {
+     *   const res = await profileAPI.getUserTrades({ pageToken });
+     *   handle(res.trades);
+     *   pageToken = res.nextPageToken;
+     * } while (pageToken);
      *
      * // Filter by trading pair
      * const pairTrades = await profileAPI.getUserTrades({ tradingPairId: "550e8400-e29b-41d4-a716-446655440000" });
      * ```
      */
     getUserTrades(params?: GetUserTradesParams): Promise<GetUserTradesResponse>;
+    /**
+     * Walks the user's full trade history with cursor pagination, yielding one
+     * trade at a time.
+     *
+     * Starts a cursor walk (`pageToken: ""`) and follows each response's
+     * `nextPageToken` until the server proves exhaustion (a page with zero rows
+     * and an empty token). Covers full trade history — hot and archived rows
+     * merged — unlike the deprecated page-number mode.
+     *
+     * @param params - Optional filters and page size; `page`/`pageToken` are
+     * managed by the iterator and cannot be passed.
+     * @returns Async generator yielding trades newest-first
+     * @throws {APIError} When any underlying request fails
+     *
+     * @example
+     * ```typescript
+     * for await (const trade of profileAPI.iterateUserTrades()) {
+     *   console.log(trade.tradeId);
+     * }
+     * ```
+     */
+    iterateUserTrades(params?: Omit<GetUserTradesParams, "page" | "pageToken">): AsyncGenerator<GetUserTradesResponse["trades"][number], void, undefined>;
     /**
      * List the current user's funding payment history with pagination and filters.
      *

package/dist/api/profile/api.js

@@ -220,24 +220,37 @@ export class ProfileAPIImpl extends BaseAPI {
      * Fetches the user's executed trades from the /api/v1/accounts/trades endpoint.
      * Requires a valid access token to be set.
      *
+     * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
+     * pagination: it starts a cursor walk from the newest row and the response's
+     * `nextPageToken` resumes it. Cursor responses carry no exact totals
+     * (`total`/`page`/`totalPages` are 0).
+     *
      * @param params - Optional query parameters for pagination and filtering
-     * @param params.page - Page number (starts from 1, default: 1)
-     * @param params.pageSize - Number of items per page (default: 20, max: 100)
+     * @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.
+     * @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)
-     * @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.
+     * @param params.pageToken - Pagination cursor: 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. Omitting both `page` and
+     * `pageToken` starts a cursor walk (`pageToken=""`).
      * @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
      *
      * @example
      * ```typescript
-     * // Get first page of trades
-     * const trades = await profileAPI.getUserTrades();
-     * console.log(`Total trades: ${trades.total}`);
+     * // Walk full trade history with cursor pagination (the default mode)
+     * let pageToken: string | undefined;
+     * do {
+     *   const res = await profileAPI.getUserTrades({ pageToken });
+     *   handle(res.trades);
+     *   pageToken = res.nextPageToken;
+     * } while (pageToken);
      *
      * // Filter by trading pair
      * const pairTrades = await profileAPI.getUserTrades({ tradingPairId: "550e8400-e29b-41d4-a716-446655440000" });
@@ -247,8 +260,11 @@ export class ProfileAPIImpl extends BaseAPI {
         if (params) {
             validate(GetUserTradesSchema, params);
         }
+        // Legacy offset mode only when the caller explicitly asked for a page and
+        // no cursor was given; everything else drives cursor (pageToken) mode.
+        const legacyOffsetMode = params?.page !== undefined && params?.pageToken === undefined;
         const searchParams = new URLSearchParams();
-        if (params?.page !== undefined) {
+        if (legacyOffsetMode && params?.page !== undefined) {
             searchParams.append("page", params.page.toString());
         }
         if (params?.pageSize !== undefined) {
@@ -257,13 +273,53 @@ export class ProfileAPIImpl extends BaseAPI {
         if (params?.tradingPairId !== undefined) {
             searchParams.append("tradingPairId", params.tradingPairId);
         }
-        if (params?.pageToken !== undefined) {
-            searchParams.append("pageToken", params.pageToken);
+        // Cursor mode selects itself by the *presence* of `pageToken` on the wire,
+        // even when it is the empty string (the documented way to start a walk),
+        // so it must be sent explicitly rather than dropped like a falsy value.
+        // When the caller gave neither `page` nor `pageToken`, default to starting
+        // a cursor walk (`pageToken=""`).
+        if (!legacyOffsetMode) {
+            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);
     }
+    /**
+     * Walks the user's full trade history with cursor pagination, yielding one
+     * trade at a time.
+     *
+     * Starts a cursor walk (`pageToken: ""`) and follows each response's
+     * `nextPageToken` until the server proves exhaustion (a page with zero rows
+     * and an empty token). Covers full trade history — hot and archived rows
+     * merged — unlike the deprecated page-number mode.
+     *
+     * @param params - Optional filters and page size; `page`/`pageToken` are
+     * managed by the iterator and cannot be passed.
+     * @returns Async generator yielding trades newest-first
+     * @throws {APIError} When any underlying request fails
+     *
+     * @example
+     * ```typescript
+     * for await (const trade of profileAPI.iterateUserTrades()) {
+     *   console.log(trade.tradeId);
+     * }
+     * ```
+     */
+    async *iterateUserTrades(params) {
+        let pageToken = "";
+        // A non-empty token never guarantees further results (AIP-158 "maybe
+        // more"): keep following it until a response returns zero rows and an
+        // empty token, the sole proof the walk is exhausted.
+        for (;;) {
+            const response = await this.getUserTrades({ ...params, pageToken });
+            yield* response.trades;
+            if (!response.nextPageToken) {
+                return;
+            }
+            pageToken = response.nextPageToken;
+        }
+    }
     /**
      * List the current user's funding payment history with pagination and filters.
      *

package/dist/api/pulse/api.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pulse API Implementation
+ *
+ * Read-only access to the market-pulse news feed: AI-synthesized, per-asset
+ * headlines with sentiment tags, served from the backend's hourly-refreshed
+ * cache. Public — no authentication required.
+ *
+ * @example
+ * ```typescript
+ * const pulse = await sdk.pulse.getPulse();
+ * for (const item of pulse.items) {
+ *   console.log(`[${item.sentiment}] ${item.asset}: ${item.summary}`);
+ * }
+ * ```
+ */
+import type { GetPulseResponse, PulseAPI } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export declare class PulseAPIImpl extends BaseAPI implements PulseAPI {
+    /**
+     * Get the latest market pulse snapshot (public, no auth headers).
+     * Returns 503 while the backend cache is cold.
+     */
+    getPulse(): Promise<GetPulseResponse>;
+}

package/dist/api/pulse/api.js

@@ -0,0 +1,27 @@
+/**
+ * Pulse API Implementation
+ *
+ * Read-only access to the market-pulse news feed: AI-synthesized, per-asset
+ * headlines with sentiment tags, served from the backend's hourly-refreshed
+ * cache. Public — no authentication required.
+ *
+ * @example
+ * ```typescript
+ * const pulse = await sdk.pulse.getPulse();
+ * for (const item of pulse.items) {
+ *   console.log(`[${item.sentiment}] ${item.asset}: ${item.summary}`);
+ * }
+ * ```
+ */
+import { BaseAPI } from "../base";
+export class PulseAPIImpl extends BaseAPI {
+    /**
+     * Get the latest market pulse snapshot (public, no auth headers).
+     * Returns 503 while the backend cache is cold.
+     */
+    async getPulse() {
+        return await this.makePublicRequest("/api/v1/pulse", {
+            method: "GET",
+        });
+    }
+}

package/dist/api/pulse/index.d.ts

@@ -0,0 +1 @@
+export { PulseAPIImpl } from "./api";

package/dist/api/pulse/index.js

@@ -0,0 +1 @@
+export { PulseAPIImpl } from "./api";

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

@@ -260,40 +260,66 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      */
     batchReplace(orders: BatchReplaceOrderParams[]): Promise<BatchReplaceOrdersResponse>;
     /**
-     * Gets paginated orders based on query parameters with automatic pagination.
+     * Gets orders based on query parameters, cursor-paginated by default.
      *
      * Retrieves orders with optional filtering by status, trading pair, and pagination.
-     * Pagination parameters are always included with sensible defaults for consistent API behavior.
+     * 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).
      *
      * @param params - Query parameters for filtering orders
-     * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED") (optional)
+     * @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 - 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.
+     * @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.
+     * @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
+     * 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. Omitting both `page` and `pageToken` starts a cursor walk (`pageToken=""`).
      * @returns Promise resolving to GetPaginatedOrdersResponse with orders and pagination info
      * @throws {APIError} When API communication fails
      *
      * @example
      * ```typescript
-     * // Get submitted orders for a specific trading pair with custom pagination
-     * const orders = await tradingAPI.getPaginatedOrders({
-     *   status: "SUBMITTED",
-     *   tradingPairId: "456e7890-e12b-12d3-a456-426614174000",
-     *   page: 1,
-     *   pageSize: 20
-     * });
-     * console.log(`Found ${orders.total} orders, showing page ${orders.page}`);
-     *
-     * // Get all orders with default pagination (page=1, pageSize=10)
-     * const allOrders = await tradingAPI.getPaginatedOrders();
+     * // Walk full order history with cursor pagination (the default mode)
+     * let pageToken: string | undefined;
+     * do {
+     *   const res = await tradingAPI.getPaginatedOrders({ status: "FILLED", pageToken });
+     *   handle(res.orders);
+     *   pageToken = res.nextPageToken;
+     * } while (pageToken);
      * ```
      */
     getPaginatedOrders(params?: GetPaginatedOrdersParams): Promise<GetPaginatedOrdersResponse>;
+    /**
+     * Walks the user's full order history with cursor pagination, yielding one
+     * order at a time.
+     *
+     * Starts a cursor walk (`pageToken: ""`) and follows each response's
+     * `nextPageToken` until the server proves exhaustion (a page with zero rows
+     * and an empty token). Covers full order history — hot and archived rows
+     * merged — unlike the deprecated page-number mode.
+     *
+     * @param params - Optional filters and page size; `page`/`pageToken` are
+     * managed by the iterator and cannot be passed.
+     * @returns Async generator yielding orders newest-first (or oldest-first for
+     * `orderBy: "ASC"`)
+     * @throws {APIError} When any underlying request fails
+     *
+     * @example
+     * ```typescript
+     * for await (const order of tradingAPI.iterateOrders({ status: "FILLED" })) {
+     *   console.log(order.id);
+     * }
+     * ```
+     */
+    iterateOrders(params?: Omit<GetPaginatedOrdersParams, "page" | "pageToken">): AsyncGenerator<GetPaginatedOrdersResponse["orders"][number], void, undefined>;
     /**
      * Gets a single order by its ID.
      *

package/dist/api/trading/api.js

@@ -409,37 +409,40 @@ export class TradingAPIImpl extends BaseAPI {
         });
     }
     /**
-     * Gets paginated orders based on query parameters with automatic pagination.
+     * Gets orders based on query parameters, cursor-paginated by default.
      *
      * Retrieves orders with optional filtering by status, trading pair, and pagination.
-     * Pagination parameters are always included with sensible defaults for consistent API behavior.
+     * 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).
      *
      * @param params - Query parameters for filtering orders
-     * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED") (optional)
+     * @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 - 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.
+     * @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.
+     * @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
+     * 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. Omitting both `page` and `pageToken` starts a cursor walk (`pageToken=""`).
      * @returns Promise resolving to GetPaginatedOrdersResponse with orders and pagination info
      * @throws {APIError} When API communication fails
      *
      * @example
      * ```typescript
-     * // Get submitted orders for a specific trading pair with custom pagination
-     * const orders = await tradingAPI.getPaginatedOrders({
-     *   status: "SUBMITTED",
-     *   tradingPairId: "456e7890-e12b-12d3-a456-426614174000",
-     *   page: 1,
-     *   pageSize: 20
-     * });
-     * console.log(`Found ${orders.total} orders, showing page ${orders.page}`);
-     *
-     * // Get all orders with default pagination (page=1, pageSize=10)
-     * const allOrders = await tradingAPI.getPaginatedOrders();
+     * // Walk full order history with cursor pagination (the default mode)
+     * let pageToken: string | undefined;
+     * do {
+     *   const res = await tradingAPI.getPaginatedOrders({ status: "FILLED", pageToken });
+     *   handle(res.orders);
+     *   pageToken = res.nextPageToken;
+     * } while (pageToken);
      * ```
      */
     async getPaginatedOrders(params) {
@@ -448,16 +451,25 @@ 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, pageToken } = params || {};
-        const validPage = page > 0 ? page : 1;
+        const { page, pageSize: requestedPageSize = 10, status, tradingPairId, tradingMode, marginAccountId, pageToken } = params || {};
         const validPageSize = requestedPageSize > 0 ? requestedPageSize : 10;
-        const pageSize = Math.min(validPageSize, 100);
+        // Legacy offset mode only when the caller explicitly asked for a page and
+        // no cursor was given; everything else drives cursor (pageToken) mode.
+        const legacyOffsetMode = page !== undefined && pageToken === undefined;
+        // Cursor requests may use pages up to 1000 (keyset reads); page-number
+        // requests keep the server's 100 cap.
+        const pageSize = Math.min(validPageSize, legacyOffsetMode ? 100 : 1000);
         const searchParams = new URLSearchParams();
-        // Always include pagination parameters for consistent API behavior
-        searchParams.append("page", validPage.toString());
+        if (legacyOffsetMode) {
+            const validPage = page > 0 ? page : 1;
+            searchParams.append("page", validPage.toString());
+        }
         searchParams.append("pageSize", pageSize.toString());
-        if (status) {
-            searchParams.append("status", status);
+        // An array filter is sent as one comma-separated `status` value, which the
+        // API reads as "any of these", so several statuses cost a single request.
+        const statusFilter = typeof status === "string" ? status : status?.join(",");
+        if (statusFilter) {
+            searchParams.append("status", statusFilter);
         }
         if (tradingPairId) {
             searchParams.append("tradingPairId", tradingPairId);
@@ -468,18 +480,55 @@ 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);
+        // Cursor mode selects itself by the *presence* of `pageToken` on the wire,
+        // even when it is the empty string (the documented way to start a walk),
+        // so it must be sent explicitly rather than dropped like a falsy value.
+        // When the caller gave neither `page` nor `pageToken`, default to starting
+        // a cursor walk (`pageToken=""`).
+        if (!legacyOffsetMode) {
+            searchParams.append("pageToken", pageToken ?? "");
         }
         const endpoint = `/api/v1/orders?${searchParams.toString()}`;
         return await this.makeAuthenticatedRequest(endpoint, {
             method: "GET",
         });
     }
+    /**
+     * Walks the user's full order history with cursor pagination, yielding one
+     * order at a time.
+     *
+     * Starts a cursor walk (`pageToken: ""`) and follows each response's
+     * `nextPageToken` until the server proves exhaustion (a page with zero rows
+     * and an empty token). Covers full order history — hot and archived rows
+     * merged — unlike the deprecated page-number mode.
+     *
+     * @param params - Optional filters and page size; `page`/`pageToken` are
+     * managed by the iterator and cannot be passed.
+     * @returns Async generator yielding orders newest-first (or oldest-first for
+     * `orderBy: "ASC"`)
+     * @throws {APIError} When any underlying request fails
+     *
+     * @example
+     * ```typescript
+     * for await (const order of tradingAPI.iterateOrders({ status: "FILLED" })) {
+     *   console.log(order.id);
+     * }
+     * ```
+     */
+    async *iterateOrders(params) {
+        let pageToken = "";
+        // A non-empty token never guarantees further results (AIP-158 "maybe
+        // more"): keep following it until a response returns zero rows and an
+        // empty token, the sole proof the walk is exhausted.
+        for (;;) {
+            const response = await this.getPaginatedOrders({ ...params, pageToken });
+            yield* response.orders;
+            if (!response.nextPageToken) {
+                return;
+            }
+            pageToken = response.nextPageToken;
+        }
+    }
     /**
      * Gets a single order by its ID.
      *

package/dist/coverage.d.ts

@@ -30,6 +30,7 @@ export declare const COVERED: {
     get_market_metadata: string;
     get_market_stats: string;
     get_my_fee_tier: string;
+    get_pulse: string;
     get_my_trader_code: string;
     get_rewards_balance: string;
     get_trader_code_info: string;
@@ -64,6 +65,7 @@ export declare const COVERED: {
     get_withdrawal: string;
     initiate_withdrawal: string;
     list_pending_withdrawals: string;
+    list_all_funding_history: string;
     list_application_balances: string;
     list_application_movements: string;
     list_application_orders: string;

package/dist/coverage.js

@@ -30,6 +30,7 @@ export const COVERED = {
     get_market_metadata: "getMarketMetadata",
     get_market_stats: "getMarketStats",
     get_my_fee_tier: "getMyFeeTier",
+    get_pulse: "pulse.getPulse",
     get_my_trader_code: "pitpass.getMyTraderCode",
     get_rewards_balance: "pitpass.getRewardsBalance",
     get_trader_code_info: "pitpass.getTraderCodeInfo",
@@ -64,6 +65,7 @@ export const COVERED = {
     get_withdrawal: "getWithdrawal",
     initiate_withdrawal: "initiateWithdrawal",
     list_pending_withdrawals: "listPendingWithdrawals",
+    list_all_funding_history: "listAllFundingHistory",
     list_application_balances: "listApplicationBalances",
     list_application_movements: "listApplicationMovements",
     list_application_orders: "listApplicationOrders",

package/dist/networks/networks.js

@@ -23,10 +23,10 @@ const DEFAULT_API_URLS = {
 const DEFAULT_WS_URLS = {
     local: "ws://localhost:8085/ws",
     // Dedicated WebSocket ingress (NLB behind Cloudflare). The previous
-    // ALB path (wss://develop.apimonaco.xyz/ws) keeps working during the
-    // migration window.
+    // ALB paths (wss://develop.apimonaco.xyz/ws, wss://staging.apimonaco.xyz/ws)
+    // keep working during the migration window.
     development: "wss://ws-develop.apimonaco.xyz/ws",
-    staging: "wss://staging.apimonaco.xyz/ws",
+    staging: "wss://ws-staging.apimonaco.xyz/ws",
     mainnet: "wss://api.monaco.xyz/ws",
 };
 /**

package/dist/sdk.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PortfolioAPI, PositionsAPI, ProfileAPI, SDKConfig, SubAccountsAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
+import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PortfolioAPI, PositionsAPI, ProfileAPI, PulseAPI, SDKConfig, SubAccountsAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
 import { type Address, type PublicClient, type TransactionReceipt, type WalletClient } from "viem";
 import { type MonacoWebSocket, OrderbookAPIImpl, TradesAPIImpl } from "./api";
 export declare class MonacoSDKImpl implements MonacoSDK {
@@ -18,6 +18,7 @@ export declare class MonacoSDKImpl implements MonacoSDK {
     faucet: FaucetAPI;
     whitelist: WhitelistAPI;
     profile: ProfileAPI;
+    pulse: PulseAPI;
     orderbook: OrderbookAPIImpl;
     trades: TradesAPIImpl;
     ws: MonacoWebSocket;

package/dist/sdk.js

@@ -12,6 +12,7 @@ import { PitpassAPIImpl } from "./api/pitpass";
 import { PortfolioAPIImpl } from "./api/portfolio";
 import { PositionsAPIImpl } from "./api/positions";
 import { ProfileAPIImpl } from "./api/profile";
+import { PulseAPIImpl } from "./api/pulse";
 import { SubAccountsAPIImpl } from "./api/sub-accounts";
 import { TradingAPIImpl } from "./api/trading";
 import { VaultAPIImpl } from "./api/vault";
@@ -54,6 +55,7 @@ export class MonacoSDKImpl {
     faucet;
     whitelist;
     profile;
+    pulse;
     orderbook;
     trades;
     ws;
@@ -82,6 +84,7 @@ export class MonacoSDKImpl {
         this.subAccounts.setSessionKeypair(credentials);
         this.faucet.setSessionKeypair(credentials);
         this.whitelist.setSessionKeypair(credentials);
+        this.pulse.setSessionKeypair(credentials);
         this.profile.setSessionKeypair(credentials);
         this.orderbook.setSessionKeypair(credentials);
         this.trades.setSessionKeypair(credentials);
@@ -120,6 +123,7 @@ export class MonacoSDKImpl {
         this.subAccounts.setServerKey(serverKey);
         this.faucet.setServerKey(serverKey);
         this.whitelist.setServerKey(serverKey);
+        this.pulse.setServerKey(serverKey);
         this.profile.setServerKey(serverKey);
         this.orderbook.setServerKey(serverKey);
         this.trades.setServerKey(serverKey);
@@ -181,6 +185,7 @@ export class MonacoSDKImpl {
         this.subAccounts = new SubAccountsAPIImpl(apiUrl);
         this.faucet = new FaucetAPIImpl(apiUrl);
         this.whitelist = new WhitelistAPIImpl(apiUrl);
+        this.pulse = new PulseAPIImpl(apiUrl);
         this.auth = new AuthAPIImpl(this.walletClient, this.chain, apiUrl);
         this.delegatedAgents = new DelegatedAgentsAPIImpl(apiUrl);
         this.fees = new FeesAPIImpl(apiUrl);

package/package.json

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