@nadohq/nuanze-client 0.41.0 → 0.42.0

package/README.md

@@ -29,14 +29,14 @@ Nuanze runs a single public deployment that serves mainnet data, so every entry
 
 ## API Surface
 
-Each method maps one-to-one onto a public operation. Most are GET; `getFollowedLeaderboard` is a
-non-mutating POST whose body carries the followed set:
+Each method maps one-to-one onto a public GET operation:
 
 - `getNews`
 - `getMarkets`
 - `getMarketByTicker`
 - `getFundingRates`
 - `getLeaderboard`
+- `getSubaccountLeaderboard`
 - `getPlatformSummary`
 - `getFollowedLeaderboard`
 - `getWalletSummary`
@@ -60,13 +60,6 @@ Decimal fields are mapped to `BigNumber`; timestamps stay UTC ISO 8601 strings,
 Failures arrive as `NuanzeServerFailureError`, carrying `errorCode` (comparable against
 `NUANZE_ERROR_CODES`), `httpStatus`, and the `requestId` to quote when reporting the failure.
 
-## Rate Limits
-
-The API meters a weighted token bucket per client IP and reports its state in the `RateLimit-Limit`,
-`RateLimit-Remaining`, and `RateLimit-Reset` response headers. The client never retries, sleeps, or
-self-throttles; add an interceptor on `nuanze.axiosInstance` to observe the headers or to apply per-request
-timeouts and cancellation.
-
 ## License
 
 ISC

package/dist/{NuanzeClient-BUjoXpWV.cjs → NuanzeClient-ILfa7B1C.cjs}

@@ -33,11 +33,7 @@ axios = __toESM(axios, 1);
 * Read-only and credential-free, so unlike the other service clients it takes no wallet client or
 * linked signer. It also sends no `x-nado-client-type` header: Nuanze is a public API that does not
 * attribute traffic per client, and its `Access-Control-Allow-Headers` does not list the header, so
-* sending it would fail CORS preflight in the browser. Most operations are GET;
-* {@link NuanzeClient.getFollowedLeaderboard} is a non-mutating POST whose body carries a followed
-* set larger than a query string can reliably hold. The API meters a weighted token bucket per
-* client IP and reports its state in the `RateLimit-Limit`, `RateLimit-Remaining`, and
-* `RateLimit-Reset` response headers; add an interceptor on {@link axiosInstance} to observe them.
+* sending it would fail CORS preflight in the browser. All operations are GET.
 */
 var NuanzeClient = class {
 	constructor(opts) {
@@ -94,7 +90,7 @@ var NuanzeClient = class {
 	}
 	/**
 	* Gets the account PnL leaderboard. Equity-basis account PnL includes realized and unrealized
-	* movement plus funding and is not realized PnL. All-time analytics cost five rate-limit units.
+	* movement plus funding and is not realized PnL.
 	*
 	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid.
 	*/
@@ -102,6 +98,17 @@ var NuanzeClient = class {
 		return require_dataMappers.mapNuanzeLeaderboardResponse(await this.getJson("/leaderboard", params));
 	}
 	/**
+	* Gets the global public leaderboard of username-claimed subaccounts. Results are sorted by
+	* equity-basis account PnL descending with nulls last. `globalRank` is independent of the active
+	* privacy and trading filters. Pagination uses a filter-bound opaque cursor.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`, or
+	* `CURSOR_FILTER_MISMATCH` when filters or the cursor are invalid.
+	*/
+	async getSubaccountLeaderboard(params = {}) {
+		return require_dataMappers.mapNuanzeSubaccountLeaderboardResponse(await this.getJson("/leaderboard/subaccounts", params));
+	}
+	/**
 	* Gets platform activity summary from five-minute aggregates.
 	*
 	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if the window is not a documented value.
@@ -110,17 +117,15 @@ var NuanzeClient = class {
 		return require_dataMappers.mapNuanzePlatformSummaryResponse(await this.getJson("/platform/summary", params));
 	}
 	/**
-	* Gets leaderboard stats for a set of followed subaccounts. POST rather than GET so the body can
-	* carry up to 300 `subaccountHex` values. The response preserves request order. Subaccounts with
-	* no data in the window are backfilled with `pnl: null`, `globalRank: null`, zero counts, and an
-	* empty `productIds`. Costs five rate-limit units. The response is not cached.
+	* Gets a keyset-paginated leaderboard for every subaccount a username actively follows, sorted
+	* by PnL descending with nulls last. Subaccounts with no PnL in the window are included by
+	* default with null PnL/rank, zero counts, and no products.
 	*
-	* @throws {NuanzeServerFailureError} With `INVALID_SUBACCOUNT` if a hex is not 32-byte
-	* 0x-prefixed, and `BAD_REQUEST` if the set is empty, exceeds 300, or `timeframe` is not a
-	* documented value.
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid, or
+	* `USERNAME_NOT_FOUND` when the supplied username has no claimed identity.
 	*/
 	async getFollowedLeaderboard(params) {
-		return require_dataMappers.mapNuanzeFollowedLeaderboardResponse(await this.postJson("/wallets/leaderboard", params));
+		return require_dataMappers.mapNuanzeFollowedLeaderboardResponse(await this.getJson("/wallets/leaderboard", params));
 	}
 	/**
 	* Gets replica-backed wallet analytics. Without `subaccountName`, latest cumulative values are
@@ -241,7 +246,7 @@ var NuanzeClient = class {
 	* Gets privacy-preserving aggregate positioning for an active perpetual. Cross and isolated legs
 	* are summed within owner/subaccount/product before direction classification. Every cell requires
 	* at least 20 distinct contributing owners. No identity, individual position, entry price, PnL,
-	* margin, or leverage fields are returned. This operation costs five rate-limit units.
+	* margin, or leverage fields are returned.
 	*
 	* @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`, or
 	* `BAD_REQUEST` on invalid input, and `MARKET_NOT_FOUND` when the ticker does not resolve to a
@@ -269,8 +274,7 @@ var NuanzeClient = class {
 	* Lists current open perpetual position legs across every market by signed unrealized PnL.
 	* Descending returns the largest gainers and ascending returns the largest losers. This is a
 	* latest indexed snapshot with no timeframe. Legs below $10 absolute notional are excluded.
-	* Each row includes market identity and its source snapshot timestamp. Costs five rate-limit
-	* units.
+	* Each row includes market identity and its source snapshot timestamp.
 	*
 	* @throws {NuanzeServerFailureError} With `INVALID_CURSOR`, `CURSOR_FILTER_MISMATCH`, or
 	* `BAD_REQUEST` when the query or cursor is invalid.
@@ -282,18 +286,11 @@ var NuanzeClient = class {
 	* Performs a GET against `{baseUrl}{path}` and classifies the status before returning the body.
 	*/
 	async getJson(path, params) {
-		return this.requestJson("GET", path, { params });
-	}
-	/**
-	* Performs a POST against `{baseUrl}{path}` with a JSON body and classifies the status before
-	* returning the response. Used only for the non-mutating followed-leaderboard operation.
-	*/
-	async postJson(path, data) {
-		return this.requestJson("POST", path, { data });
+		return this.requestJson(path, { params });
 	}
-	async requestJson(method, path, config = {}) {
+	async requestJson(path, config = {}) {
 		const response = await this.axiosInstance.request({
-			method,
+			method: "GET",
 			url: `${this.opts.url}${path}`,
 			...config
 		});
@@ -324,4 +321,4 @@ Object.defineProperty(exports, "__toESM", {
 	}
 });
 
-//# sourceMappingURL=NuanzeClient-BUjoXpWV.cjs.map
+//# sourceMappingURL=NuanzeClient-ILfa7B1C.cjs.map

package/dist/NuanzeClient-ILfa7B1C.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuanzeClient-ILfa7B1C.cjs","names":["mapNuanzeNewsResponse","mapNuanzeMarketsResponse","mapNuanzeMarketByTickerResponse","mapNuanzeFundingRatesResponse","mapNuanzeLeaderboardResponse","mapNuanzeSubaccountLeaderboardResponse","mapNuanzePlatformSummaryResponse","mapNuanzeFollowedLeaderboardResponse","mapNuanzeWalletSummaryResponse","mapNuanzeWalletPositionsResponse","mapNuanzeMarketTradesResponse","mapNuanzeMarketCandlesResponse","mapNuanzeWalletTradesResponse","mapNuanzeWalletPnlResponse","mapNuanzeWalletPnlSeriesResponse","mapNuanzeCollateralFlowsResponse","mapNuanzeCollateralFlowSummaryResponse","mapNuanzeCollateralFlowSeriesResponse","mapNuanzeMarketPositioningResponse","mapNuanzeMarketPositionsResponse","mapNuanzeOpenPositionsResponse","isNuanzeServerFailureResponse","NuanzeServerFailureError"],"sources":["../src/NuanzeClient.ts"],"sourcesContent":["import axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  mapNuanzeCollateralFlowSeriesResponse,\n  mapNuanzeCollateralFlowSummaryResponse,\n  mapNuanzeCollateralFlowsResponse,\n  mapNuanzeFollowedLeaderboardResponse,\n  mapNuanzeFundingRatesResponse,\n  mapNuanzeLeaderboardResponse,\n  mapNuanzeMarketByTickerResponse,\n  mapNuanzeMarketCandlesResponse,\n  mapNuanzeMarketPositioningResponse,\n  mapNuanzeMarketPositionsResponse,\n  mapNuanzeMarketTradesResponse,\n  mapNuanzeMarketsResponse,\n  mapNuanzeNewsResponse,\n  mapNuanzeOpenPositionsResponse,\n  mapNuanzePlatformSummaryResponse,\n  mapNuanzeSubaccountLeaderboardResponse,\n  mapNuanzeWalletPnlResponse,\n  mapNuanzeWalletPnlSeriesResponse,\n  mapNuanzeWalletPositionsResponse,\n  mapNuanzeWalletSummaryResponse,\n  mapNuanzeWalletTradesResponse,\n} from './dataMappers';\nimport {\n  GetNuanzeCollateralFlowSeriesParams,\n  GetNuanzeCollateralFlowSeriesResponse,\n  GetNuanzeCollateralFlowSummaryParams,\n  GetNuanzeCollateralFlowSummaryResponse,\n  GetNuanzeCollateralFlowsParams,\n  GetNuanzeCollateralFlowsResponse,\n  GetNuanzeFollowedLeaderboardParams,\n  GetNuanzeFollowedLeaderboardResponse,\n  GetNuanzeFundingRatesParams,\n  GetNuanzeFundingRatesResponse,\n  GetNuanzeLeaderboardParams,\n  GetNuanzeLeaderboardResponse,\n  GetNuanzeMarketByTickerParams,\n  GetNuanzeMarketByTickerResponse,\n  GetNuanzeMarketCandlesParams,\n  GetNuanzeMarketCandlesResponse,\n  GetNuanzeMarketPositioningParams,\n  GetNuanzeMarketPositioningResponse,\n  GetNuanzeMarketPositionsParams,\n  GetNuanzeMarketPositionsResponse,\n  GetNuanzeMarketTradesParams,\n  GetNuanzeMarketTradesResponse,\n  GetNuanzeMarketsParams,\n  GetNuanzeMarketsResponse,\n  GetNuanzeNewsParams,\n  GetNuanzeNewsResponse,\n  GetNuanzeOpenPositionsParams,\n  GetNuanzeOpenPositionsResponse,\n  GetNuanzePlatformSummaryParams,\n  GetNuanzePlatformSummaryResponse,\n  GetNuanzeSubaccountLeaderboardParams,\n  GetNuanzeSubaccountLeaderboardResponse,\n  GetNuanzeWalletPnlParams,\n  GetNuanzeWalletPnlResponse,\n  GetNuanzeWalletPnlSeriesParams,\n  GetNuanzeWalletPnlSeriesResponse,\n  GetNuanzeWalletPositionsParams,\n  GetNuanzeWalletPositionsResponse,\n  GetNuanzeWalletSummaryParams,\n  GetNuanzeWalletSummaryResponse,\n  GetNuanzeWalletTradesParams,\n  GetNuanzeWalletTradesResponse,\n} from './types/clientTypes';\nimport { NuanzeServerFailureError } from './types/NuanzeServerFailureError';\nimport { NuanzeServerMarketPositioningResponse } from './types/serverModelTypes';\nimport {\n  NuanzeServerCollateralFlowSeriesResponse,\n  NuanzeServerCollateralFlowSummaryResponse,\n  NuanzeServerCollateralFlowsResponse,\n  NuanzeServerFollowedLeaderboardResponse,\n  NuanzeServerFundingRatesResponse,\n  NuanzeServerLeaderboardResponse,\n  NuanzeServerMarketByTickerResponse,\n  NuanzeServerMarketCandlesResponse,\n  NuanzeServerMarketPositionsResponse,\n  NuanzeServerMarketTradesResponse,\n  NuanzeServerMarketsResponse,\n  NuanzeServerNewsResponse,\n  NuanzeServerOpenPositionsResponse,\n  NuanzeServerPlatformSummaryResponse,\n  NuanzeServerSubaccountLeaderboardResponse,\n  NuanzeServerWalletPnlResponse,\n  NuanzeServerWalletPnlSeriesResponse,\n  NuanzeServerWalletPositionsResponse,\n  NuanzeServerWalletSummaryResponse,\n  NuanzeServerWalletTradesResponse,\n  isNuanzeServerFailureResponse,\n} from './types/serverQueryTypes';\n\n/**\n * Options for constructing a {@link NuanzeClient}.\n */\nexport interface NuanzeClientOpts {\n  /**\n   * Base URL of the Nuanze API, including the version segment, e.g. {@link NUANZE_CLIENT_ENDPOINTS}.\n   */\n  url: string;\n}\n\n/**\n * Client for the Nuanze public analytics API: markets, wallets, trades, candles, collateral flows,\n * and positioning.\n *\n * Read-only and credential-free, so unlike the other service clients it takes no wallet client or\n * linked signer. It also sends no `x-nado-client-type` header: Nuanze is a public API that does not\n * attribute traffic per client, and its `Access-Control-Allow-Headers` does not list the header, so\n * sending it would fail CORS preflight in the browser. All operations are GET.\n */\nexport class NuanzeClient {\n  readonly opts: NuanzeClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: NuanzeClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      // Nuanze is public and answers every origin with `Access-Control-Allow-Origin: *`, which\n      // browsers reject for credentialed requests.\n      withCredentials: false,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n      // Repeatable `productId` must serialize as `productId=1&productId=2` (OpenAPI explode).\n      paramsSerializer: { indexes: null },\n    });\n  }\n\n  /**\n   * Lists published editorial stories, sorted by `publishedAt` descending then `id` descending.\n   * The opaque cursor is exclusive and bound to normalized filters. Raw article ingestion, scoring,\n   * queue, and newsdesk fields are excluded.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`, or\n   * `CURSOR_FILTER_MISMATCH` when filters or the cursor are invalid.\n   */\n  async getNews(\n    params: GetNuanzeNewsParams = {},\n  ): Promise<GetNuanzeNewsResponse> {\n    return mapNuanzeNewsResponse(\n      await this.getJson<NuanzeServerNewsResponse>('/news', params),\n    );\n  }\n\n  /**\n   * Gets the active market universe, ordered by `productId` ascending. Never truncated, so `count`\n   * always equals the length of `markets`. Market metadata refreshes about every five minutes and\n   * prices about every minute.\n   *\n   * @throws {NuanzeServerFailureError} With error code `BAD_REQUEST` if a filter value is not a\n   * documented venue or tradability state.\n   */\n  async getMarkets(\n    params: GetNuanzeMarketsParams = {},\n  ): Promise<GetNuanzeMarketsResponse> {\n    return mapNuanzeMarketsResponse(\n      await this.getJson<NuanzeServerMarketsResponse>('/markets', params),\n    );\n  }\n\n  /**\n   * Resolves a market by ticker. Lookup is case-insensitive and accepts canonical tickers or\n   * legacy source symbols. An explicit unavailable venue returns `MARKET_NOT_FOUND`. With no\n   * venue, `strictVenue=true` returns `AMBIGUOUS_MARKET` for multi-venue assets; otherwise the\n   * primary venue is used.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`, or\n   * `BAD_REQUEST` on invalid selectors, and `MARKET_NOT_FOUND` when the ticker does not resolve.\n   */\n  async getMarketByTicker(\n    params: GetNuanzeMarketByTickerParams,\n  ): Promise<GetNuanzeMarketByTickerResponse> {\n    const { ticker, ...query } = params;\n    return mapNuanzeMarketByTickerResponse(\n      await this.getJson<NuanzeServerMarketByTickerResponse>(\n        `/markets/${encodeURIComponent(ticker)}`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists the latest funding observation per active perpetual market, refreshed about every five\n   * minutes.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid.\n   */\n  async getFundingRates(\n    params: GetNuanzeFundingRatesParams = {},\n  ): Promise<GetNuanzeFundingRatesResponse> {\n    return mapNuanzeFundingRatesResponse(\n      await this.getJson<NuanzeServerFundingRatesResponse>(\n        '/funding/rates',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Gets the account PnL leaderboard. Equity-basis account PnL includes realized and unrealized\n   * movement plus funding and is not realized PnL.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid.\n   */\n  async getLeaderboard(\n    params: GetNuanzeLeaderboardParams = {},\n  ): Promise<GetNuanzeLeaderboardResponse> {\n    return mapNuanzeLeaderboardResponse(\n      await this.getJson<NuanzeServerLeaderboardResponse>(\n        '/leaderboard',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Gets the global public leaderboard of username-claimed subaccounts. Results are sorted by\n   * equity-basis account PnL descending with nulls last. `globalRank` is independent of the active\n   * privacy and trading filters. Pagination uses a filter-bound opaque cursor.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`, or\n   * `CURSOR_FILTER_MISMATCH` when filters or the cursor are invalid.\n   */\n  async getSubaccountLeaderboard(\n    params: GetNuanzeSubaccountLeaderboardParams = {},\n  ): Promise<GetNuanzeSubaccountLeaderboardResponse> {\n    return mapNuanzeSubaccountLeaderboardResponse(\n      await this.getJson<NuanzeServerSubaccountLeaderboardResponse>(\n        '/leaderboard/subaccounts',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Gets platform activity summary from five-minute aggregates.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if the window is not a documented value.\n   */\n  async getPlatformSummary(\n    params: GetNuanzePlatformSummaryParams = {},\n  ): Promise<GetNuanzePlatformSummaryResponse> {\n    return mapNuanzePlatformSummaryResponse(\n      await this.getJson<NuanzeServerPlatformSummaryResponse>(\n        '/platform/summary',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Gets a keyset-paginated leaderboard for every subaccount a username actively follows, sorted\n   * by PnL descending with nulls last. Subaccounts with no PnL in the window are included by\n   * default with null PnL/rank, zero counts, and no products.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid, or\n   * `USERNAME_NOT_FOUND` when the supplied username has no claimed identity.\n   */\n  async getFollowedLeaderboard(\n    params: GetNuanzeFollowedLeaderboardParams,\n  ): Promise<GetNuanzeFollowedLeaderboardResponse> {\n    return mapNuanzeFollowedLeaderboardResponse(\n      await this.getJson<NuanzeServerFollowedLeaderboardResponse>(\n        '/wallets/leaderboard',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Gets replica-backed wallet analytics. Without `subaccountName`, latest cumulative values are\n   * selected per known subaccount and then summed. The response is a snapshot and does not claim\n   * live health, withdrawable collateral, open-order, or signer state.\n   *\n   * @throws {NuanzeServerFailureError} With `INVALID_ADDRESS` or `BAD_REQUEST` on invalid input,\n   * and `WALLET_NOT_FOUND` when the address has no wallet data.\n   */\n  async getWalletSummary(\n    params: GetNuanzeWalletSummaryParams,\n  ): Promise<GetNuanzeWalletSummaryResponse> {\n    const { address, ...query } = params;\n    return mapNuanzeWalletSummaryResponse(\n      await this.getJson<NuanzeServerWalletSummaryResponse>(\n        `/wallets/${encodeURIComponent(address)}`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists at most 500 current replica position rows across all known subaccounts by default. Rows\n   * remain per subaccount. Spot rows are excluded unless `includeSpot=true`. This is not an\n   * execution-grade live feed.\n   *\n   * @throws {NuanzeServerFailureError} With `INVALID_ADDRESS` or `BAD_REQUEST` on invalid input,\n   * and `WALLET_NOT_FOUND` when the address has no wallet data.\n   */\n  async getWalletPositions(\n    params: GetNuanzeWalletPositionsParams,\n  ): Promise<GetNuanzeWalletPositionsResponse> {\n    const { address, ...query } = params;\n    return mapNuanzeWalletPositionsResponse(\n      await this.getJson<NuanzeServerWalletPositionsResponse>(\n        `/wallets/${encodeURIComponent(address)}/positions`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists market trades: one taker-side row per match, sorted by `matchedAt` then `id` descending.\n   * The exclusive cursor is bound to operation and normalized filters. `from` is inclusive and\n   * `to` exclusive. Wallet identity is absent.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`,\n   * `INVALID_CURSOR`, `CURSOR_FILTER_MISMATCH`, `RANGE_TOO_LARGE`, or `BAD_REQUEST` on invalid\n   * input, and `MARKET_NOT_FOUND` when the ticker does not resolve.\n   */\n  async getMarketTrades(\n    params: GetNuanzeMarketTradesParams,\n  ): Promise<GetNuanzeMarketTradesResponse> {\n    const { ticker, ...query } = params;\n    return mapNuanzeMarketTradesResponse(\n      await this.getJson<NuanzeServerMarketTradesResponse>(\n        `/markets/${encodeURIComponent(ticker)}/trades`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists market candles. Source storage is 1h; 4h and 1d are UTC-aligned rollups and missing bars\n   * are not interpolated. The newest `limit` matching bars are selected and returned\n   * oldest-to-newest, at most 750, with no pagination. A current bucket has `complete=false`.\n   *\n   * @throws {NuanzeServerFailureError} With `UNSUPPORTED_INTERVAL`, `RANGE_TOO_LARGE`,\n   * `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`, or `BAD_REQUEST` on invalid input, and\n   * `MARKET_NOT_FOUND` when the ticker does not resolve.\n   */\n  async getMarketCandles(\n    params: GetNuanzeMarketCandlesParams,\n  ): Promise<GetNuanzeMarketCandlesResponse> {\n    const { ticker, ...query } = params;\n    return mapNuanzeMarketCandlesResponse(\n      await this.getJson<NuanzeServerMarketCandlesResponse>(\n        `/markets/${encodeURIComponent(ticker)}/candles`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists wallet-owned maker and taker execution rows, sorted by `matchedAt` then `id` descending.\n   * The cursor is exclusive and filter-bound. `from` is inclusive and `to` exclusive.\n   *\n   * @throws {NuanzeServerFailureError} With `INVALID_ADDRESS`, `INVALID_CURSOR`,\n   * `CURSOR_FILTER_MISMATCH`, `RANGE_TOO_LARGE`, or `BAD_REQUEST` on invalid input, and\n   * `WALLET_NOT_FOUND` when the address has no wallet data.\n   */\n  async getWalletTrades(\n    params: GetNuanzeWalletTradesParams,\n  ): Promise<GetNuanzeWalletTradesResponse> {\n    const { address, ...query } = params;\n    return mapNuanzeWalletTradesResponse(\n      await this.getJson<NuanzeServerWalletTradesResponse>(\n        `/wallets/${encodeURIComponent(address)}/trades`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Gets wallet account PnL. 24h is rolling and uses hourly snapshots with a daily fallback\n   * baseline. Longer windows use daily snapshots; `all` starts at earliest coverage. PnL includes\n   * realized and unrealized movement plus funding.\n   *\n   * @throws {NuanzeServerFailureError} With `INVALID_ADDRESS` or `BAD_REQUEST` on invalid input,\n   * and `WALLET_NOT_FOUND` when the address has no wallet data.\n   */\n  async getWalletPnl(\n    params: GetNuanzeWalletPnlParams,\n  ): Promise<GetNuanzeWalletPnlResponse> {\n    const { address, ...query } = params;\n    return mapNuanzeWalletPnlResponse(\n      await this.getJson<NuanzeServerWalletPnlResponse>(\n        `/wallets/${encodeURIComponent(address)}/pnl`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Gets a wallet account series of at most 1,000 deterministically sampled points ordered by\n   * timestamp. Series contain a boundary anchor and a carried-forward request-time tip; synthetic\n   * points are identified. Latest buckets may be provisional.\n   *\n   * @throws {NuanzeServerFailureError} With `INVALID_ADDRESS` or `BAD_REQUEST` on invalid input,\n   * and `WALLET_NOT_FOUND` when the address has no wallet data.\n   */\n  async getWalletPnlSeries(\n    params: GetNuanzeWalletPnlSeriesParams,\n  ): Promise<GetNuanzeWalletPnlSeriesResponse> {\n    const { address, ...query } = params;\n    return mapNuanzeWalletPnlSeriesResponse(\n      await this.getJson<NuanzeServerWalletPnlSeriesResponse>(\n        `/wallets/${encodeURIComponent(address)}/pnl/series`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists public collateral events, sorted by timestamp then `id` descending. Repeated `productId`\n   * uses OR semantics. `minUsd` excludes unvalued events; without it unvalued events remain.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`, or\n   * `CURSOR_FILTER_MISMATCH` when filters or the cursor are invalid.\n   */\n  async getCollateralFlows(\n    params: GetNuanzeCollateralFlowsParams = {},\n  ): Promise<GetNuanzeCollateralFlowsResponse> {\n    return mapNuanzeCollateralFlowsResponse(\n      await this.getJson<NuanzeServerCollateralFlowsResponse>('/flows', params),\n    );\n  }\n\n  /**\n   * Gets collateral flow aggregates: deposited, withdrawn, net, and gross, with valuation coverage\n   * and a prior equal-window comparison. `all` has no prior window.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid.\n   */\n  async getCollateralFlowSummary(\n    params: GetNuanzeCollateralFlowSummaryParams = {},\n  ): Promise<GetNuanzeCollateralFlowSummaryResponse> {\n    return mapNuanzeCollateralFlowSummaryResponse(\n      await this.getJson<NuanzeServerCollateralFlowSummaryResponse>(\n        '/flows/summary',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Gets collateral flow series of at most 1,000 UTC buckets. Allowed timeframe/bucket pairs are\n   * 24h/hour, 7d/hour or day (default hour), 30d/day, and all/day.\n   *\n   * @throws {NuanzeServerFailureError} With `UNSUPPORTED_BUCKET` or `BAD_REQUEST` when the pair or\n   * filters are invalid.\n   */\n  async getCollateralFlowSeries(\n    params: GetNuanzeCollateralFlowSeriesParams = {},\n  ): Promise<GetNuanzeCollateralFlowSeriesResponse> {\n    return mapNuanzeCollateralFlowSeriesResponse(\n      await this.getJson<NuanzeServerCollateralFlowSeriesResponse>(\n        '/flows/series',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Gets privacy-preserving aggregate positioning for an active perpetual. Cross and isolated legs\n   * are summed within owner/subaccount/product before direction classification. Every cell requires\n   * at least 20 distinct contributing owners. No identity, individual position, entry price, PnL,\n   * margin, or leverage fields are returned.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`, or\n   * `BAD_REQUEST` on invalid input, and `MARKET_NOT_FOUND` when the ticker does not resolve to a\n   * perp.\n   */\n  async getMarketPositioning(\n    params: GetNuanzeMarketPositioningParams,\n  ): Promise<GetNuanzeMarketPositioningResponse> {\n    const { ticker, ...query } = params;\n    return mapNuanzeMarketPositioningResponse(\n      await this.getJson<NuanzeServerMarketPositioningResponse>(\n        `/markets/${encodeURIComponent(ticker)}/positioning`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists open perpetual position legs for the resolved market. Results default to absolute\n   * notional descending and can be ordered by signed unrealized PnL or absolute base amount in\n   * either direction. Spot markets are not supported. Legs below $10 absolute notional are excluded.\n   * Wallet addresses and signed exact base amounts are returned.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`,\n   * `INVALID_CURSOR`, `CURSOR_FILTER_MISMATCH`, or `BAD_REQUEST` on invalid input, and\n   * `MARKET_NOT_FOUND` when the ticker does not resolve to a perp.\n   */\n  async getMarketPositions(\n    params: GetNuanzeMarketPositionsParams,\n  ): Promise<GetNuanzeMarketPositionsResponse> {\n    const { ticker, ...query } = params;\n    return mapNuanzeMarketPositionsResponse(\n      await this.getJson<NuanzeServerMarketPositionsResponse>(\n        `/markets/${encodeURIComponent(ticker)}/positions`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Lists current open perpetual position legs across every market by signed unrealized PnL.\n   * Descending returns the largest gainers and ascending returns the largest losers. This is a\n   * latest indexed snapshot with no timeframe. Legs below $10 absolute notional are excluded.\n   * Each row includes market identity and its source snapshot timestamp.\n   *\n   * @throws {NuanzeServerFailureError} With `INVALID_CURSOR`, `CURSOR_FILTER_MISMATCH`, or\n   * `BAD_REQUEST` when the query or cursor is invalid.\n   */\n  async getOpenPositions(\n    params: GetNuanzeOpenPositionsParams = {},\n  ): Promise<GetNuanzeOpenPositionsResponse> {\n    return mapNuanzeOpenPositionsResponse(\n      await this.getJson<NuanzeServerOpenPositionsResponse>(\n        '/positions',\n        params,\n      ),\n    );\n  }\n\n  /**\n   * Performs a GET against `{baseUrl}{path}` and classifies the status before returning the body.\n   */\n  private async getJson<T>(path: string, params?: object): Promise<T> {\n    return this.requestJson<T>(path, { params });\n  }\n\n  private async requestJson<T>(\n    path: string,\n    config: { params?: object } = {},\n  ): Promise<T> {\n    const response = await this.axiosInstance.request<T>({\n      method: 'GET',\n      url: `${this.opts.url}${path}`,\n      ...config,\n    });\n    this.checkResponseStatus(response);\n    return response.data;\n  }\n\n  /**\n   * Validates the HTTP status before interpreting the body. Nuanze maps every domain failure onto a\n   * non-2xx status carrying a failure envelope, so anything else is a transport-level error.\n   */\n  private checkResponseStatus(response: AxiosResponse<unknown>) {\n    if (response.status >= 200 && response.status < 300) {\n      return;\n    }\n    if (isNuanzeServerFailureResponse(response.data)) {\n      throw new NuanzeServerFailureError(response.data, response.status);\n    }\n    throw new Error(\n      `Unexpected response from Nuanze: ${response.status} ${response.statusText}. Data: ${JSON.stringify(response.data)}`,\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/NuanzeClient.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_NuanzeClient = require("./NuanzeClient-BUjoXpWV.cjs");
+const require_NuanzeClient = require("./NuanzeClient-ILfa7B1C.cjs");
 require("./dataMappers.cjs");
 exports.NuanzeClient = require_NuanzeClient.NuanzeClient;

package/dist/NuanzeClient.d.cts

@@ -1,4 +1,4 @@
-import { A as GetNuanzePlatformSummaryResponse, B as GetNuanzeWalletTradesResponse, C as GetNuanzeMarketsParams, D as GetNuanzeOpenPositionsParams, E as GetNuanzeNewsResponse, F as GetNuanzeWalletPositionsParams, I as GetNuanzeWalletPositionsResponse, L as GetNuanzeWalletSummaryParams, M as GetNuanzeWalletPnlResponse, N as GetNuanzeWalletPnlSeriesParams, O as GetNuanzeOpenPositionsResponse, P as GetNuanzeWalletPnlSeriesResponse, R as GetNuanzeWalletSummaryResponse, S as GetNuanzeMarketTradesResponse, T as GetNuanzeNewsParams, _ as GetNuanzeMarketPositioningParams, a as GetNuanzeCollateralFlowsParams, b as GetNuanzeMarketPositionsResponse, c as GetNuanzeFollowedLeaderboardResponse, d as GetNuanzeLeaderboardParams, f as GetNuanzeLeaderboardResponse, g as GetNuanzeMarketCandlesResponse, h as GetNuanzeMarketCandlesParams, i as GetNuanzeCollateralFlowSummaryResponse, j as GetNuanzeWalletPnlParams, k as GetNuanzePlatformSummaryParams, l as GetNuanzeFundingRatesParams, m as GetNuanzeMarketByTickerResponse, n as GetNuanzeCollateralFlowSeriesResponse, o as GetNuanzeCollateralFlowsResponse, p as GetNuanzeMarketByTickerParams, r as GetNuanzeCollateralFlowSummaryParams, s as GetNuanzeFollowedLeaderboardParams, t as GetNuanzeCollateralFlowSeriesParams, u as GetNuanzeFundingRatesResponse, v as GetNuanzeMarketPositioningResponse, w as GetNuanzeMarketsResponse, x as GetNuanzeMarketTradesParams, y as GetNuanzeMarketPositionsParams, z as GetNuanzeWalletTradesParams } from "./clientTypes-Du2RLy4W.cjs";
+import { A as GetNuanzePlatformSummaryResponse, B as GetNuanzeWalletSummaryResponse, C as GetNuanzeMarketsParams, D as GetNuanzeOpenPositionsParams, E as GetNuanzeNewsResponse, F as GetNuanzeWalletPnlSeriesParams, H as GetNuanzeWalletTradesResponse, I as GetNuanzeWalletPnlSeriesResponse, L as GetNuanzeWalletPositionsParams, M as GetNuanzeSubaccountLeaderboardResponse, N as GetNuanzeWalletPnlParams, O as GetNuanzeOpenPositionsResponse, P as GetNuanzeWalletPnlResponse, R as GetNuanzeWalletPositionsResponse, S as GetNuanzeMarketTradesResponse, T as GetNuanzeNewsParams, V as GetNuanzeWalletTradesParams, _ as GetNuanzeMarketPositioningParams, a as GetNuanzeCollateralFlowsParams, b as GetNuanzeMarketPositionsResponse, c as GetNuanzeFollowedLeaderboardResponse, d as GetNuanzeLeaderboardParams, f as GetNuanzeLeaderboardResponse, g as GetNuanzeMarketCandlesResponse, h as GetNuanzeMarketCandlesParams, i as GetNuanzeCollateralFlowSummaryResponse, j as GetNuanzeSubaccountLeaderboardParams, k as GetNuanzePlatformSummaryParams, l as GetNuanzeFundingRatesParams, m as GetNuanzeMarketByTickerResponse, n as GetNuanzeCollateralFlowSeriesResponse, o as GetNuanzeCollateralFlowsResponse, p as GetNuanzeMarketByTickerParams, r as GetNuanzeCollateralFlowSummaryParams, s as GetNuanzeFollowedLeaderboardParams, t as GetNuanzeCollateralFlowSeriesParams, u as GetNuanzeFundingRatesResponse, v as GetNuanzeMarketPositioningResponse, w as GetNuanzeMarketsResponse, x as GetNuanzeMarketTradesParams, y as GetNuanzeMarketPositionsParams, z as GetNuanzeWalletSummaryParams } from "./clientTypes-COeQAlKN.cjs";
 import { AxiosInstance } from "axios";
 
 //#region src/NuanzeClient.d.ts
@@ -18,11 +18,7 @@ interface NuanzeClientOpts {
  * Read-only and credential-free, so unlike the other service clients it takes no wallet client or
  * linked signer. It also sends no `x-nado-client-type` header: Nuanze is a public API that does not
  * attribute traffic per client, and its `Access-Control-Allow-Headers` does not list the header, so
- * sending it would fail CORS preflight in the browser. Most operations are GET;
- * {@link NuanzeClient.getFollowedLeaderboard} is a non-mutating POST whose body carries a followed
- * set larger than a query string can reliably hold. The API meters a weighted token bucket per
- * client IP and reports its state in the `RateLimit-Limit`, `RateLimit-Remaining`, and
- * `RateLimit-Reset` response headers; add an interceptor on {@link axiosInstance} to observe them.
+ * sending it would fail CORS preflight in the browser. All operations are GET.
  */
 declare class NuanzeClient {
   readonly opts: NuanzeClientOpts;
@@ -65,11 +61,20 @@ declare class NuanzeClient {
   getFundingRates(params?: GetNuanzeFundingRatesParams): Promise<GetNuanzeFundingRatesResponse>;
   /**
    * Gets the account PnL leaderboard. Equity-basis account PnL includes realized and unrealized
-   * movement plus funding and is not realized PnL. All-time analytics cost five rate-limit units.
+   * movement plus funding and is not realized PnL.
    *
    * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid.
    */
   getLeaderboard(params?: GetNuanzeLeaderboardParams): Promise<GetNuanzeLeaderboardResponse>;
+  /**
+   * Gets the global public leaderboard of username-claimed subaccounts. Results are sorted by
+   * equity-basis account PnL descending with nulls last. `globalRank` is independent of the active
+   * privacy and trading filters. Pagination uses a filter-bound opaque cursor.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`, or
+   * `CURSOR_FILTER_MISMATCH` when filters or the cursor are invalid.
+   */
+  getSubaccountLeaderboard(params?: GetNuanzeSubaccountLeaderboardParams): Promise<GetNuanzeSubaccountLeaderboardResponse>;
   /**
    * Gets platform activity summary from five-minute aggregates.
    *
@@ -77,14 +82,12 @@ declare class NuanzeClient {
    */
   getPlatformSummary(params?: GetNuanzePlatformSummaryParams): Promise<GetNuanzePlatformSummaryResponse>;
   /**
-   * Gets leaderboard stats for a set of followed subaccounts. POST rather than GET so the body can
-   * carry up to 300 `subaccountHex` values. The response preserves request order. Subaccounts with
-   * no data in the window are backfilled with `pnl: null`, `globalRank: null`, zero counts, and an
-   * empty `productIds`. Costs five rate-limit units. The response is not cached.
+   * Gets a keyset-paginated leaderboard for every subaccount a username actively follows, sorted
+   * by PnL descending with nulls last. Subaccounts with no PnL in the window are included by
+   * default with null PnL/rank, zero counts, and no products.
    *
-   * @throws {NuanzeServerFailureError} With `INVALID_SUBACCOUNT` if a hex is not 32-byte
-   * 0x-prefixed, and `BAD_REQUEST` if the set is empty, exceeds 300, or `timeframe` is not a
-   * documented value.
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid, or
+   * `USERNAME_NOT_FOUND` when the supplied username has no claimed identity.
    */
   getFollowedLeaderboard(params: GetNuanzeFollowedLeaderboardParams): Promise<GetNuanzeFollowedLeaderboardResponse>;
   /**
@@ -179,7 +182,7 @@ declare class NuanzeClient {
    * Gets privacy-preserving aggregate positioning for an active perpetual. Cross and isolated legs
    * are summed within owner/subaccount/product before direction classification. Every cell requires
    * at least 20 distinct contributing owners. No identity, individual position, entry price, PnL,
-   * margin, or leverage fields are returned. This operation costs five rate-limit units.
+   * margin, or leverage fields are returned.
    *
    * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`, or
    * `BAD_REQUEST` on invalid input, and `MARKET_NOT_FOUND` when the ticker does not resolve to a
@@ -201,8 +204,7 @@ declare class NuanzeClient {
    * Lists current open perpetual position legs across every market by signed unrealized PnL.
    * Descending returns the largest gainers and ascending returns the largest losers. This is a
    * latest indexed snapshot with no timeframe. Legs below $10 absolute notional are excluded.
-   * Each row includes market identity and its source snapshot timestamp. Costs five rate-limit
-   * units.
+   * Each row includes market identity and its source snapshot timestamp.
    *
    * @throws {NuanzeServerFailureError} With `INVALID_CURSOR`, `CURSOR_FILTER_MISMATCH`, or
    * `BAD_REQUEST` when the query or cursor is invalid.
@@ -212,11 +214,6 @@ declare class NuanzeClient {
    * Performs a GET against `{baseUrl}{path}` and classifies the status before returning the body.
    */
   private getJson;
-  /**
-   * Performs a POST against `{baseUrl}{path}` with a JSON body and classifies the status before
-   * returning the response. Used only for the non-mutating followed-leaderboard operation.
-   */
-  private postJson;
   private requestJson;
   /**
    * Validates the HTTP status before interpreting the body. Nuanze maps every domain failure onto a

package/dist/NuanzeClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"NuanzeClient.d.cts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AA6FA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;;;;;cAgBQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EA2FP;;;;;;;;EAtEL,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EA4HA;;;;;;;;EA9GL,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EA0KA;;;;;;;;;EA3JL,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EAqNR;;;;;;EArMG,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAqPD;;;;;;EAtOJ,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EAgRA;;;;;EAlQL,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAsRD;;;;;;;;;;EAnQJ,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EAzGR;;;;;;;;EA0HG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA5FT;;;;;;;;EA8GI,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA7ED;;;;;;;;;EAgGJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA7DD;;;;;;;;;EAgFJ,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA3CD;;;;;;;;EA6DJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAtBL;;;;;;;;EAwCA,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EApBA;;;;;;;;EAsCL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAAR;;;;;;;EAiBG,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAaD;;;;;;EADJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAkBR;;;;;;;EAFG,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;EA0CD;;;;;;;;;;EAvBJ,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;EAoEG;;;AAkBa;;;;;;;EAlErB,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;;EAoBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;;;;;UAQA,QAAA;EAAA,QAIA,WAAA;;;;;UAkBN,mBAAA;AAAA"}
+{"version":3,"file":"NuanzeClient.d.cts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AAiGA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;cAYQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAyER;;;;;;;;EApDJ,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EAsGD;;;;;;;;EAxFJ,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EAgJD;;;;;;;;;EAjIJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EA8LA;;;;;;EA9KL,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAoNR;;;;;;EArMG,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EAqPD;;;;;;;;EApOJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAkSD;;;;;EApRJ,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAjII;;;;;;;;EAkJT,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EA1HR;;;;;;;;EA2IG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA7GT;;;;;;;;EA+HI,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA9FD;;;;;;;;;EAiHJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAhFD;;;;;;;;;EAmGJ,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA/DD;;;;;;;;EAiFJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA3CL;;;;;;;;EA6DA,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EAxCA;;;;;;;;EA0DL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EApBR;;;;;;;EAqCG,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EADD;;;;;;EAaJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAAR;;;;;;;EAgBG,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;EAoBD;;;;;;;;;;EADJ,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;EA0CT;;;;;;;AAkCyB;;;EAxDrB,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;EAmBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;EAAA,QAIA,WAAA;;;;;UAiBN,mBAAA;AAAA"}

package/dist/NuanzeClient.d.ts

@@ -1,4 +1,4 @@
-import { A as GetNuanzePlatformSummaryResponse, B as GetNuanzeWalletTradesResponse, C as GetNuanzeMarketsParams, D as GetNuanzeOpenPositionsParams, E as GetNuanzeNewsResponse, F as GetNuanzeWalletPositionsParams, I as GetNuanzeWalletPositionsResponse, L as GetNuanzeWalletSummaryParams, M as GetNuanzeWalletPnlResponse, N as GetNuanzeWalletPnlSeriesParams, O as GetNuanzeOpenPositionsResponse, P as GetNuanzeWalletPnlSeriesResponse, R as GetNuanzeWalletSummaryResponse, S as GetNuanzeMarketTradesResponse, T as GetNuanzeNewsParams, _ as GetNuanzeMarketPositioningParams, a as GetNuanzeCollateralFlowsParams, b as GetNuanzeMarketPositionsResponse, c as GetNuanzeFollowedLeaderboardResponse, d as GetNuanzeLeaderboardParams, f as GetNuanzeLeaderboardResponse, g as GetNuanzeMarketCandlesResponse, h as GetNuanzeMarketCandlesParams, i as GetNuanzeCollateralFlowSummaryResponse, j as GetNuanzeWalletPnlParams, k as GetNuanzePlatformSummaryParams, l as GetNuanzeFundingRatesParams, m as GetNuanzeMarketByTickerResponse, n as GetNuanzeCollateralFlowSeriesResponse, o as GetNuanzeCollateralFlowsResponse, p as GetNuanzeMarketByTickerParams, r as GetNuanzeCollateralFlowSummaryParams, s as GetNuanzeFollowedLeaderboardParams, t as GetNuanzeCollateralFlowSeriesParams, u as GetNuanzeFundingRatesResponse, v as GetNuanzeMarketPositioningResponse, w as GetNuanzeMarketsResponse, x as GetNuanzeMarketTradesParams, y as GetNuanzeMarketPositionsParams, z as GetNuanzeWalletTradesParams } from "./clientTypes-DdpinbkS.js";
+import { A as GetNuanzePlatformSummaryResponse, B as GetNuanzeWalletSummaryResponse, C as GetNuanzeMarketsParams, D as GetNuanzeOpenPositionsParams, E as GetNuanzeNewsResponse, F as GetNuanzeWalletPnlSeriesParams, H as GetNuanzeWalletTradesResponse, I as GetNuanzeWalletPnlSeriesResponse, L as GetNuanzeWalletPositionsParams, M as GetNuanzeSubaccountLeaderboardResponse, N as GetNuanzeWalletPnlParams, O as GetNuanzeOpenPositionsResponse, P as GetNuanzeWalletPnlResponse, R as GetNuanzeWalletPositionsResponse, S as GetNuanzeMarketTradesResponse, T as GetNuanzeNewsParams, V as GetNuanzeWalletTradesParams, _ as GetNuanzeMarketPositioningParams, a as GetNuanzeCollateralFlowsParams, b as GetNuanzeMarketPositionsResponse, c as GetNuanzeFollowedLeaderboardResponse, d as GetNuanzeLeaderboardParams, f as GetNuanzeLeaderboardResponse, g as GetNuanzeMarketCandlesResponse, h as GetNuanzeMarketCandlesParams, i as GetNuanzeCollateralFlowSummaryResponse, j as GetNuanzeSubaccountLeaderboardParams, k as GetNuanzePlatformSummaryParams, l as GetNuanzeFundingRatesParams, m as GetNuanzeMarketByTickerResponse, n as GetNuanzeCollateralFlowSeriesResponse, o as GetNuanzeCollateralFlowsResponse, p as GetNuanzeMarketByTickerParams, r as GetNuanzeCollateralFlowSummaryParams, s as GetNuanzeFollowedLeaderboardParams, t as GetNuanzeCollateralFlowSeriesParams, u as GetNuanzeFundingRatesResponse, v as GetNuanzeMarketPositioningResponse, w as GetNuanzeMarketsResponse, x as GetNuanzeMarketTradesParams, y as GetNuanzeMarketPositionsParams, z as GetNuanzeWalletSummaryParams } from "./clientTypes-CpOcZ6ST.js";
 import { AxiosInstance } from "axios";
 
 //#region src/NuanzeClient.d.ts
@@ -18,11 +18,7 @@ interface NuanzeClientOpts {
  * Read-only and credential-free, so unlike the other service clients it takes no wallet client or
  * linked signer. It also sends no `x-nado-client-type` header: Nuanze is a public API that does not
  * attribute traffic per client, and its `Access-Control-Allow-Headers` does not list the header, so
- * sending it would fail CORS preflight in the browser. Most operations are GET;
- * {@link NuanzeClient.getFollowedLeaderboard} is a non-mutating POST whose body carries a followed
- * set larger than a query string can reliably hold. The API meters a weighted token bucket per
- * client IP and reports its state in the `RateLimit-Limit`, `RateLimit-Remaining`, and
- * `RateLimit-Reset` response headers; add an interceptor on {@link axiosInstance} to observe them.
+ * sending it would fail CORS preflight in the browser. All operations are GET.
  */
 declare class NuanzeClient {
   readonly opts: NuanzeClientOpts;
@@ -65,11 +61,20 @@ declare class NuanzeClient {
   getFundingRates(params?: GetNuanzeFundingRatesParams): Promise<GetNuanzeFundingRatesResponse>;
   /**
    * Gets the account PnL leaderboard. Equity-basis account PnL includes realized and unrealized
-   * movement plus funding and is not realized PnL. All-time analytics cost five rate-limit units.
+   * movement plus funding and is not realized PnL.
    *
    * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid.
    */
   getLeaderboard(params?: GetNuanzeLeaderboardParams): Promise<GetNuanzeLeaderboardResponse>;
+  /**
+   * Gets the global public leaderboard of username-claimed subaccounts. Results are sorted by
+   * equity-basis account PnL descending with nulls last. `globalRank` is independent of the active
+   * privacy and trading filters. Pagination uses a filter-bound opaque cursor.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`, or
+   * `CURSOR_FILTER_MISMATCH` when filters or the cursor are invalid.
+   */
+  getSubaccountLeaderboard(params?: GetNuanzeSubaccountLeaderboardParams): Promise<GetNuanzeSubaccountLeaderboardResponse>;
   /**
    * Gets platform activity summary from five-minute aggregates.
    *
@@ -77,14 +82,12 @@ declare class NuanzeClient {
    */
   getPlatformSummary(params?: GetNuanzePlatformSummaryParams): Promise<GetNuanzePlatformSummaryResponse>;
   /**
-   * Gets leaderboard stats for a set of followed subaccounts. POST rather than GET so the body can
-   * carry up to 300 `subaccountHex` values. The response preserves request order. Subaccounts with
-   * no data in the window are backfilled with `pnl: null`, `globalRank: null`, zero counts, and an
-   * empty `productIds`. Costs five rate-limit units. The response is not cached.
+   * Gets a keyset-paginated leaderboard for every subaccount a username actively follows, sorted
+   * by PnL descending with nulls last. Subaccounts with no PnL in the window are included by
+   * default with null PnL/rank, zero counts, and no products.
    *
-   * @throws {NuanzeServerFailureError} With `INVALID_SUBACCOUNT` if a hex is not 32-byte
-   * 0x-prefixed, and `BAD_REQUEST` if the set is empty, exceeds 300, or `timeframe` is not a
-   * documented value.
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid, or
+   * `USERNAME_NOT_FOUND` when the supplied username has no claimed identity.
    */
   getFollowedLeaderboard(params: GetNuanzeFollowedLeaderboardParams): Promise<GetNuanzeFollowedLeaderboardResponse>;
   /**
@@ -179,7 +182,7 @@ declare class NuanzeClient {
    * Gets privacy-preserving aggregate positioning for an active perpetual. Cross and isolated legs
    * are summed within owner/subaccount/product before direction classification. Every cell requires
    * at least 20 distinct contributing owners. No identity, individual position, entry price, PnL,
-   * margin, or leverage fields are returned. This operation costs five rate-limit units.
+   * margin, or leverage fields are returned.
    *
    * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`, or
    * `BAD_REQUEST` on invalid input, and `MARKET_NOT_FOUND` when the ticker does not resolve to a
@@ -201,8 +204,7 @@ declare class NuanzeClient {
    * Lists current open perpetual position legs across every market by signed unrealized PnL.
    * Descending returns the largest gainers and ascending returns the largest losers. This is a
    * latest indexed snapshot with no timeframe. Legs below $10 absolute notional are excluded.
-   * Each row includes market identity and its source snapshot timestamp. Costs five rate-limit
-   * units.
+   * Each row includes market identity and its source snapshot timestamp.
    *
    * @throws {NuanzeServerFailureError} With `INVALID_CURSOR`, `CURSOR_FILTER_MISMATCH`, or
    * `BAD_REQUEST` when the query or cursor is invalid.
@@ -212,11 +214,6 @@ declare class NuanzeClient {
    * Performs a GET against `{baseUrl}{path}` and classifies the status before returning the body.
    */
   private getJson;
-  /**
-   * Performs a POST against `{baseUrl}{path}` with a JSON body and classifies the status before
-   * returning the response. Used only for the non-mutating followed-leaderboard operation.
-   */
-  private postJson;
   private requestJson;
   /**
    * Validates the HTTP status before interpreting the body. Nuanze maps every domain failure onto a

package/dist/NuanzeClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NuanzeClient.d.ts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AA6FA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;;;;;cAgBQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EA2FP;;;;;;;;EAtEL,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EA4HA;;;;;;;;EA9GL,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EA0KA;;;;;;;;;EA3JL,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EAqNR;;;;;;EArMG,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAqPD;;;;;;EAtOJ,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EAgRA;;;;;EAlQL,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAsRD;;;;;;;;;;EAnQJ,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EAzGR;;;;;;;;EA0HG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA5FT;;;;;;;;EA8GI,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA7ED;;;;;;;;;EAgGJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA7DD;;;;;;;;;EAgFJ,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA3CD;;;;;;;;EA6DJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAtBL;;;;;;;;EAwCA,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EApBA;;;;;;;;EAsCL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAAR;;;;;;;EAiBG,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAaD;;;;;;EADJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAkBR;;;;;;;EAFG,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;EA0CD;;;;;;;;;;EAvBJ,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;EAoEG;;;AAkBa;;;;;;;EAlErB,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;;EAoBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;;;;;UAQA,QAAA;EAAA,QAIA,WAAA;;;;;UAkBN,mBAAA;AAAA"}
+{"version":3,"file":"NuanzeClient.d.ts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AAiGA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;cAYQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAyER;;;;;;;;EApDJ,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EAsGD;;;;;;;;EAxFJ,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EAgJD;;;;;;;;;EAjIJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EA8LA;;;;;;EA9KL,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAoNR;;;;;;EArMG,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EAqPD;;;;;;;;EApOJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAkSD;;;;;EApRJ,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAjII;;;;;;;;EAkJT,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EA1HR;;;;;;;;EA2IG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA7GT;;;;;;;;EA+HI,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA9FD;;;;;;;;;EAiHJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAhFD;;;;;;;;;EAmGJ,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA/DD;;;;;;;;EAiFJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA3CL;;;;;;;;EA6DA,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EAxCA;;;;;;;;EA0DL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EApBR;;;;;;;EAqCG,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EADD;;;;;;EAaJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAAR;;;;;;;EAgBG,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;EAoBD;;;;;;;;;;EADJ,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;EA0CT;;;;;;;AAkCyB;;;EAxDrB,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;EAmBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;EAAA,QAIA,WAAA;;;;;UAiBN,mBAAA;AAAA"}

package/dist/NuanzeClient.js

@@ -1,4 +1,4 @@
-import { mapNuanzeCollateralFlowSeriesResponse, mapNuanzeCollateralFlowSummaryResponse, mapNuanzeCollateralFlowsResponse, mapNuanzeFollowedLeaderboardResponse, mapNuanzeFundingRatesResponse, mapNuanzeLeaderboardResponse, mapNuanzeMarketByTickerResponse, mapNuanzeMarketCandlesResponse, mapNuanzeMarketPositioningResponse, mapNuanzeMarketPositionsResponse, mapNuanzeMarketTradesResponse, mapNuanzeMarketsResponse, mapNuanzeNewsResponse, mapNuanzeOpenPositionsResponse, mapNuanzePlatformSummaryResponse, mapNuanzeWalletPnlResponse, mapNuanzeWalletPnlSeriesResponse, mapNuanzeWalletPositionsResponse, mapNuanzeWalletSummaryResponse, mapNuanzeWalletTradesResponse } from "./dataMappers.js";
+import { mapNuanzeCollateralFlowSeriesResponse, mapNuanzeCollateralFlowSummaryResponse, mapNuanzeCollateralFlowsResponse, mapNuanzeFollowedLeaderboardResponse, mapNuanzeFundingRatesResponse, mapNuanzeLeaderboardResponse, mapNuanzeMarketByTickerResponse, mapNuanzeMarketCandlesResponse, mapNuanzeMarketPositioningResponse, mapNuanzeMarketPositionsResponse, mapNuanzeMarketTradesResponse, mapNuanzeMarketsResponse, mapNuanzeNewsResponse, mapNuanzeOpenPositionsResponse, mapNuanzePlatformSummaryResponse, mapNuanzeSubaccountLeaderboardResponse, mapNuanzeWalletPnlResponse, mapNuanzeWalletPnlSeriesResponse, mapNuanzeWalletPositionsResponse, mapNuanzeWalletSummaryResponse, mapNuanzeWalletTradesResponse } from "./dataMappers.js";
 import { NuanzeServerFailureError } from "./types/NuanzeServerFailureError.js";
 import { isNuanzeServerFailureResponse } from "./types/serverQueryTypes.js";
 import axios from "axios";
@@ -10,11 +10,7 @@ import axios from "axios";
 * Read-only and credential-free, so unlike the other service clients it takes no wallet client or
 * linked signer. It also sends no `x-nado-client-type` header: Nuanze is a public API that does not
 * attribute traffic per client, and its `Access-Control-Allow-Headers` does not list the header, so
-* sending it would fail CORS preflight in the browser. Most operations are GET;
-* {@link NuanzeClient.getFollowedLeaderboard} is a non-mutating POST whose body carries a followed
-* set larger than a query string can reliably hold. The API meters a weighted token bucket per
-* client IP and reports its state in the `RateLimit-Limit`, `RateLimit-Remaining`, and
-* `RateLimit-Reset` response headers; add an interceptor on {@link axiosInstance} to observe them.
+* sending it would fail CORS preflight in the browser. All operations are GET.
 */
 var NuanzeClient = class {
 	constructor(opts) {
@@ -71,7 +67,7 @@ var NuanzeClient = class {
 	}
 	/**
 	* Gets the account PnL leaderboard. Equity-basis account PnL includes realized and unrealized
-	* movement plus funding and is not realized PnL. All-time analytics cost five rate-limit units.
+	* movement plus funding and is not realized PnL.
 	*
 	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid.
 	*/
@@ -79,6 +75,17 @@ var NuanzeClient = class {
 		return mapNuanzeLeaderboardResponse(await this.getJson("/leaderboard", params));
 	}
 	/**
+	* Gets the global public leaderboard of username-claimed subaccounts. Results are sorted by
+	* equity-basis account PnL descending with nulls last. `globalRank` is independent of the active
+	* privacy and trading filters. Pagination uses a filter-bound opaque cursor.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`, or
+	* `CURSOR_FILTER_MISMATCH` when filters or the cursor are invalid.
+	*/
+	async getSubaccountLeaderboard(params = {}) {
+		return mapNuanzeSubaccountLeaderboardResponse(await this.getJson("/leaderboard/subaccounts", params));
+	}
+	/**
 	* Gets platform activity summary from five-minute aggregates.
 	*
 	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if the window is not a documented value.
@@ -87,17 +94,15 @@ var NuanzeClient = class {
 		return mapNuanzePlatformSummaryResponse(await this.getJson("/platform/summary", params));
 	}
 	/**
-	* Gets leaderboard stats for a set of followed subaccounts. POST rather than GET so the body can
-	* carry up to 300 `subaccountHex` values. The response preserves request order. Subaccounts with
-	* no data in the window are backfilled with `pnl: null`, `globalRank: null`, zero counts, and an
-	* empty `productIds`. Costs five rate-limit units. The response is not cached.
+	* Gets a keyset-paginated leaderboard for every subaccount a username actively follows, sorted
+	* by PnL descending with nulls last. Subaccounts with no PnL in the window are included by
+	* default with null PnL/rank, zero counts, and no products.
 	*
-	* @throws {NuanzeServerFailureError} With `INVALID_SUBACCOUNT` if a hex is not 32-byte
-	* 0x-prefixed, and `BAD_REQUEST` if the set is empty, exceeds 300, or `timeframe` is not a
-	* documented value.
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid, or
+	* `USERNAME_NOT_FOUND` when the supplied username has no claimed identity.
 	*/
 	async getFollowedLeaderboard(params) {
-		return mapNuanzeFollowedLeaderboardResponse(await this.postJson("/wallets/leaderboard", params));
+		return mapNuanzeFollowedLeaderboardResponse(await this.getJson("/wallets/leaderboard", params));
 	}
 	/**
 	* Gets replica-backed wallet analytics. Without `subaccountName`, latest cumulative values are
@@ -218,7 +223,7 @@ var NuanzeClient = class {
 	* Gets privacy-preserving aggregate positioning for an active perpetual. Cross and isolated legs
 	* are summed within owner/subaccount/product before direction classification. Every cell requires
 	* at least 20 distinct contributing owners. No identity, individual position, entry price, PnL,
-	* margin, or leverage fields are returned. This operation costs five rate-limit units.
+	* margin, or leverage fields are returned.
 	*
 	* @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `MARKET_SELECTOR_MISMATCH`, or
 	* `BAD_REQUEST` on invalid input, and `MARKET_NOT_FOUND` when the ticker does not resolve to a
@@ -246,8 +251,7 @@ var NuanzeClient = class {
 	* Lists current open perpetual position legs across every market by signed unrealized PnL.
 	* Descending returns the largest gainers and ascending returns the largest losers. This is a
 	* latest indexed snapshot with no timeframe. Legs below $10 absolute notional are excluded.
-	* Each row includes market identity and its source snapshot timestamp. Costs five rate-limit
-	* units.
+	* Each row includes market identity and its source snapshot timestamp.
 	*
 	* @throws {NuanzeServerFailureError} With `INVALID_CURSOR`, `CURSOR_FILTER_MISMATCH`, or
 	* `BAD_REQUEST` when the query or cursor is invalid.
@@ -259,18 +263,11 @@ var NuanzeClient = class {
 	* Performs a GET against `{baseUrl}{path}` and classifies the status before returning the body.
 	*/
 	async getJson(path, params) {
-		return this.requestJson("GET", path, { params });
-	}
-	/**
-	* Performs a POST against `{baseUrl}{path}` with a JSON body and classifies the status before
-	* returning the response. Used only for the non-mutating followed-leaderboard operation.
-	*/
-	async postJson(path, data) {
-		return this.requestJson("POST", path, { data });
+		return this.requestJson(path, { params });
 	}
-	async requestJson(method, path, config = {}) {
+	async requestJson(path, config = {}) {
 		const response = await this.axiosInstance.request({
-			method,
+			method: "GET",
 			url: `${this.opts.url}${path}`,
 			...config
 		});