@gearbox-protocol/sdk 16.0.0-next.53 → 16.0.0-next.54

package/dist/esm/model/positions.schema.js

@@ -1,8 +1,8 @@
 import { ZodAddress, ZodBigInt, ZodHex } from "../onchain/utils/zod.js";
-import { backendPreferred, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
-import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
+import { backendPreferred, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { delayedReceivedAssetSchema, liquidationPositionSchema } from "./liquidations.schema.js";
 import { apyBreakdownSchema, pointsProgramSchema } from "./opportunities.schema.js";
 import { z } from "zod/v4";

package/dist/esm/offchain/GearboxAPI.js

@@ -1,3 +1,5 @@
+import { OffchainAnalytics } from "./analytics/OffchainAnalytics.js";
+import "./analytics/index.js";
 import { OffchainNotices } from "./notices/OffchainNotices.js";
 import "./notices/index.js";
 import { OffchainOpportunities } from "./opportunities/OffchainOpportunities.js";
@@ -27,6 +29,8 @@ var GearboxAPI = class {
 	* Chains every read of this client is scoped to.
 	**/
 	chainIds;
+	/** Protocol-wide, backend-only analytics. */
+	analytics;
 	/**
 	* Namespace for pool and strategy opportunities.
 	**/
@@ -41,6 +45,7 @@ var GearboxAPI = class {
 	notices;
 	constructor(options) {
 		this.chainIds = [...options.chainIds];
+		this.analytics = new OffchainAnalytics(options);
 		this.opportunities = new OffchainOpportunities(options);
 		this.positions = new OffchainPositions(options);
 		this.notices = new OffchainNotices(options);

package/dist/esm/offchain/analytics/OffchainAnalytics.js

@@ -0,0 +1,11 @@
+import { OffchainAnalyticsPositions } from "./OffchainAnalyticsPositions.js";
+//#region src/offchain/analytics/OffchainAnalytics.ts
+/** Backend-only protocol analytics, grouped by subject. */
+var OffchainAnalytics = class {
+	positions;
+	constructor(options) {
+		this.positions = new OffchainAnalyticsPositions(options);
+	}
+};
+//#endregion
+export { OffchainAnalytics };

package/dist/esm/offchain/analytics/OffchainAnalyticsPositions.js

@@ -0,0 +1,23 @@
+import { analyticsPositionListQuerySchema, analyticsPositionPageSchema } from "../../model/analytics.schema.js";
+import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
+import { z } from "zod/v4";
+//#region src/offchain/analytics/OffchainAnalyticsPositions.ts
+/** Backend client for protocol-wide position analytics. */
+var OffchainAnalyticsPositions = class extends AbstractOffchainNamespace {
+	constructor(options) {
+		super("OffchainAnalyticsPositions", options);
+	}
+	/** {@inheritDoc IOffchainAnalyticsPositions.list} */
+	async list(options) {
+		return this.get({
+			path: "/v2/analytics/positions",
+			query: z.encode(analyticsPositionListQuerySchema, {
+				...options,
+				chainIds: this.scopedChainIds(options)
+			}),
+			schema: analyticsPositionPageSchema
+		});
+	}
+};
+//#endregion
+export { OffchainAnalyticsPositions };

package/dist/esm/offchain/analytics/index.js

@@ -0,0 +1,4 @@
+import { OffchainAnalyticsPositions } from "./OffchainAnalyticsPositions.js";
+import { OffchainAnalytics } from "./OffchainAnalytics.js";
+import "./types.js";
+export { OffchainAnalytics, OffchainAnalyticsPositions };

package/dist/esm/offchain/analytics/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/offchain/index.js

@@ -10,6 +10,9 @@ import { OffchainValidationError } from "./errors/OffchainValidationError.js";
 import { readResponseBody } from "./errors/readResponseBody.js";
 import "./errors/index.js";
 import { AbstractOffchainNamespace } from "./AbstractOffchainNamespace.js";
+import { OffchainAnalyticsPositions } from "./analytics/OffchainAnalyticsPositions.js";
+import { OffchainAnalytics } from "./analytics/OffchainAnalytics.js";
+import "./analytics/index.js";
 import { OffchainNotices } from "./notices/OffchainNotices.js";
 import "./notices/index.js";
 import { OffchainOpportunities } from "./opportunities/OffchainOpportunities.js";
@@ -18,4 +21,4 @@ import { OffchainPositions } from "./positions/OffchainPositions.js";
 import "./positions/index.js";
 import { GearboxAPI } from "./GearboxAPI.js";
 import "./types.js";
-export { AbstractOffchainNamespace, GearboxAPI, OffchainInvalidJsonError, OffchainNotConfiguredError, OffchainNotImplementedError, OffchainNotices, OffchainOpportunities, OffchainPositions, OffchainRequestFailedError, OffchainStatusError, OffchainTransportError, OffchainValidationError, backendMessage, errorCause, readResponseBody };
+export { AbstractOffchainNamespace, GearboxAPI, OffchainAnalytics, OffchainAnalyticsPositions, OffchainInvalidJsonError, OffchainNotConfiguredError, OffchainNotImplementedError, OffchainNotices, OffchainOpportunities, OffchainPositions, OffchainRequestFailedError, OffchainStatusError, OffchainTransportError, OffchainValidationError, backendMessage, errorCause, readResponseBody };

package/dist/esm/sdk/GearboxSDK.js

@@ -6,6 +6,8 @@ import "../offchain/index.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
 import { MissingSourceError } from "./errors/MissingSourceError.js";
 import "./errors/index.js";
+import { AnalyticsNamespace } from "./analytics/AnalyticsNamespace.js";
+import "./analytics/index.js";
 import { LiquidationsNamespace } from "./liquidations/LiquidationsNamespace.js";
 import "./liquidations/index.js";
 import "./utils/mergeChains.js";
@@ -50,6 +52,8 @@ var GearboxSDK = class {
 	* Chains this instance covers, which every read is scoped to.
 	**/
 	networks;
+	/** Protocol-wide analytics. Undefined in `onchain` mode. */
+	analytics;
 	/**
 	* Namespace for pool and strategy opportunities.
 	**/
@@ -130,6 +134,7 @@ var GearboxSDK = class {
 			ensureFresh: this.#onchain ? (chainIds) => this.#ensureFresh(chainIds) : void 0,
 			logger
 		};
+		this.analytics = this.#offchain ? new AnalyticsNamespace(this.#offchain) : void 0;
 		this.opportunities = new OpportunitiesNamespace(this.#onchain, this.#offchain, namespaceOptions);
 		this.positions = new PositionsNamespace(this.#onchain, this.#offchain, namespaceOptions);
 		this.liquidations = this.#onchain ? new LiquidationsNamespace(this.#onchain, namespaceOptions) : void 0;

package/dist/esm/sdk/analytics/AnalyticsNamespace.js

@@ -0,0 +1,10 @@
+//#region src/sdk/analytics/AnalyticsNamespace.ts
+/** Backend-only protocol analytics exposed by {@link GearboxSDK}. */
+var AnalyticsNamespace = class {
+	positions;
+	constructor(backend) {
+		this.positions = backend.analytics.positions;
+	}
+};
+//#endregion
+export { AnalyticsNamespace };

package/dist/esm/sdk/analytics/index.js

@@ -0,0 +1,3 @@
+import { AnalyticsNamespace } from "./AnalyticsNamespace.js";
+import "./types.js";
+export { AnalyticsNamespace };

package/dist/esm/sdk/analytics/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/sdk/index.js

@@ -8,6 +8,8 @@ import { NoSourceServedError } from "./errors/NoSourceServedError.js";
 import { SourceUnavailableError } from "./errors/SourceUnavailableError.js";
 import "./errors/index.js";
 import { AbstractNamespace } from "./AbstractNamespace.js";
+import { AnalyticsNamespace } from "./analytics/AnalyticsNamespace.js";
+import "./analytics/index.js";
 import { LiquidationsNamespace } from "./liquidations/LiquidationsNamespace.js";
 import "./liquidations/index.js";
 import { ExecuteApi } from "./execute/ExecuteApi.js";
@@ -26,4 +28,4 @@ import { PreviewNamespace } from "./preview/PreviewNamespace.js";
 import "./preview/index.js";
 import { DEFAULT_MAX_STATE_AGE, GearboxSDK } from "./GearboxSDK.js";
 import "./types.js";
-export { AbstractNamespace, AllSourcesFailedError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, IntentPreviewError, LiquidationsNamespace, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, PreviewNamespace, SourceChainMismatchError, SourceUnavailableError, assertSameChains, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };
+export { AbstractNamespace, AllSourcesFailedError, AnalyticsNamespace, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, ExecuteApi, GearboxSDK, IntentPreviewError, LiquidationsNamespace, MissingSourceError, NoSourceServedError, OpportunitiesNamespace, PositionsNamespace, PrepareApi, PreviewNamespace, SourceChainMismatchError, SourceUnavailableError, assertSameChains, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, raise, refuse, toRefusalError, unexpectedFailure };

package/dist/types/model/analytics.d.ts

@@ -0,0 +1,62 @@
+import { PoolPosition, PositionFilter, StrategyPosition } from "./positions.js";
+import { LiquidationPosition } from "./liquidations.js";
+import { Address } from "viem";
+//#region src/model/analytics.d.ts
+/**
+ * A protocol-wide position row together with the wallet that owns it.
+ *
+ * The position fields stay flat, so consumers can render this row exactly as
+ * they render a wallet-scoped {@link Position}; `borrower` is the only extra
+ * identity the protocol-wide list needs.
+ **/
+type AnalyticsPosition = AnalyticsPoolPosition | AnalyticsStrategyPosition | AnalyticsLiquidationPosition;
+/** Pool position with its owner on the protocol-wide list. */
+type AnalyticsPoolPosition = PoolPosition & AnalyticsPositionOwner;
+/** Strategy position with its borrower on the protocol-wide list. */
+type AnalyticsStrategyPosition = StrategyPosition & AnalyticsPositionOwner;
+/** Liquidation position with its owner on the protocol-wide list. */
+type AnalyticsLiquidationPosition = LiquidationPosition & AnalyticsPositionOwner;
+/** Ownership added to every protocol-wide position row. */
+interface AnalyticsPositionOwner {
+  /** Wallet that owns the pool shares or opened the credit account. */
+  borrower: Address;
+}
+/** Fields the protocol-wide position list can order by. */
+type AnalyticsPositionSortField = "netValueUsd" | "totalValueUsd" | "totalDebtUsd" | "pnlUsd" | "apy" | "healthFactor" | "leverage" | "chainId" | "name" | "borrower";
+/** Direction of one analytics list ordering. */
+type AnalyticsSortDirection = "asc" | "desc";
+/**
+ * Filtering, ordering and offset pagination of the protocol-wide position
+ * list. Omitted position criteria have the same meaning as they do on
+ * {@link PositionFilter}.
+ **/
+interface AnalyticsPositionListOptions extends PositionFilter {
+  /** Keep only positions owned by this wallet. */
+  borrower?: Address;
+  /**
+   * Field to order by. Values that do not apply to a position kind, and USD
+   * values that cannot be priced, are always placed after concrete values.
+   *
+   * @defaultValue `"netValueUsd"`
+   */
+  sortBy?: AnalyticsPositionSortField;
+  /** @defaultValue `"desc"` */
+  sortDirection?: AnalyticsSortDirection;
+  /** Number of matching rows to skip. @defaultValue `0` */
+  offset?: number;
+  /** Number of rows to return, from 1 through 100. @defaultValue `25` */
+  limit?: number;
+}
+/** One page of the protocol-wide position list. */
+interface AnalyticsPositionPage {
+  /** Requested slice after filtering and ordering. */
+  items: AnalyticsPosition[];
+  /** Number of rows matching the filter before pagination. */
+  total: number;
+  /** Effective number of rows skipped. */
+  offset: number;
+  /** Effective maximum number of rows returned. */
+  limit: number;
+}
+//#endregion
+export { AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition };

package/dist/types/model/analytics.schema.d.ts

@@ -0,0 +1,149 @@
+import { AnalyticsPosition } from "./analytics.js";
+import { z } from "zod/v4";
+//#region src/model/analytics.schema.d.ts
+/** Default page size of the protocol-wide positions list. */
+declare const ANALYTICS_POSITIONS_DEFAULT_LIMIT = 25;
+/** Largest page the protocol-wide positions list accepts. */
+declare const ANALYTICS_POSITIONS_MAX_LIMIT = 100;
+/** {@link AnalyticsPositionSortField} */
+declare const analyticsPositionSortFieldSchema: z.ZodEnum<{
+  apy: "apy";
+  borrower: "borrower";
+  chainId: "chainId";
+  healthFactor: "healthFactor";
+  leverage: "leverage";
+  name: "name";
+  netValueUsd: "netValueUsd";
+  pnlUsd: "pnlUsd";
+  totalDebtUsd: "totalDebtUsd";
+  totalValueUsd: "totalValueUsd";
+}>;
+/** {@link AnalyticsSortDirection} */
+declare const analyticsSortDirectionSchema: z.ZodEnum<{
+  asc: "asc";
+  desc: "desc";
+}>;
+/** {@link AnalyticsPosition} */
+declare const analyticsPositionSchema: z.ZodType<AnalyticsPosition>;
+/** {@link AnalyticsPositionListOptions} */
+declare const analyticsPositionListOptionsSchema: z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  kind: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>, z.ZodLiteral<"all">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"all">]>>;
+  chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+  underlyingType: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>, z.ZodLiteral<"all">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * {@link AnalyticsPositionListOptions} as URL query parameters.
+ **/
+declare const analyticsPositionListQueryParamsSchema: z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>>;
+  kind: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodEnum<{
+    false: "false";
+    true: "true";
+  }>>;
+  chainIds: z.ZodOptional<z.ZodString>;
+  underlyingType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Codec for an analytics position-list query. It is shared by the SDK client
+ * and backend controller so both sides interpret every parameter identically.
+ **/
+declare const analyticsPositionListQuerySchema: z.ZodCodec<z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>>;
+  kind: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodEnum<{
+    false: "false";
+    true: "true";
+  }>>;
+  chainIds: z.ZodOptional<z.ZodString>;
+  underlyingType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  borrower: z.ZodOptional<z.ZodCustom<`0x${string}`, `0x${string}`>>;
+  kind: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"pool">, z.ZodLiteral<"strategy">, z.ZodLiteral<"liquidation">]>, z.ZodLiteral<"all">]>>;
+  isZeroDebt: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"all">]>>;
+  chainIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+  underlyingType: z.ZodOptional<z.ZodUnion<[z.ZodUnion<readonly [z.ZodLiteral<"Stable">, z.ZodLiteral<"ETH">, z.ZodLiteral<"BTC">]>, z.ZodLiteral<"all">]>>;
+  sortBy: z.ZodOptional<z.ZodEnum<{
+    apy: "apy";
+    borrower: "borrower";
+    chainId: "chainId";
+    healthFactor: "healthFactor";
+    leverage: "leverage";
+    name: "name";
+    netValueUsd: "netValueUsd";
+    pnlUsd: "pnlUsd";
+    totalDebtUsd: "totalDebtUsd";
+    totalValueUsd: "totalValueUsd";
+  }>>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/** {@link AnalyticsPositionPage} */
+declare const analyticsPositionPageSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodType<AnalyticsPosition, unknown, z.core.$ZodTypeInternals<AnalyticsPosition, unknown>>>;
+  total: z.ZodNumber;
+  offset: z.ZodNumber;
+  limit: z.ZodNumber;
+}, z.core.$strip>;
+//#endregion
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema };

package/dist/types/model/index.d.ts

@@ -1,17 +1,19 @@
 import { Amount, Asset, AssetType, Bps, ChainId, Leverage, Timestamp, Token, TokenAmount, TxCall, UnderlyingToken } from "./primitives.js";
-import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, GridSampling, OpportunityChartMetric, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PoolOpportunityChartMetric, PoolPositionChartMetric, PositionChartMetric, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunityChartMetric, StrategyPositionChartMetric } from "./charts.js";
-import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
-import { CompareTag, CompareTolerance, ToleranceCompareTag, backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { ChainScopedFilter, FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
+import { IGearboxError } from "./errors.js";
 import { Curator, CuratorName } from "./curators.js";
-import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
 import { DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedWithdrawCollateralIntent } from "./delayed-intents.js";
-import { IGearboxError } from "./errors.js";
-import { ChainScopedFilter, FILTER_ALL, FilterAll, Filterable, isFilterSet } from "./filters.js";
-import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
 import { ApyBreakdown, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, PointRewards, PointsProgram, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, Rewards, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, TokenRewards, matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
 import { BorrowRateBreakdown, PnlBreakdown, PointsProgramPnL, PointsRewardsPnL, PoolPosition, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionTransaction, PositionTransactionKind, PositionsTotals, RewardsPnL, STRATEGY_POSITION_COLLATERAL_ERROR, StrategyPosition, StrategyPositionKey, StrategyPositionRef, TokenQuotaRate, TokenRewardsPnL, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
 import { AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdapterCallOutsideBracketError, AdjustStrategyPositionPreview, CreditOperationMarket, DelayedStrategyPositionOperationPreview, Estimated, EstimatedProjection, ExitStrategyPositionPreview, InstantStrategyPositionOperationPreview, InvalidTransactionValueError, MalformedBracketError, MalformedBracketKind, MalformedPreviewError, NonAdapterCallInBracketError, OpenStrategyPositionPreview, OperationPreview, OperationPreviewError, PoolOperationType, PoolPositionOperationPreview, PreviewOperationInput, PreviewOperationOptions, RepayStrategyPositionPreview, RoutedField, UnpreviewableAdapterCallError, UnsupportedOutOfBracketCallError, asEstimated } from "./previews.js";
 import { DelayedReceivedAsset, InstantReceivedAsset, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, ReceivedAsset, matchesLiquidatableAccountFilter } from "./liquidations.js";
+import { AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition } from "./analytics.js";
+import { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema } from "./analytics.schema.js";
+import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, GridSampling, OpportunityChartMetric, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PoolOpportunityChartMetric, PoolPositionChartMetric, PositionChartMetric, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, StrategyOpportunityChartMetric, StrategyPositionChartMetric } from "./charts.js";
+import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
+import { CompareTag, CompareTolerance, ToleranceCompareTag, backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { curatorNameSchema, curatorSchema } from "./curators.schema.js";
+import { booleanParamSchema, encodeFlag, filterAllSchema, filterable } from "./filters.schema.js";
 import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionSchema, receivedAssetSchema } from "./liquidations.schema.js";
 import { Notice, NoticeKind, NoticeSubject } from "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
@@ -23,4 +25,4 @@ import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourc
 import { SDKError, SDKResult, SDKReturn, SafeValue, isSDKError, safeValue, sdkErr, sdkOk } from "./result.js";
 import { PositionClaimableWithdrawal, PositionPendingWithdrawal, PositionWithdrawals, WithdrawalOutputAmount } from "./withdrawals.js";
 import { positionClaimableWithdrawalSchema, positionPendingWithdrawalSchema, positionWithdrawalsSchema, withdrawalOutputAmountSchema } from "./withdrawals.schema.js";
-export { AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdapterCallOutsideBracketError, AdjustStrategyPositionPreview, Amount, ApyBreakdown, Asset, AssetType, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InvalidTransactionValueError, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, MalformedBracketError, MalformedBracketKind, MalformedPreviewError, NonAdapterCallInBracketError, Notice, NoticeKind, NoticeSubject, OpenStrategyPositionPreview, OperationPreview, OperationPreviewError, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ResponseMetadata, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnpreviewableAdapterCallError, UnsupportedOutOfBracketCallError, WithdrawalOutputAmount, amountSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, isSDKError, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, withdrawalOutputAmountSchema };
+export { ANALYTICS_POSITIONS_DEFAULT_LIMIT, ANALYTICS_POSITIONS_MAX_LIMIT, AccountHoldings, AccountMetrics, AccountProjection, AccountStateChange, AdapterCallOutsideBracketError, AdjustStrategyPositionPreview, Amount, AnalyticsLiquidationPosition, AnalyticsPoolPosition, AnalyticsPosition, AnalyticsPositionListOptions, AnalyticsPositionOwner, AnalyticsPositionPage, AnalyticsPositionSortField, AnalyticsSortDirection, AnalyticsStrategyPosition, ApyBreakdown, Asset, AssetType, BorrowRateBreakdown, Bps, CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainScopedFilter, ChainSucceeded, ChartBundle, ChartDenomination, ChartMetric, ChartQuery, ChartRange, ChartSeries, ChartSeriesOk, ChartSeriesUnavailable, ChartUnavailableCode, ChartUnit, ChartValue, ChartWindow, CompareTag, CompareTolerance, CreditOperationMarket, Curator, CuratorName, DataResponse, DataSource, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedReceivedAsset, DelayedStrategyPositionOperationPreview, DelayedWithdrawCollateralIntent, Estimated, EstimatedProjection, ExitStrategyPositionPreview, FILTER_ALL, FilterAll, Filterable, GridSampling, IGearboxError, InstantReceivedAsset, InstantStrategyPositionOperationPreview, InvalidTransactionValueError, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, MalformedBracketError, MalformedBracketKind, MalformedPreviewError, NonAdapterCallInBracketError, Notice, NoticeKind, NoticeSubject, OpenStrategyPositionPreview, OperationPreview, OperationPreviewError, Opportunity, OpportunityBase, OpportunityChartMetric, OpportunityDetail, OpportunityFilter, OpportunityId, OpportunityKey, OpportunityKind, OpportunityTotals, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolOperationType, PoolOpportunity, PoolOpportunityChartMetric, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionChartMetric, PoolPositionKey, PoolPositionOperationPreview, PoolPositionRef, Position, PositionChartMetric, PositionClaimableWithdrawal, PositionCollateral, PositionFilter, PositionId, PositionKey, PositionKind, PositionPendingWithdrawal, PositionTransaction, PositionTransactionKind, PositionWithdrawals, PositionsTotals, PreviewOperationInput, PreviewOperationOptions, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, RepayStrategyPositionPreview, ResponseMetadata, Rewards, RewardsPnL, RoutedField, SDKError, SDKResult, SDKReturn, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, SafeValue, StrategyOpportunity, StrategyOpportunityChartMetric, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionChartMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenQuotaRate, TokenRewards, TokenRewardsPnL, ToleranceCompareTag, TxCall, UnderlyingToken, UnpreviewableAdapterCallError, UnsupportedOutOfBracketCallError, WithdrawalOutputAmount, amountSchema, analyticsPositionListOptionsSchema, analyticsPositionListQueryParamsSchema, analyticsPositionListQuerySchema, analyticsPositionPageSchema, analyticsPositionSchema, analyticsPositionSortFieldSchema, analyticsSortDirectionSchema, apyBreakdownSchema, asEstimated, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, isSDKError, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionClaimableWithdrawalSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionPendingWithdrawalSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionWithdrawalsSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, safeValue, sdkErr, sdkOk, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema, withdrawalOutputAmountSchema };

package/dist/types/model/opportunities.d.ts

@@ -1,6 +1,6 @@
 import { Amount, AssetType, Bps, ChainId, Leverage, Timestamp, Token, UnderlyingToken } from "./primitives.js";
-import { Curator } from "./curators.js";
 import { ChainScopedFilter, Filterable } from "./filters.js";
+import { Curator } from "./curators.js";
 import { Address } from "viem";
 //#region src/model/opportunities.d.ts
 /**

package/dist/types/model/previews.d.ts

@@ -1,8 +1,8 @@
 import { Bps, ChainId, Leverage, Timestamp, Token, TokenAmount, UnderlyingToken } from "./primitives.js";
-import { Curator } from "./curators.js";
-import { DelayedIntent } from "./delayed-intents.js";
 import { IGearboxError } from "./errors.js";
 import { UnpriceableTokenError } from "../onchain/market/oracle/errors.js";
+import { Curator } from "./curators.js";
+import { DelayedIntent } from "./delayed-intents.js";
 import { BorrowRateBreakdown } from "./positions.js";
 import { Address, Hex } from "viem";
 //#region src/model/previews.d.ts

package/dist/types/offchain/AbstractOffchainNamespace.d.ts

@@ -1,7 +1,7 @@
 import { ILogger } from "../onchain/types/logger.js";
 import { ChainId } from "../model/primitives.js";
-import { ChartBundle, ChartMetric, ChartRange } from "../model/charts.js";
 import { ChainScopedFilter } from "../model/filters.js";
+import { ChartBundle, ChartMetric, ChartRange } from "../model/charts.js";
 import { DataResponse } from "../model/response.js";
 import { GearboxAPIOptions } from "./types.js";
 import { z } from "zod/v4";

package/dist/types/offchain/GearboxAPI.d.ts

@@ -1,5 +1,7 @@
 import { ChainId } from "../model/primitives.js";
 import { GearboxAPIOptions } from "./types.js";
+import { OffchainAnalytics } from "./analytics/OffchainAnalytics.js";
+import "./analytics/index.js";
 import { OffchainNotices } from "./notices/OffchainNotices.js";
 import "./notices/index.js";
 import { OffchainOpportunities } from "./opportunities/OffchainOpportunities.js";
@@ -29,6 +31,8 @@ declare class GearboxAPI {
    * Chains every read of this client is scoped to.
    **/
   readonly chainIds: readonly ChainId[];
+  /** Protocol-wide, backend-only analytics. */
+  readonly analytics: OffchainAnalytics;
   /**
    * Namespace for pool and strategy opportunities.
    **/

package/dist/types/offchain/analytics/OffchainAnalytics.d.ts

@@ -0,0 +1,11 @@
+import { GearboxAPIOptions } from "../types.js";
+import { IOffchainAnalytics } from "./types.js";
+import { OffchainAnalyticsPositions } from "./OffchainAnalyticsPositions.js";
+//#region src/offchain/analytics/OffchainAnalytics.d.ts
+/** Backend-only protocol analytics, grouped by subject. */
+declare class OffchainAnalytics implements IOffchainAnalytics {
+  readonly positions: OffchainAnalyticsPositions;
+  constructor(options: GearboxAPIOptions);
+}
+//#endregion
+export { OffchainAnalytics };

package/dist/types/offchain/analytics/OffchainAnalyticsPositions.d.ts

@@ -0,0 +1,14 @@
+import { AnalyticsPositionListOptions, AnalyticsPositionPage } from "../../model/analytics.js";
+import { DataResponse } from "../../model/response.js";
+import { GearboxAPIOptions } from "../types.js";
+import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
+import { IOffchainAnalyticsPositions } from "./types.js";
+//#region src/offchain/analytics/OffchainAnalyticsPositions.d.ts
+/** Backend client for protocol-wide position analytics. */
+declare class OffchainAnalyticsPositions extends AbstractOffchainNamespace implements IOffchainAnalyticsPositions {
+  constructor(options: GearboxAPIOptions);
+  /** {@inheritDoc IOffchainAnalyticsPositions.list} */
+  list(options?: AnalyticsPositionListOptions): Promise<DataResponse<AnalyticsPositionPage>>;
+}
+//#endregion
+export { OffchainAnalyticsPositions };

package/dist/types/offchain/analytics/index.d.ts

@@ -0,0 +1,4 @@
+import { IOffchainAnalytics, IOffchainAnalyticsPositions } from "./types.js";
+import { OffchainAnalyticsPositions } from "./OffchainAnalyticsPositions.js";
+import { OffchainAnalytics } from "./OffchainAnalytics.js";
+export { IOffchainAnalytics, IOffchainAnalyticsPositions, OffchainAnalytics, OffchainAnalyticsPositions };

package/dist/types/offchain/analytics/types.d.ts

@@ -0,0 +1,17 @@
+import { AnalyticsPositionListOptions, AnalyticsPositionPage } from "../../model/analytics.js";
+import { DataResponse } from "../../model/response.js";
+//#region src/offchain/analytics/types.d.ts
+/** Protocol-wide position reads served by the backend. */
+interface IOffchainAnalyticsPositions {
+  /**
+   * Every current position in the protocol, with its owning borrower, after
+   * applying the requested filter, ordering and pagination.
+   **/
+  list(options?: AnalyticsPositionListOptions): Promise<DataResponse<AnalyticsPositionPage>>;
+}
+/** Backend-only protocol analytics, grouped by subject. */
+interface IOffchainAnalytics {
+  readonly positions: IOffchainAnalyticsPositions;
+}
+//#endregion
+export { IOffchainAnalytics, IOffchainAnalyticsPositions };

package/dist/types/offchain/index.d.ts

@@ -1,5 +1,9 @@
 import { GearboxAPIOptions } from "./types.js";
 import { AbstractOffchainNamespace, OffchainGetRequest, OffchainQuery } from "./AbstractOffchainNamespace.js";
+import { IOffchainAnalytics, IOffchainAnalyticsPositions } from "./analytics/types.js";
+import { OffchainAnalyticsPositions } from "./analytics/OffchainAnalyticsPositions.js";
+import { OffchainAnalytics } from "./analytics/OffchainAnalytics.js";
+import "./analytics/index.js";
 import { OffchainNotices } from "./notices/OffchainNotices.js";
 import "./notices/index.js";
 import { IOffchainOpportunities, OpportunityChartMetricFor } from "./opportunities/types.js";
@@ -20,4 +24,4 @@ import { backendMessage } from "./errors/backendMessage.js";
 import { ErrorCause, errorCause } from "./errors/errorCause.js";
 import { readResponseBody } from "./errors/readResponseBody.js";
 import "./errors/index.js";
-export { AbstractOffchainNamespace, ErrorCause, GearboxAPI, GearboxAPIOptions, IOffchainOpportunities, IOffchainPositions, OffchainGetRequest, OffchainInvalidJsonError, OffchainNotConfiguredError, OffchainNotImplementedError, OffchainNotices, OffchainOpportunities, OffchainPositions, OffchainQuery, OffchainRequestFailedError, OffchainStatusError, OffchainTransportError, OffchainTransportErrorParams, OffchainValidationError, OpportunityChartMetricFor, PositionChartMetricFor, backendMessage, errorCause, readResponseBody };
+export { AbstractOffchainNamespace, ErrorCause, GearboxAPI, GearboxAPIOptions, IOffchainAnalytics, IOffchainAnalyticsPositions, IOffchainOpportunities, IOffchainPositions, OffchainAnalytics, OffchainAnalyticsPositions, OffchainGetRequest, OffchainInvalidJsonError, OffchainNotConfiguredError, OffchainNotImplementedError, OffchainNotices, OffchainOpportunities, OffchainPositions, OffchainQuery, OffchainRequestFailedError, OffchainStatusError, OffchainTransportError, OffchainTransportErrorParams, OffchainValidationError, OpportunityChartMetricFor, PositionChartMetricFor, backendMessage, errorCause, readResponseBody };

package/dist/types/offchain/opportunities/OffchainOpportunities.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { Opportunity, OpportunityFilter, OpportunityKey, OpportunityTotals, PoolOpportunityDetail, PoolOpportunityKey, StrategyOpportunityDetail, StrategyOpportunityKey } from "../../model/opportunities.js";
+import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 import { GearboxAPIOptions } from "../types.js";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";

package/dist/types/offchain/opportunities/types.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
 import { Opportunity, OpportunityFilter, OpportunityKey, OpportunityTotals, PoolOpportunityDetail, PoolOpportunityKey, StrategyOpportunityDetail, StrategyOpportunityKey } from "../../model/opportunities.js";
+import { ChartBundle, ChartRange, PoolOpportunityChartMetric, StrategyOpportunityChartMetric } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 //#region src/offchain/opportunities/types.d.ts
 type OpportunityChartMetricFor<K extends OpportunityKey> = {

package/dist/types/offchain/positions/OffchainPositions.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { Position, PositionKey, PositionTransaction, PositionsTotals, StrategyPositionKey } from "../../model/positions.js";
+import { ChartBundle, ChartRange } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 import { ListPositionsPropsBase } from "../../onchain/positions/types.js";
 import { GearboxAPIOptions } from "../types.js";

package/dist/types/offchain/positions/types.d.ts

@@ -1,5 +1,5 @@
-import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { Position, PositionKey, PositionTransaction, PositionsTotals, StrategyPositionKey } from "../../model/positions.js";
+import { ChartBundle, ChartRange, PoolPositionChartMetric, StrategyPositionChartMetric } from "../../model/charts.js";
 import { DataResponse } from "../../model/response.js";
 import { ListPositionsPropsBase } from "../../onchain/positions/types.js";
 import { Address } from "viem";

package/dist/types/sdk/GearboxSDK.d.ts

@@ -1,10 +1,12 @@
 import { NetworkType } from "../onchain/chain/chains.js";
 import "../onchain/index.js";
+import { IAnalyticsByMode } from "./analytics/types.js";
 import { ILiquidationsByMode } from "./liquidations/types.js";
 import { IOpportunities } from "./opportunities/types.js";
 import { IPositions } from "./positions/types.js";
 import { IPreviewByMode } from "./preview/types.js";
 import { GearboxSDKOptions, IGearboxSDK, INoticesByMode, Mode, OffchainByMode, OnchainByMode } from "./types.js";
+import "./analytics/index.js";
 import "./liquidations/index.js";
 import "./opportunities/index.js";
 import "./positions/index.js";
@@ -44,6 +46,8 @@ declare class GearboxSDK<const M extends Mode = Mode> implements IGearboxSDK<M>
    * Chains this instance covers, which every read is scoped to.
    **/
   readonly networks: readonly NetworkType[];
+  /** Protocol-wide analytics. Undefined in `onchain` mode. */
+  readonly analytics: IAnalyticsByMode[M];
   /**
    * Namespace for pool and strategy opportunities.
    **/