@nadohq/nuanze-client 0.54.0 → 0.55.0

package/src/dataMappers.ts

@@ -2,6 +2,8 @@ import { toBigNumber } from '@nadohq/shared';
 import BigNumber from 'bignumber.js';
 import {
   NuanzeCandle,
+  NuanzeCohort,
+  NuanzeCohortSeriesPoint,
   NuanzeCollateralFlow,
   NuanzeCollateralFlowPoint,
   NuanzeFollowedLeaderboardItem,
@@ -23,11 +25,15 @@ import {
   NuanzePositioningTotals,
   NuanzeSeriesPoint,
   NuanzeStockFundamentals,
+  NuanzeSubaccountCloseTrade,
   NuanzeSubaccountLeaderboardItem,
+  NuanzeSubaccountLongShortBias,
+  NuanzeSubaccountMostTradedMarket,
   NuanzeWalletPosition,
   NuanzeWalletTrade,
 } from './types/clientModelTypes';
 import {
+  GetNuanzeCohortsResponse,
   GetNuanzeCollateralFlowSeriesResponse,
   GetNuanzeCollateralFlowSummaryResponse,
   GetNuanzeCollateralFlowsResponse,
@@ -46,6 +52,7 @@ import {
   GetNuanzePlatformSummaryResponse,
   GetNuanzeSubaccountLeaderboardPositionResponse,
   GetNuanzeSubaccountLeaderboardResponse,
+  GetNuanzeSubaccountStatsResponse,
   GetNuanzeWalletLeaderboardPositionResponse,
   GetNuanzeWalletPnlResponse,
   GetNuanzeWalletPnlSeriesResponse,
@@ -55,7 +62,9 @@ import {
 } from './types/clientTypes';
 import {
   NuanzeServerCandle,
+  NuanzeServerCohort,
   NuanzeServerCohortPositioningCell,
+  NuanzeServerCohortSeriesPoint,
   NuanzeServerCollateralFlow,
   NuanzeServerCollateralFlowPoint,
   NuanzeServerFollowedLeaderboardItem,
@@ -80,11 +89,15 @@ import {
   NuanzeServerSeriesPoint,
   NuanzeServerSidePositioningCell,
   NuanzeServerStockFundamentals,
+  NuanzeServerSubaccountCloseTrade,
   NuanzeServerSubaccountLeaderboardItem,
+  NuanzeServerSubaccountLongShortBias,
+  NuanzeServerSubaccountMostTradedMarket,
   NuanzeServerWalletPosition,
   NuanzeServerWalletTrade,
 } from './types/serverModelTypes';
 import {
+  NuanzeServerCohortsResponse,
   NuanzeServerCollateralFlowSeriesResponse,
   NuanzeServerCollateralFlowSummaryResponse,
   NuanzeServerCollateralFlowsResponse,
@@ -101,6 +114,7 @@ import {
   NuanzeServerPlatformSummaryResponse,
   NuanzeServerSubaccountLeaderboardPositionResponse,
   NuanzeServerSubaccountLeaderboardResponse,
+  NuanzeServerSubaccountStatsResponse,
   NuanzeServerWalletLeaderboardPositionResponse,
   NuanzeServerWalletPnlResponse,
   NuanzeServerWalletPnlSeriesResponse,
@@ -400,6 +414,8 @@ export function mapNuanzeFollowedLeaderboardItem(
     productIds: server.productIds,
     productCount: server.productCount,
     globalRank: server.globalRank,
+    volume: mapNuanzeDecimal(server.volume),
+    pointsTier: server.pointsTier,
   };
 }
 
@@ -421,6 +437,8 @@ export function mapNuanzeSubaccountLeaderboardItem(
     productIds: server.productIds,
     productCount: server.productCount,
     globalRank: server.globalRank,
+    volume: mapNuanzeDecimal(server.volume),
+    pointsTier: server.pointsTier,
   };
 }
 
@@ -470,6 +488,94 @@ export function mapNuanzeSubaccountLeaderboardPositionResponse(
   };
 }
 
+/**
+ * Maps a server-side close-event trade extreme, converting realized PnL to `BigNumber`.
+ */
+export function mapNuanzeSubaccountCloseTrade(
+  server: NuanzeServerSubaccountCloseTrade,
+): NuanzeSubaccountCloseTrade {
+  return {
+    tradeId: server.tradeId,
+    productId: server.productId,
+    ticker: server.ticker,
+    realizedPnl: toBigNumber(server.realizedPnl),
+    matchedAt: server.matchedAt,
+  };
+}
+
+/**
+ * Maps a server-side position-based long/short bias, converting notionals and percentages to
+ * `BigNumber`.
+ */
+export function mapNuanzeSubaccountLongShortBias(
+  server: NuanzeServerSubaccountLongShortBias,
+): NuanzeSubaccountLongShortBias {
+  return {
+    longPct: mapNuanzeDecimal(server.longPct),
+    shortPct: mapNuanzeDecimal(server.shortPct),
+    longNotional: toBigNumber(server.longNotional),
+    shortNotional: toBigNumber(server.shortNotional),
+  };
+}
+
+/**
+ * Maps a server-side most-traded market, converting volume to `BigNumber`.
+ */
+export function mapNuanzeSubaccountMostTradedMarket(
+  server: NuanzeServerSubaccountMostTradedMarket,
+): NuanzeSubaccountMostTradedMarket {
+  return {
+    productId: server.productId,
+    ticker: server.ticker,
+    trades: server.trades,
+    volume: toBigNumber(server.volume),
+  };
+}
+
+/**
+ * Maps a server-side `GET /subaccounts/{subaccountHex}` response, converting every decimal
+ * string to `BigNumber`.
+ */
+export function mapNuanzeSubaccountStatsResponse(
+  server: NuanzeServerSubaccountStatsResponse,
+): GetNuanzeSubaccountStatsResponse {
+  return {
+    subaccountHex: server.subaccountHex,
+    timeframe: server.timeframe,
+    owner: server.owner,
+    subaccountName: server.subaccountName,
+    username: server.username,
+    displayName: server.displayName,
+    pnl: mapNuanzeDecimal(server.pnl),
+    wins: server.wins,
+    losses: server.losses,
+    winRate: mapNuanzeDecimal(server.winRate),
+    trades: server.trades,
+    productIds: server.productIds,
+    productCount: server.productCount,
+    globalRank: server.globalRank,
+    filteredRank: server.filteredRank,
+    cumulativeVolume: toBigNumber(server.cumulativeVolume),
+    windowVolume: toBigNumber(server.windowVolume),
+    windowPnl: toBigNumber(server.windowPnl),
+    averageLeverage: mapNuanzeDecimal(server.averageLeverage),
+    bestTrade:
+      server.bestTrade === null
+        ? null
+        : mapNuanzeSubaccountCloseTrade(server.bestTrade),
+    worstTrade:
+      server.worstTrade === null
+        ? null
+        : mapNuanzeSubaccountCloseTrade(server.worstTrade),
+    longShortBias: mapNuanzeSubaccountLongShortBias(server.longShortBias),
+    mostTradedMarket:
+      server.mostTradedMarket === null
+        ? null
+        : mapNuanzeSubaccountMostTradedMarket(server.mostTradedMarket),
+    asOf: server.asOf,
+  };
+}
+
 /**
  * Maps a server-side `GET /wallets/leaderboard` response, including the nullable `viewAs`
  * viewer. A filter-excluded followed viewer keeps its full item with `filteredRank` null; a
@@ -545,6 +651,54 @@ export function mapNuanzePlatformSummaryResponse(
   };
 }
 
+/**
+ * Maps a server-side cohort long-percentage sample.
+ */
+export function mapNuanzeCohortSeriesPoint(
+  server: NuanzeServerCohortSeriesPoint,
+): NuanzeCohortSeriesPoint {
+  return {
+    timestamp: server.timestamp,
+    walletCount: server.walletCount,
+    longPct: mapNuanzeDecimal(server.longPct),
+  };
+}
+
+/**
+ * Maps a server-side lifetime-PnL wallet cohort.
+ */
+export function mapNuanzeCohort(server: NuanzeServerCohort): NuanzeCohort {
+  return {
+    key: server.key,
+    label: server.label,
+    pnlMin: mapNuanzeDecimal(server.pnlMin),
+    pnlMax: mapNuanzeDecimal(server.pnlMax),
+    walletCount: server.walletCount,
+    pnl: toBigNumber(server.pnl),
+    averagePnl: mapNuanzeDecimal(server.averagePnl),
+    walletsInProfit: server.walletsInProfit,
+    walletsInLoss: server.walletsInLoss,
+    trades: server.trades,
+    longNotional: toBigNumber(server.longNotional),
+    shortNotional: toBigNumber(server.shortNotional),
+    longPct: mapNuanzeDecimal(server.longPct),
+    shortPct: mapNuanzeDecimal(server.shortPct),
+    series: server.series.map(mapNuanzeCohortSeriesPoint),
+  };
+}
+
+/**
+ * Maps a server-side `GET /cohorts` response.
+ */
+export function mapNuanzeCohortsResponse(
+  server: NuanzeServerCohortsResponse,
+): GetNuanzeCohortsResponse {
+  return {
+    items: server.items.map(mapNuanzeCohort),
+    asOf: server.asOf,
+  };
+}
+
 /**
  * Maps a server-side `GET /wallets/{address}` response.
  */

package/src/types/clientModelTypes.ts

@@ -311,10 +311,21 @@ export const NUANZE_COHORT_KEYS = [
 ] as const;
 
 /**
- * Wallet cohort label used by positioning cells.
+ * Lifetime account PnL wallet cohort, used by positioning cells and `GET /cohorts`.
  */
 export type NuanzeCohortKey = (typeof NUANZE_COHORT_KEYS)[number];
 
+/**
+ * Every {@link NuanzePointsTier} the API can report: 1 Breeze, 2 Gust, 3 Wind, 4 Storm, and
+ * 5 Tornado.
+ */
+export const NUANZE_POINTS_TIERS = [1, 2, 3, 4, 5] as const;
+
+/**
+ * Nado Points tier, from 1 Breeze to 5 Tornado.
+ */
+export type NuanzePointsTier = (typeof NUANZE_POINTS_TIERS)[number];
+
 /**
  * Every {@link NuanzeNotionalBucket} the API can report. Frozen USD ranges are small [10, 1000),
  * medium [1000, 10000), large [10000, 100000), and whale [100000, +infinity).
@@ -694,6 +705,61 @@ export interface NuanzeFollowedLeaderboardItem {
    * the subaccount has no PnL in the window.
    */
   globalRank: number | null;
+  /**
+   * Perp plus spot volume in the timeframe, from the same account snapshots and window bounds as
+   * `pnl`, or null when the subaccount has no account snapshot at the window's grain.
+   */
+  volume: BigNumber | null;
+  /**
+   * Owner wallet's Nado Points tier in the latest completed weekly epoch (the tier Nado shows as
+   * current), shared by every subaccount of the owner and refreshed daily. Null when the owner
+   * has no points record for that epoch.
+   */
+  pointsTier: NuanzePointsTier | null;
+}
+
+/**
+ * Close-event trade extreme from `GET /subaccounts/{subaccountHex}`.
+ */
+export interface NuanzeSubaccountCloseTrade {
+  /** Fill ID of the closing fill. */
+  tradeId: number;
+  /** Perp product ID. */
+  productId: number;
+  /** Asset ticker, e.g. `ETH`. */
+  ticker: string;
+  /** Close-event realized PnL of the fill. */
+  realizedPnl: BigNumber;
+  /** When the fill matched, as a UTC ISO 8601 string. */
+  matchedAt: string;
+}
+
+/**
+ * Position-based long/short bias from `GET /subaccounts/{subaccountHex}`.
+ */
+export interface NuanzeSubaccountLongShortBias {
+  /** Share of qualifying current perp notional held long, 0-100. Null when flat. */
+  longPct: BigNumber | null;
+  /** Share of qualifying current perp notional held short, 0-100. Null when flat. */
+  shortPct: BigNumber | null;
+  /** Qualifying current long notional in USD. */
+  longNotional: BigNumber;
+  /** Qualifying current short notional in USD. */
+  shortNotional: BigNumber;
+}
+
+/**
+ * Most-traded perp market from `GET /subaccounts/{subaccountHex}`.
+ */
+export interface NuanzeSubaccountMostTradedMarket {
+  /** Perp product ID. */
+  productId: number;
+  /** Asset ticker, e.g. `ETH`. */
+  ticker: string;
+  /** Perp fill count in the window. */
+  trades: number;
+  /** Windowed fill volume in USD. */
+  volume: BigNumber;
 }
 
 /**
@@ -730,6 +796,18 @@ export interface NuanzeSubaccountLeaderboardItem {
    * subaccount has no PnL in the window.
    */
   globalRank: number | null;
+  /**
+   * Perp plus spot volume in the timeframe, from the same account snapshots and window bounds as
+   * `pnl` (and as `windowVolume` on `GET /subaccounts/{subaccountHex}`), or null when the
+   * subaccount has no account snapshot at the window's grain.
+   */
+  volume: BigNumber | null;
+  /**
+   * Owner wallet's Nado Points tier in the latest completed weekly epoch (the tier Nado shows as
+   * current), shared by every subaccount of the owner and refreshed daily. Null when the owner
+   * has no points record for that epoch.
+   */
+  pointsTier: NuanzePointsTier | null;
 }
 
 /**
@@ -776,6 +854,55 @@ export interface NuanzePlatformDeltas {
   tradersPct: BigNumber | null;
 }
 
+/**
+ * Four-hourly sample of a wallet cohort's long percentage.
+ */
+export interface NuanzeCohortSeriesPoint {
+  /** Sample time as a UTC ISO 8601 string. */
+  timestamp: string;
+  /** Wallets in the cohort at the sample. */
+  walletCount: number;
+  /** Share of the cohort's open perp notional held long, 0-100, or null when it was flat. */
+  longPct: BigNumber | null;
+}
+
+/**
+ * Wallet cohort bucketed by lifetime equity-basis account PnL summed across the wallet's
+ * subaccounts. Every wallet that has traded belongs to exactly one cohort.
+ */
+export interface NuanzeCohort {
+  /** Cohort key. */
+  key: NuanzeCohortKey;
+  /** Display label. */
+  label: string;
+  /** Inclusive lower lifetime PnL bound, or null when unbounded. */
+  pnlMin: BigNumber | null;
+  /** Exclusive upper lifetime PnL bound, or null when unbounded. */
+  pnlMax: BigNumber | null;
+  /** Wallets in the cohort. */
+  walletCount: number;
+  /** Sum of the members' lifetime account PnL. */
+  pnl: BigNumber;
+  /** Mean lifetime account PnL per wallet, or null when the cohort is empty. */
+  averagePnl: BigNumber | null;
+  /** Members with lifetime account PnL above zero. */
+  walletsInProfit: number;
+  /** Members with lifetime account PnL at or below zero. */
+  walletsInLoss: number;
+  /** Lifetime fill count across the members. */
+  trades: number;
+  /** Members' current open perp notional held long. */
+  longNotional: BigNumber;
+  /** Members' current open perp notional held short. */
+  shortNotional: BigNumber;
+  /** Share of open perp notional held long, 0-100, or null when the cohort is flat. */
+  longPct: BigNumber | null;
+  /** Share of open perp notional held short, 0-100, or null when the cohort is flat. */
+  shortPct: BigNumber | null;
+  /** Long percentage every four hours over the last 30 days, oldest first. */
+  series: NuanzeCohortSeriesPoint[];
+}
+
 /**
  * Replica-backed wallet position snapshot. Not an execution-grade live feed.
  */

package/src/types/clientTypes.ts

@@ -2,6 +2,7 @@ import BigNumber from 'bignumber.js';
 import {
   NuanzeCandle,
   NuanzeCandleInterval,
+  NuanzeCohort,
   NuanzeCollateralFlow,
   NuanzeCollateralFlowPoint,
   NuanzeCoverage,
@@ -36,7 +37,10 @@ import {
   NuanzeSeriesMetric,
   NuanzeSeriesPoint,
   NuanzeSourceInterval,
+  NuanzeSubaccountCloseTrade,
   NuanzeSubaccountLeaderboardItem,
+  NuanzeSubaccountLongShortBias,
+  NuanzeSubaccountMostTradedMarket,
   NuanzeWalletPosition,
   NuanzeWalletTrade,
 } from './clientModelTypes';
@@ -332,6 +336,73 @@ export interface GetNuanzeSubaccountLeaderboardPositionResponse {
   asOf: string;
 }
 
+/**
+ * Params for `NuanzeClient.getSubaccountStats`.
+ */
+export interface GetNuanzeSubaccountStatsParams {
+  /**
+   * Explicit public bytes32 subaccount hex (`0x` plus 64 hex characters, the SDK
+   * `subaccountToHex` form) to look up.
+   */
+  subaccountHex: string;
+  /** Stat window, default `30d`. */
+  timeframe?: NuanzeLeaderboardTimeframe;
+}
+
+/**
+ * Response of `NuanzeClient.getSubaccountStats`.
+ */
+export interface GetNuanzeSubaccountStatsResponse {
+  /** Lowercase bytes32 subaccount hex (owner + name). */
+  subaccountHex: string;
+  /** Echoed stat window. */
+  timeframe: NuanzeLeaderboardTimeframe;
+  /** Lowercase subaccount owner address. */
+  owner: string;
+  /** Subaccount name. */
+  subaccountName: string;
+  /** Canonical username, or null when the subaccount has not claimed one. */
+  username: string | null;
+  /** User-facing display name, or null when unavailable. */
+  displayName: string | null;
+  /** Equity-basis account PnL for the window, or null for an untraded window. */
+  pnl: BigNumber | null;
+  /** Close-derived win count. */
+  wins: number;
+  /** Close-derived loss count. */
+  losses: number;
+  /** Win rate, or null when there are no closed trades. */
+  winRate: BigNumber | null;
+  /** Perp fill count in the window. */
+  trades: number;
+  /** Traded product IDs, sorted by fill count descending. */
+  productIds: number[];
+  /** Number of distinct traded products. Equals `productIds.length`. */
+  productCount: number;
+  /** Rank across all subaccounts for the window. Null when the subaccount has no PnL. */
+  globalRank: number | null;
+  /** Rank with private, untraded, and unclaimed subaccounts included. */
+  filteredRank: number | null;
+  /** Lifetime fill volume in USD. */
+  cumulativeVolume: BigNumber;
+  /** Window fill volume in USD. */
+  windowVolume: BigNumber;
+  /** Window PnL delta in USD. */
+  windowPnl: BigNumber;
+  /** Notional-weighted effective leverage over current isolated perp legs. Null when none. */
+  averageLeverage: BigNumber | null;
+  /** Fill with the largest close-event realized PnL in the window. Null when no closes. */
+  bestTrade: NuanzeSubaccountCloseTrade | null;
+  /** Fill with the smallest close-event realized PnL in the window. Null when no closes. */
+  worstTrade: NuanzeSubaccountCloseTrade | null;
+  /** Point-in-time bias from current open perp legs. */
+  longShortBias: NuanzeSubaccountLongShortBias;
+  /** Top perp market by fill count in the window. Null when no activity row. */
+  mostTradedMarket: NuanzeSubaccountMostTradedMarket | null;
+  /** When the response was generated, as a UTC ISO 8601 string. */
+  asOf: string;
+}
+
 /**
  * Params for `NuanzeClient.getFollowedLeaderboard`. `timeframe` is required and applies to
  * every per-subaccount figure.
@@ -469,6 +540,16 @@ export interface GetNuanzePlatformSummaryResponse {
   asOf: string;
 }
 
+/**
+ * Response of `NuanzeClient.getCohorts`.
+ */
+export interface GetNuanzeCohortsResponse {
+  /** All six cohorts, always in `NUANZE_COHORT_KEYS` order (most to least profitable). */
+  items: NuanzeCohort[];
+  /** When the response was generated, as a UTC ISO 8601 string. */
+  asOf: string;
+}
+
 /**
  * Params for `NuanzeClient.getWalletSummary`.
  */

package/src/types/serverModelTypes.ts

@@ -10,6 +10,7 @@ import {
   NuanzeMinPositionUsd,
   NuanzeNewsStory,
   NuanzeNotionalBucket,
+  NuanzePointsTier,
   NuanzePositionSide,
   NuanzeTradeSide,
 } from './clientModelTypes';
@@ -182,6 +183,8 @@ export interface NuanzeServerFollowedLeaderboardItem {
   productIds: number[];
   productCount: number;
   globalRank: number | null;
+  volume: string | null;
+  pointsTier: NuanzePointsTier | null;
 }
 
 /**
@@ -199,6 +202,39 @@ export interface NuanzeServerSubaccountLeaderboardItem {
   productIds: number[];
   productCount: number;
   globalRank: number | null;
+  volume: string | null;
+  pointsTier: NuanzePointsTier | null;
+}
+
+/**
+ * Close-event trade extreme as returned on the wire.
+ */
+export interface NuanzeServerSubaccountCloseTrade {
+  tradeId: number;
+  productId: number;
+  ticker: string;
+  realizedPnl: string;
+  matchedAt: string;
+}
+
+/**
+ * Position-based long/short bias as returned on the wire.
+ */
+export interface NuanzeServerSubaccountLongShortBias {
+  longPct: string | null;
+  shortPct: string | null;
+  longNotional: string;
+  shortNotional: string;
+}
+
+/**
+ * Most-traded perp market as returned on the wire.
+ */
+export interface NuanzeServerSubaccountMostTradedMarket {
+  productId: number;
+  ticker: string;
+  trades: number;
+  volume: string;
 }
 
 /**
@@ -210,6 +246,36 @@ export interface NuanzeServerPlatformDeltas {
   tradersPct: string | null;
 }
 
+/**
+ * Cohort long-percentage sample as returned on the wire.
+ */
+export interface NuanzeServerCohortSeriesPoint {
+  timestamp: string;
+  walletCount: number;
+  longPct: string | null;
+}
+
+/**
+ * Lifetime-PnL wallet cohort as returned on the wire.
+ */
+export interface NuanzeServerCohort {
+  key: NuanzeCohortKey;
+  label: string;
+  pnlMin: string | null;
+  pnlMax: string | null;
+  walletCount: number;
+  pnl: string;
+  averagePnl: string | null;
+  walletsInProfit: number;
+  walletsInLoss: number;
+  trades: number;
+  longNotional: string;
+  shortNotional: string;
+  longPct: string | null;
+  shortPct: string | null;
+  series: NuanzeServerCohortSeriesPoint[];
+}
+
 /**
  * Wallet position snapshot as returned on the wire.
  */

package/src/types/serverQueryTypes.ts

@@ -14,6 +14,7 @@ import { NuanzeNewsStory } from './clientModelTypes';
 import { NuanzeErrorCode } from './nuanzeErrorCodes';
 import {
   NuanzeServerCandle,
+  NuanzeServerCohort,
   NuanzeServerCollateralFlow,
   NuanzeServerCollateralFlowPoint,
   NuanzeServerFollowedLeaderboardItem,
@@ -26,7 +27,10 @@ import {
   NuanzeServerOpenPosition,
   NuanzeServerPlatformDeltas,
   NuanzeServerSeriesPoint,
+  NuanzeServerSubaccountCloseTrade,
   NuanzeServerSubaccountLeaderboardItem,
+  NuanzeServerSubaccountLongShortBias,
+  NuanzeServerSubaccountMostTradedMarket,
   NuanzeServerWalletPosition,
   NuanzeServerWalletTrade,
 } from './serverModelTypes';
@@ -124,6 +128,36 @@ export interface NuanzeServerSubaccountLeaderboardPositionResponse {
   asOf: string;
 }
 
+/**
+ * `GET /subaccounts/{subaccountHex}` response as returned on the wire.
+ */
+export interface NuanzeServerSubaccountStatsResponse {
+  subaccountHex: string;
+  timeframe: NuanzeLeaderboardTimeframe;
+  owner: string;
+  subaccountName: string;
+  username: string | null;
+  displayName: string | null;
+  pnl: string | null;
+  wins: number;
+  losses: number;
+  winRate: string | null;
+  trades: number;
+  productIds: number[];
+  productCount: number;
+  globalRank: number | null;
+  filteredRank: number | null;
+  cumulativeVolume: string;
+  windowVolume: string;
+  windowPnl: string;
+  averageLeverage: string | null;
+  bestTrade: NuanzeServerSubaccountCloseTrade | null;
+  worstTrade: NuanzeServerSubaccountCloseTrade | null;
+  longShortBias: NuanzeServerSubaccountLongShortBias;
+  mostTradedMarket: NuanzeServerSubaccountMostTradedMarket | null;
+  asOf: string;
+}
+
 /**
  * `GET /wallets/leaderboard` response as returned on the wire.
  */
@@ -163,6 +197,14 @@ export interface NuanzeServerPlatformSummaryResponse {
   asOf: string;
 }
 
+/**
+ * `GET /cohorts` response as returned on the wire.
+ */
+export interface NuanzeServerCohortsResponse {
+  items: NuanzeServerCohort[];
+  asOf: string;
+}
+
 /**
  * `GET /wallets/{address}` response as returned on the wire.
  */