@0xmonaco/core 1.0.73-develop.af0f5d0 → 1.0.74-develop.367860f

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

@@ -47,8 +47,8 @@ export declare const perpRoutes: {
         readonly initiate: () => string;
         readonly byIndex: (withdrawalIndex: number) => string;
         readonly list: (params?: {
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
         }) => string;
     };
     readonly market: {
@@ -75,15 +75,15 @@ export declare const perpRoutes: {
         readonly listFundingHistory: (tradingPairId: string, params?: {
             startTime?: string;
             endTime?: string;
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
             orderBy?: string;
         }) => string;
         readonly listAllFundingHistory: (params?: {
             startTime?: string;
             endTime?: string;
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
             orderBy?: string;
         }) => string;
         readonly getOpenInterest: (tradingPairId: string) => string;
@@ -119,8 +119,9 @@ export declare const perpRoutes: {
     };
     readonly applications: {
         readonly orders: (params?: {
-            page?: number;
+            clientId?: string;
             pageSize?: number;
+            pageToken?: string;
             status?: string;
             userId?: string;
             tradingPairId?: string;
@@ -128,27 +129,31 @@ export declare const perpRoutes: {
             orderType?: string;
         }) => string;
         readonly users: (params?: {
-            page?: number;
+            clientId?: string;
             pageSize?: number;
+            pageToken?: string;
             isActive?: boolean;
             accountType?: string;
             address?: string;
         }) => string;
         readonly movements: (params?: {
-            page?: number;
+            clientId?: string;
             pageSize?: number;
+            pageToken?: string;
             userId?: string;
             transactionType?: string;
             entryType?: string;
             assetId?: string;
         }) => string;
         readonly balances: (params?: {
-            page?: number;
+            clientId?: string;
             pageSize?: number;
+            pageToken?: string;
             userId?: string;
             assetId?: string;
         }) => string;
         readonly stats: (params?: {
+            clientId?: string;
             since?: string;
         }) => string;
     };
@@ -174,8 +179,8 @@ export declare const perpRoutes: {
             marginAccountId?: string;
             tradingPairId?: string;
             status?: string;
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
         }) => string;
         readonly get: (positionId: string) => string;
         readonly close: (positionId: string) => string;
@@ -186,8 +191,8 @@ export declare const perpRoutes: {
             positionId?: string;
             marginAccountId?: string;
             tradingPairId?: string;
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
             reductionOnly?: boolean;
         }) => string;
         readonly pnlHistory: (positionId: string, params: {
@@ -198,8 +203,8 @@ export declare const perpRoutes: {
     };
     readonly marginAccounts: {
         readonly list: (params?: {
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
             state?: string;
             tradingPairId?: string;
         }) => string;
@@ -219,19 +224,21 @@ export declare const perpRoutes: {
         readonly transferOutParent: () => string;
         readonly movements: (marginAccountId: string, params?: {
             movementType?: string;
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
         }) => string;
         readonly parentMovements: (params?: {
             movementType?: string;
-            page?: number;
             pageSize?: number;
+            pageToken?: string;
         }) => string;
         readonly simulateParentMarginOrderRisk: () => string;
         readonly simulateOrderRisk: (marginAccountId: string) => string;
         readonly simulateRiskBucketOrderRisk: () => string;
         readonly createSubAccount: () => string;
         readonly closeSubAccount: (marginAccountId: string) => string;
+        readonly subAccountTransferIn: (marginAccountId: string) => string;
+        readonly subAccountTransferOut: (marginAccountId: string) => string;
         readonly pnl: (marginAccountId: string) => string;
         readonly transferCollateral: () => string;
     };

package/dist/api/perp/routes.js

@@ -121,6 +121,8 @@ export const perpRoutes = {
         simulateRiskBucketOrderRisk: () => `${API_V1}/margin/risk-buckets/simulate-order-risk`,
         createSubAccount: () => `${API_V1}/margin/sub-accounts`,
         closeSubAccount: (marginAccountId) => `${API_V1}/margin/sub-accounts/${encodeSegment(marginAccountId)}/close`,
+        subAccountTransferIn: (marginAccountId) => `${API_V1}/margin/sub-accounts/${encodeSegment(marginAccountId)}/collateral/transfer-in`,
+        subAccountTransferOut: (marginAccountId) => `${API_V1}/margin/sub-accounts/${encodeSegment(marginAccountId)}/collateral/transfer-out`,
         pnl: (marginAccountId) => `${API_V1}/margin/accounts/${encodeSegment(marginAccountId)}/pnl`,
         transferCollateral: () => `${API_V1}/margin/collateral/transfer`,
     },

package/dist/api/pitpass/api.d.ts

@@ -33,7 +33,7 @@
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import type { GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
+import type { GetMyReferralDownlineParams, GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
     /**
@@ -77,23 +77,26 @@ export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
      */
     transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
     /**
-     * Read the caller's own referral position: their upline (L1, L2, L3), their
+     * Read the caller's own referral position: their upline (L1, L2, ...), their
      * L1 referrer, total earned, and recent rewards. Self-scoped — no id is sent,
      * so it can only ever return your own chain. `referrer` is "" and `upline` is
      * empty when you were not referred.
      */
     getMyReferralPosition(): Promise<GetMyReferralPositionResponse>;
     /**
-     * Read the caller's own downline: earnings by source across L1/L2/L3, the L1
-     * direct-referee roster (including referees who haven't traded), and a
-     * per-level earnings summary. Self-scoped, read-only.
+     * Read the caller's own downline: one page of earnings by source across
+     * every reward level (largest first), the L1 direct-referee roster
+     * (including referees who haven't traded), and a per-level earnings summary
+     * covering every level and source. Without paging params the server returns
+     * the first page (100 rows); follow `nextPageToken` until it is empty.
+     * Self-scoped, read-only.
      */
-    getMyReferralDownline(): Promise<GetMyReferralDownlineResponse>;
+    getMyReferralDownline(params?: GetMyReferralDownlineParams): Promise<GetMyReferralDownlineResponse>;
     /**
      * Read one level of the caller's own referral tree: the wallets `parent`
      * directly referred (the caller when omitted), a page at a time, newest
-     * first. `parent` must be the caller or one of their own L1/L2 referees;
-     * any other wallet is a 404.
+     * first. `parent` must be the caller or one of their own referees above the
+     * deepest rewarded level; any other wallet is a 404.
      */
     getMyReferralTree(params?: GetMyReferralTreeParams): Promise<GetMyReferralTreeResponse>;
 }

package/dist/api/pitpass/api.js

@@ -33,7 +33,7 @@
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import { GetMyReferralTreeParamsSchema, SetTraderCodeParamsSchema, TransferRewardsParamsSchema, validate } from "@0xmonaco/types";
+import { GetMyReferralDownlineParamsSchema, GetMyReferralTreeParamsSchema, SetTraderCodeParamsSchema, TransferRewardsParamsSchema, validate, } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export class PitpassAPIImpl extends BaseAPI {
     /**
@@ -109,7 +109,7 @@ export class PitpassAPIImpl extends BaseAPI {
         });
     }
     /**
-     * Read the caller's own referral position: their upline (L1, L2, L3), their
+     * Read the caller's own referral position: their upline (L1, L2, ...), their
      * L1 referrer, total earned, and recent rewards. Self-scoped — no id is sent,
      * so it can only ever return your own chain. `referrer` is "" and `upline` is
      * empty when you were not referred.
@@ -120,20 +120,33 @@ export class PitpassAPIImpl extends BaseAPI {
         });
     }
     /**
-     * Read the caller's own downline: earnings by source across L1/L2/L3, the L1
-     * direct-referee roster (including referees who haven't traded), and a
-     * per-level earnings summary. Self-scoped, read-only.
+     * Read the caller's own downline: one page of earnings by source across
+     * every reward level (largest first), the L1 direct-referee roster
+     * (including referees who haven't traded), and a per-level earnings summary
+     * covering every level and source. Without paging params the server returns
+     * the first page (100 rows); follow `nextPageToken` until it is empty.
+     * Self-scoped, read-only.
      */
-    async getMyReferralDownline() {
-        return await this.makeAuthenticatedRequest("/api/v1/pitpass/referrals/me/downline", {
-            method: "GET",
-        });
+    async getMyReferralDownline(params) {
+        if (params) {
+            validate(GetMyReferralDownlineParamsSchema, params);
+        }
+        const searchParams = new URLSearchParams();
+        if (params?.pageSize !== undefined) {
+            searchParams.append("pageSize", params.pageSize.toString());
+        }
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
+        const query = searchParams.toString();
+        const path = query ? `/api/v1/pitpass/referrals/me/downline?${query}` : "/api/v1/pitpass/referrals/me/downline";
+        return await this.makeAuthenticatedRequest(path, { method: "GET" });
     }
     /**
      * Read one level of the caller's own referral tree: the wallets `parent`
      * directly referred (the caller when omitted), a page at a time, newest
-     * first. `parent` must be the caller or one of their own L1/L2 referees;
-     * any other wallet is a 404.
+     * first. `parent` must be the caller or one of their own referees above the
+     * deepest rewarded level; any other wallet is a 404.
      */
     async getMyReferralTree(params) {
         if (params) {

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

@@ -2,10 +2,19 @@ import type { AttachPositionTpSlRequest, AttachPositionTpSlResponse, BatchCloseA
 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.
+     * List the caller's positions, cursor paged (0XM-2788): omit `pageToken` or
+     * pass `""` to start, then follow `nextPageToken` until it comes back
+     * empty. There is no `page` — sending one is a `400`.
+     *
+     * `total` is bounded by the server count ceiling; `totalCapped` is `true`
+     * when more than that matched, so it is a lower bound. Do not drive a
+     * paging loop off it — follow `nextPageToken`.
+     *
+     * Order depends on the filter: `status: "OPEN"` is served from the engine's
+     * live view in `(marginAccountId, tradingPairId, positionId)` order, every
+     * other filter from persisted rows newest-opened first. The two are
+     * separate cursor spaces, so a token is only valid in the one that minted
+     * it.
      */
     listPositions(params?: ListPositionsParams): Promise<ListPositionsResponse>;
     getPosition(positionId: string): Promise<GetPositionResponse>;
@@ -14,10 +23,13 @@ export declare class PositionsAPIImpl extends BaseAPI implements PositionsAPI {
     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.
+     * List the caller's position-history events, cursor paged (0XM-2788): omit
+     * `pageToken` or pass `""` to start, then follow `nextPageToken` until it
+     * comes back empty. There is no `page` — sending one is a `400`.
+     *
+     * The response carries no item count: this listing spans the hot table and
+     * the archive, so counting behind a filter would walk the caller's whole
+     * lifetime prefix on every page.
      */
     listPositionHistory(params?: ListPositionHistoryParams): Promise<ListPositionHistoryResponse>;
     getPositionPnlHistory(positionId: string, params: GetPositionPnlHistoryParams): Promise<GetPositionPnlHistoryResponse>;

package/dist/api/positions/api.js

@@ -3,10 +3,19 @@ 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.
+     * List the caller's positions, cursor paged (0XM-2788): omit `pageToken` or
+     * pass `""` to start, then follow `nextPageToken` until it comes back
+     * empty. There is no `page` — sending one is a `400`.
+     *
+     * `total` is bounded by the server count ceiling; `totalCapped` is `true`
+     * when more than that matched, so it is a lower bound. Do not drive a
+     * paging loop off it — follow `nextPageToken`.
+     *
+     * Order depends on the filter: `status: "OPEN"` is served from the engine's
+     * live view in `(marginAccountId, tradingPairId, positionId)` order, every
+     * other filter from persisted rows newest-opened first. The two are
+     * separate cursor spaces, so a token is only valid in the one that minted
+     * it.
      */
     async listPositions(params) {
         if (params) {
@@ -90,10 +99,13 @@ 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.
+     * List the caller's position-history events, cursor paged (0XM-2788): omit
+     * `pageToken` or pass `""` to start, then follow `nextPageToken` until it
+     * comes back empty. There is no `page` — sending one is a `400`.
+     *
+     * The response carries no item count: this listing spans the hot table and
+     * the archive, so counting behind a filter would walk the caller's whole
+     * lifetime prefix on every page.
      */
     async listPositionHistory(params) {
         if (params) {

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

@@ -50,14 +50,19 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * Fetches the user's transaction history from the /api/v1/accounts/movements endpoint.
      * Requires a valid access token to be set.
      *
-     * The response `total` and `totalPages` are bounded by the listing's pagination reach:
-     * exact up to `pageSize` x 10,000 rows (10,000 pages) and saturating there, so a user
-     * with more matching movements than the listing can page through reads the cap, not
-     * their lifetime total. A `page` above 10,000 is rejected.
+     * Cursor paged (0XM-2788/0XM-2820): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` from each response until it comes back empty.
+     * There is no `page` — sending one is a `400`.
+     *
+     * The response `total` and `totalPages` are bounded by the server count
+     * ceiling; `totalCapped` is `true` when more than that matched, so `total`
+     * is a lower bound. Do not drive a paging loop off `total`: a user past the
+     * ceiling would stop early. Follow `nextPageToken`.
      *
      * @param params - Optional query parameters for pagination and filtering
-     * @param params.page - Page number (starts from 1, default: 1, at most 10,000)
-     * @param params.limit - Number of items per page (default: 20, max: 100)
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
+     * @param params.orderBy - Sort direction for `createdAt` (default: `"DESC"`)
      * @param params.entryType - Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE)
      * @param params.transactionType - Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, FEE, FUNDING, LIQUIDATION, INTEREST, REWARD)
      * @param params.assetId - Filter by asset ID (UUID)
@@ -70,9 +75,14 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * const movements = await profileAPI.getPaginatedUserMovements();
      * console.log(`Total movements: ${movements.total}`);
      *
-     * // Get second page with custom pageSize
-     * const page2 = await profileAPI.getPaginatedUserMovements({ page: 2, pageSize: 50 });
-     * console.log(`Page ${page2.page} of ${page2.totalPages}`);
+     * // Walk every page
+     * let pageToken = "";
+     * for (;;) {
+     *   const page = await profileAPI.getPaginatedUserMovements({ pageToken, pageSize: 50 });
+     *   console.log(page.movements.length);
+     *   if (page.nextPageToken === "") break;
+     *   pageToken = page.nextPageToken;
+     * }
      *
      * // Filter by entry type and transaction type
      * const deposits = await profileAPI.getPaginatedUserMovements({ entryType: "CREDIT", transactionType: "DEPOSIT" });
@@ -88,9 +98,13 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * Fetches the user's token balances from the /api/v1/accounts/balances endpoint.
      * Requires a valid access token to be set.
      *
+     * Cursor paged (0XM-2788/0XM-2821): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` until it comes back empty. There is no `page`
+     * — sending one is a `400`.
+     *
      * @param params - Optional query parameters for pagination
-     * @param params.page - Page number (starts from 1, default: 1)
-     * @param params.pageSize - Number of items per page (default: 20, max: 100)
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
      * @returns Promise resolving to paginated balances response
      * @throws {APIError} When the request fails or user is not authenticated
      *
@@ -103,9 +117,14 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      *   console.log(`${balance.symbol}: ${balance.availableBalance}`);
      * });
      *
-     * // Get page 2 with 50 items per page
-     * const nextBalances = await profileAPI.getUserBalances({ page: 2, pageSize: 50 });
-     * console.log(`Returned ${nextBalances.balances.length} balances`);
+     * // Walk every page
+     * let pageToken = "";
+     * for (;;) {
+     *   const page = await profileAPI.getUserBalances({ pageToken, pageSize: 50 });
+     *   console.log(page.balances.length);
+     *   if (page.nextPageToken === "") break;
+     *   pageToken = page.nextPageToken;
+     * }
      * ```
      */
     getUserBalances(params?: GetUserBalancesParams): Promise<GetUserBalancesResponse>;
@@ -233,12 +252,21 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * Fetches funding payments from the /api/v1/accounts/funding-payments endpoint.
      * Requires a valid access token to be set.
      *
-     * The response `total` and `totalPages` are bounded by the listing's pagination reach:
-     * exact up to `pageSize` x 10,000 rows (10,000 pages) and saturating there, so a user
-     * with more matching payments than the listing can page through reads the cap, not
-     * their lifetime total. A `page` above 10,000 is rejected.
+     * Cursor paged (0XM-2788/0XM-2818): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` from each response until it comes back empty.
+     * There is no `page` — sending one is a `400`.
+     *
+     * The response `total` and `totalPages` are bounded by the server count
+     * ceiling; `totalCapped` is `true` when more than that matched, so `total`
+     * is a lower bound. Do not drive a paging loop off `total`: a user past the
+     * ceiling would stop early. Follow `nextPageToken`.
      *
      * @param params - Optional query parameters for pagination and filtering
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
+     * @param params.tradingPairId - Filter by trading pair ID (UUID)
+     * @param params.positionId - Filter by margin position ID (UUID)
+     * @param params.marginAccountId - Filter by margin account ID (UUID)
      * @returns Promise resolving to paginated funding payments response
      * @throws {APIError} When the request fails or user is not authenticated
      *
@@ -246,6 +274,15 @@ export declare class ProfileAPIImpl extends BaseAPI implements ProfileAPI {
      * ```typescript
      * const funding = await profileAPI.listFundingPayments({ tradingPairId: "550e8400-e29b-41d4-a716-446655440000" });
      * console.log(`Total funding payments: ${funding.total}`);
+     *
+     * // Walk every page
+     * let pageToken = "";
+     * for (;;) {
+     *   const page = await profileAPI.listFundingPayments({ pageToken, pageSize: 100 });
+     *   console.log(page.records.length);
+     *   if (page.nextPageToken === "") break;
+     *   pageToken = page.nextPageToken;
+     * }
      * ```
      */
     listFundingPayments(params?: ListFundingPaymentsParams): Promise<ListFundingPaymentsResponse>;

package/dist/api/profile/api.js

@@ -17,7 +17,7 @@
  * console.log(`User: ${profile.username} (${profile.address})`);
  * ```
  */
-import { GetUserMovementsSchema, GetUserTradesSchema, ListFundingPaymentsSchema, SetSelfTradePreventionDefaultSchema, validate } from "@0xmonaco/types";
+import { GetUserBalancesSchema, GetUserMovementsSchema, GetUserTradesSchema, ListFundingPaymentsSchema, SetSelfTradePreventionDefaultSchema, validate, } from "@0xmonaco/types";
 import { APIError } from "../../errors";
 import { BaseAPI } from "../base";
 export class ProfileAPIImpl extends BaseAPI {
@@ -53,14 +53,19 @@ export class ProfileAPIImpl extends BaseAPI {
      * Fetches the user's transaction history from the /api/v1/accounts/movements endpoint.
      * Requires a valid access token to be set.
      *
-     * The response `total` and `totalPages` are bounded by the listing's pagination reach:
-     * exact up to `pageSize` x 10,000 rows (10,000 pages) and saturating there, so a user
-     * with more matching movements than the listing can page through reads the cap, not
-     * their lifetime total. A `page` above 10,000 is rejected.
+     * Cursor paged (0XM-2788/0XM-2820): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` from each response until it comes back empty.
+     * There is no `page` — sending one is a `400`.
+     *
+     * The response `total` and `totalPages` are bounded by the server count
+     * ceiling; `totalCapped` is `true` when more than that matched, so `total`
+     * is a lower bound. Do not drive a paging loop off `total`: a user past the
+     * ceiling would stop early. Follow `nextPageToken`.
      *
      * @param params - Optional query parameters for pagination and filtering
-     * @param params.page - Page number (starts from 1, default: 1, at most 10,000)
-     * @param params.limit - Number of items per page (default: 20, max: 100)
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
+     * @param params.orderBy - Sort direction for `createdAt` (default: `"DESC"`)
      * @param params.entryType - Filter by entry type (CREDIT, DEBIT, LOCK, UNLOCK, FEE)
      * @param params.transactionType - Filter by transaction type (DEPOSIT, WITHDRAWAL, TRADE, FEE, FUNDING, LIQUIDATION, INTEREST, REWARD)
      * @param params.assetId - Filter by asset ID (UUID)
@@ -73,9 +78,14 @@ export class ProfileAPIImpl extends BaseAPI {
      * const movements = await profileAPI.getPaginatedUserMovements();
      * console.log(`Total movements: ${movements.total}`);
      *
-     * // Get second page with custom pageSize
-     * const page2 = await profileAPI.getPaginatedUserMovements({ page: 2, pageSize: 50 });
-     * console.log(`Page ${page2.page} of ${page2.totalPages}`);
+     * // Walk every page
+     * let pageToken = "";
+     * for (;;) {
+     *   const page = await profileAPI.getPaginatedUserMovements({ pageToken, pageSize: 50 });
+     *   console.log(page.movements.length);
+     *   if (page.nextPageToken === "") break;
+     *   pageToken = page.nextPageToken;
+     * }
      *
      * // Filter by entry type and transaction type
      * const deposits = await profileAPI.getPaginatedUserMovements({ entryType: "CREDIT", transactionType: "DEPOSIT" });
@@ -89,12 +99,17 @@ export class ProfileAPIImpl extends BaseAPI {
             validate(GetUserMovementsSchema, params);
         }
         const searchParams = new URLSearchParams();
-        if (params?.page !== undefined) {
-            searchParams.append("page", params.page.toString());
-        }
         if (params?.pageSize !== undefined) {
             searchParams.append("pageSize", params.pageSize.toString());
         }
+        // An empty token is a distinct, meaningful value — "start the walk" — so
+        // it must reach the wire rather than be dropped as falsy.
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
+        if (params?.orderBy !== undefined) {
+            searchParams.append("orderBy", params.orderBy);
+        }
         if (params?.entryType !== undefined) {
             searchParams.append("entryType", params.entryType);
         }
@@ -114,9 +129,13 @@ export class ProfileAPIImpl extends BaseAPI {
      * Fetches the user's token balances from the /api/v1/accounts/balances endpoint.
      * Requires a valid access token to be set.
      *
+     * Cursor paged (0XM-2788/0XM-2821): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` until it comes back empty. There is no `page`
+     * — sending one is a `400`.
+     *
      * @param params - Optional query parameters for pagination
-     * @param params.page - Page number (starts from 1, default: 1)
-     * @param params.pageSize - Number of items per page (default: 20, max: 100)
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
      * @returns Promise resolving to paginated balances response
      * @throws {APIError} When the request fails or user is not authenticated
      *
@@ -129,19 +148,29 @@ export class ProfileAPIImpl extends BaseAPI {
      *   console.log(`${balance.symbol}: ${balance.availableBalance}`);
      * });
      *
-     * // Get page 2 with 50 items per page
-     * const nextBalances = await profileAPI.getUserBalances({ page: 2, pageSize: 50 });
-     * console.log(`Returned ${nextBalances.balances.length} balances`);
+     * // Walk every page
+     * let pageToken = "";
+     * for (;;) {
+     *   const page = await profileAPI.getUserBalances({ pageToken, pageSize: 50 });
+     *   console.log(page.balances.length);
+     *   if (page.nextPageToken === "") break;
+     *   pageToken = page.nextPageToken;
+     * }
      * ```
      */
     async getUserBalances(params) {
-        const searchParams = new URLSearchParams();
-        if (params?.page !== undefined) {
-            searchParams.append("page", params.page.toString());
+        if (params) {
+            validate(GetUserBalancesSchema, params);
         }
+        const searchParams = new URLSearchParams();
         if (params?.pageSize !== undefined) {
             searchParams.append("pageSize", params.pageSize.toString());
         }
+        // An empty token is a distinct, meaningful value — "start the walk" — so
+        // it must reach the wire rather than be dropped as falsy.
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
         const queryString = searchParams.toString();
         const url = queryString ? `/api/v1/accounts/balances?${queryString}` : "/api/v1/accounts/balances";
         return await this.makeAuthenticatedRequest(url);
@@ -315,12 +344,21 @@ export class ProfileAPIImpl extends BaseAPI {
      * Fetches funding payments from the /api/v1/accounts/funding-payments endpoint.
      * Requires a valid access token to be set.
      *
-     * The response `total` and `totalPages` are bounded by the listing's pagination reach:
-     * exact up to `pageSize` x 10,000 rows (10,000 pages) and saturating there, so a user
-     * with more matching payments than the listing can page through reads the cap, not
-     * their lifetime total. A `page` above 10,000 is rejected.
+     * Cursor paged (0XM-2788/0XM-2818): omit `pageToken` or pass `""` to start,
+     * then follow `nextPageToken` from each response until it comes back empty.
+     * There is no `page` — sending one is a `400`.
+     *
+     * The response `total` and `totalPages` are bounded by the server count
+     * ceiling; `totalCapped` is `true` when more than that matched, so `total`
+     * is a lower bound. Do not drive a paging loop off `total`: a user past the
+     * ceiling would stop early. Follow `nextPageToken`.
      *
      * @param params - Optional query parameters for pagination and filtering
+     * @param params.pageToken - Cursor from a previous response's `nextPageToken`
+     * @param params.pageSize - Number of items per page (default: 20, max: 1000)
+     * @param params.tradingPairId - Filter by trading pair ID (UUID)
+     * @param params.positionId - Filter by margin position ID (UUID)
+     * @param params.marginAccountId - Filter by margin account ID (UUID)
      * @returns Promise resolving to paginated funding payments response
      * @throws {APIError} When the request fails or user is not authenticated
      *
@@ -328,6 +366,15 @@ export class ProfileAPIImpl extends BaseAPI {
      * ```typescript
      * const funding = await profileAPI.listFundingPayments({ tradingPairId: "550e8400-e29b-41d4-a716-446655440000" });
      * console.log(`Total funding payments: ${funding.total}`);
+     *
+     * // Walk every page
+     * let pageToken = "";
+     * for (;;) {
+     *   const page = await profileAPI.listFundingPayments({ pageToken, pageSize: 100 });
+     *   console.log(page.records.length);
+     *   if (page.nextPageToken === "") break;
+     *   pageToken = page.nextPageToken;
+     * }
      * ```
      */
     async listFundingPayments(params) {
@@ -335,12 +382,14 @@ export class ProfileAPIImpl extends BaseAPI {
             validate(ListFundingPaymentsSchema, params);
         }
         const searchParams = new URLSearchParams();
-        if (params?.page !== undefined) {
-            searchParams.append("page", params.page.toString());
-        }
         if (params?.pageSize !== undefined) {
             searchParams.append("pageSize", params.pageSize.toString());
         }
+        // An empty token is a distinct, meaningful value — "start the walk" — so
+        // it must reach the wire rather than be dropped as falsy.
+        if (params?.pageToken !== undefined) {
+            searchParams.append("pageToken", params.pageToken);
+        }
         if (params?.tradingPairId !== undefined) {
             searchParams.append("tradingPairId", params.tradingPairId);
         }