@pipeworx/defillama

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/defillama’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 9

DefiLlama is the canonical free dashboard and API for decentralized finance. TVL (total value locked), protocol tokens, yield aggregators, stablecoins, derivatives, lending markets, DEX volumes — across every major chain and protocol. Used by everyone in crypto. Free, no auth.

Why this matters for AI agents

For DeFi research — comparing yields, tracking TVL flows between protocols, analyzing stablecoin issuance, monitoring liquidations — DefiLlama is the source. The data is normalized across chains (Ethereum, Solana, Base, Arbitrum, etc.) so cross-chain comparison is sane. Pair with Alpha Vantage or Finnhub for the public-equity intersection (Coinbase, Microstrategy, etc.).

Common flows:

• Protocol TVL. “What’s Aave’s TVL?” → current TVL with history.

• TVL leaderboard. “Top 20 DeFi protocols by TVL” → rankings.

• Yield search. “Best stablecoin yields right now?” → APY across pools, with volume + risk indicators.

• Stablecoin supply. “USDC supply across chains” → issuance + bridge flows.

• DEX volume. Trading volumes by exchange or pair.

• Token unlocks. “Which token unlocks are scheduled this week?” / “unlocks over $10M between 2026-10-05 and 2026-10-12” → defi_token_unlocks: every vesting cliff and emission-rate change across ~370 tokens, with tokens, USD value, share of circulating supply and recipients.

• One token’s vesting schedule. “Hyperliquid HYPE unlock schedule” → defi_token_emission: allocation by category, per-recipient unlocked-now vs final, dated past and upcoming unlocks.

Token unlock data

defi_token_unlocks and defi_token_emission read DefiLlama’s public unlocks dataset (defillama-datasets.llama.fi — the same files https://defillama.com/unlocks renders). The documented API route for this (api.llama.fi/emissions) answers 402 Upgrade to the paid API plan, so these tools do not use it. Every response carries data_as_of (the dataset file’s Last-Modified time) and price_as_of.

• USD values use the CURRENT price, not the price on the unlock date. A past unlock’s cliff_usd is what those tokens are worth now.
• Not every allocation is scheduled. Some tokens (Hyperliquid among them) document past unlocks only; the rest of the supply sits in supply_metrics.tbdAmount with no published dates, and the response says so instead of returning an empty future.
• emission_rate_changes are linear-vesting rate changes (tokens per week), which have no single USD amount; min_usd filters them out.

Auth

Free, no auth. DefiLlama is community-supported and welcomes API use; rate limits are gentle.

What’s tracked

Common pitfalls

• TVL ≠ protocol value. TVL is the dollar amount of assets deposited. Doesn’t reflect protocol revenue, token price, or actual usage. A protocol can have $1B TVL and zero users (sleeping idle deposits).
• Double-counting across chains. A protocol on Ethereum + Arbitrum has TVL on both. DefiLlama mostly handles this but edge cases (assets bridged-then-deposited) can double-count.
• Yield decay. APYs in pools change rapidly. The “current APY” snapshot may not last days. For “expected return” computations, use longer-term averages.
• Risk isn’t priced. A 100% APY pool isn’t free money — it usually reflects high impermanent-loss risk, smart-contract risk, or token-emission inflation. DefiLlama exposes some risk metrics but agents should report them prominently.
• Stablecoin supply ≠ stable. “Stablecoin” supply tracks token-level supply. Not all stablecoins are equally stable (USDT, USDC ≈ truly stable; algorithmic stables can deviate). Trust depends on issuer and mechanism.
• Bridge data is approximate. Cross-chain flows are tracked via bridge contracts; not every bridge is monitored, and centralized bridges (CEX deposits/withdrawals) are invisible.
• Token prices vary by source. DefiLlama has its own price index. May differ slightly from CoinGecko / CoinMarketCap. For high-precision price work, use a dedicated price feed.

Revenue ranking

defi_revenue_ranking({ data_type?, period?, sort_by?, category?, chain?, limit? }) ranks protocols by revenue (or fees) over 24h / 7d / 30d, with the prior-period value and percent change. Source: DefiLlama fees and revenue dataset. Pass a returned slug to defi_protocol_fees for the daily series.

Tools

• defi_tvl_protocols — Search DeFi protocols by name or category to compare their total value locked. Returns protocol name, TVL amount, blockchain, and category.
• defi_protocol_detail — Get detailed metrics for a specific DeFi protocol including TVL history over time, breakdown by blockchain, and token information.
• defi_chain_tvl — Compare total value locked across all blockchains. Returns TVL per chain to identify where capital is concentrated.
• defi_protocol_fees — Check daily fees and revenue for a DeFi protocol. Returns fee trends to analyze profitability and income changes over time.
• defi_revenue_ranking — Rank DeFi protocols by revenue (or fees) over the last 24h, 7d or 30d, with the change versus the prior period. Answers “top DeFi protocols by 30-day revenue” and “which protocols’ revenue grew most”.
• defi_stablecoins — Get stablecoin market cap and distribution across blockchains. Returns supply per chain to track adoption and network preferences.
• defi_yields — Find yield opportunities across DeFi pools filtered by project name, minimum TVL, or minimum APY. Returns APY, TVL, and project details.
• defi_token_unlocks — Crypto token UNLOCK calendar from DefiLlama: every scheduled vesting cliff and emission-rate change across ~370 tracked tokens in a date window (e.g. “which token unlocks are scheduled this week”, “un
• defi_token_emission — One crypto token’s full vesting / EMISSION SCHEDULE from DefiLlama (e.g. “Hyperliquid HYPE unlock schedule”, “when do Arbitrum team tokens vest”). Returns max supply, allocation by category (insiders,