@uniswap/client-data-api 0.0.278 → 0.0.280

package/dist/data/v2/api_pb.d.ts

@@ -4,7 +4,7 @@ import { FiatAmount, FiatCurrency, HistoryDuration, Launch, LaunchesOrderBy, Lau
 import { PageRequest, PageResponse } from "./common_pb.js";
 import { EarnPosition, EarnVault } from "./earn_pb.js";
 import { TimestampedValue } from "../v1/types_pb.js";
-import { RankedCategory, TimeSeriesPoint } from "./categories_pb.js";
+import { CategoryKind, RankedCategory, RankedPoolCategory, TimeSeriesPoint } from "./categories_pb.js";
 import { RankedTokenGroup, TokenGroup, TokenGroupListFilter } from "./tokenGroups_pb.js";
 import { ProtocolVersion } from "../v1/poolTypes_pb.js";
 /**
@@ -2454,11 +2454,18 @@ export declare class ListTokensResponse extends Message<ListTokensResponse> {
  */
 export declare class ListCategoriesRequest extends Message<ListCategoriesRequest> {
     /**
-     * Chains to scope the aggregate stats and top_tokens to. Must be non-empty.
+     * Chains to scope the aggregate stats and top_tokens / top_pools to. Must
+     * be non-empty.
      *
      * @generated from field: repeated uint32 chain_ids = 1;
      */
     chainIds: number[];
+    /**
+     * Which taxonomy to list. UNSPECIFIED reads as TOKEN.
+     *
+     * @generated from field: data.v2.CategoryKind kind = 2;
+     */
+    kind: CategoryKind;
     constructor(data?: PartialMessage<ListCategoriesRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.ListCategoriesRequest";
@@ -2473,9 +2480,17 @@ export declare class ListCategoriesRequest extends Message<ListCategoriesRequest
  */
 export declare class ListCategoriesResponse extends Message<ListCategoriesResponse> {
     /**
+     * Set for kind TOKEN; empty for kind POOL.
+     *
      * @generated from field: repeated data.v2.RankedCategory categories = 1;
      */
     categories: RankedCategory[];
+    /**
+     * Set for kind POOL; empty for kind TOKEN. One list per kind, never both.
+     *
+     * @generated from field: repeated data.v2.RankedPoolCategory pool_categories = 2;
+     */
+    poolCategories: RankedPoolCategory[];
     constructor(data?: PartialMessage<ListCategoriesResponse>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.ListCategoriesResponse";
@@ -2519,21 +2534,46 @@ export declare class GetCategoryRequest extends Message<GetCategoryRequest> {
  */
 export declare class GetCategoryResponse extends Message<GetCategoryResponse> {
     /**
+     * Set for a token category id; unset for a pool category id.
+     *
      * @generated from field: data.v2.RankedCategory category = 1;
      */
     category?: RankedCategory;
     /**
-     * Aggregate member swap volume over time. Empty unless include_charts.
+     * Aggregate member swap volume over time: the members' trading volume for
+     * a token category, the member pools' swap volume for a pool category.
+     * Empty unless include_charts.
      *
      * @generated from field: repeated data.v2.TimeSeriesPoint volume_series = 2;
      */
     volumeSeries: TimeSeriesPoint[];
     /**
-     * Aggregate member FDV over time. Empty unless include_charts.
+     * Aggregate member FDV over time. Empty unless include_charts; empty for a
+     * pool category.
      *
      * @generated from field: repeated data.v2.TimeSeriesPoint fdv_series = 3;
      */
     fdvSeries: TimeSeriesPoint[];
+    /**
+     * Aggregate member pool TVL over time. Empty unless include_charts; empty
+     * for a token category.
+     *
+     * @generated from field: repeated data.v2.TimeSeriesPoint tvl_series = 4;
+     */
+    tvlSeries: TimeSeriesPoint[];
+    /**
+     * Aggregate member pool LP fees over time. Empty unless include_charts;
+     * empty for a token category.
+     *
+     * @generated from field: repeated data.v2.TimeSeriesPoint fees_series = 5;
+     */
+    feesSeries: TimeSeriesPoint[];
+    /**
+     * Set for a pool category id; unset for a token category id.
+     *
+     * @generated from field: data.v2.RankedPoolCategory pool_category = 6;
+     */
+    poolCategory?: RankedPoolCategory;
     constructor(data?: PartialMessage<GetCategoryResponse>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.GetCategoryResponse";

package/dist/data/v2/api_pb.js

@@ -7,7 +7,7 @@ import { FiatAmount, FiatCurrency, HistoryDuration, Launch, LaunchesOrderBy, Lau
 import { PageRequest, PageResponse } from "./common_pb.js";
 import { EarnPosition, EarnVault } from "./earn_pb.js";
 import { TimestampedValue } from "../v1/types_pb.js";
-import { RankedCategory, TimeSeriesPoint } from "./categories_pb.js";
+import { CategoryKind, RankedCategory, RankedPoolCategory, TimeSeriesPoint } from "./categories_pb.js";
 import { RankedTokenGroup, TokenGroup, TokenGroupListFilter } from "./tokenGroups_pb.js";
 import { ProtocolVersion } from "../v1/poolTypes_pb.js";
 /**
@@ -2805,11 +2805,18 @@ export class ListCategoriesRequest extends Message {
     constructor(data) {
         super();
         /**
-         * Chains to scope the aggregate stats and top_tokens to. Must be non-empty.
+         * Chains to scope the aggregate stats and top_tokens / top_pools to. Must
+         * be non-empty.
          *
          * @generated from field: repeated uint32 chain_ids = 1;
          */
         this.chainIds = [];
+        /**
+         * Which taxonomy to list. UNSPECIFIED reads as TOKEN.
+         *
+         * @generated from field: data.v2.CategoryKind kind = 2;
+         */
+        this.kind = CategoryKind.UNSPECIFIED;
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -2829,6 +2836,7 @@ ListCategoriesRequest.runtime = proto3;
 ListCategoriesRequest.typeName = "data.v2.ListCategoriesRequest";
 ListCategoriesRequest.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "chain_ids", kind: "scalar", T: 13 /* ScalarType.UINT32 */, repeated: true },
+    { no: 2, name: "kind", kind: "enum", T: proto3.getEnumType(CategoryKind) },
 ]);
 /**
  * @generated from message data.v2.ListCategoriesResponse
@@ -2837,9 +2845,17 @@ export class ListCategoriesResponse extends Message {
     constructor(data) {
         super();
         /**
+         * Set for kind TOKEN; empty for kind POOL.
+         *
          * @generated from field: repeated data.v2.RankedCategory categories = 1;
          */
         this.categories = [];
+        /**
+         * Set for kind POOL; empty for kind TOKEN. One list per kind, never both.
+         *
+         * @generated from field: repeated data.v2.RankedPoolCategory pool_categories = 2;
+         */
+        this.poolCategories = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -2859,6 +2875,7 @@ ListCategoriesResponse.runtime = proto3;
 ListCategoriesResponse.typeName = "data.v2.ListCategoriesResponse";
 ListCategoriesResponse.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "categories", kind: "message", T: RankedCategory, repeated: true },
+    { no: 2, name: "pool_categories", kind: "message", T: RankedPoolCategory, repeated: true },
 ]);
 /**
  * @generated from message data.v2.GetCategoryRequest
@@ -2911,17 +2928,34 @@ export class GetCategoryResponse extends Message {
     constructor(data) {
         super();
         /**
-         * Aggregate member swap volume over time. Empty unless include_charts.
+         * Aggregate member swap volume over time: the members' trading volume for
+         * a token category, the member pools' swap volume for a pool category.
+         * Empty unless include_charts.
          *
          * @generated from field: repeated data.v2.TimeSeriesPoint volume_series = 2;
          */
         this.volumeSeries = [];
         /**
-         * Aggregate member FDV over time. Empty unless include_charts.
+         * Aggregate member FDV over time. Empty unless include_charts; empty for a
+         * pool category.
          *
          * @generated from field: repeated data.v2.TimeSeriesPoint fdv_series = 3;
          */
         this.fdvSeries = [];
+        /**
+         * Aggregate member pool TVL over time. Empty unless include_charts; empty
+         * for a token category.
+         *
+         * @generated from field: repeated data.v2.TimeSeriesPoint tvl_series = 4;
+         */
+        this.tvlSeries = [];
+        /**
+         * Aggregate member pool LP fees over time. Empty unless include_charts;
+         * empty for a token category.
+         *
+         * @generated from field: repeated data.v2.TimeSeriesPoint fees_series = 5;
+         */
+        this.feesSeries = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -2943,6 +2977,9 @@ GetCategoryResponse.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "category", kind: "message", T: RankedCategory },
     { no: 2, name: "volume_series", kind: "message", T: TimeSeriesPoint, repeated: true },
     { no: 3, name: "fdv_series", kind: "message", T: TimeSeriesPoint, repeated: true },
+    { no: 4, name: "tvl_series", kind: "message", T: TimeSeriesPoint, repeated: true },
+    { no: 5, name: "fees_series", kind: "message", T: TimeSeriesPoint, repeated: true },
+    { no: 6, name: "pool_category", kind: "message", T: RankedPoolCategory },
 ]);
 /**
  * @generated from message data.v2.ListTokenGroupsRequest

package/dist/data/v2/categories_pb.d.ts

@@ -1,5 +1,6 @@
 import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
 import { Message, proto3 } from "@bufbuild/protobuf";
+import { ProtocolVersion } from "../v1/poolTypes_pb.js";
 import { TokensSort } from "./types_pb.js";
 import { TokenGroup } from "./tokenGroups_pb.js";
 /**
@@ -29,6 +30,27 @@ export declare enum CategoryClass {
      */
     SECTOR = 3
 }
+/**
+ * Which taxonomy a category belongs to. Ids are unique across kinds.
+ *
+ * @generated from enum data.v2.CategoryKind
+ */
+export declare enum CategoryKind {
+    /**
+     * Read as TOKEN: a category that carries no kind is a token category.
+     *
+     * @generated from enum value: CATEGORY_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: CATEGORY_KIND_TOKEN = 1;
+     */
+    TOKEN = 1,
+    /**
+     * @generated from enum value: CATEGORY_KIND_POOL = 2;
+     */
+    POOL = 2
+}
 /**
  * One member token of a category.
  *
@@ -60,6 +82,55 @@ export declare class CategoryTopToken extends Message<CategoryTopToken> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CategoryTopToken;
     static equals(a: CategoryTopToken | PlainMessage<CategoryTopToken> | undefined, b: CategoryTopToken | PlainMessage<CategoryTopToken> | undefined): boolean;
 }
+/**
+ * One member pool of a pool category: the pool twin of CategoryTopToken.
+ *
+ * @generated from message data.v2.CategoryTopPool
+ */
+export declare class CategoryTopPool extends Message<CategoryTopPool> {
+    /**
+     * @generated from field: uint32 chain_id = 1;
+     */
+    chainId: number;
+    /**
+     * Same value as Pool.pool_id: checksummed pool address (V4: pool id hash).
+     *
+     * @generated from field: string pool_id = 2;
+     */
+    poolId: string;
+    /**
+     * @generated from field: string token0_symbol = 3;
+     */
+    token0Symbol: string;
+    /**
+     * @generated from field: string token0_logo_url = 4;
+     */
+    token0LogoUrl: string;
+    /**
+     * @generated from field: string token1_symbol = 5;
+     */
+    token1Symbol: string;
+    /**
+     * @generated from field: string token1_logo_url = 6;
+     */
+    token1LogoUrl: string;
+    /**
+     * @generated from field: pools.v1.ProtocolVersion protocol_version = 7;
+     */
+    protocolVersion: ProtocolVersion;
+    /**
+     * @generated from field: optional uint32 fee_tier = 8;
+     */
+    feeTier?: number;
+    constructor(data?: PartialMessage<CategoryTopPool>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "data.v2.CategoryTopPool";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CategoryTopPool;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CategoryTopPool;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CategoryTopPool;
+    static equals(a: CategoryTopPool | PlainMessage<CategoryTopPool> | undefined, b: CategoryTopPool | PlainMessage<CategoryTopPool> | undefined): boolean;
+}
 /**
  * Chain-scoped, multichain-deduped aggregates over the category's members.
  *
@@ -116,6 +187,57 @@ export declare class CategoryAggregateStats extends Message<CategoryAggregateSta
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CategoryAggregateStats;
     static equals(a: CategoryAggregateStats | PlainMessage<CategoryAggregateStats> | undefined, b: CategoryAggregateStats | PlainMessage<CategoryAggregateStats> | undefined): boolean;
 }
+/**
+ * Chain-scoped aggregates over a pool category's members. USD values.
+ *
+ * @generated from message data.v2.CategoryPoolAggregateStats
+ */
+export declare class CategoryPoolAggregateStats extends Message<CategoryPoolAggregateStats> {
+    /**
+     * @generated from field: uint32 pool_count = 1;
+     */
+    poolCount: number;
+    /**
+     * @generated from field: double tvl = 2;
+     */
+    tvl: number;
+    /**
+     * @generated from field: double volume_1d = 3;
+     */
+    volume1d: number;
+    /**
+     * @generated from field: double volume_1w = 4;
+     */
+    volume1w: number;
+    /**
+     * @generated from field: double volume_1m = 5;
+     */
+    volume1m: number;
+    /**
+     * @generated from field: double fees_1d = 6;
+     */
+    fees1d: number;
+    /**
+     * @generated from field: optional double tvl_change_24h_pct = 7;
+     */
+    tvlChange24hPct?: number;
+    /**
+     * @generated from field: optional double volume_change_24h_pct = 8;
+     */
+    volumeChange24hPct?: number;
+    /**
+     * @generated from field: optional double avg_apr = 9;
+     */
+    avgApr?: number;
+    constructor(data?: PartialMessage<CategoryPoolAggregateStats>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "data.v2.CategoryPoolAggregateStats";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CategoryPoolAggregateStats;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CategoryPoolAggregateStats;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CategoryPoolAggregateStats;
+    static equals(a: CategoryPoolAggregateStats | PlainMessage<CategoryPoolAggregateStats> | undefined, b: CategoryPoolAggregateStats | PlainMessage<CategoryPoolAggregateStats> | undefined): boolean;
+}
 /**
  * Category identity: stable, request-independent metadata.
  *
@@ -163,11 +285,19 @@ export declare class Category extends Message<Category> {
     };
     /**
      * Sort the category page opens with, before the user picks a column.
-     * Always set. Feed it to ListTokens / ListTokenGroups as the sort.
+     * Always set for a token category; feed it to ListTokens / ListTokenGroups
+     * as the sort. Unset for a pool category, whose page opens on 1D volume,
+     * highest first.
      *
      * @generated from field: data.v2.TokensSort default_sort = 9;
      */
     defaultSort?: TokensSort;
+    /**
+     * UNSPECIFIED reads as TOKEN.
+     *
+     * @generated from field: data.v2.CategoryKind kind = 10;
+     */
+    kind: CategoryKind;
     constructor(data?: PartialMessage<Category>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.Category";
@@ -212,6 +342,37 @@ export declare class RankedCategory extends Message<RankedCategory> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RankedCategory;
     static equals(a: RankedCategory | PlainMessage<RankedCategory> | undefined, b: RankedCategory | PlainMessage<RankedCategory> | undefined): boolean;
 }
+/**
+ * A pool category plus its chain-scoped market view: the pool twin of
+ * RankedCategory. Served by ListCategories(kind: POOL) and by GetCategory for
+ * a pool category id.
+ *
+ * @generated from message data.v2.RankedPoolCategory
+ */
+export declare class RankedPoolCategory extends Message<RankedPoolCategory> {
+    /**
+     * @generated from field: data.v2.Category category = 1;
+     */
+    category?: Category;
+    /**
+     * @generated from field: data.v2.CategoryPoolAggregateStats stats = 2;
+     */
+    stats?: CategoryPoolAggregateStats;
+    /**
+     * The members a logo pile renders, highest TVL first.
+     *
+     * @generated from field: repeated data.v2.CategoryTopPool top_pools = 3;
+     */
+    topPools: CategoryTopPool[];
+    constructor(data?: PartialMessage<RankedPoolCategory>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "data.v2.RankedPoolCategory";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): RankedPoolCategory;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): RankedPoolCategory;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RankedPoolCategory;
+    static equals(a: RankedPoolCategory | PlainMessage<RankedPoolCategory> | undefined, b: RankedPoolCategory | PlainMessage<RankedPoolCategory> | undefined): boolean;
+}
 /**
  * @generated from message data.v2.TimeSeriesPoint
  */

package/dist/data/v2/categories_pb.js

@@ -3,6 +3,7 @@
 /* eslint-disable */
 // @ts-nocheck
 import { Message, proto3, protoInt64 } from "@bufbuild/protobuf";
+import { ProtocolVersion } from "../v1/poolTypes_pb.js";
 import { TokensSort } from "./types_pb.js";
 import { TokenGroup } from "./tokenGroups_pb.js";
 /**
@@ -40,6 +41,34 @@ proto3.util.setEnumType(CategoryClass, "data.v2.CategoryClass", [
     { no: 2, name: "CATEGORY_CLASS_ASSET" },
     { no: 3, name: "CATEGORY_CLASS_SECTOR" },
 ]);
+/**
+ * Which taxonomy a category belongs to. Ids are unique across kinds.
+ *
+ * @generated from enum data.v2.CategoryKind
+ */
+export var CategoryKind;
+(function (CategoryKind) {
+    /**
+     * Read as TOKEN: a category that carries no kind is a token category.
+     *
+     * @generated from enum value: CATEGORY_KIND_UNSPECIFIED = 0;
+     */
+    CategoryKind[CategoryKind["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * @generated from enum value: CATEGORY_KIND_TOKEN = 1;
+     */
+    CategoryKind[CategoryKind["TOKEN"] = 1] = "TOKEN";
+    /**
+     * @generated from enum value: CATEGORY_KIND_POOL = 2;
+     */
+    CategoryKind[CategoryKind["POOL"] = 2] = "POOL";
+})(CategoryKind || (CategoryKind = {}));
+// Retrieve enum metadata with: proto3.getEnumType(CategoryKind)
+proto3.util.setEnumType(CategoryKind, "data.v2.CategoryKind", [
+    { no: 0, name: "CATEGORY_KIND_UNSPECIFIED" },
+    { no: 1, name: "CATEGORY_KIND_TOKEN" },
+    { no: 2, name: "CATEGORY_KIND_POOL" },
+]);
 /**
  * One member token of a category.
  *
@@ -87,6 +116,71 @@ CategoryTopToken.fields = proto3.util.newFieldList(() => [
     { no: 3, name: "symbol", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 4, name: "logo_url", kind: "scalar", T: 9 /* ScalarType.STRING */ },
 ]);
+/**
+ * One member pool of a pool category: the pool twin of CategoryTopToken.
+ *
+ * @generated from message data.v2.CategoryTopPool
+ */
+export class CategoryTopPool extends Message {
+    constructor(data) {
+        super();
+        /**
+         * @generated from field: uint32 chain_id = 1;
+         */
+        this.chainId = 0;
+        /**
+         * Same value as Pool.pool_id: checksummed pool address (V4: pool id hash).
+         *
+         * @generated from field: string pool_id = 2;
+         */
+        this.poolId = "";
+        /**
+         * @generated from field: string token0_symbol = 3;
+         */
+        this.token0Symbol = "";
+        /**
+         * @generated from field: string token0_logo_url = 4;
+         */
+        this.token0LogoUrl = "";
+        /**
+         * @generated from field: string token1_symbol = 5;
+         */
+        this.token1Symbol = "";
+        /**
+         * @generated from field: string token1_logo_url = 6;
+         */
+        this.token1LogoUrl = "";
+        /**
+         * @generated from field: pools.v1.ProtocolVersion protocol_version = 7;
+         */
+        this.protocolVersion = ProtocolVersion.UNSPECIFIED;
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new CategoryTopPool().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new CategoryTopPool().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new CategoryTopPool().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(CategoryTopPool, a, b);
+    }
+}
+CategoryTopPool.runtime = proto3;
+CategoryTopPool.typeName = "data.v2.CategoryTopPool";
+CategoryTopPool.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "chain_id", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "pool_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "token0_symbol", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "token0_logo_url", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 5, name: "token1_symbol", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 6, name: "token1_logo_url", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 7, name: "protocol_version", kind: "enum", T: proto3.getEnumType(ProtocolVersion) },
+    { no: 8, name: "fee_tier", kind: "scalar", T: 13 /* ScalarType.UINT32 */, opt: true },
+]);
 /**
  * Chain-scoped, multichain-deduped aggregates over the category's members.
  *
@@ -156,6 +250,66 @@ CategoryAggregateStats.fields = proto3.util.newFieldList(() => [
     { no: 8, name: "fdv", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
     { no: 9, name: "market_cap", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
 ]);
+/**
+ * Chain-scoped aggregates over a pool category's members. USD values.
+ *
+ * @generated from message data.v2.CategoryPoolAggregateStats
+ */
+export class CategoryPoolAggregateStats extends Message {
+    constructor(data) {
+        super();
+        /**
+         * @generated from field: uint32 pool_count = 1;
+         */
+        this.poolCount = 0;
+        /**
+         * @generated from field: double tvl = 2;
+         */
+        this.tvl = 0;
+        /**
+         * @generated from field: double volume_1d = 3;
+         */
+        this.volume1d = 0;
+        /**
+         * @generated from field: double volume_1w = 4;
+         */
+        this.volume1w = 0;
+        /**
+         * @generated from field: double volume_1m = 5;
+         */
+        this.volume1m = 0;
+        /**
+         * @generated from field: double fees_1d = 6;
+         */
+        this.fees1d = 0;
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new CategoryPoolAggregateStats().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new CategoryPoolAggregateStats().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new CategoryPoolAggregateStats().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(CategoryPoolAggregateStats, a, b);
+    }
+}
+CategoryPoolAggregateStats.runtime = proto3;
+CategoryPoolAggregateStats.typeName = "data.v2.CategoryPoolAggregateStats";
+CategoryPoolAggregateStats.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "pool_count", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "tvl", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 3, name: "volume_1d", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 4, name: "volume_1w", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 5, name: "volume_1m", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 6, name: "fees_1d", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 7, name: "tvl_change_24h_pct", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+    { no: 8, name: "volume_change_24h_pct", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+    { no: 9, name: "avg_apr", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+]);
 /**
  * Category identity: stable, request-independent metadata.
  *
@@ -199,6 +353,12 @@ export class Category extends Message {
          * @generated from field: map<string, string> description_translations = 8;
          */
         this.descriptionTranslations = {};
+        /**
+         * UNSPECIFIED reads as TOKEN.
+         *
+         * @generated from field: data.v2.CategoryKind kind = 10;
+         */
+        this.kind = CategoryKind.UNSPECIFIED;
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -225,6 +385,7 @@ Category.fields = proto3.util.newFieldList(() => [
     { no: 7, name: "name_translations", kind: "map", K: 9 /* ScalarType.STRING */, V: { kind: "scalar", T: 9 /* ScalarType.STRING */ } },
     { no: 8, name: "description_translations", kind: "map", K: 9 /* ScalarType.STRING */, V: { kind: "scalar", T: 9 /* ScalarType.STRING */ } },
     { no: 9, name: "default_sort", kind: "message", T: TokensSort },
+    { no: 10, name: "kind", kind: "enum", T: proto3.getEnumType(CategoryKind) },
 ]);
 /**
  * A category plus its chain-scoped market view (mirrors RankedPool /
@@ -269,6 +430,44 @@ RankedCategory.fields = proto3.util.newFieldList(() => [
     { no: 3, name: "top_tokens", kind: "message", T: CategoryTopToken, repeated: true },
     { no: 4, name: "top_groups", kind: "message", T: TokenGroup, repeated: true },
 ]);
+/**
+ * A pool category plus its chain-scoped market view: the pool twin of
+ * RankedCategory. Served by ListCategories(kind: POOL) and by GetCategory for
+ * a pool category id.
+ *
+ * @generated from message data.v2.RankedPoolCategory
+ */
+export class RankedPoolCategory extends Message {
+    constructor(data) {
+        super();
+        /**
+         * The members a logo pile renders, highest TVL first.
+         *
+         * @generated from field: repeated data.v2.CategoryTopPool top_pools = 3;
+         */
+        this.topPools = [];
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new RankedPoolCategory().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new RankedPoolCategory().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new RankedPoolCategory().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(RankedPoolCategory, a, b);
+    }
+}
+RankedPoolCategory.runtime = proto3;
+RankedPoolCategory.typeName = "data.v2.RankedPoolCategory";
+RankedPoolCategory.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "category", kind: "message", T: Category },
+    { no: 2, name: "stats", kind: "message", T: CategoryPoolAggregateStats },
+    { no: 3, name: "top_pools", kind: "message", T: CategoryTopPool, repeated: true },
+]);
 /**
  * @generated from message data.v2.TimeSeriesPoint
  */

package/dist/data/v2/search_pb.d.ts

@@ -33,7 +33,14 @@ export declare enum SearchType {
      *
      * @generated from enum value: SEARCH_TYPE_TOKEN_GROUP = 5;
      */
-    TOKEN_GROUP = 5
+    TOKEN_GROUP = 5,
+    /**
+     * Pool categories whose name has a word that starts with the query.
+     * CATEGORY stays token-only.
+     *
+     * @generated from enum value: SEARCH_TYPE_POOL_CATEGORY = 6;
+     */
+    POOL_CATEGORY = 6
 }
 /**
  * Where an auction is in its life, decided server-side from the chain head against start_block/end_block and, once ended, from the raise outcome.
@@ -156,6 +163,13 @@ export declare class SearchResponse extends Message<SearchResponse> {
      * @generated from field: repeated data.v2.RankedTokenGroup token_groups = 6;
      */
     tokenGroups: RankedTokenGroup[];
+    /**
+     * Matching pool-category ids; hydrate display data from
+     * ListCategories(kind: POOL). Only with SEARCH_TYPE_POOL_CATEGORY.
+     *
+     * @generated from field: repeated string pool_category_ids = 7;
+     */
+    poolCategoryIds: string[];
     constructor(data?: PartialMessage<SearchResponse>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.SearchResponse";

package/dist/data/v2/search_pb.js

@@ -38,6 +38,13 @@ export var SearchType;
      * @generated from enum value: SEARCH_TYPE_TOKEN_GROUP = 5;
      */
     SearchType[SearchType["TOKEN_GROUP"] = 5] = "TOKEN_GROUP";
+    /**
+     * Pool categories whose name has a word that starts with the query.
+     * CATEGORY stays token-only.
+     *
+     * @generated from enum value: SEARCH_TYPE_POOL_CATEGORY = 6;
+     */
+    SearchType[SearchType["POOL_CATEGORY"] = 6] = "POOL_CATEGORY";
 })(SearchType || (SearchType = {}));
 // Retrieve enum metadata with: proto3.getEnumType(SearchType)
 proto3.util.setEnumType(SearchType, "data.v2.SearchType", [
@@ -47,6 +54,7 @@ proto3.util.setEnumType(SearchType, "data.v2.SearchType", [
     { no: 3, name: "SEARCH_TYPE_AUCTION" },
     { no: 4, name: "SEARCH_TYPE_CATEGORY" },
     { no: 5, name: "SEARCH_TYPE_TOKEN_GROUP" },
+    { no: 6, name: "SEARCH_TYPE_POOL_CATEGORY" },
 ]);
 /**
  * Where an auction is in its life, decided server-side from the chain head against start_block/end_block and, once ended, from the raise outcome.
@@ -190,6 +198,13 @@ export class SearchResponse extends Message {
          * @generated from field: repeated data.v2.RankedTokenGroup token_groups = 6;
          */
         this.tokenGroups = [];
+        /**
+         * Matching pool-category ids; hydrate display data from
+         * ListCategories(kind: POOL). Only with SEARCH_TYPE_POOL_CATEGORY.
+         *
+         * @generated from field: repeated string pool_category_ids = 7;
+         */
+        this.poolCategoryIds = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -214,6 +229,7 @@ SearchResponse.fields = proto3.util.newFieldList(() => [
     { no: 4, name: "auctions", kind: "message", T: SearchAuction, repeated: true },
     { no: 5, name: "category_ids", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
     { no: 6, name: "token_groups", kind: "message", T: RankedTokenGroup, repeated: true },
+    { no: 7, name: "pool_category_ids", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
 ]);
 /**
  * @generated from message data.v2.SearchAuction

package/dist/data/v2/types_pb.d.ts

@@ -785,6 +785,14 @@ export declare class TokenMarketStats extends Message<TokenMarketStats> {
      * @generated from field: data.v2.HistoryDuration volume_duration = 7;
      */
     volumeDuration: HistoryDuration;
+    /**
+     * USD value of the token's explore-eligible pools, both sides; unset when it
+     * has none. Summed like total_value_locked_usd, so a pool holding two summed
+     * deployments (e.g. ETH/WETH) counts twice.
+     *
+     * @generated from field: optional double pools_total_value_locked_usd = 8;
+     */
+    poolsTotalValueLockedUsd?: number;
     constructor(data?: PartialMessage<TokenMarketStats>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.TokenMarketStats";
@@ -1417,6 +1425,13 @@ export declare class Pool extends Message<Pool> {
      * @generated from field: optional uint32 current_lp_fee = 15;
      */
     currentLpFee?: number;
+    /**
+     * Pool-category ids this pool belongs to, ordered by display precedence:
+     * the first id is the preferred tag. Mirrors Token.category_ids.
+     *
+     * @generated from field: repeated string category_ids = 16;
+     */
+    categoryIds: string[];
     constructor(data?: PartialMessage<Pool>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.Pool";
@@ -1591,6 +1606,14 @@ export declare class PoolListFilter extends Message<PoolListFilter> {
      * @generated from field: optional string search_query = 10;
      */
     searchQuery?: string;
+    /**
+     * Serve only members of these pool categories: OR within this list, AND
+     * with the other filter fields. An unknown id, a token-category id
+     * included, is rejected.
+     *
+     * @generated from field: repeated string category_ids = 12;
+     */
+    categoryIds: string[];
     constructor(data?: PartialMessage<PoolListFilter>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.PoolListFilter";

package/dist/data/v2/types_pb.js

@@ -870,6 +870,7 @@ TokenMarketStats.fields = proto3.util.newFieldList(() => [
     { no: 5, name: "price_low_52w_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
     { no: 6, name: "volume_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
     { no: 7, name: "volume_duration", kind: "enum", T: proto3.getEnumType(HistoryDuration) },
+    { no: 8, name: "pools_total_value_locked_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
 ]);
 /**
  * Single-chain market view of one token.
@@ -1492,6 +1493,13 @@ export class Pool extends Message {
          * @generated from field: bool is_dynamic_fee = 8;
          */
         this.isDynamicFee = false;
+        /**
+         * Pool-category ids this pool belongs to, ordered by display precedence:
+         * the first id is the preferred tag. Mirrors Token.category_ids.
+         *
+         * @generated from field: repeated string category_ids = 16;
+         */
+        this.categoryIds = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -1525,6 +1533,7 @@ Pool.fields = proto3.util.newFieldList(() => [
     { no: 13, name: "protocol_fee", kind: "scalar", T: 13 /* ScalarType.UINT32 */, opt: true },
     { no: 14, name: "effective_fee", kind: "scalar", T: 13 /* ScalarType.UINT32 */, opt: true },
     { no: 15, name: "current_lp_fee", kind: "scalar", T: 13 /* ScalarType.UINT32 */, opt: true },
+    { no: 16, name: "category_ids", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
 ]);
 /**
  * @generated from message data.v2.PoolTokenFilter
@@ -1639,6 +1648,14 @@ export class PoolListFilter extends Message {
          * @generated from field: repeated uint32 fee_tiers = 5;
          */
         this.feeTiers = [];
+        /**
+         * Serve only members of these pool categories: OR within this list, AND
+         * with the other filter fields. An unknown id, a token-category id
+         * included, is rejected.
+         *
+         * @generated from field: repeated string category_ids = 12;
+         */
+        this.categoryIds = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -1667,6 +1684,7 @@ PoolListFilter.fields = proto3.util.newFieldList(() => [
     { no: 8, name: "apply_top_level_filters", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
     { no: 9, name: "rewards_only", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
     { no: 10, name: "search_query", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 12, name: "category_ids", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
 ]);
 /**
  * Returned by ListPools — wraps a Pool with its ranking stats.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uniswap/client-data-api",
-    "version": "0.0.278",
+    "version": "0.0.280",
     "publishConfig": {
       "access": "public"
     },