@0xmonaco/types 1.0.74 → 1.0.75

package/dist/api/index.d.ts

@@ -16,11 +16,4 @@ export interface BaseAPI {
      * @param credentials - Hex-encoded session keypair, or `undefined` to clear.
      */
     setSessionKeypair(credentials: SessionCredentials | undefined): void;
-    /**
-     * Set (or clear) the application secret key used for backend-authenticated
-     * requests. When set, it is sent in the `x-server-key` header.
-     *
-     * @param serverKey - The application secret key (`sk_...`), or `undefined` to clear.
-     */
-    setServerKey(serverKey: string | undefined): void;
 }

package/dist/applications/index.d.ts

@@ -1,8 +1,8 @@
 /**
  * Applications Types
  *
- * Types for application configuration and the backend-authenticated
- * application reporting endpoints.
+ * Types for application configuration and the public application reporting
+ * endpoints.
  */
 import type { BaseAPI } from "../api";
 import type { GetAppStatsParams, ListAppBalancesParams, ListAppMovementsParams, ListAppOrdersParams, ListAppUsersParams } from "./requests";
@@ -11,9 +11,8 @@ import type { ApplicationConfigResponse, GetAppStatsResponse, ListAppBalancesRes
  * Applications API interface.
  *
  * `getApplicationConfig` is session-authenticated (signed with the session
- * key). The reporting methods are backend-authenticated: set the application's
- * secret key with {@link BaseAPI.setServerKey} before calling them — each
- * request sends it in the `x-server-key` header.
+ * key). The reporting methods are public: each selects its application by
+ * `clientId` and is rate limited per client IP.
  */
 export interface ApplicationsAPI extends BaseAPI {
     /**
@@ -26,40 +25,40 @@ export interface ApplicationsAPI extends BaseAPI {
      */
     getApplicationConfig(): Promise<ApplicationConfigResponse>;
     /**
-     * Lists orders placed by the application's users. Backend-authenticated.
+     * Lists orders placed by the application's users. Public, selected by `clientId`.
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of orders
      */
-    listApplicationOrders(params?: ListAppOrdersParams): Promise<ListAppOrdersResponse>;
+    listApplicationOrders(params: ListAppOrdersParams): Promise<ListAppOrdersResponse>;
     /**
-     * Lists the application's users. Backend-authenticated.
+     * Lists the application's users. Public, selected by `clientId`.
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of users
      */
-    listApplicationUsers(params?: ListAppUsersParams): Promise<ListAppUsersResponse>;
+    listApplicationUsers(params: ListAppUsersParams): Promise<ListAppUsersResponse>;
     /**
-     * Lists ledger movements for the application's users. Backend-authenticated.
+     * Lists ledger movements for the application's users. Public, selected by `clientId`.
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of movements
      */
-    listApplicationMovements(params?: ListAppMovementsParams): Promise<ListAppMovementsResponse>;
+    listApplicationMovements(params: ListAppMovementsParams): Promise<ListAppMovementsResponse>;
     /**
-     * Lists user balances held within the application. Backend-authenticated.
+     * Lists user balances held within the application. Public, selected by `clientId`.
      *
      * @param params - Pagination and filter options
      * @returns Promise resolving to a paginated list of balances
      */
-    listApplicationBalances(params?: ListAppBalancesParams): Promise<ListAppBalancesResponse>;
+    listApplicationBalances(params: ListAppBalancesParams): Promise<ListAppBalancesResponse>;
     /**
-     * Gets aggregate volume and fee stats for the application. Backend-authenticated.
+     * Gets aggregate volume and fee stats for the application. Public, selected by `clientId`.
      *
      * @param params - Optional `since` filter
      * @returns Promise resolving to the application stats
      */
-    getApplicationStats(params?: GetAppStatsParams): Promise<GetAppStatsResponse>;
+    getApplicationStats(params: GetAppStatsParams): Promise<GetAppStatsResponse>;
 }
 export type { GetAppStatsParams, ListAppBalancesParams, ListAppMovementsParams, ListAppOrdersParams, ListAppUsersParams } from "./requests";
 export type { AppBalance, ApplicationConfigResponse, AppMovement, AppOrder, AppUser, GetAppStatsResponse, ListAppBalancesResponse, ListAppMovementsResponse, ListAppOrdersResponse, ListAppUsersResponse, } from "./responses";

package/dist/applications/index.js

@@ -1,6 +1,6 @@
 /**
  * Applications Types
  *
- * Types for application configuration and the backend-authenticated
- * application reporting endpoints.
+ * Types for application configuration and the public application reporting
+ * endpoints.
  */

package/dist/applications/requests.d.ts

@@ -1,18 +1,30 @@
 /**
  * Applications Request Types
  *
- * Query parameters for the backend-authenticated application reporting
- * endpoints. Field names match the wire (snake_case) so they can be passed
- * straight through to the query string.
+ * Query parameters for the public application reporting endpoints. Each one
+ * selects its application by `clientId`.
  */
 /**
  * Query parameters for listing application orders.
  */
 export interface ListAppOrdersParams {
-    /** Page number (starts from 1, at most 10,000 — the last page the listing counts towards) */
-    page?: number;
-    /** Items per page (max 100) */
+    /** Public client ID of the application to list (required). An unknown or inactive one is a `404`. */
+    clientId: string;
+    /** Items per page, 1 to 1000 (default 20). Rejected if larger. */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2822): there is no `page`, and
+     * sending one is a `400`. The response carries no item count — follow
+     * `nextPageToken` until it comes back empty. Filters must match the request
+     * that minted the token.
+     */
+    pageToken?: string;
     /** Filter by order status (e.g. SUBMITTED, PARTIALLY_FILLED, FILLED, SETTLED, CANCELLED, EXPIRED, REJECTED) */
     status?: string;
     /** Filter by user UUID */
@@ -28,10 +40,24 @@ export interface ListAppOrdersParams {
  * Query parameters for listing application users.
  */
 export interface ListAppUsersParams {
-    /** Page number (starts from 1) */
-    page?: number;
-    /** Items per page (max 100) */
+    /** Public client ID of the application to list (required). An unknown or inactive one is a `404`. */
+    clientId: string;
+    /** Items per page, 1 to 1000 (default 20). Rejected if larger. */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2822): there is no `page`, and
+     * sending one is a `400`. Ordered by id ascending, not newest-first.
+     * `total` / `totalPages` are populated, bounded by the server count
+     * ceiling — see `totalCapped`. Filters must match the request that minted
+     * the token.
+     */
+    pageToken?: string;
     /** Filter by active status */
     isActive?: boolean;
     /** Filter by account type: master or sub */
@@ -43,10 +69,23 @@ export interface ListAppUsersParams {
  * Query parameters for listing application movements.
  */
 export interface ListAppMovementsParams {
-    /** Page number (starts from 1, at most 10,000 — the last page the listing counts towards) */
-    page?: number;
-    /** Items per page (max 100) */
+    /** Public client ID of the application to list (required). An unknown or inactive one is a `404`. */
+    clientId: string;
+    /** Items per page, 1 to 1000 (default 20). Rejected if larger. */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2822): there is no `page`, and
+     * sending one is a `400`. The response carries no item count — follow
+     * `nextPageToken` until it comes back empty. Filters must match the request
+     * that minted the token.
+     */
+    pageToken?: string;
     /** Filter by user UUID */
     userId?: string;
     /** Filter by transaction type (e.g. DEPOSIT, WITHDRAWAL, TRADE, FEE, FUNDING, LIQUIDATION, INTEREST, REWARD) */
@@ -60,10 +99,24 @@ export interface ListAppMovementsParams {
  * Query parameters for listing application balances.
  */
 export interface ListAppBalancesParams {
-    /** Page number (starts from 1) */
-    page?: number;
-    /** Items per page (max 100) */
+    /** Public client ID of the application to list (required). An unknown or inactive one is a `404`. */
+    clientId: string;
+    /** Items per page, 1 to 1000 (default 20). Rejected if larger. */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2822): there is no `page`, and
+     * sending one is a `400`. Ordered by id ascending, not newest-first.
+     * `total` / `totalPages` are populated, bounded by the server count
+     * ceiling — see `totalCapped`. Filters must match the request that minted
+     * the token.
+     */
+    pageToken?: string;
     /** Filter by user UUID */
     userId?: string;
     /** Filter by asset UUID */
@@ -73,6 +126,8 @@ export interface ListAppBalancesParams {
  * Query parameters for application stats.
  */
 export interface GetAppStatsParams {
+    /** Public client ID of the application to list (required). An unknown or inactive one is a `404`. */
+    clientId: string;
     /** ISO 8601 datetime to filter stats from (e.g. 2026-01-01T00:00:00Z). Omit for all-time. */
     since?: string;
 }

package/dist/applications/requests.js

@@ -1,7 +1,6 @@
 /**
  * Applications Request Types
  *
- * Query parameters for the backend-authenticated application reporting
- * endpoints. Field names match the wire (snake_case) so they can be passed
- * straight through to the query string.
+ * Query parameters for the public application reporting endpoints. Each one
+ * selects its application by `clientId`.
  */

package/dist/applications/responses.d.ts

@@ -2,7 +2,7 @@
  * Applications Response Types
  *
  * Response types for application configuration operations and the
- * backend-authenticated application reporting endpoints. Reporting types use
+ * public application reporting endpoints. Reporting types use
  * the wire shape (snake_case); optional fields are `null` rather than omitted.
  */
 import type { Address } from "viem";
@@ -72,16 +72,10 @@ export interface AppUser {
     username: string | null;
     /** Account type: master or sub */
     accountType: string;
-    /** Whether the user is allowed to withdraw */
-    canWithdraw: boolean;
     /** Account creation timestamp (ISO 8601) */
     createdAt: string | null;
-    /** Email address */
-    email: string | null;
     /** Whether the user account is active */
     isActive: boolean | null;
-    /** Whether the user is banned */
-    isBanned: boolean | null;
     /** Master account ID (for sub-accounts) */
     masterAccountId: string | null;
     /** Last update timestamp (ISO 8601) */
@@ -162,72 +156,74 @@ export interface AppBalance {
  */
 export interface ListAppOrdersResponse {
     orders: AppOrder[];
-    /**
-     * Matching orders. Exact up to 10,000 pages of the requested page size
-     * (`pageSize` x 10,000 rows) and saturates there, so an application with
-     * more matching orders than the listing can page through reads the cap,
-     * not its lifetime total.
-     */
-    total: number;
-    /** Current page number */
-    page: number;
     /** Items per page */
     pageSize: number;
     /**
-     * Number of pages at the requested page size. Exact up to 10,000 and
-     * saturates there, the last page this listing can reach.
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page: this listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`.
      */
-    totalPages: number;
+    nextPageToken: string;
 }
 /**
  * Paginated list of application users.
  */
 export interface ListAppUsersResponse {
     users: AppUser[];
-    /** Total number of users */
+    /** Users matching the filter, bounded by the server count ceiling. */
     total: number;
-    /** Current page number */
-    page: number;
     /** Items per page */
     pageSize: number;
-    /** Total number of pages */
+    /** Pages at this `pageSize`, bounded by the same ceiling as `total`. */
     totalPages: number;
+    /**
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page: this listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`.
+     */
+    nextPageToken: string;
+    /**
+     * `true` when MORE than the server ceiling matched, so the count stopped
+     * there and `total` / `totalPages` are a lower bound.
+     */
+    totalCapped: boolean;
 }
 /**
  * Paginated list of application movements.
  */
 export interface ListAppMovementsResponse {
     movements: AppMovement[];
-    /**
-     * Matching movements. Exact up to 10,000 pages of the requested page size
-     * (`pageSize` x 10,000 rows) and saturates there, so an application with
-     * more matching movements than the listing can page through reads the cap,
-     * not its lifetime total.
-     */
-    total: number;
-    /** Current page number */
-    page: number;
     /** Items per page */
     pageSize: number;
     /**
-     * Number of pages at the requested page size. Exact up to 10,000 and
-     * saturates there, the last page this listing can reach.
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page: this listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`.
      */
-    totalPages: number;
+    nextPageToken: string;
 }
 /**
  * Paginated list of application balances.
  */
 export interface ListAppBalancesResponse {
     balances: AppBalance[];
-    /** Total matching balances */
+    /** Balances matching the filter, bounded by the server count ceiling. */
     total: number;
-    /** Current page number */
-    page: number;
     /** Items per page */
     pageSize: number;
-    /** Total number of pages */
+    /** Pages at this `pageSize`, bounded by the same ceiling as `total`. */
     totalPages: number;
+    /**
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page: this listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`.
+     */
+    nextPageToken: string;
+    /**
+     * `true` when MORE than the server ceiling matched, so the count stopped
+     * there and `total` / `totalPages` are a lower bound.
+     */
+    totalCapped: boolean;
 }
 /**
  * Aggregate volume and fee stats for an application.

package/dist/applications/responses.js

@@ -2,6 +2,6 @@
  * Applications Response Types
  *
  * Response types for application configuration operations and the
- * backend-authenticated application reporting endpoints. Reporting types use
+ * public application reporting endpoints. Reporting types use
  * the wire shape (snake_case); optional fields are `null` rather than omitted.
  */

package/dist/fees/responses.js

@@ -126,7 +126,7 @@ export const FeeTierScheduleRowSchema = z.object({
  * Zod schema for the "my fee tier" response
  */
 export const GetMyFeeTierResponseSchema = z.object({
-    /** Caller's resolved tier (1–6) from their wallet's stored weighted 14-day volume */
+    /** Caller's resolved tier (1–6) from the higher of their wallet's weighted 14-day volume and any volume floor set on the wallet. A floor that is set or changed counts once it applies to the wallet's fills, usually within a minute, and likewise for an account the wallet opens in a new application; a removed or expired floor stops counting at once */
     currentTierLevel: z.number().int(),
     /** Caller's weighted 14-day volume (perp + 2.5× spot), summed across every application the wallet trades through */
     weightedVolume14d: z.string(),
@@ -134,7 +134,7 @@ export const GetMyFeeTierResponseSchema = z.object({
     spotVolume14d: z.string(),
     /** Caller's rolling 14-day perp volume, summed across every application the wallet trades through */
     perpVolume14d: z.string(),
-    /** Additional weighted volume needed to reach the next tier; absent at tier 6 */
+    /** Additional weighted volume needed to reach the next tier, counted from the volume the current tier resolved from; absent at tier 6 */
     volumeToNextTier: z.string().nullable().optional(),
     /** Next tier level; absent when already at tier 6 */
     nextTierLevel: z.number().int().nullable().optional(),

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

@@ -42,7 +42,8 @@ export interface MarginAccountSummary {
      * liquidation or frozen as bad debt) and on one whose realized loss has used
      * up its allocation; the parent margin account is charged at most a risk
      * bucket's allocation. Size transfers against this field, not
-     * `freeCollateral`.
+     * `freeCollateral`. Truncated toward zero at the quote asset's precision,
+     * so the printed amount itself is always accepted.
      */
     withdrawableCollateral: string;
     totalPositionNotional: string;
@@ -88,7 +89,8 @@ export interface MarginAccountSummary {
      *
      * Present only on risk-bucket rows served from a live risk engine snapshot;
      * absent (the key is omitted, never null) on parent rows and on
-     * persisted-fallback reads.
+     * persisted-fallback reads. Truncated toward zero at the quote asset's
+     * precision, like `withdrawableCollateral`.
      */
     availableOrderCollateral?: string;
     /**
@@ -105,8 +107,29 @@ export interface MarginAccountSummary {
     copyLeaderHandle?: string;
 }
 export interface ListMarginAccountsParams {
-    page?: number;
+    /** Number of items per page, 1 to 1000 (default 20) */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position, from the lowest margin account id.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a `400`. The walk seeks on
+     * `(marginAccountId, tradingPairId, riskBucketId, strategyKey)` over the
+     * repriced set the server builds per request — the parent account row ahead
+     * of its own bucket rows — so a bucket that opens or closes mid-walk no
+     * longer shifts the rows behind it across the resume point. The strategy key
+     * is part of the key because an auto bucket the engine has not materialized
+     * yet carries no `riskBucketId`, and one account and pair can hold several
+     * strategies; such a row sorts under the id its bucket will carry once the
+     * engine projects it, so provisioning completing mid-walk cannot serve the
+     * same risk bucket twice. The filters must match the request that minted the
+     * token.
+     */
+    pageToken?: string;
     /**
      * Keep only risk-bucket rows in this state (see
      * {@link MarginAccountSummary.riskBucketState}). A parent margin account row
@@ -117,9 +140,19 @@ export interface ListMarginAccountsParams {
 }
 export interface ListMarginAccountsResponse {
     accounts: MarginAccountSummary[];
+    /**
+     * Rows matching the filters. Exact — a user's margin accounts and risk
+     * buckets are a small bounded set, counted in memory after the repricing
+     * pass.
+     */
     total: number;
-    page: number;
     pageSize: number;
+    /**
+     * Cursor for the next page, `""` once the walk is exhausted. The whole set
+     * is already in memory, so each page over-fetches one row and an empty token
+     * is definitive — follow a non-empty token, stop on an empty one.
+     */
+    nextPageToken: string;
 }
 export interface GetMarginAccountSummaryParams {
     tradingPairId?: string;
@@ -247,6 +280,10 @@ export interface TransferCollateralResponse {
     status: string;
     newEquity: string;
     newTotalCollateralValue: string;
+    /**
+     * The largest amount a further transfer-out will accept after this one,
+     * truncated toward zero at the collateral asset's precision.
+     */
     newWithdrawableCollateral: string;
     /**
      * Whether the transfer was committed to a position's stored margin. Present
@@ -261,8 +298,21 @@ export interface TransferCollateralResponse {
 }
 export interface GetMarginAccountMovementsParams {
     movementType?: string;
-    page?: number;
+    /** Items per page, 1 to 1000 (default 20). */
     pageSize?: number;
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position, from the newest row — this listing always sorts
+     *   newest-first.
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a 400. Filters must match the request that produced the
+     * token, or the request is rejected.
+     */
+    pageToken?: string;
 }
 export interface MarginAccountMovement {
     movementId: string;
@@ -274,15 +324,17 @@ export interface MarginAccountMovement {
 }
 export interface GetMarginAccountMovementsResponse {
     movements: MarginAccountMovement[];
+    pageSize: number;
     /**
-     * Matching movements. Exact up to 10,000 pages of the requested page size
-     * (`pageSize` x 10,000 rows) and saturates there, so a caller with more
-     * movements than the listing can page through reads the cap, not its
-     * lifetime total. `page` is capped at 10,000.
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page: this listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`. A non-empty token always
+     * has at least one further row behind it.
+     *
+     * The response carries no item count: the underlying ledger is too large to
+     * count behind a filter.
      */
-    total: number;
-    page: number;
-    pageSize: number;
+    nextPageToken: string;
 }
 export interface SimulateOrderRiskRequest {
     tradingPairId: string;
@@ -521,6 +573,14 @@ export interface MarginAccountsAPI extends BaseAPI {
     /** One of the caller's margin accounts' own realized and unrealized PnL. */
     getMarginAccountPnl(marginAccountId: string): Promise<MarginAccountPnl>;
     transferMarginCollateral(request: TransferMarginCollateralRequest): Promise<TransferMarginCollateralResponse>;
+    /**
+     * Move collateral from the default margin account to one of the caller's sub-accounts, in one
+     * sequenced step. The default margin account itself is refused; fund it with the
+     * parent-margin-account routes.
+     */
+    transferCollateralToSubAccount(marginAccountId: string, amount: string): Promise<TransferMarginCollateralResponse>;
+    /** Move collateral from one of the caller's sub-accounts back to the default margin account. */
+    transferCollateralFromSubAccount(marginAccountId: string, amount: string): Promise<TransferMarginCollateralResponse>;
     listMarginAccounts(params?: ListMarginAccountsParams): Promise<ListMarginAccountsResponse>;
     getParentMarginAccountSummary(params?: GetMarginAccountSummaryParams): Promise<MarginAccountSummary>;
     /**

package/dist/market/index.d.ts

@@ -48,6 +48,12 @@ export interface TradingPair {
     category: string;
     /** Whether the market is active */
     isActive: boolean;
+    /**
+     * Isolated-only market: cross margin may only reduce a position here. A
+     * CROSS order that is not reduce-only is rejected with the error code
+     * `CROSS_MARGIN_NOT_ALLOWED`; open the position with `marginMode: "ISOLATED"`.
+     */
+    isolatedOnly: boolean;
     /** Maker fee in basis points */
     makerFeeBps: number;
     /** Taker fee in basis points */
@@ -486,30 +492,94 @@ export interface FundingRecord {
 export interface ListFundingHistoryParams {
     startTime?: string;
     endTime?: string;
-    page?: number;
+    /** Number of items per page, 1 to 1000 (default 50) */
     pageSize?: number;
-    /** Sort direction for epoch: "ASC" or "DESC" (default DESC). */
+    /** Sort direction for `settledAt`: "ASC" or "DESC" (default DESC). */
     orderBy?: "ASC" | "DESC";
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position, from the newest settlement (the oldest when
+     *   `orderBy` is `"ASC"`).
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a `400`. The walk seeks on `(settledAt, id)` in the
+     * requested direction. Filters and `orderBy` must match the request that
+     * minted the token.
+     */
+    pageToken?: string;
 }
 export interface ListFundingHistoryResponse {
     records: FundingRecord[];
+    /**
+     * Settlements matching the filter, bounded by the server count ceiling — see
+     * `totalCapped`. A lower bound when `totalCapped` is `true`.
+     */
     total: number;
-    page: number;
+    /** Items per page */
     pageSize: number;
+    /**
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page. This listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`. A non-empty token always
+     * has at least one further row behind it.
+     */
+    nextPageToken: string;
+    /**
+     * `true` when MORE than the server ceiling of settlements matched, so the
+     * count stopped at the ceiling and `total` is a lower bound. `false` when
+     * `total` is the exact count — including exactly the ceiling, which is
+     * still reported exactly.
+     */
+    totalCapped: boolean;
 }
 export interface ListAllFundingHistoryParams {
     startTime?: string;
     endTime?: string;
-    page?: number;
+    /** Number of items per page, 1 to 1000 (default 50) */
     pageSize?: number;
-    /** Sort direction for settledAt (default DESC). */
+    /** Sort direction for `settledAt` (default DESC). */
     orderBy?: "ASC" | "DESC";
+    /**
+     * Pagination cursor with two states:
+     * - Omitted (`undefined`) or empty string (`""`): start a cursor walk with
+     *   no prior position, from the newest settlement (the oldest when
+     *   `orderBy` is `"ASC"`).
+     * - Non-empty: an opaque cursor from a previous response's
+     *   `nextPageToken`; results resume immediately after that position.
+     *
+     * Page-number pagination was removed (0XM-2788): there is no `page`, and
+     * sending one is a `400`. The walk seeks on `(settledAt, id)` in the
+     * requested direction. Filters and `orderBy` must match the request that
+     * minted the token.
+     */
+    pageToken?: string;
 }
 export interface ListAllFundingHistoryResponse {
     records: FundingRecord[];
+    /**
+     * Settlements matching the filter, bounded by the server count ceiling — see
+     * `totalCapped`. A lower bound when `totalCapped` is `true`.
+     */
     total: number;
-    page: number;
+    /** Items per page */
     pageSize: number;
+    /**
+     * Cursor for the next page, minted from the last row of an over-fetched
+     * page. This listing is one ordered read, so a page shorter than `pageSize`
+     * proves the walk is exhausted and this is `""`. A non-empty token always
+     * has at least one further row behind it.
+     */
+    nextPageToken: string;
+    /**
+     * `true` when MORE than the server ceiling of settlements matched, so the
+     * count stopped at the ceiling and `total` is a lower bound. `false` when
+     * `total` is the exact count — including exactly the ceiling, which is
+     * still reported exactly.
+     */
+    totalCapped: boolean;
 }
 export interface OpenInterest {
     tradingPairId: string;