@spectratools/defillama-cli 0.2.0 → 0.4.0

package/dist/index.js

@@ -4,9 +4,9 @@
 import { readFileSync, realpathSync } from "fs";
 import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
-import { Cli as Cli2 } from "incur";
+import { Cli as Cli5 } from "incur";
 
-// src/commands/tvl.ts
+// src/commands/fees.ts
 import { Cli, z as z2 } from "incur";
 
 // src/api.ts
@@ -129,48 +129,399 @@ var protocolDetailSchema = z.object({
 var volumeEntrySchema = z.object({
   name: z.string(),
   displayName: z.string().optional(),
+  slug: z.string().optional(),
+  category: z.string().nullable().optional(),
+  chains: z.array(z.string()).optional(),
   total24h: z.number().nullable().optional(),
   total7d: z.number().nullable().optional(),
   total30d: z.number().nullable().optional(),
+  totalAllTime: z.number().nullable().optional(),
   change_1d: z.number().nullable().optional(),
   change_7d: z.number().nullable().optional(),
   change_1m: z.number().nullable().optional()
 });
+var volumeOverviewResponseSchema = z.object({
+  protocols: z.array(volumeEntrySchema),
+  allChains: z.array(z.string()).optional(),
+  chain: z.string().nullable().optional(),
+  total24h: z.number().nullable().optional(),
+  total7d: z.number().nullable().optional(),
+  total30d: z.number().nullable().optional(),
+  change_1d: z.number().nullable().optional()
+});
 var feeEntrySchema = z.object({
   name: z.string(),
   displayName: z.string().optional(),
+  slug: z.string().optional(),
+  category: z.string().nullable().optional(),
+  chains: z.array(z.string()).optional(),
   total24h: z.number().nullable().optional(),
   total7d: z.number().nullable().optional(),
   total30d: z.number().nullable().optional(),
   totalAllTime: z.number().nullable().optional(),
+  change_1d: z.number().nullable().optional(),
+  change_7d: z.number().nullable().optional(),
+  change_1m: z.number().nullable().optional()
+});
+var feeOverviewResponseSchema = z.object({
+  protocols: z.array(feeEntrySchema),
+  allChains: z.array(z.string()).optional(),
+  chain: z.string().nullable().optional(),
+  total24h: z.number().nullable().optional(),
+  total7d: z.number().nullable().optional(),
+  total30d: z.number().nullable().optional(),
   change_1d: z.number().nullable().optional()
 });
+var summaryDetailSchema = z.object({
+  name: z.string(),
+  displayName: z.string().optional(),
+  slug: z.string().optional(),
+  category: z.string().nullable().optional(),
+  chains: z.array(z.string()).optional(),
+  total24h: z.number().nullable().optional(),
+  total48hto24h: z.number().nullable().optional(),
+  total7d: z.number().nullable().optional(),
+  total30d: z.number().nullable().optional(),
+  totalAllTime: z.number().nullable().optional(),
+  change_1d: z.number().nullable().optional(),
+  change_7d: z.number().nullable().optional(),
+  change_1m: z.number().nullable().optional()
+});
+var coinPriceSchema = z.object({
+  price: z.number(),
+  decimals: z.number().optional(),
+  symbol: z.string(),
+  timestamp: z.number(),
+  confidence: z.number().optional()
+});
+var pricesResponseSchema = z.object({
+  coins: z.record(z.string(), coinPriceSchema)
+});
+var coinChartSchema = z.object({
+  decimals: z.number().optional(),
+  symbol: z.string(),
+  prices: z.array(z.object({ timestamp: z.number(), price: z.number() })),
+  confidence: z.number().optional()
+});
+var chartResponseSchema = z.object({
+  coins: z.record(z.string(), coinChartSchema)
+});
 
-// src/commands/tvl.ts
-var tvlCli = Cli.create("tvl", {
-  description: "Total value locked queries."
+// src/commands/fees.ts
+var feesCli = Cli.create("fees", {
+  description: "Protocol fees and revenue queries."
 });
-var protocolSortFields = ["tvl", "change_1d", "change_7d"];
-tvlCli.command("protocols", {
-  description: "List protocols ranked by TVL.",
+var feesSortFields = ["total24h", "total7d", "change_1d"];
+feesCli.command("overview", {
+  description: "List protocols ranked by fees and revenue.",
   options: z2.object({
-    chain: z2.string().optional().describe("Filter protocols by chain name"),
+    chain: z2.string().optional().describe("Filter by chain name"),
     limit: z2.coerce.number().default(20).describe("Max protocols to display"),
-    sort: z2.enum(protocolSortFields).default("tvl").describe("Sort field: tvl, change_1d, or change_7d")
+    sort: z2.enum(feesSortFields).default("total24h").describe("Sort field: total24h, total7d, or change_1d"),
+    category: z2.string().optional().describe("Filter by category (e.g. Dexs, Lending, Bridge)")
   }),
   output: z2.object({
     protocols: z2.array(
       z2.object({
         name: z2.string(),
-        tvl: z2.string(),
-        change_1d: z2.string(),
-        change_7d: z2.string(),
-        category: z2.string()
+        fees_24h: z2.string(),
+        fees_7d: z2.string(),
+        change_1d: z2.string()
       })
     ),
     chain: z2.string().optional(),
+    category: z2.string().optional(),
     total: z2.number()
   }),
+  examples: [
+    { options: { limit: 10 }, description: "Top 10 protocols by 24h fees" },
+    { options: { chain: "abstract", limit: 10 }, description: "Top protocols on Abstract by fees" },
+    { options: { sort: "change_1d", limit: 5 }, description: "Top 5 by 1-day fee change" },
+    {
+      options: { category: "Dexs", limit: 10 },
+      description: "Top 10 DEXes by fees"
+    }
+  ],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const path = c.options.chain ? `/overview/fees/${c.options.chain}?excludeTotalDataChart=true&excludeTotalDataChartBreakdown=true` : "/overview/fees?excludeTotalDataChart=true&excludeTotalDataChartBreakdown=true";
+    const raw = await client.get("api", path);
+    const data = feeOverviewResponseSchema.parse(raw);
+    let protocols = data.protocols;
+    if (c.options.category) {
+      const catLower = c.options.category.toLowerCase();
+      protocols = protocols.filter(
+        (p) => p.category != null && p.category.toLowerCase() === catLower
+      );
+    }
+    protocols = protocols.filter((p) => p.total24h != null && p.total24h > 0);
+    const sortKey = c.options.sort;
+    protocols.sort((a, b) => {
+      const aVal = a[sortKey] ?? 0;
+      const bVal = b[sortKey] ?? 0;
+      return bVal - aVal;
+    });
+    const limited = protocols.slice(0, c.options.limit);
+    const rows = limited.map((p) => ({
+      name: p.displayName ?? p.name,
+      fees_24h: formatUsd(p.total24h ?? 0),
+      fees_7d: formatUsd(p.total7d ?? 0),
+      change_1d: formatPct(p.change_1d)
+    }));
+    return c.ok({
+      protocols: rows,
+      chain: c.options.chain,
+      category: c.options.category,
+      total: protocols.length
+    });
+  }
+});
+feesCli.command("protocol", {
+  description: "Get detailed fee and revenue data for a specific protocol.",
+  args: z2.object({
+    slug: z2.string().describe("Protocol slug (e.g. aave, lido)")
+  }),
+  output: z2.object({
+    name: z2.string(),
+    fees_24h: z2.string(),
+    fees_7d: z2.string(),
+    fees_30d: z2.string(),
+    fees_all_time: z2.string(),
+    change_1d: z2.string(),
+    change_7d: z2.string(),
+    change_1m: z2.string(),
+    chains: z2.array(z2.string())
+  }),
+  examples: [{ args: { slug: "aave" }, description: "Aave fee details" }],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", `/summary/fees/${c.args.slug}`);
+    const detail = summaryDetailSchema.parse(raw);
+    return c.ok({
+      name: detail.displayName ?? detail.name,
+      fees_24h: formatUsd(detail.total24h ?? 0),
+      fees_7d: formatUsd(detail.total7d ?? 0),
+      fees_30d: formatUsd(detail.total30d ?? 0),
+      fees_all_time: formatUsd(detail.totalAllTime ?? 0),
+      change_1d: formatPct(detail.change_1d),
+      change_7d: formatPct(detail.change_7d),
+      change_1m: formatPct(detail.change_1m),
+      chains: detail.chains ?? []
+    });
+  }
+});
+
+// src/commands/prices.ts
+import { Cli as Cli2, z as z3 } from "incur";
+var pricesCli = Cli2.create("prices", {
+  description: "Token price queries via coins.llama.fi."
+});
+var COIN_ID_RE = /^[a-zA-Z0-9_-]+:0x[a-fA-F0-9]{1,}$/;
+function parseCoins(raw) {
+  const coins = [];
+  for (const arg of raw) {
+    for (const part of arg.split(",")) {
+      const trimmed = part.trim();
+      if (trimmed.length === 0) continue;
+      if (!COIN_ID_RE.test(trimmed)) {
+        throw new Error(
+          `Invalid coin identifier "${trimmed}". Expected format: chainName:0xAddress (e.g. ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7)`
+        );
+      }
+      coins.push(trimmed);
+    }
+  }
+  if (coins.length === 0) {
+    throw new Error("At least one coin identifier is required.");
+  }
+  return [...new Set(coins)].join(",");
+}
+function parseTimestamp(value) {
+  if (/^\d+$/.test(value)) {
+    return Number(value);
+  }
+  const ms = Date.parse(value);
+  if (Number.isNaN(ms)) {
+    throw new Error(
+      `Invalid timestamp "${value}". Provide a Unix timestamp in seconds or an ISO date string (e.g. 2025-01-01 or 2025-01-01T00:00:00Z).`
+    );
+  }
+  return Math.floor(ms / 1e3);
+}
+pricesCli.command("current", {
+  description: "Get current prices for one or more tokens.",
+  args: z3.object({
+    coins: z3.array(z3.string()).describe("Coin identifiers (chainName:0xAddress)")
+  }),
+  options: z3.object({
+    "search-width": z3.string().default("4h").describe("Timestamp search width (e.g. 4h, 6h)")
+  }),
+  output: z3.object({
+    prices: z3.array(
+      z3.object({
+        coin: z3.string(),
+        symbol: z3.string(),
+        price: z3.string(),
+        confidence: z3.number().optional(),
+        timestamp: z3.string()
+      })
+    )
+  }),
+  examples: [
+    {
+      args: { coins: ["ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7"] },
+      description: "Current price of USDT on Ethereum"
+    }
+  ],
+  async run(c) {
+    const coinsPath = parseCoins(c.args.coins);
+    const client = createDefiLlamaClient();
+    const searchWidth = c.options["search-width"];
+    const path = `/prices/current/${coinsPath}?searchWidth=${searchWidth}`;
+    const raw = await client.get("coins", path);
+    const data = pricesResponseSchema.parse(raw);
+    const prices = Object.entries(data.coins).map(([coin, info]) => ({
+      coin,
+      symbol: info.symbol,
+      price: formatUsd(info.price),
+      confidence: info.confidence,
+      timestamp: new Date(info.timestamp * 1e3).toISOString()
+    }));
+    return c.ok({ prices });
+  }
+});
+pricesCli.command("historical", {
+  description: "Get token prices at a specific point in time.",
+  args: z3.object({
+    coins: z3.array(z3.string()).describe("Coin identifiers (chainName:0xAddress)")
+  }),
+  options: z3.object({
+    timestamp: z3.string().optional().describe("Unix timestamp in seconds"),
+    date: z3.string().optional().describe("ISO date string (e.g. 2025-01-01)"),
+    "search-width": z3.string().default("4h").describe("Timestamp search width (e.g. 4h, 6h)")
+  }),
+  output: z3.object({
+    prices: z3.array(
+      z3.object({
+        coin: z3.string(),
+        symbol: z3.string(),
+        price: z3.string(),
+        timestamp: z3.string()
+      })
+    )
+  }),
+  examples: [
+    {
+      args: { coins: ["ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7"] },
+      options: { date: "2025-01-01" },
+      description: "USDT price on 2025-01-01"
+    }
+  ],
+  async run(c) {
+    const tsRaw = c.options.timestamp ?? c.options.date;
+    if (!tsRaw) {
+      throw new Error("Either --timestamp or --date is required for historical prices.");
+    }
+    const ts = parseTimestamp(tsRaw);
+    const coinsPath = parseCoins(c.args.coins);
+    const client = createDefiLlamaClient();
+    const searchWidth = c.options["search-width"];
+    const path = `/prices/historical/${ts}/${coinsPath}?searchWidth=${searchWidth}`;
+    const raw = await client.get("coins", path);
+    const data = pricesResponseSchema.parse(raw);
+    const prices = Object.entries(data.coins).map(([coin, info]) => ({
+      coin,
+      symbol: info.symbol,
+      price: formatUsd(info.price),
+      timestamp: new Date(info.timestamp * 1e3).toISOString()
+    }));
+    return c.ok({ prices });
+  }
+});
+pricesCli.command("chart", {
+  description: "Get a price chart over a time range.",
+  args: z3.object({
+    coins: z3.array(z3.string()).describe("Coin identifiers (chainName:0xAddress)")
+  }),
+  options: z3.object({
+    start: z3.string().optional().describe("Start timestamp or ISO date"),
+    end: z3.string().optional().describe("End timestamp or ISO date (default: now)"),
+    span: z3.coerce.number().optional().describe("Number of data points"),
+    period: z3.string().optional().describe("Data point period (e.g. 1d, 1h, 4h)"),
+    "search-width": z3.string().default("4h").describe("Timestamp search width (e.g. 4h, 600)")
+  }),
+  output: z3.object({
+    charts: z3.array(
+      z3.object({
+        coin: z3.string(),
+        symbol: z3.string(),
+        prices: z3.array(
+          z3.object({
+            date: z3.string(),
+            price: z3.string()
+          })
+        )
+      })
+    )
+  }),
+  examples: [
+    {
+      args: { coins: ["ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7"] },
+      options: { start: "2025-01-01", period: "1d" },
+      description: "USDT daily price chart since 2025-01-01"
+    }
+  ],
+  async run(c) {
+    const coinsPath = parseCoins(c.args.coins);
+    const client = createDefiLlamaClient();
+    const params = new URLSearchParams();
+    if (c.options.start) params.set("start", String(parseTimestamp(c.options.start)));
+    if (c.options.end) params.set("end", String(parseTimestamp(c.options.end)));
+    if (c.options.span) params.set("span", String(c.options.span));
+    if (c.options.period) params.set("period", c.options.period);
+    params.set("searchWidth", c.options["search-width"]);
+    const qs = params.toString();
+    const path = `/chart/${coinsPath}${qs ? `?${qs}` : ""}`;
+    const raw = await client.get("coins", path);
+    const data = chartResponseSchema.parse(raw);
+    const charts = Object.entries(data.coins).map(([coin, info]) => ({
+      coin,
+      symbol: info.symbol,
+      prices: info.prices.map((p) => ({
+        date: new Date(p.timestamp * 1e3).toISOString(),
+        price: formatUsd(p.price)
+      }))
+    }));
+    return c.ok({ charts });
+  }
+});
+
+// src/commands/tvl.ts
+import { Cli as Cli3, z as z4 } from "incur";
+var tvlCli = Cli3.create("tvl", {
+  description: "Total value locked queries."
+});
+var protocolSortFields = ["tvl", "change_1d", "change_7d"];
+tvlCli.command("protocols", {
+  description: "List protocols ranked by TVL.",
+  options: z4.object({
+    chain: z4.string().optional().describe("Filter protocols by chain name"),
+    limit: z4.coerce.number().default(20).describe("Max protocols to display"),
+    sort: z4.enum(protocolSortFields).default("tvl").describe("Sort field: tvl, change_1d, or change_7d")
+  }),
+  output: z4.object({
+    protocols: z4.array(
+      z4.object({
+        name: z4.string(),
+        tvl: z4.string(),
+        change_1d: z4.string(),
+        change_7d: z4.string(),
+        category: z4.string()
+      })
+    ),
+    chain: z4.string().optional(),
+    total: z4.number()
+  }),
   examples: [
     { options: { limit: 10 }, description: "Top 10 protocols by TVL" },
     { options: { chain: "abstract", limit: 10 }, description: "Top protocols on Abstract" },
@@ -211,17 +562,17 @@ tvlCli.command("protocols", {
 });
 tvlCli.command("chains", {
   description: "List chains ranked by TVL.",
-  options: z2.object({
-    limit: z2.coerce.number().default(20).describe("Max chains to display")
+  options: z4.object({
+    limit: z4.coerce.number().default(20).describe("Max chains to display")
   }),
-  output: z2.object({
-    chains: z2.array(
-      z2.object({
-        name: z2.string(),
-        tvl: z2.string()
+  output: z4.object({
+    chains: z4.array(
+      z4.object({
+        name: z4.string(),
+        tvl: z4.string()
       })
     ),
-    total: z2.number()
+    total: z4.number()
   }),
   examples: [{ options: { limit: 10 }, description: "Top 10 chains by TVL" }],
   async run(c) {
@@ -242,20 +593,20 @@ tvlCli.command("chains", {
 });
 tvlCli.command("protocol", {
   description: "Get detailed protocol info with TVL breakdown by chain.",
-  args: z2.object({
-    slug: z2.string().describe("Protocol slug (e.g. aave, uniswap)")
+  args: z4.object({
+    slug: z4.string().describe("Protocol slug (e.g. aave, uniswap)")
   }),
-  output: z2.object({
-    name: z2.string(),
-    description: z2.string(),
-    category: z2.string(),
-    url: z2.string(),
-    symbol: z2.string(),
-    tvl: z2.string(),
-    chains: z2.array(
-      z2.object({
-        chain: z2.string(),
-        tvl: z2.string()
+  output: z4.object({
+    name: z4.string(),
+    description: z4.string(),
+    category: z4.string(),
+    url: z4.string(),
+    symbol: z4.string(),
+    tvl: z4.string(),
+    chains: z4.array(
+      z4.object({
+        chain: z4.string(),
+        tvl: z4.string()
       })
     )
   }),
@@ -298,21 +649,21 @@ tvlCli.command("protocol", {
 });
 tvlCli.command("history", {
   description: "Show historical TVL for a protocol.",
-  args: z2.object({
-    slug: z2.string().describe("Protocol slug (e.g. aave, uniswap)")
+  args: z4.object({
+    slug: z4.string().describe("Protocol slug (e.g. aave, uniswap)")
   }),
-  options: z2.object({
-    days: z2.coerce.number().default(30).describe("Number of days of history to display"),
-    chain: z2.string().optional().describe("Filter to a specific chain")
+  options: z4.object({
+    days: z4.coerce.number().default(30).describe("Number of days of history to display"),
+    chain: z4.string().optional().describe("Filter to a specific chain")
   }),
-  output: z2.object({
-    protocol: z2.string(),
-    chain: z2.string().optional(),
-    days: z2.number(),
-    history: z2.array(
-      z2.object({
-        date: z2.string(),
-        tvl: z2.string()
+  output: z4.object({
+    protocol: z4.string(),
+    chain: z4.string().optional(),
+    days: z4.number(),
+    history: z4.array(
+      z4.object({
+        date: z4.string(),
+        tvl: z4.string()
       })
     )
   }),
@@ -358,25 +709,168 @@ tvlCli.command("history", {
   }
 });
 
+// src/commands/volume.ts
+import { Cli as Cli4, z as z5 } from "incur";
+var volumeCli = Cli4.create("volume", {
+  description: "DEX volume queries."
+});
+var dexsSortFields = ["total24h", "total7d", "change_1d"];
+volumeCli.command("dexs", {
+  description: "List DEXes ranked by trading volume.",
+  options: z5.object({
+    chain: z5.string().optional().describe("Filter by chain name"),
+    limit: z5.coerce.number().default(20).describe("Max protocols to display"),
+    sort: z5.enum(dexsSortFields).default("total24h").describe("Sort field: total24h, total7d, or change_1d"),
+    category: z5.string().optional().describe("Filter by category (e.g. Dexs, Prediction)")
+  }),
+  output: z5.object({
+    protocols: z5.array(
+      z5.object({
+        name: z5.string(),
+        volume_24h: z5.string(),
+        volume_7d: z5.string(),
+        change_1d: z5.string()
+      })
+    ),
+    chain: z5.string().optional(),
+    category: z5.string().optional(),
+    total: z5.number()
+  }),
+  examples: [
+    { options: { limit: 10 }, description: "Top 10 DEXes by 24h volume" },
+    { options: { chain: "abstract", limit: 10 }, description: "Top DEXes on Abstract" },
+    { options: { sort: "change_1d", limit: 5 }, description: "Top 5 by 1-day volume change" },
+    {
+      options: { category: "Dexs", limit: 10 },
+      description: "Top 10 DEXes excluding prediction markets"
+    }
+  ],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const path = c.options.chain ? `/overview/dexs/${c.options.chain}?excludeTotalDataChart=true&excludeTotalDataChartBreakdown=true` : "/overview/dexs?excludeTotalDataChart=true&excludeTotalDataChartBreakdown=true";
+    const raw = await client.get("api", path);
+    const data = volumeOverviewResponseSchema.parse(raw);
+    let protocols = data.protocols;
+    if (c.options.category) {
+      const catLower = c.options.category.toLowerCase();
+      protocols = protocols.filter(
+        (p) => p.category != null && p.category.toLowerCase() === catLower
+      );
+    }
+    protocols = protocols.filter((p) => p.total24h != null && p.total24h > 0);
+    const sortKey = c.options.sort;
+    protocols.sort((a, b) => {
+      const aVal = a[sortKey] ?? 0;
+      const bVal = b[sortKey] ?? 0;
+      return bVal - aVal;
+    });
+    const limited = protocols.slice(0, c.options.limit);
+    const rows = limited.map((p) => ({
+      name: p.displayName ?? p.name,
+      volume_24h: formatUsd(p.total24h ?? 0),
+      volume_7d: formatUsd(p.total7d ?? 0),
+      change_1d: formatPct(p.change_1d)
+    }));
+    return c.ok({
+      protocols: rows,
+      chain: c.options.chain,
+      category: c.options.category,
+      total: protocols.length
+    });
+  }
+});
+volumeCli.command("protocol", {
+  description: "Get detailed volume data for a specific protocol.",
+  args: z5.object({
+    slug: z5.string().describe("Protocol slug (e.g. uniswap, curve-dex)")
+  }),
+  output: z5.object({
+    name: z5.string(),
+    volume_24h: z5.string(),
+    volume_7d: z5.string(),
+    volume_30d: z5.string(),
+    volume_all_time: z5.string(),
+    change_1d: z5.string(),
+    change_7d: z5.string(),
+    change_1m: z5.string(),
+    chains: z5.array(z5.string())
+  }),
+  examples: [{ args: { slug: "uniswap" }, description: "Uniswap volume details" }],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", `/summary/dexs/${c.args.slug}`);
+    const detail = summaryDetailSchema.parse(raw);
+    return c.ok({
+      name: detail.displayName ?? detail.name,
+      volume_24h: formatUsd(detail.total24h ?? 0),
+      volume_7d: formatUsd(detail.total7d ?? 0),
+      volume_30d: formatUsd(detail.total30d ?? 0),
+      volume_all_time: formatUsd(detail.totalAllTime ?? 0),
+      change_1d: formatPct(detail.change_1d),
+      change_7d: formatPct(detail.change_7d),
+      change_1m: formatPct(detail.change_1m),
+      chains: detail.chains ?? []
+    });
+  }
+});
+volumeCli.command("aggregators", {
+  description: "List DEX aggregators ranked by trading volume.",
+  options: z5.object({
+    chain: z5.string().optional().describe("Filter by chain name"),
+    limit: z5.coerce.number().default(20).describe("Max aggregators to display")
+  }),
+  output: z5.object({
+    protocols: z5.array(
+      z5.object({
+        name: z5.string(),
+        volume_24h: z5.string(),
+        volume_7d: z5.string(),
+        change_1d: z5.string()
+      })
+    ),
+    chain: z5.string().optional(),
+    total: z5.number()
+  }),
+  examples: [
+    { options: { limit: 10 }, description: "Top 10 DEX aggregators by volume" },
+    {
+      options: { chain: "ethereum", limit: 5 },
+      description: "Top 5 aggregators on Ethereum"
+    }
+  ],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const path = c.options.chain ? `/overview/aggregators/${c.options.chain}?excludeTotalDataChart=true&excludeTotalDataChartBreakdown=true` : "/overview/aggregators?excludeTotalDataChart=true&excludeTotalDataChartBreakdown=true";
+    const raw = await client.get("api", path);
+    const data = volumeOverviewResponseSchema.parse(raw);
+    let protocols = data.protocols;
+    protocols = protocols.filter((p) => p.total24h != null && p.total24h > 0);
+    protocols.sort((a, b) => (b.total24h ?? 0) - (a.total24h ?? 0));
+    const limited = protocols.slice(0, c.options.limit);
+    const rows = limited.map((p) => ({
+      name: p.displayName ?? p.name,
+      volume_24h: formatUsd(p.total24h ?? 0),
+      volume_7d: formatUsd(p.total7d ?? 0),
+      change_1d: formatPct(p.change_1d)
+    }));
+    return c.ok({
+      protocols: rows,
+      chain: c.options.chain,
+      total: protocols.length
+    });
+  }
+});
+
 // src/cli.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync(resolve(__dirname, "../package.json"), "utf8"));
-var cli = Cli2.create("defillama", {
+var cli = Cli5.create("defillama", {
   version: pkg.version,
   description: "Query DefiLlama API data from the command line."
 });
 cli.command(tvlCli);
-var volumeCli = Cli2.create("volume", {
-  description: "DEX volume queries."
-});
 cli.command(volumeCli);
-var feesCli = Cli2.create("fees", {
-  description: "Protocol fees and revenue queries."
-});
 cli.command(feesCli);
-var pricesCli = Cli2.create("prices", {
-  description: "Token price queries."
-});
 cli.command(pricesCli);
 var isMain = (() => {
   const entrypoint = process.argv[1];
@@ -395,15 +889,22 @@ if (isMain) {
 export {
   DEFILLAMA_HOSTS,
   chainTvlSchema,
+  chartResponseSchema,
   cli,
+  coinChartSchema,
+  coinPriceSchema,
   createDefiLlamaClient,
   feeEntrySchema,
+  feeOverviewResponseSchema,
   formatDelta,
   formatNumber,
   formatPct,
   formatUsd,
+  pricesResponseSchema,
   protocolDetailSchema,
   protocolSummarySchema,
+  summaryDetailSchema,
   tvlHistoryPointSchema,
-  volumeEntrySchema
+  volumeEntrySchema,
+  volumeOverviewResponseSchema
 };