@nadohq/nuanze-client 0.47.0 → 0.49.0

package/README.md

@@ -2,9 +2,11 @@
 
 HTTP client for the Nuanze public analytics API. Serves markets, wallets, trades, candles, collateral flows,
 positioning, and globally ranked current open positions. Read-only and credential-free, so unlike the other
-service clients it takes no wallet client or linked signer. Leaderboard viewer lookups take an explicit public
-wallet address (`getLeaderboard` `viewAs`) or bytes32 subaccount hex (`getSubaccountLeaderboard` `viewAs`) and
-require no authentication.
+service clients it takes no wallet client or linked signer. Leaderboard lookups take explicit public
+identifiers and require no authentication: collection viewer lookups take a wallet address (`getLeaderboard`
+`viewAs`) or bytes32 subaccount hex (`getSubaccountLeaderboard` and `getFollowedLeaderboard` `viewAs`), while
+dedicated point reads (`getWalletLeaderboardPosition`, `getSubaccountLeaderboardPosition`,
+`getFollowedLeaderboardPosition`) fetch one rank by path identifier.
 
 [Full SDK Documentation](https://nadohq.github.io/nado-typescript-sdk/index.html)
 
@@ -59,9 +61,12 @@ Each method maps one-to-one onto a public GET operation:
 - `getMarketByTicker`
 - `getFundingRates`
 - `getLeaderboard`
+- `getWalletLeaderboardPosition`
 - `getSubaccountLeaderboard`
+- `getSubaccountLeaderboardPosition`
 - `getPlatformSummary`
 - `getFollowedLeaderboard`
+- `getFollowedLeaderboardPosition`
 - `getWalletSummary`
 - `getWalletPositions`
 - `getMarketTrades`
@@ -77,11 +82,21 @@ Each method maps one-to-one onto a public GET operation:
 - `getOpenPositions`
 
 Decimal fields are mapped to `BigNumber`; timestamps stay UTC ISO 8601 strings, matching the API contract.
-Both leaderboard collections accept an optional `viewAs` viewer selector: `getLeaderboard` takes an EVM address
-and returns the wallet's full row plus rank as `viewer`; `getSubaccountLeaderboard` takes a bytes32 subaccount hex
-and returns `{ filteredRank, item }` as `viewer`. A `viewer` is null when `viewAs` is omitted or has no source row.
+All leaderboard collections accept an optional `viewAs` viewer selector: `getLeaderboard` takes an EVM address
+and returns the wallet's full row plus rank as `viewer`; `getSubaccountLeaderboard` and `getFollowedLeaderboard`
+take a bytes32 subaccount hex and return `{ filteredRank, item }` as `viewer`. A `viewer` is null when `viewAs` is
+omitted or has no source row (for the followed leaderboard: when the follower does not actively follow it).
 For subaccounts, privacy, trading, and username-claim filters define the filtered-rank population without removing
-an existing full item or its `globalRank`; exclusion sets only `filteredRank` to null.
+an existing full item or its `globalRank`; exclusion sets only `filteredRank` to null. On the followed leaderboard
+`filteredRank` counts only the follower's filter-passing followed subaccounts, while `globalRank` stays global.
+
+The dedicated point reads coexist with `viewAs`: `getWalletLeaderboardPosition({ address })` GETs
+`/leaderboard/wallets/{address}`, `getSubaccountLeaderboardPosition({ subaccountHex })` GETs
+`/leaderboard/subaccounts/{subaccountHex}`, and `getFollowedLeaderboardPosition({ subaccountHex, viewAs })` GETs
+`/wallets/leaderboard/followed/{viewAs}` scoped to the `subaccountHex` follower, each returning the same row shape
+without pagination. Use a point read when only one rank is needed; use `viewAs` for an inline lookup scoped to a
+ranked page. Position `item` is null only when no leaderboard source row exists for the identifier, and a
+filter-excluded subaccount keeps its full item (including `globalRank`) with `filteredRank` null.
 
 ```ts
 const board = await nuanze.getLeaderboard({
@@ -100,6 +115,31 @@ const subs = await nuanze.getSubaccountLeaderboard({
 if (subs.viewer) {
   console.log(subs.viewer.filteredRank, subs.viewer.item?.globalRank);
 }
+
+const position = await nuanze.getWalletLeaderboardPosition({
+  address: '0x1234567890123456789012345678901234567890',
+  timeframe: '30d',
+});
+if (position.item) {
+  console.log(position.item.rank, position.item.accountPnl.toFixed());
+}
+
+const subPosition = await nuanze.getSubaccountLeaderboardPosition({
+  subaccountHex: '0x1234...0012',
+  timeframe: '30d',
+});
+if (subPosition.item) {
+  console.log(subPosition.filteredRank, subPosition.item.globalRank);
+}
+
+const followedPosition = await nuanze.getFollowedLeaderboardPosition({
+  subaccountHex: '0xabcd...0000', // follower
+  viewAs: '0x1234...0012', // followed subaccount to position
+  timeframe: '30d',
+});
+if (followedPosition.item) {
+  console.log(followedPosition.filteredRank, followedPosition.item.globalRank);
+}
 ```
 
 ## Errors

package/dist/{NuanzeClient-DK1Y8O_6.cjs → NuanzeClient-Tl_Dke8Z.cjs}

@@ -103,6 +103,20 @@ var NuanzeClient = class {
 		return require_dataMappers.mapNuanzeLeaderboardResponse(await this.getJson("/leaderboard", params));
 	}
 	/**
+	* Gets one wallet's leaderboard position by explicit EVM address. Equity-basis account PnL
+	* includes realized and unrealized movement plus funding and is not realized PnL. `item` is
+	* null only when the wallet leaderboard source row is absent; `rank` is the global rank in
+	* the unfiltered leaderboard, independent of collection `limit` and `offset`. For an inline
+	* lookup scoped to a ranked page, `getLeaderboard` accepts `viewAs` instead.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid, or
+	* `INVALID_ADDRESS` when the address is malformed.
+	*/
+	async getWalletLeaderboardPosition(params) {
+		const { address, ...query } = params;
+		return require_dataMappers.mapNuanzeWalletLeaderboardPositionResponse(await this.getJson(`/leaderboard/wallets/${encodeURIComponent(address)}`, query));
+	}
+	/**
 	* Gets the global public leaderboard of subaccounts. Results are sorted by equity-basis account
 	* PnL descending with nulls last. Username and display name are null when unavailable.
 	* `globalRank` is independent of the active privacy and trading filters. Pagination uses a
@@ -119,6 +133,23 @@ var NuanzeClient = class {
 		return require_dataMappers.mapNuanzeSubaccountLeaderboardResponse(await this.getJson("/leaderboard/subaccounts", params));
 	}
 	/**
+	* Gets one subaccount's leaderboard position by explicit bytes32 subaccount hex
+	* (the SDK `subaccountToHex` form). `item.globalRank` reflects the subaccount's true position
+	* across the full leaderboard, independent of the `includePrivate`, `includeUntraded`, and
+	* `includeUnclaimed` filters, while `filteredRank` uses the request's active filters: an
+	* absent source row yields `filteredRank` null with `item` null, an existing but
+	* filter-excluded row keeps its full item with `filteredRank` null, and an included row
+	* carries both ranks. For an inline lookup scoped to a ranked page,
+	* `getSubaccountLeaderboard` accepts `viewAs` instead.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when filters are invalid, or
+	* `INVALID_SUBACCOUNT` when the subaccount hex is malformed.
+	*/
+	async getSubaccountLeaderboardPosition(params) {
+		const { subaccountHex, ...query } = params;
+		return require_dataMappers.mapNuanzeSubaccountLeaderboardPositionResponse(await this.getJson(`/leaderboard/subaccounts/${encodeURIComponent(subaccountHex)}`, query));
+	}
+	/**
 	* Gets platform activity summary from five-minute aggregates.
 	*
 	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if the window is not a documented value.
@@ -131,13 +162,39 @@ var NuanzeClient = class {
 	* follows, sorted by PnL descending with nulls last. The follower does not need a claimed
 	* username. Subaccounts with no PnL in the window are included by default with null PnL/rank,
 	* zero counts, and no products. Private subaccounts are excluded unless `includePrivate=true`.
+	* Pass `viewAs` with a bytes32 subaccount hex to also receive that followed subaccount's
+	* `filteredRank` (counted among the follower's filter-passing followed subaccounts) plus full
+	* item as `viewer` without altering pagination: `viewer` is null when `viewAs` is omitted or
+	* the follower does not actively follow that subaccount, and a filter-excluded followed row
+	* keeps its item with `filteredRank` null.
 	*
-	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid.
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`,
+	* `CURSOR_FILTER_MISMATCH`, or `INVALID_SUBACCOUNT` when params, the cursor, the follower
+	* hex, or `viewAs` are invalid.
 	*/
 	async getFollowedLeaderboard(params) {
 		return require_dataMappers.mapNuanzeFollowedLeaderboardResponse(await this.getJson("/wallets/leaderboard", params));
 	}
 	/**
+	* Gets one followed subaccount's position within a follower's leaderboard. `subaccountHex`
+	* identifies the follower whose active follow graph is ranked and `viewAs` the followed
+	* subaccount to position, both as bytes32 subaccount hex (the SDK `subaccountToHex` form).
+	* `item.globalRank` reflects the subaccount's true position across the full global subaccount
+	* leaderboard, independent of the follow graph and of the `includeUntraded`, `includePrivate`,
+	* and `includeUnclaimed` filters, while `filteredRank` counts only the follower's followed
+	* subaccounts passing the request's active filters: a subaccount the follower does not follow
+	* yields `filteredRank` null with `item` null, an existing but filter-excluded followed row
+	* keeps its full item with `filteredRank` null, and an included row carries both ranks. For an
+	* inline lookup scoped to a ranked page, `getFollowedLeaderboard` accepts `viewAs` instead.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when the timeframe or filters are
+	* invalid, or `INVALID_SUBACCOUNT` when either subaccount hex is malformed.
+	*/
+	async getFollowedLeaderboardPosition(params) {
+		const { viewAs, ...query } = params;
+		return require_dataMappers.mapNuanzeFollowedLeaderboardPositionResponse(await this.getJson(`/wallets/leaderboard/followed/${encodeURIComponent(viewAs)}`, query));
+	}
+	/**
 	* Gets replica-backed wallet analytics. Without `subaccountName`, latest cumulative values are
 	* selected per known subaccount and then summed. The response is a snapshot and does not claim
 	* live health, withdrawable collateral, open-order, or signer state.
@@ -345,4 +402,4 @@ Object.defineProperty(exports, "__toESM", {
 	}
 });
 
-//# sourceMappingURL=NuanzeClient-DK1Y8O_6.cjs.map
+//# sourceMappingURL=NuanzeClient-Tl_Dke8Z.cjs.map

package/dist/NuanzeClient-Tl_Dke8Z.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuanzeClient-Tl_Dke8Z.cjs","names":["mapNuanzeNewsResponse","mapNuanzeMarketsResponse","mapNuanzeMarketByTickerResponse","mapNuanzeFundingRatesResponse","mapNuanzeLeaderboardResponse","mapNuanzeWalletLeaderboardPositionResponse","mapNuanzeSubaccountLeaderboardResponse","mapNuanzeSubaccountLeaderboardPositionResponse","mapNuanzePlatformSummaryResponse","mapNuanzeFollowedLeaderboardResponse","mapNuanzeFollowedLeaderboardPositionResponse","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  mapNuanzeFollowedLeaderboardPositionResponse,\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  mapNuanzeSubaccountLeaderboardPositionResponse,\n  mapNuanzeSubaccountLeaderboardResponse,\n  mapNuanzeWalletLeaderboardPositionResponse,\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  GetNuanzeFollowedLeaderboardPositionParams,\n  GetNuanzeFollowedLeaderboardPositionResponse,\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  GetNuanzeSubaccountLeaderboardPositionParams,\n  GetNuanzeSubaccountLeaderboardPositionResponse,\n  GetNuanzeSubaccountLeaderboardResponse,\n  GetNuanzeWalletLeaderboardPositionParams,\n  GetNuanzeWalletLeaderboardPositionResponse,\n  GetNuanzeWalletPnlParams,\n  GetNuanzeWalletPnlResponse,\n  GetNuanzeWalletPnlSeriesParams,\n  GetNuanzeWalletPnlSeriesResponse,\n  GetNuanzeWalletPositionsParams,\n  GetNuanzeWalletPositionsResponse,\n  GetNuanzeWalletSummaryParams,\n  GetNuanzeWalletSummaryResponse,\n  GetNuanzeWalletTradesParams,\n  GetNuanzeWalletTradesResponse,\n  NuanzeMarketSelector,\n} from './types/clientTypes';\nimport { NuanzeServerFailureError } from './types/NuanzeServerFailureError';\nimport { NuanzeServerMarketPositioningResponse } from './types/serverModelTypes';\nimport {\n  NuanzeServerCollateralFlowSeriesResponse,\n  NuanzeServerCollateralFlowSummaryResponse,\n  NuanzeServerCollateralFlowsResponse,\n  NuanzeServerFollowedLeaderboardPositionResponse,\n  NuanzeServerFollowedLeaderboardResponse,\n  NuanzeServerFundingRatesResponse,\n  NuanzeServerLeaderboardResponse,\n  NuanzeServerMarketByTickerResponse,\n  NuanzeServerMarketCandlesResponse,\n  NuanzeServerMarketPositionsResponse,\n  NuanzeServerMarketTradesResponse,\n  NuanzeServerMarketsResponse,\n  NuanzeServerNewsResponse,\n  NuanzeServerOpenPositionsResponse,\n  NuanzeServerPlatformSummaryResponse,\n  NuanzeServerSubaccountLeaderboardPositionResponse,\n  NuanzeServerSubaccountLeaderboardResponse,\n  NuanzeServerWalletLeaderboardPositionResponse,\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   * Ticker filters include every product for the asset without distinguishing spot from perpetual\n   * markets; an optional product ID narrows to one exact product. The opaque cursor is exclusive\n   * and bound to normalized filters. Raw article ingestion, scoring, queue, and newsdesk fields are\n   * 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 {@link NuanzeMarketSelector}. Supply at least `ticker` or `productId`;\n   * when both are given, `productId` is used for the path segment and `ticker` is ignored.\n   * Ticker lookup is case-insensitive and accepts canonical tickers or legacy source symbols.\n   * An explicit unavailable venue returns `MARKET_NOT_FOUND`. With no venue, `strictVenue=true`\n   * returns `AMBIGUOUS_MARKET` for multi-venue assets; otherwise the primary venue is used.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET` or `BAD_REQUEST` on invalid\n   * selectors, and `MARKET_NOT_FOUND` when the selector does not resolve.\n   */\n  async getMarketByTicker(\n    params: GetNuanzeMarketByTickerParams,\n  ): Promise<GetNuanzeMarketByTickerResponse> {\n    return mapNuanzeMarketByTickerResponse(\n      await this.getMarketJson<NuanzeServerMarketByTickerResponse>(params),\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. Pass `viewAs` with an EVM address to also\n   * receive that wallet's full row plus rank as `viewer`, computed in the same request without\n   * altering pagination; `viewer` is null when `viewAs` is omitted or has no source row.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid, or\n   * `INVALID_ADDRESS` when `viewAs` is malformed.\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 one wallet's leaderboard position by explicit EVM address. Equity-basis account PnL\n   * includes realized and unrealized movement plus funding and is not realized PnL. `item` is\n   * null only when the wallet leaderboard source row is absent; `rank` is the global rank in\n   * the unfiltered leaderboard, independent of collection `limit` and `offset`. For an inline\n   * lookup scoped to a ranked page, `getLeaderboard` accepts `viewAs` instead.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid, or\n   * `INVALID_ADDRESS` when the address is malformed.\n   */\n  async getWalletLeaderboardPosition(\n    params: GetNuanzeWalletLeaderboardPositionParams,\n  ): Promise<GetNuanzeWalletLeaderboardPositionResponse> {\n    const { address, ...query } = params;\n    return mapNuanzeWalletLeaderboardPositionResponse(\n      await this.getJson<NuanzeServerWalletLeaderboardPositionResponse>(\n        `/leaderboard/wallets/${encodeURIComponent(address)}`,\n        query,\n      ),\n    );\n  }\n\n  /**\n   * Gets the global public leaderboard of subaccounts. Results are sorted by equity-basis account\n   * PnL descending with nulls last. Username and display name are null when unavailable.\n   * `globalRank` is independent of the active privacy and trading filters. Pagination uses a\n   * filter-bound opaque cursor. Pass `viewAs` with a bytes32 subaccount hex to also receive that\n   * subaccount's `filteredRank` plus full item as `viewer` without altering pagination: `viewer`\n   * is null when `viewAs` is omitted or has no source row, and a filter-excluded row keeps its\n   * item with `filteredRank` null.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`,\n   * `CURSOR_FILTER_MISMATCH`, or `INVALID_SUBACCOUNT` when filters, the cursor, or `viewAs`\n   * 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 one subaccount's leaderboard position by explicit bytes32 subaccount hex\n   * (the SDK `subaccountToHex` form). `item.globalRank` reflects the subaccount's true position\n   * across the full leaderboard, independent of the `includePrivate`, `includeUntraded`, and\n   * `includeUnclaimed` filters, while `filteredRank` uses the request's active filters: an\n   * absent source row yields `filteredRank` null with `item` null, an existing but\n   * filter-excluded row keeps its full item with `filteredRank` null, and an included row\n   * carries both ranks. For an inline lookup scoped to a ranked page,\n   * `getSubaccountLeaderboard` accepts `viewAs` instead.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when filters are invalid, or\n   * `INVALID_SUBACCOUNT` when the subaccount hex is malformed.\n   */\n  async getSubaccountLeaderboardPosition(\n    params: GetNuanzeSubaccountLeaderboardPositionParams,\n  ): Promise<GetNuanzeSubaccountLeaderboardPositionResponse> {\n    const { subaccountHex, ...query } = params;\n    return mapNuanzeSubaccountLeaderboardPositionResponse(\n      await this.getJson<NuanzeServerSubaccountLeaderboardPositionResponse>(\n        `/leaderboard/subaccounts/${encodeURIComponent(subaccountHex)}`,\n        query,\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 supplied bytes32 subaccount actively\n   * follows, sorted by PnL descending with nulls last. The follower does not need a claimed\n   * username. Subaccounts with no PnL in the window are included by default with null PnL/rank,\n   * zero counts, and no products. Private subaccounts are excluded unless `includePrivate=true`.\n   * Pass `viewAs` with a bytes32 subaccount hex to also receive that followed subaccount's\n   * `filteredRank` (counted among the follower's filter-passing followed subaccounts) plus full\n   * item as `viewer` without altering pagination: `viewer` is null when `viewAs` is omitted or\n   * the follower does not actively follow that subaccount, and a filter-excluded followed row\n   * keeps its item with `filteredRank` null.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`,\n   * `CURSOR_FILTER_MISMATCH`, or `INVALID_SUBACCOUNT` when params, the cursor, the follower\n   * hex, or `viewAs` are invalid.\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 one followed subaccount's position within a follower's leaderboard. `subaccountHex`\n   * identifies the follower whose active follow graph is ranked and `viewAs` the followed\n   * subaccount to position, both as bytes32 subaccount hex (the SDK `subaccountToHex` form).\n   * `item.globalRank` reflects the subaccount's true position across the full global subaccount\n   * leaderboard, independent of the follow graph and of the `includeUntraded`, `includePrivate`,\n   * and `includeUnclaimed` filters, while `filteredRank` counts only the follower's followed\n   * subaccounts passing the request's active filters: a subaccount the follower does not follow\n   * yields `filteredRank` null with `item` null, an existing but filter-excluded followed row\n   * keeps its full item with `filteredRank` null, and an included row carries both ranks. For an\n   * inline lookup scoped to a ranked page, `getFollowedLeaderboard` accepts `viewAs` instead.\n   *\n   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when the timeframe or filters are\n   * invalid, or `INVALID_SUBACCOUNT` when either subaccount hex is malformed.\n   */\n  async getFollowedLeaderboardPosition(\n    params: GetNuanzeFollowedLeaderboardPositionParams,\n  ): Promise<GetNuanzeFollowedLeaderboardPositionResponse> {\n    const { viewAs, ...query } = params;\n    return mapNuanzeFollowedLeaderboardPositionResponse(\n      await this.getJson<NuanzeServerFollowedLeaderboardPositionResponse>(\n        `/wallets/leaderboard/followed/${encodeURIComponent(viewAs)}`,\n        query,\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 for a {@link NuanzeMarketSelector}: one taker-side row per match, sorted\n   * by `matchedAt` then `id` descending. Supply at least `ticker` or `productId`; when both are\n   * given, `productId` is used for the path segment and `ticker` is ignored. The exclusive cursor\n   * is bound to operation and normalized filters. `from` is inclusive and `to` exclusive. Wallet\n   * identity is absent.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `INVALID_CURSOR`,\n   * `CURSOR_FILTER_MISMATCH`, `RANGE_TOO_LARGE`, or `BAD_REQUEST` on invalid input, and\n   * `MARKET_NOT_FOUND` when the selector does not resolve.\n   */\n  async getMarketTrades(\n    params: GetNuanzeMarketTradesParams,\n  ): Promise<GetNuanzeMarketTradesResponse> {\n    return mapNuanzeMarketTradesResponse(\n      await this.getMarketJson<NuanzeServerMarketTradesResponse>(\n        params,\n        '/trades',\n      ),\n    );\n  }\n\n  /**\n   * Lists market candles for a {@link NuanzeMarketSelector}. Supply at least `ticker` or\n   * `productId`; when both are given, `productId` is used for the path segment and `ticker` is\n   * ignored. Source storage is 1h; 4h and 1d are UTC-aligned rollups and missing bars are not\n   * interpolated. The newest `limit` matching bars are selected and returned oldest-to-newest,\n   * 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`, or `BAD_REQUEST` on invalid input, and `MARKET_NOT_FOUND` when the\n   * selector does not resolve.\n   */\n  async getMarketCandles(\n    params: GetNuanzeMarketCandlesParams,\n  ): Promise<GetNuanzeMarketCandlesResponse> {\n    return mapNuanzeMarketCandlesResponse(\n      await this.getMarketJson<NuanzeServerMarketCandlesResponse>(\n        params,\n        '/candles',\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 identified by\n   * {@link NuanzeMarketSelector}. Supply at least `ticker` or `productId`; when both are given,\n   * `productId` is used for the path segment and `ticker` is ignored. Cross and isolated legs\n   * are summed within owner/subaccount/product before direction classification. Every cell\n   * requires at least 20 distinct contributing owners. No identity, individual position, entry\n   * price, PnL, margin, or leverage fields are returned.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET` or `BAD_REQUEST` on invalid input,\n   * and `MARKET_NOT_FOUND` when the selector does not resolve to a perp.\n   */\n  async getMarketPositioning(\n    params: GetNuanzeMarketPositioningParams,\n  ): Promise<GetNuanzeMarketPositioningResponse> {\n    return mapNuanzeMarketPositioningResponse(\n      await this.getMarketJson<NuanzeServerMarketPositioningResponse>(\n        params,\n        '/positioning',\n      ),\n    );\n  }\n\n  /**\n   * Lists open perpetual position legs for a market identified by {@link NuanzeMarketSelector}.\n   * Supply at least `ticker` or `productId`; when both are given, `productId` is used for the\n   * path segment and `ticker` is ignored. Results default to absolute notional descending and\n   * can be ordered by signed unrealized PnL or absolute base amount in either direction. Spot\n   * markets are not supported. Legs below $10 absolute notional are excluded. Wallet addresses,\n   * nullable synced usernames and display names, and signed exact base amounts are returned.\n   * Isolated positions include effective leverage computed by Nuanze; cross positions return\n   * null leverage.\n   *\n   * @throws {NuanzeServerFailureError} With `AMBIGUOUS_MARKET`, `INVALID_CURSOR`,\n   * `CURSOR_FILTER_MISMATCH`, or `BAD_REQUEST` on invalid input, and `MARKET_NOT_FOUND` when the\n   * selector does not resolve to a perp.\n   */\n  async getMarketPositions(\n    params: GetNuanzeMarketPositionsParams,\n  ): Promise<GetNuanzeMarketPositionsResponse> {\n    return mapNuanzeMarketPositionsResponse(\n      await this.getMarketJson<NuanzeServerMarketPositionsResponse>(\n        params,\n        '/positions',\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   * Private subaccounts are excluded unless `includePrivate=true`. Each row includes market\n   * identity, nullable synced username and display name, and its source snapshot timestamp.\n   * Isolated positions include effective leverage computed by Nuanze; cross positions return\n   * null leverage.\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 getMarketJson<T>(\n    params: NuanzeMarketSelector & object,\n    suffix = '',\n  ): Promise<T> {\n    const { productId, ticker, ...query } = params;\n    const selector = productId ?? ticker;\n    if (selector === undefined) {\n      throw new Error('A market ticker or productId is required.');\n    }\n    return this.getJson<T>(\n      `/markets/${encodeURIComponent(selector.toString())}${suffix}`,\n      query,\n    );\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-DK1Y8O_6.cjs");
+const require_NuanzeClient = require("./NuanzeClient-Tl_Dke8Z.cjs");
 require("./dataMappers.cjs");
 exports.NuanzeClient = require_NuanzeClient.NuanzeClient;

package/dist/NuanzeClient.d.cts

@@ -1,4 +1,4 @@
-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-Dn_aEMkq.cjs";
+import { A as GetNuanzeOpenPositionsResponse, B as GetNuanzeWalletPnlResponse, C as GetNuanzeMarketTradesParams, D as GetNuanzeNewsParams, E as GetNuanzeMarketsResponse, F as GetNuanzeSubaccountLeaderboardPositionResponse, G as GetNuanzeWalletSummaryParams, H as GetNuanzeWalletPnlSeriesResponse, I as GetNuanzeSubaccountLeaderboardResponse, J as GetNuanzeWalletTradesResponse, K as GetNuanzeWalletSummaryResponse, L as GetNuanzeWalletLeaderboardPositionParams, M as GetNuanzePlatformSummaryResponse, N as GetNuanzeSubaccountLeaderboardParams, O as GetNuanzeNewsResponse, P as GetNuanzeSubaccountLeaderboardPositionParams, R as GetNuanzeWalletLeaderboardPositionResponse, S as GetNuanzeMarketPositionsResponse, T as GetNuanzeMarketsParams, U as GetNuanzeWalletPositionsParams, V as GetNuanzeWalletPnlSeriesParams, W as GetNuanzeWalletPositionsResponse, _ as GetNuanzeMarketCandlesParams, a as GetNuanzeCollateralFlowsParams, b as GetNuanzeMarketPositioningResponse, c as GetNuanzeFollowedLeaderboardPositionParams, d as GetNuanzeFundingRatesParams, f as GetNuanzeFundingRatesResponse, g as GetNuanzeMarketByTickerResponse, h as GetNuanzeMarketByTickerParams, i as GetNuanzeCollateralFlowSummaryResponse, j as GetNuanzePlatformSummaryParams, k as GetNuanzeOpenPositionsParams, l as GetNuanzeFollowedLeaderboardPositionResponse, m as GetNuanzeLeaderboardResponse, n as GetNuanzeCollateralFlowSeriesResponse, o as GetNuanzeCollateralFlowsResponse, p as GetNuanzeLeaderboardParams, q as GetNuanzeWalletTradesParams, r as GetNuanzeCollateralFlowSummaryParams, s as GetNuanzeFollowedLeaderboardParams, t as GetNuanzeCollateralFlowSeriesParams, u as GetNuanzeFollowedLeaderboardResponse, v as GetNuanzeMarketCandlesResponse, w as GetNuanzeMarketTradesResponse, x as GetNuanzeMarketPositionsParams, y as GetNuanzeMarketPositioningParams, z as GetNuanzeWalletPnlParams } from "./clientTypes-CX6Rpkyf.cjs";
 import { AxiosInstance } from "axios";
 
 //#region src/NuanzeClient.d.ts
@@ -72,6 +72,17 @@ declare class NuanzeClient {
    * `INVALID_ADDRESS` when `viewAs` is malformed.
    */
   getLeaderboard(params?: GetNuanzeLeaderboardParams): Promise<GetNuanzeLeaderboardResponse>;
+  /**
+   * Gets one wallet's leaderboard position by explicit EVM address. Equity-basis account PnL
+   * includes realized and unrealized movement plus funding and is not realized PnL. `item` is
+   * null only when the wallet leaderboard source row is absent; `rank` is the global rank in
+   * the unfiltered leaderboard, independent of collection `limit` and `offset`. For an inline
+   * lookup scoped to a ranked page, `getLeaderboard` accepts `viewAs` instead.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid, or
+   * `INVALID_ADDRESS` when the address is malformed.
+   */
+  getWalletLeaderboardPosition(params: GetNuanzeWalletLeaderboardPositionParams): Promise<GetNuanzeWalletLeaderboardPositionResponse>;
   /**
    * Gets the global public leaderboard of subaccounts. Results are sorted by equity-basis account
    * PnL descending with nulls last. Username and display name are null when unavailable.
@@ -86,6 +97,20 @@ declare class NuanzeClient {
    * are invalid.
    */
   getSubaccountLeaderboard(params?: GetNuanzeSubaccountLeaderboardParams): Promise<GetNuanzeSubaccountLeaderboardResponse>;
+  /**
+   * Gets one subaccount's leaderboard position by explicit bytes32 subaccount hex
+   * (the SDK `subaccountToHex` form). `item.globalRank` reflects the subaccount's true position
+   * across the full leaderboard, independent of the `includePrivate`, `includeUntraded`, and
+   * `includeUnclaimed` filters, while `filteredRank` uses the request's active filters: an
+   * absent source row yields `filteredRank` null with `item` null, an existing but
+   * filter-excluded row keeps its full item with `filteredRank` null, and an included row
+   * carries both ranks. For an inline lookup scoped to a ranked page,
+   * `getSubaccountLeaderboard` accepts `viewAs` instead.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when filters are invalid, or
+   * `INVALID_SUBACCOUNT` when the subaccount hex is malformed.
+   */
+  getSubaccountLeaderboardPosition(params: GetNuanzeSubaccountLeaderboardPositionParams): Promise<GetNuanzeSubaccountLeaderboardPositionResponse>;
   /**
    * Gets platform activity summary from five-minute aggregates.
    *
@@ -97,10 +122,33 @@ declare class NuanzeClient {
    * follows, sorted by PnL descending with nulls last. The follower does not need a claimed
    * username. Subaccounts with no PnL in the window are included by default with null PnL/rank,
    * zero counts, and no products. Private subaccounts are excluded unless `includePrivate=true`.
+   * Pass `viewAs` with a bytes32 subaccount hex to also receive that followed subaccount's
+   * `filteredRank` (counted among the follower's filter-passing followed subaccounts) plus full
+   * item as `viewer` without altering pagination: `viewer` is null when `viewAs` is omitted or
+   * the follower does not actively follow that subaccount, and a filter-excluded followed row
+   * keeps its item with `filteredRank` null.
    *
-   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid.
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`,
+   * `CURSOR_FILTER_MISMATCH`, or `INVALID_SUBACCOUNT` when params, the cursor, the follower
+   * hex, or `viewAs` are invalid.
    */
   getFollowedLeaderboard(params: GetNuanzeFollowedLeaderboardParams): Promise<GetNuanzeFollowedLeaderboardResponse>;
+  /**
+   * Gets one followed subaccount's position within a follower's leaderboard. `subaccountHex`
+   * identifies the follower whose active follow graph is ranked and `viewAs` the followed
+   * subaccount to position, both as bytes32 subaccount hex (the SDK `subaccountToHex` form).
+   * `item.globalRank` reflects the subaccount's true position across the full global subaccount
+   * leaderboard, independent of the follow graph and of the `includeUntraded`, `includePrivate`,
+   * and `includeUnclaimed` filters, while `filteredRank` counts only the follower's followed
+   * subaccounts passing the request's active filters: a subaccount the follower does not follow
+   * yields `filteredRank` null with `item` null, an existing but filter-excluded followed row
+   * keeps its full item with `filteredRank` null, and an included row carries both ranks. For an
+   * inline lookup scoped to a ranked page, `getFollowedLeaderboard` accepts `viewAs` instead.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when the timeframe or filters are
+   * invalid, or `INVALID_SUBACCOUNT` when either subaccount hex is malformed.
+   */
+  getFollowedLeaderboardPosition(params: GetNuanzeFollowedLeaderboardPositionParams): Promise<GetNuanzeFollowedLeaderboardPositionResponse>;
   /**
    * Gets replica-backed wallet analytics. Without `subaccountName`, latest cumulative values are
    * selected per known subaccount and then summed. The response is a snapshot and does not claim

package/dist/NuanzeClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"NuanzeClient.d.cts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AAkGA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;cAYQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAwER;;;;;;;;;;EAjDJ,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EA4GR;;;;;;;;EA9FG,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EAsJR;;;;;;;;;;EAtIG,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EAwNA;;;;;;EA5ML,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAiPR;;;;;;;;;EA/NG,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EA2SD;;;;;;;;;;;;;EArRJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EArHC;;;;;EAmIN,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA9FL;;;;;;;;EA+GA,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EA7FA;;;;;;;;EA8GL,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA9ER;;;;;;;;EAgGG,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA3DT;;;;;;;;;;;EAgFI,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA3CA;;;;;;;;;;;EA+DL,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EADD;;;;;;;;EAkBJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAkBL;;;;;;;;EAAA,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EAoBA;;;;;;;;EAFL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAiCR;;;;;;;EAhBG,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAqDD;;;;;;EAzCJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAiER;;;;;;;EAjDG,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;EAsFG;;;;AAgCa;;;;;;;EAlGrB,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;;;;;;;;;;;;;;;EAuBL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;;;;EAqBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;EAAA,QAIA,aAAA;EAAA,QAeA,WAAA;;;;;UAiBN,mBAAA;AAAA"}
+{"version":3,"file":"NuanzeClient.d.cts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AA8GA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;cAYQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAwER;;;;;;;;;;EAjDJ,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EAkHR;;;;;;;;EApGG,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EAqKR;;;;;;;;;;EArJG,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EA4OA;;;;;;EAhOL,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAuQR;;;;;;;;;EArPG,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EA2TD;;;;;;;;;;EAxSJ,4BAAA,CACJ,MAAA,EAAQ,wCAAA,GACP,OAAA,CAAQ,0CAAA;EAwWR;;;;;;;;;;;;;EAjVG,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAnHD;;;;;;;;;;;;;EAyIJ,gCAAA,CACJ,MAAA,EAAQ,4CAAA,GACP,OAAA,CAAQ,8CAAA;EA5FL;;;;;EA2GA,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAxFD;;;;;;;;;;;;;;;EAgHJ,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EA5CT;;;;;;;;;;;;;;;EAoEI,8BAAA,CACJ,MAAA,EAAQ,0CAAA,GACP,OAAA,CAAQ,4CAAA;EAAR;;;;;;;;EAkBG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EAmBT;;;;;;;;EADI,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA4CD;;;;;;;;;;;EAvBJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA6DR;;;;;;;;;;;EAzCG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA0FL;;;;;;;;EAzEA,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA2FA;;;;;;;;EAzEL,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EAsHR;;;;;;;;EApGG,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAwJG;;;AAiBa;;;;EAxJrB,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;EAYL,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;;;;;;;;EAgBL,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;;;;;;;;;;;;EAoBL,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;;;;;;;;;;;;;;;EAuBL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;;;;EAqBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;EAAA,QAIA,aAAA;EAAA,QAeA,WAAA;;;;;UAiBN,mBAAA;AAAA"}

package/dist/NuanzeClient.d.ts

@@ -1,4 +1,4 @@
-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-o_pl9igJ.js";
+import { A as GetNuanzeOpenPositionsResponse, B as GetNuanzeWalletPnlResponse, C as GetNuanzeMarketTradesParams, D as GetNuanzeNewsParams, E as GetNuanzeMarketsResponse, F as GetNuanzeSubaccountLeaderboardPositionResponse, G as GetNuanzeWalletSummaryParams, H as GetNuanzeWalletPnlSeriesResponse, I as GetNuanzeSubaccountLeaderboardResponse, J as GetNuanzeWalletTradesResponse, K as GetNuanzeWalletSummaryResponse, L as GetNuanzeWalletLeaderboardPositionParams, M as GetNuanzePlatformSummaryResponse, N as GetNuanzeSubaccountLeaderboardParams, O as GetNuanzeNewsResponse, P as GetNuanzeSubaccountLeaderboardPositionParams, R as GetNuanzeWalletLeaderboardPositionResponse, S as GetNuanzeMarketPositionsResponse, T as GetNuanzeMarketsParams, U as GetNuanzeWalletPositionsParams, V as GetNuanzeWalletPnlSeriesParams, W as GetNuanzeWalletPositionsResponse, _ as GetNuanzeMarketCandlesParams, a as GetNuanzeCollateralFlowsParams, b as GetNuanzeMarketPositioningResponse, c as GetNuanzeFollowedLeaderboardPositionParams, d as GetNuanzeFundingRatesParams, f as GetNuanzeFundingRatesResponse, g as GetNuanzeMarketByTickerResponse, h as GetNuanzeMarketByTickerParams, i as GetNuanzeCollateralFlowSummaryResponse, j as GetNuanzePlatformSummaryParams, k as GetNuanzeOpenPositionsParams, l as GetNuanzeFollowedLeaderboardPositionResponse, m as GetNuanzeLeaderboardResponse, n as GetNuanzeCollateralFlowSeriesResponse, o as GetNuanzeCollateralFlowsResponse, p as GetNuanzeLeaderboardParams, q as GetNuanzeWalletTradesParams, r as GetNuanzeCollateralFlowSummaryParams, s as GetNuanzeFollowedLeaderboardParams, t as GetNuanzeCollateralFlowSeriesParams, u as GetNuanzeFollowedLeaderboardResponse, v as GetNuanzeMarketCandlesResponse, w as GetNuanzeMarketTradesResponse, x as GetNuanzeMarketPositionsParams, y as GetNuanzeMarketPositioningParams, z as GetNuanzeWalletPnlParams } from "./clientTypes-Dm5-t7pz.js";
 import { AxiosInstance } from "axios";
 
 //#region src/NuanzeClient.d.ts
@@ -72,6 +72,17 @@ declare class NuanzeClient {
    * `INVALID_ADDRESS` when `viewAs` is malformed.
    */
   getLeaderboard(params?: GetNuanzeLeaderboardParams): Promise<GetNuanzeLeaderboardResponse>;
+  /**
+   * Gets one wallet's leaderboard position by explicit EVM address. Equity-basis account PnL
+   * includes realized and unrealized movement plus funding and is not realized PnL. `item` is
+   * null only when the wallet leaderboard source row is absent; `rank` is the global rank in
+   * the unfiltered leaderboard, independent of collection `limit` and `offset`. For an inline
+   * lookup scoped to a ranked page, `getLeaderboard` accepts `viewAs` instead.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid, or
+   * `INVALID_ADDRESS` when the address is malformed.
+   */
+  getWalletLeaderboardPosition(params: GetNuanzeWalletLeaderboardPositionParams): Promise<GetNuanzeWalletLeaderboardPositionResponse>;
   /**
    * Gets the global public leaderboard of subaccounts. Results are sorted by equity-basis account
    * PnL descending with nulls last. Username and display name are null when unavailable.
@@ -86,6 +97,20 @@ declare class NuanzeClient {
    * are invalid.
    */
   getSubaccountLeaderboard(params?: GetNuanzeSubaccountLeaderboardParams): Promise<GetNuanzeSubaccountLeaderboardResponse>;
+  /**
+   * Gets one subaccount's leaderboard position by explicit bytes32 subaccount hex
+   * (the SDK `subaccountToHex` form). `item.globalRank` reflects the subaccount's true position
+   * across the full leaderboard, independent of the `includePrivate`, `includeUntraded`, and
+   * `includeUnclaimed` filters, while `filteredRank` uses the request's active filters: an
+   * absent source row yields `filteredRank` null with `item` null, an existing but
+   * filter-excluded row keeps its full item with `filteredRank` null, and an included row
+   * carries both ranks. For an inline lookup scoped to a ranked page,
+   * `getSubaccountLeaderboard` accepts `viewAs` instead.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when filters are invalid, or
+   * `INVALID_SUBACCOUNT` when the subaccount hex is malformed.
+   */
+  getSubaccountLeaderboardPosition(params: GetNuanzeSubaccountLeaderboardPositionParams): Promise<GetNuanzeSubaccountLeaderboardPositionResponse>;
   /**
    * Gets platform activity summary from five-minute aggregates.
    *
@@ -97,10 +122,33 @@ declare class NuanzeClient {
    * follows, sorted by PnL descending with nulls last. The follower does not need a claimed
    * username. Subaccounts with no PnL in the window are included by default with null PnL/rank,
    * zero counts, and no products. Private subaccounts are excluded unless `includePrivate=true`.
+   * Pass `viewAs` with a bytes32 subaccount hex to also receive that followed subaccount's
+   * `filteredRank` (counted among the follower's filter-passing followed subaccounts) plus full
+   * item as `viewer` without altering pagination: `viewer` is null when `viewAs` is omitted or
+   * the follower does not actively follow that subaccount, and a filter-excluded followed row
+   * keeps its item with `filteredRank` null.
    *
-   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid.
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`,
+   * `CURSOR_FILTER_MISMATCH`, or `INVALID_SUBACCOUNT` when params, the cursor, the follower
+   * hex, or `viewAs` are invalid.
    */
   getFollowedLeaderboard(params: GetNuanzeFollowedLeaderboardParams): Promise<GetNuanzeFollowedLeaderboardResponse>;
+  /**
+   * Gets one followed subaccount's position within a follower's leaderboard. `subaccountHex`
+   * identifies the follower whose active follow graph is ranked and `viewAs` the followed
+   * subaccount to position, both as bytes32 subaccount hex (the SDK `subaccountToHex` form).
+   * `item.globalRank` reflects the subaccount's true position across the full global subaccount
+   * leaderboard, independent of the follow graph and of the `includeUntraded`, `includePrivate`,
+   * and `includeUnclaimed` filters, while `filteredRank` counts only the follower's followed
+   * subaccounts passing the request's active filters: a subaccount the follower does not follow
+   * yields `filteredRank` null with `item` null, an existing but filter-excluded followed row
+   * keeps its full item with `filteredRank` null, and an included row carries both ranks. For an
+   * inline lookup scoped to a ranked page, `getFollowedLeaderboard` accepts `viewAs` instead.
+   *
+   * @throws {NuanzeServerFailureError} With `BAD_REQUEST` when the timeframe or filters are
+   * invalid, or `INVALID_SUBACCOUNT` when either subaccount hex is malformed.
+   */
+  getFollowedLeaderboardPosition(params: GetNuanzeFollowedLeaderboardPositionParams): Promise<GetNuanzeFollowedLeaderboardPositionResponse>;
   /**
    * Gets replica-backed wallet analytics. Without `subaccountName`, latest cumulative values are
    * selected per known subaccount and then summed. The response is a snapshot and does not claim

package/dist/NuanzeClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NuanzeClient.d.ts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AAkGA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;cAYQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAwER;;;;;;;;;;EAjDJ,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EA4GR;;;;;;;;EA9FG,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EAsJR;;;;;;;;;;EAtIG,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EAwNA;;;;;;EA5ML,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAiPR;;;;;;;;;EA/NG,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EA2SD;;;;;;;;;;;;;EArRJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EArHC;;;;;EAmIN,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA9FL;;;;;;;;EA+GA,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EA7FA;;;;;;;;EA8GL,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA9ER;;;;;;;;EAgGG,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA3DT;;;;;;;;;;;EAgFI,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA3CA;;;;;;;;;;;EA+DL,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EADD;;;;;;;;EAkBJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAkBL;;;;;;;;EAAA,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EAoBA;;;;;;;;EAFL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAiCR;;;;;;;EAhBG,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAqDD;;;;;;EAzCJ,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAiER;;;;;;;EAjDG,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;EAsFG;;;;AAgCa;;;;;;;EAlGrB,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;;;;;;;;;;;;;;;EAuBL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;;;;EAqBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;EAAA,QAIA,aAAA;EAAA,QAeA,WAAA;;;;;UAiBN,mBAAA;AAAA"}
+{"version":3,"file":"NuanzeClient.d.ts","names":[],"sources":["../src/src/NuanzeClient.ts"],"mappings":";;;;;;AA8GA;UAAiB,gBAAA;;;AAIZ;EAAH,GAAG;AAAA;;;;;;;;;;cAYQ,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAwER;;;;;;;;;;EAjDJ,OAAA,CACJ,MAAA,GAAQ,mBAAA,GACP,OAAA,CAAQ,qBAAA;EAkHR;;;;;;;;EApGG,UAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,wBAAA;EAqKR;;;;;;;;;;EArJG,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,+BAAA;EA4OA;;;;;;EAhOL,eAAA,CACJ,MAAA,GAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EAuQR;;;;;;;;;EArPG,cAAA,CACJ,MAAA,GAAQ,0BAAA,GACP,OAAA,CAAQ,4BAAA;EA2TD;;;;;;;;;;EAxSJ,4BAAA,CACJ,MAAA,EAAQ,wCAAA,GACP,OAAA,CAAQ,0CAAA;EAwWR;;;;;;;;;;;;;EAjVG,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;EAnHD;;;;;;;;;;;;;EAyIJ,gCAAA,CACJ,MAAA,EAAQ,4CAAA,GACP,OAAA,CAAQ,8CAAA;EA5FL;;;;;EA2GA,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAxFD;;;;;;;;;;;;;;;EAgHJ,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,oCAAA;EA5CT;;;;;;;;;;;;;;;EAoEI,8BAAA,CACJ,MAAA,EAAQ,0CAAA,GACP,OAAA,CAAQ,4CAAA;EAAR;;;;;;;;EAkBG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EAmBT;;;;;;;;EADI,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EA4CD;;;;;;;;;;;EAvBJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA6DR;;;;;;;;;;;EAzCG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;EA0FL;;;;;;;;EAzEA,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,6BAAA;EA2FA;;;;;;;;EAzEL,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,0BAAA;EAsHR;;;;;;;;EApGG,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;EAwJG;;;AAiBa;;;;EAxJrB,kBAAA,CACJ,MAAA,GAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;EAYL,wBAAA,CACJ,MAAA,GAAQ,oCAAA,GACP,OAAA,CAAQ,sCAAA;;;;;;;;EAgBL,uBAAA,CACJ,MAAA,GAAQ,mCAAA,GACP,OAAA,CAAQ,qCAAA;;;;;;;;;;;;EAoBL,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,kCAAA;;;;;;;;;;;;;;;EAuBL,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,gCAAA;;;;;;;;;;;;;EAqBL,gBAAA,CACJ,MAAA,GAAQ,4BAAA,GACP,OAAA,CAAQ,8BAAA;;;;UAYG,OAAA;EAAA,QAIA,aAAA;EAAA,QAeA,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, mapNuanzeSubaccountLeaderboardResponse, mapNuanzeWalletPnlResponse, mapNuanzeWalletPnlSeriesResponse, mapNuanzeWalletPositionsResponse, mapNuanzeWalletSummaryResponse, mapNuanzeWalletTradesResponse } from "./dataMappers.js";
+import { mapNuanzeCollateralFlowSeriesResponse, mapNuanzeCollateralFlowSummaryResponse, mapNuanzeCollateralFlowsResponse, mapNuanzeFollowedLeaderboardPositionResponse, mapNuanzeFollowedLeaderboardResponse, mapNuanzeFundingRatesResponse, mapNuanzeLeaderboardResponse, mapNuanzeMarketByTickerResponse, mapNuanzeMarketCandlesResponse, mapNuanzeMarketPositioningResponse, mapNuanzeMarketPositionsResponse, mapNuanzeMarketTradesResponse, mapNuanzeMarketsResponse, mapNuanzeNewsResponse, mapNuanzeOpenPositionsResponse, mapNuanzePlatformSummaryResponse, mapNuanzeSubaccountLeaderboardPositionResponse, mapNuanzeSubaccountLeaderboardResponse, mapNuanzeWalletLeaderboardPositionResponse, mapNuanzeWalletPnlResponse, mapNuanzeWalletPnlSeriesResponse, mapNuanzeWalletPositionsResponse, mapNuanzeWalletSummaryResponse, mapNuanzeWalletTradesResponse } from "./dataMappers.js";
 import { NuanzeServerFailureError } from "./types/NuanzeServerFailureError.js";
 import { isNuanzeServerFailureResponse } from "./types/serverQueryTypes.js";
 import axios from "axios";
@@ -80,6 +80,20 @@ var NuanzeClient = class {
 		return mapNuanzeLeaderboardResponse(await this.getJson("/leaderboard", params));
 	}
 	/**
+	* Gets one wallet's leaderboard position by explicit EVM address. Equity-basis account PnL
+	* includes realized and unrealized movement plus funding and is not realized PnL. `item` is
+	* null only when the wallet leaderboard source row is absent; `rank` is the global rank in
+	* the unfiltered leaderboard, independent of collection `limit` and `offset`. For an inline
+	* lookup scoped to a ranked page, `getLeaderboard` accepts `viewAs` instead.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if a filter value is invalid, or
+	* `INVALID_ADDRESS` when the address is malformed.
+	*/
+	async getWalletLeaderboardPosition(params) {
+		const { address, ...query } = params;
+		return mapNuanzeWalletLeaderboardPositionResponse(await this.getJson(`/leaderboard/wallets/${encodeURIComponent(address)}`, query));
+	}
+	/**
 	* Gets the global public leaderboard of subaccounts. Results are sorted by equity-basis account
 	* PnL descending with nulls last. Username and display name are null when unavailable.
 	* `globalRank` is independent of the active privacy and trading filters. Pagination uses a
@@ -96,6 +110,23 @@ var NuanzeClient = class {
 		return mapNuanzeSubaccountLeaderboardResponse(await this.getJson("/leaderboard/subaccounts", params));
 	}
 	/**
+	* Gets one subaccount's leaderboard position by explicit bytes32 subaccount hex
+	* (the SDK `subaccountToHex` form). `item.globalRank` reflects the subaccount's true position
+	* across the full leaderboard, independent of the `includePrivate`, `includeUntraded`, and
+	* `includeUnclaimed` filters, while `filteredRank` uses the request's active filters: an
+	* absent source row yields `filteredRank` null with `item` null, an existing but
+	* filter-excluded row keeps its full item with `filteredRank` null, and an included row
+	* carries both ranks. For an inline lookup scoped to a ranked page,
+	* `getSubaccountLeaderboard` accepts `viewAs` instead.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when filters are invalid, or
+	* `INVALID_SUBACCOUNT` when the subaccount hex is malformed.
+	*/
+	async getSubaccountLeaderboardPosition(params) {
+		const { subaccountHex, ...query } = params;
+		return mapNuanzeSubaccountLeaderboardPositionResponse(await this.getJson(`/leaderboard/subaccounts/${encodeURIComponent(subaccountHex)}`, query));
+	}
+	/**
 	* Gets platform activity summary from five-minute aggregates.
 	*
 	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` if the window is not a documented value.
@@ -108,13 +139,39 @@ var NuanzeClient = class {
 	* follows, sorted by PnL descending with nulls last. The follower does not need a claimed
 	* username. Subaccounts with no PnL in the window are included by default with null PnL/rank,
 	* zero counts, and no products. Private subaccounts are excluded unless `includePrivate=true`.
+	* Pass `viewAs` with a bytes32 subaccount hex to also receive that followed subaccount's
+	* `filteredRank` (counted among the follower's filter-passing followed subaccounts) plus full
+	* item as `viewer` without altering pagination: `viewer` is null when `viewAs` is omitted or
+	* the follower does not actively follow that subaccount, and a filter-excluded followed row
+	* keeps its item with `filteredRank` null.
 	*
-	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when params are invalid.
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST`, `INVALID_CURSOR`,
+	* `CURSOR_FILTER_MISMATCH`, or `INVALID_SUBACCOUNT` when params, the cursor, the follower
+	* hex, or `viewAs` are invalid.
 	*/
 	async getFollowedLeaderboard(params) {
 		return mapNuanzeFollowedLeaderboardResponse(await this.getJson("/wallets/leaderboard", params));
 	}
 	/**
+	* Gets one followed subaccount's position within a follower's leaderboard. `subaccountHex`
+	* identifies the follower whose active follow graph is ranked and `viewAs` the followed
+	* subaccount to position, both as bytes32 subaccount hex (the SDK `subaccountToHex` form).
+	* `item.globalRank` reflects the subaccount's true position across the full global subaccount
+	* leaderboard, independent of the follow graph and of the `includeUntraded`, `includePrivate`,
+	* and `includeUnclaimed` filters, while `filteredRank` counts only the follower's followed
+	* subaccounts passing the request's active filters: a subaccount the follower does not follow
+	* yields `filteredRank` null with `item` null, an existing but filter-excluded followed row
+	* keeps its full item with `filteredRank` null, and an included row carries both ranks. For an
+	* inline lookup scoped to a ranked page, `getFollowedLeaderboard` accepts `viewAs` instead.
+	*
+	* @throws {NuanzeServerFailureError} With `BAD_REQUEST` when the timeframe or filters are
+	* invalid, or `INVALID_SUBACCOUNT` when either subaccount hex is malformed.
+	*/
+	async getFollowedLeaderboardPosition(params) {
+		const { viewAs, ...query } = params;
+		return mapNuanzeFollowedLeaderboardPositionResponse(await this.getJson(`/wallets/leaderboard/followed/${encodeURIComponent(viewAs)}`, query));
+	}
+	/**
 	* Gets replica-backed wallet analytics. Without `subaccountName`, latest cumulative values are
 	* selected per known subaccount and then summed. The response is a snapshot and does not claim
 	* live health, withdrawable collateral, open-order, or signer state.