@spectratools/defillama-cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 spectra-the-bot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.js

@@ -0,0 +1,386 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { readFileSync, realpathSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { Cli as Cli2 } from "incur";
+
+// src/commands/tvl.ts
+import { Cli, z as z2 } from "incur";
+
+// src/api.ts
+import {
+  createHttpClient,
+  createRateLimiter,
+  withRateLimit,
+  withRetry
+} from "@spectratools/cli-shared";
+var DEFILLAMA_HOSTS = {
+  api: "https://api.llama.fi",
+  coins: "https://coins.llama.fi",
+  yields: "https://yields.llama.fi",
+  stablecoins: "https://stablecoins.llama.fi",
+  bridges: "https://bridges.llama.fi"
+};
+var RETRY_OPTIONS = { maxRetries: 3, baseMs: 500, maxMs: 1e4 };
+function createDefiLlamaClient(options = {}) {
+  const { hosts = {}, requestsPerSecond = 5 } = options;
+  const resolvedHosts = {
+    api: hosts.api ?? DEFILLAMA_HOSTS.api,
+    coins: hosts.coins ?? DEFILLAMA_HOSTS.coins,
+    yields: hosts.yields ?? DEFILLAMA_HOSTS.yields,
+    stablecoins: hosts.stablecoins ?? DEFILLAMA_HOSTS.stablecoins,
+    bridges: hosts.bridges ?? DEFILLAMA_HOSTS.bridges
+  };
+  const clients = Object.fromEntries(
+    Object.entries(resolvedHosts).map(([key, baseUrl]) => [key, createHttpClient({ baseUrl })])
+  );
+  const acquire = createRateLimiter({ requestsPerSecond });
+  function get(host, path) {
+    const http = clients[host];
+    return withRetry(() => withRateLimit(() => http.request(path), acquire), RETRY_OPTIONS);
+  }
+  return { get };
+}
+
+// src/format.ts
+function formatUsd(value) {
+  const abs = Math.abs(value);
+  const sign = value < 0 ? "-" : "";
+  if (abs >= 1e12) {
+    return `${sign}$${(abs / 1e12).toFixed(2)}T`;
+  }
+  if (abs >= 1e9) {
+    return `${sign}$${(abs / 1e9).toFixed(2)}B`;
+  }
+  if (abs >= 1e6) {
+    return `${sign}$${(abs / 1e6).toFixed(2)}M`;
+  }
+  if (abs >= 1e3) {
+    return `${sign}$${(abs / 1e3).toFixed(2)}K`;
+  }
+  return `${sign}$${abs.toFixed(2)}`;
+}
+function formatPct(value) {
+  if (value == null) {
+    return "\u2014";
+  }
+  const sign = value >= 0 ? "+" : "";
+  return `${sign}${value.toFixed(2)}%`;
+}
+
+// src/types.ts
+import { z } from "incur";
+var protocolSummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  symbol: z.string().optional(),
+  category: z.string().optional(),
+  chains: z.array(z.string()).optional(),
+  tvl: z.number().nullable().optional(),
+  change_1h: z.number().nullable().optional(),
+  change_1d: z.number().nullable().optional(),
+  change_7d: z.number().nullable().optional(),
+  mcap: z.number().nullable().optional()
+});
+var chainTvlSchema = z.object({
+  gecko_id: z.string().nullable().optional(),
+  tvl: z.number(),
+  tokenSymbol: z.string().optional(),
+  cmcId: z.string().nullable().optional(),
+  name: z.string(),
+  chainId: z.number().nullable().optional()
+});
+var tvlHistoryPointSchema = z.object({
+  date: z.number(),
+  totalLiquidityUSD: z.number()
+});
+var protocolDetailSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  url: z.string().optional(),
+  description: z.string().optional(),
+  symbol: z.string().optional(),
+  category: z.string().nullable().optional(),
+  chains: z.array(z.string()).optional(),
+  tvl: z.array(tvlHistoryPointSchema).optional(),
+  currentChainTvls: z.record(z.string(), z.number()).optional(),
+  chainTvls: z.record(
+    z.string(),
+    z.object({
+      tvl: z.array(tvlHistoryPointSchema).optional()
+    })
+  ).optional(),
+  mcap: z.number().nullable().optional()
+});
+var volumeEntrySchema = z.object({
+  name: z.string(),
+  displayName: z.string().optional(),
+  total24h: z.number().nullable().optional(),
+  total7d: z.number().nullable().optional(),
+  total30d: z.number().nullable().optional(),
+  change_1d: z.number().nullable().optional(),
+  change_7d: z.number().nullable().optional(),
+  change_1m: z.number().nullable().optional()
+});
+var feeEntrySchema = z.object({
+  name: z.string(),
+  displayName: 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()
+});
+
+// src/commands/tvl.ts
+var tvlCli = Cli.create("tvl", {
+  description: "Total value locked queries."
+});
+var protocolSortFields = ["tvl", "change_1d", "change_7d"];
+tvlCli.command("protocols", {
+  description: "List protocols ranked by TVL.",
+  options: z2.object({
+    chain: z2.string().optional().describe("Filter protocols 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")
+  }),
+  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()
+      })
+    ),
+    chain: z2.string().optional(),
+    total: z2.number()
+  }),
+  examples: [
+    { options: { limit: 10 }, description: "Top 10 protocols by TVL" },
+    { options: { chain: "abstract", limit: 10 }, description: "Top protocols on Abstract" },
+    { options: { sort: "change_1d", limit: 5 }, description: "Top 5 by 1-day change" }
+  ],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", "/protocols");
+    const protocols = raw.map((p) => protocolSummarySchema.parse(p));
+    let filtered = protocols;
+    if (c.options.chain) {
+      const chainLower = c.options.chain.toLowerCase();
+      filtered = filtered.filter(
+        (p) => p.chains?.some((ch) => ch.toLowerCase() === chainLower) ?? false
+      );
+    }
+    filtered = filtered.filter((p) => p.tvl != null && p.tvl > 0);
+    const sortKey = c.options.sort;
+    filtered.sort((a, b) => {
+      const aVal = a[sortKey] ?? 0;
+      const bVal = b[sortKey] ?? 0;
+      return bVal - aVal;
+    });
+    const limited = filtered.slice(0, c.options.limit);
+    const rows = limited.map((p) => ({
+      name: p.name,
+      tvl: formatUsd(p.tvl ?? 0),
+      change_1d: formatPct(p.change_1d),
+      change_7d: formatPct(p.change_7d),
+      category: p.category ?? "\u2014"
+    }));
+    return c.ok({
+      protocols: rows,
+      chain: c.options.chain,
+      total: filtered.length
+    });
+  }
+});
+tvlCli.command("chains", {
+  description: "List chains ranked by TVL.",
+  options: z2.object({
+    limit: z2.coerce.number().default(20).describe("Max chains to display")
+  }),
+  output: z2.object({
+    chains: z2.array(
+      z2.object({
+        name: z2.string(),
+        tvl: z2.string()
+      })
+    ),
+    total: z2.number()
+  }),
+  examples: [{ options: { limit: 10 }, description: "Top 10 chains by TVL" }],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", "/v2/chains");
+    const chains = raw.map((ch) => chainTvlSchema.parse(ch));
+    chains.sort((a, b) => b.tvl - a.tvl);
+    const limited = chains.slice(0, c.options.limit);
+    const rows = limited.map((ch) => ({
+      name: ch.name,
+      tvl: formatUsd(ch.tvl)
+    }));
+    return c.ok({
+      chains: rows,
+      total: chains.length
+    });
+  }
+});
+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)")
+  }),
+  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()
+      })
+    )
+  }),
+  examples: [{ args: { slug: "aave" }, description: "Aave protocol details" }],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", `/protocol/${c.args.slug}`);
+    const detail = protocolDetailSchema.parse(raw);
+    const chainBreakdown = [];
+    if (detail.currentChainTvls) {
+      for (const [chain, tvl] of Object.entries(detail.currentChainTvls)) {
+        if (chain.includes("-")) {
+          continue;
+        }
+        if (["borrowed", "staking", "pool2"].includes(chain)) {
+          continue;
+        }
+        chainBreakdown.push({ chain, tvl: formatUsd(tvl) });
+      }
+      chainBreakdown.sort((a, b) => {
+        const aRaw = detail.currentChainTvls?.[a.chain] ?? 0;
+        const bRaw = detail.currentChainTvls?.[b.chain] ?? 0;
+        return bRaw - aRaw;
+      });
+    }
+    let currentTvl = 0;
+    if (detail.tvl && detail.tvl.length > 0) {
+      currentTvl = detail.tvl[detail.tvl.length - 1].totalLiquidityUSD;
+    }
+    return c.ok({
+      name: detail.name,
+      description: detail.description ?? "\u2014",
+      category: detail.category ?? "\u2014",
+      url: detail.url ?? "\u2014",
+      symbol: detail.symbol ?? "\u2014",
+      tvl: formatUsd(currentTvl),
+      chains: chainBreakdown
+    });
+  }
+});
+tvlCli.command("history", {
+  description: "Show historical TVL for a protocol.",
+  args: z2.object({
+    slug: z2.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")
+  }),
+  output: z2.object({
+    protocol: z2.string(),
+    chain: z2.string().optional(),
+    days: z2.number(),
+    history: z2.array(
+      z2.object({
+        date: z2.string(),
+        tvl: z2.string()
+      })
+    )
+  }),
+  examples: [
+    { args: { slug: "aave" }, options: { days: 7 }, description: "Aave 7-day TVL history" },
+    {
+      args: { slug: "uniswap" },
+      options: { days: 14, chain: "Ethereum" },
+      description: "Uniswap Ethereum chain TVL over 14 days"
+    }
+  ],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", `/protocol/${c.args.slug}`);
+    const detail = protocolDetailSchema.parse(raw);
+    let tvlSeries = [];
+    if (c.options.chain) {
+      const chainLower = c.options.chain.toLowerCase();
+      if (detail.chainTvls) {
+        const matchKey = Object.keys(detail.chainTvls).find(
+          (k) => k.toLowerCase() === chainLower && !k.includes("-")
+        );
+        if (matchKey && detail.chainTvls[matchKey]?.tvl) {
+          tvlSeries = detail.chainTvls[matchKey].tvl ?? [];
+        }
+      }
+    } else if (detail.tvl) {
+      tvlSeries = detail.tvl;
+    }
+    const now = Math.floor(Date.now() / 1e3);
+    const cutoff = now - c.options.days * 86400;
+    const filtered = tvlSeries.filter((p) => p.date >= cutoff);
+    const history = filtered.map((p) => ({
+      date: new Date(p.date * 1e3).toISOString().split("T")[0],
+      tvl: formatUsd(p.totalLiquidityUSD)
+    }));
+    return c.ok({
+      protocol: detail.name,
+      chain: c.options.chain,
+      days: c.options.days,
+      history
+    });
+  }
+});
+
+// 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", {
+  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];
+  if (!entrypoint) {
+    return false;
+  }
+  try {
+    return realpathSync(entrypoint) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+})();
+if (isMain) {
+  cli.serve();
+}
+export {
+  cli
+};

package/dist/index.js

@@ -0,0 +1,409 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { readFileSync, realpathSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { Cli as Cli2 } from "incur";
+
+// src/commands/tvl.ts
+import { Cli, z as z2 } from "incur";
+
+// src/api.ts
+import {
+  createHttpClient,
+  createRateLimiter,
+  withRateLimit,
+  withRetry
+} from "@spectratools/cli-shared";
+var DEFILLAMA_HOSTS = {
+  api: "https://api.llama.fi",
+  coins: "https://coins.llama.fi",
+  yields: "https://yields.llama.fi",
+  stablecoins: "https://stablecoins.llama.fi",
+  bridges: "https://bridges.llama.fi"
+};
+var RETRY_OPTIONS = { maxRetries: 3, baseMs: 500, maxMs: 1e4 };
+function createDefiLlamaClient(options = {}) {
+  const { hosts = {}, requestsPerSecond = 5 } = options;
+  const resolvedHosts = {
+    api: hosts.api ?? DEFILLAMA_HOSTS.api,
+    coins: hosts.coins ?? DEFILLAMA_HOSTS.coins,
+    yields: hosts.yields ?? DEFILLAMA_HOSTS.yields,
+    stablecoins: hosts.stablecoins ?? DEFILLAMA_HOSTS.stablecoins,
+    bridges: hosts.bridges ?? DEFILLAMA_HOSTS.bridges
+  };
+  const clients = Object.fromEntries(
+    Object.entries(resolvedHosts).map(([key, baseUrl]) => [key, createHttpClient({ baseUrl })])
+  );
+  const acquire = createRateLimiter({ requestsPerSecond });
+  function get(host, path) {
+    const http = clients[host];
+    return withRetry(() => withRateLimit(() => http.request(path), acquire), RETRY_OPTIONS);
+  }
+  return { get };
+}
+
+// src/format.ts
+function formatDelta(current, previous) {
+  if (previous === 0) {
+    return current === 0 ? "0.0%" : current > 0 ? "+\u221E%" : "-\u221E%";
+  }
+  const pct = (current - previous) / Math.abs(previous) * 100;
+  const sign = pct >= 0 ? "+" : "";
+  return `${sign}${pct.toFixed(1)}%`;
+}
+function formatUsd(value) {
+  const abs = Math.abs(value);
+  const sign = value < 0 ? "-" : "";
+  if (abs >= 1e12) {
+    return `${sign}$${(abs / 1e12).toFixed(2)}T`;
+  }
+  if (abs >= 1e9) {
+    return `${sign}$${(abs / 1e9).toFixed(2)}B`;
+  }
+  if (abs >= 1e6) {
+    return `${sign}$${(abs / 1e6).toFixed(2)}M`;
+  }
+  if (abs >= 1e3) {
+    return `${sign}$${(abs / 1e3).toFixed(2)}K`;
+  }
+  return `${sign}$${abs.toFixed(2)}`;
+}
+function formatPct(value) {
+  if (value == null) {
+    return "\u2014";
+  }
+  const sign = value >= 0 ? "+" : "";
+  return `${sign}${value.toFixed(2)}%`;
+}
+function formatNumber(value) {
+  return value.toLocaleString("en-US");
+}
+
+// src/types.ts
+import { z } from "incur";
+var protocolSummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  slug: z.string(),
+  symbol: z.string().optional(),
+  category: z.string().optional(),
+  chains: z.array(z.string()).optional(),
+  tvl: z.number().nullable().optional(),
+  change_1h: z.number().nullable().optional(),
+  change_1d: z.number().nullable().optional(),
+  change_7d: z.number().nullable().optional(),
+  mcap: z.number().nullable().optional()
+});
+var chainTvlSchema = z.object({
+  gecko_id: z.string().nullable().optional(),
+  tvl: z.number(),
+  tokenSymbol: z.string().optional(),
+  cmcId: z.string().nullable().optional(),
+  name: z.string(),
+  chainId: z.number().nullable().optional()
+});
+var tvlHistoryPointSchema = z.object({
+  date: z.number(),
+  totalLiquidityUSD: z.number()
+});
+var protocolDetailSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  url: z.string().optional(),
+  description: z.string().optional(),
+  symbol: z.string().optional(),
+  category: z.string().nullable().optional(),
+  chains: z.array(z.string()).optional(),
+  tvl: z.array(tvlHistoryPointSchema).optional(),
+  currentChainTvls: z.record(z.string(), z.number()).optional(),
+  chainTvls: z.record(
+    z.string(),
+    z.object({
+      tvl: z.array(tvlHistoryPointSchema).optional()
+    })
+  ).optional(),
+  mcap: z.number().nullable().optional()
+});
+var volumeEntrySchema = z.object({
+  name: z.string(),
+  displayName: z.string().optional(),
+  total24h: z.number().nullable().optional(),
+  total7d: z.number().nullable().optional(),
+  total30d: z.number().nullable().optional(),
+  change_1d: z.number().nullable().optional(),
+  change_7d: z.number().nullable().optional(),
+  change_1m: z.number().nullable().optional()
+});
+var feeEntrySchema = z.object({
+  name: z.string(),
+  displayName: 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()
+});
+
+// src/commands/tvl.ts
+var tvlCli = Cli.create("tvl", {
+  description: "Total value locked queries."
+});
+var protocolSortFields = ["tvl", "change_1d", "change_7d"];
+tvlCli.command("protocols", {
+  description: "List protocols ranked by TVL.",
+  options: z2.object({
+    chain: z2.string().optional().describe("Filter protocols 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")
+  }),
+  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()
+      })
+    ),
+    chain: z2.string().optional(),
+    total: z2.number()
+  }),
+  examples: [
+    { options: { limit: 10 }, description: "Top 10 protocols by TVL" },
+    { options: { chain: "abstract", limit: 10 }, description: "Top protocols on Abstract" },
+    { options: { sort: "change_1d", limit: 5 }, description: "Top 5 by 1-day change" }
+  ],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", "/protocols");
+    const protocols = raw.map((p) => protocolSummarySchema.parse(p));
+    let filtered = protocols;
+    if (c.options.chain) {
+      const chainLower = c.options.chain.toLowerCase();
+      filtered = filtered.filter(
+        (p) => p.chains?.some((ch) => ch.toLowerCase() === chainLower) ?? false
+      );
+    }
+    filtered = filtered.filter((p) => p.tvl != null && p.tvl > 0);
+    const sortKey = c.options.sort;
+    filtered.sort((a, b) => {
+      const aVal = a[sortKey] ?? 0;
+      const bVal = b[sortKey] ?? 0;
+      return bVal - aVal;
+    });
+    const limited = filtered.slice(0, c.options.limit);
+    const rows = limited.map((p) => ({
+      name: p.name,
+      tvl: formatUsd(p.tvl ?? 0),
+      change_1d: formatPct(p.change_1d),
+      change_7d: formatPct(p.change_7d),
+      category: p.category ?? "\u2014"
+    }));
+    return c.ok({
+      protocols: rows,
+      chain: c.options.chain,
+      total: filtered.length
+    });
+  }
+});
+tvlCli.command("chains", {
+  description: "List chains ranked by TVL.",
+  options: z2.object({
+    limit: z2.coerce.number().default(20).describe("Max chains to display")
+  }),
+  output: z2.object({
+    chains: z2.array(
+      z2.object({
+        name: z2.string(),
+        tvl: z2.string()
+      })
+    ),
+    total: z2.number()
+  }),
+  examples: [{ options: { limit: 10 }, description: "Top 10 chains by TVL" }],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", "/v2/chains");
+    const chains = raw.map((ch) => chainTvlSchema.parse(ch));
+    chains.sort((a, b) => b.tvl - a.tvl);
+    const limited = chains.slice(0, c.options.limit);
+    const rows = limited.map((ch) => ({
+      name: ch.name,
+      tvl: formatUsd(ch.tvl)
+    }));
+    return c.ok({
+      chains: rows,
+      total: chains.length
+    });
+  }
+});
+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)")
+  }),
+  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()
+      })
+    )
+  }),
+  examples: [{ args: { slug: "aave" }, description: "Aave protocol details" }],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", `/protocol/${c.args.slug}`);
+    const detail = protocolDetailSchema.parse(raw);
+    const chainBreakdown = [];
+    if (detail.currentChainTvls) {
+      for (const [chain, tvl] of Object.entries(detail.currentChainTvls)) {
+        if (chain.includes("-")) {
+          continue;
+        }
+        if (["borrowed", "staking", "pool2"].includes(chain)) {
+          continue;
+        }
+        chainBreakdown.push({ chain, tvl: formatUsd(tvl) });
+      }
+      chainBreakdown.sort((a, b) => {
+        const aRaw = detail.currentChainTvls?.[a.chain] ?? 0;
+        const bRaw = detail.currentChainTvls?.[b.chain] ?? 0;
+        return bRaw - aRaw;
+      });
+    }
+    let currentTvl = 0;
+    if (detail.tvl && detail.tvl.length > 0) {
+      currentTvl = detail.tvl[detail.tvl.length - 1].totalLiquidityUSD;
+    }
+    return c.ok({
+      name: detail.name,
+      description: detail.description ?? "\u2014",
+      category: detail.category ?? "\u2014",
+      url: detail.url ?? "\u2014",
+      symbol: detail.symbol ?? "\u2014",
+      tvl: formatUsd(currentTvl),
+      chains: chainBreakdown
+    });
+  }
+});
+tvlCli.command("history", {
+  description: "Show historical TVL for a protocol.",
+  args: z2.object({
+    slug: z2.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")
+  }),
+  output: z2.object({
+    protocol: z2.string(),
+    chain: z2.string().optional(),
+    days: z2.number(),
+    history: z2.array(
+      z2.object({
+        date: z2.string(),
+        tvl: z2.string()
+      })
+    )
+  }),
+  examples: [
+    { args: { slug: "aave" }, options: { days: 7 }, description: "Aave 7-day TVL history" },
+    {
+      args: { slug: "uniswap" },
+      options: { days: 14, chain: "Ethereum" },
+      description: "Uniswap Ethereum chain TVL over 14 days"
+    }
+  ],
+  async run(c) {
+    const client = createDefiLlamaClient();
+    const raw = await client.get("api", `/protocol/${c.args.slug}`);
+    const detail = protocolDetailSchema.parse(raw);
+    let tvlSeries = [];
+    if (c.options.chain) {
+      const chainLower = c.options.chain.toLowerCase();
+      if (detail.chainTvls) {
+        const matchKey = Object.keys(detail.chainTvls).find(
+          (k) => k.toLowerCase() === chainLower && !k.includes("-")
+        );
+        if (matchKey && detail.chainTvls[matchKey]?.tvl) {
+          tvlSeries = detail.chainTvls[matchKey].tvl ?? [];
+        }
+      }
+    } else if (detail.tvl) {
+      tvlSeries = detail.tvl;
+    }
+    const now = Math.floor(Date.now() / 1e3);
+    const cutoff = now - c.options.days * 86400;
+    const filtered = tvlSeries.filter((p) => p.date >= cutoff);
+    const history = filtered.map((p) => ({
+      date: new Date(p.date * 1e3).toISOString().split("T")[0],
+      tvl: formatUsd(p.totalLiquidityUSD)
+    }));
+    return c.ok({
+      protocol: detail.name,
+      chain: c.options.chain,
+      days: c.options.days,
+      history
+    });
+  }
+});
+
+// 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", {
+  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];
+  if (!entrypoint) {
+    return false;
+  }
+  try {
+    return realpathSync(entrypoint) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+})();
+if (isMain) {
+  cli.serve();
+}
+export {
+  DEFILLAMA_HOSTS,
+  chainTvlSchema,
+  cli,
+  createDefiLlamaClient,
+  feeEntrySchema,
+  formatDelta,
+  formatNumber,
+  formatPct,
+  formatUsd,
+  protocolDetailSchema,
+  protocolSummarySchema,
+  tvlHistoryPointSchema,
+  volumeEntrySchema
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@spectratools/defillama-cli",
+  "version": "0.2.0",
+  "description": "DefiLlama API CLI for spectra-the-bot",
+  "type": "module",
+  "license": "MIT",
+  "author": "spectra-the-bot",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "defillama-cli": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "incur": "^0.3.0",
+    "@spectratools/cli-shared": "0.2.0"
+  },
+  "devDependencies": {
+    "typescript": "5.7.3",
+    "vitest": "2.1.8"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/cli.js",
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  }
+}